2.2.1 Setting the License File

Some of Launcher’s tools may be license-managed. In this case, if Launcher has no knowledge of a valid license file, those tools will not become available until a valid license is provided. A warning message will be shown to indicate that the license file cannot be found.

When you have a valid license, there are a few ways to tell Launcher about the license file:

  • Use the Launcher Configuration tab’s Choose button. This will open a file chooser dialog that will let you navigate to the license file. After choosing the file, Launcher will prompt you with the following dialog:

    • You have three choices:

    • Copy to RTI install location (all users): The chosen license file will be copied to the Connext installation directory, with the name rti_license.dat. Launcher will use this license file not only for the current execution and the current user, but for subsequent executions by any user in the system with access to the RTI Core Libraries installation. Note that if you have installed into a system directory, selecting this option may require system privileges.
    • Copy to RTI user home (just for user <user>): The chosen license file will be copied to the current user’s rti_workspace/<version> directory. The license file will thus only be visible for the current user in subsequent executions of Launcher.
    • Skip: The chosen license file will be applied by Launcher only for the current execution of the tool. It will not be automatically detected by the tool in subsequent executions.
  • Copy the file manually to one of the aforementioned locations where Launcher will search by default, and name the file rti_license.dat. As mentioned before, if the RTI license file is copied to the RTI user home, it will only be visible for this user in subsequent executions of the tool. When the file is copied to the RTI install location directly, it will be visible for all users with access to that directory.

    • The file may be copied both when Launcher has already been started or when it is offline. If the license file is copied while Launcher is executing, Launcher will detect the change automatically and apply the license to the UI.

  • Set the RTI_LICENSE_FILE environment variable with the path to the license file. When setting this variable, not only Launcher but all the RTI applications will use the license file environment variable when executing.

    • Notice that when copied to one of the known locations, all RTI applications will also detect the license file.

After successfully setting a license file with Launcher, all the tools that were disabled because of the license will become available and usable.