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*.)

#. A property called ``com.rti.serv.secure.license_string``. (Only if
   you have a free ("lm") version of *Connext*.)
#. A property called ``dds.license.license_string``. (Only if you have a
   free ("lm") version of *Connext*.)
#. A property called ``com.rti.serv.secure.license_file``. (Only if you
   have a free ("lm") version of *Connext*.)
#. A property called ``dds.license.license_file``. (Only if you have a 
   free ("lm") version of *Connext*.)
#. 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.
#. If you are running any of the tools/services as executables via
   ``NDDSHOME/bin/<executable script>`` or through *Launcher*:

   a. In your ``rti_workspace/<version>`` directory, in a file
      called ``rti_license.dat``.
   b. In your ``rti_workspace`` directory, in a file called
      ``rti_license.dat``.
   c. In ``<NDDSHOME>`` (the *Connext* installation
      directory), in a file called ``rti_license.dat``.

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

   a. In your current working directory, in a file called
      ``rti_license.dat``.
   b. 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.
