4.1. Installing the License File

Save the license file in any location of your choice; the locations checked by the plugin are listed below. You can also specify the location of your license file in RTI Launcher’s Configuration tab. Then Launcher can copy the license file to the installation directory or to the user workspace.

Each time your application starts, it will look for the license file in the following locations until it finds a valid license. (The properties are in the PropertyQosPolicy of the DomainParticipant.)

  1. A property called com.rti.serv.secure.license_string. (Only if you have a free (“lm”) version of Connext.)

  2. A property called dds.license.license_string. (Only if you have a free (“lm”) version of Connext.)

  3. A property called com.rti.serv.secure.license_file. (Only if you have a free (“lm”) version of Connext.)

  4. A property called dds.license.license_file. (Only if you have a free (“lm”) version of Connext.)

  5. In the location specified in the environment variable RTI_LICENSE_FILE, which you may set to point to the full path of the license file, including the filename.

  6. If you are running any of the tools/services as executables via NDDSHOME/bin/<executable script> or through Launcher:

    1. In your rti_workspace/<version> directory, in a file called rti_license.dat.

    2. In your rti_workspace directory, in a file called rti_license.dat.

    3. In <NDDSHOME> (the Connext installation directory), in a file called rti_license.dat.

  7. If you are running your own application linked with Connext libraries:

    1. In your current working directory, in a file called rti_license.dat.

    2. In <NDDSHOME> (the Connext installation directory), in a file called rti_license.dat.

As Connext attempts to locate and read your license file, you may (depending on the terms of the license) see a message with details about your license.

If the license file cannot be found or the license has expired, your application may be unable to initialize, depending on the terms of the license. If that is the case, your application’s call to DomainParticipantFactory.create_participant() will return null, preventing communication.

If you have any problems with your license file, please email support@rti.com.