Setting up licenses

You can determine the type of licenses you are using and, if you are using user-based licenses, set up the license configuration on your license server.

Before you begin

Determine which type of licenses you are using:
  1. Open the license key file, which has a .dat extension. Example: rational_server_perm.dat
  2. Locate the FEATURE line. This lists the features that you have installed that use the License Key Server.
  3. Locate the RPE_PUBLISH feature. This entry lists licensing as user-based, server (floating), or evaluation.
Tip: If you are using both floating and user-based licenses, verify that the user-based licenses are listed before the floating licenses. Licenses are consumed in the order that they are listed, so if a floating license is listed first, the floating license is used even if the user is specified with a user-based license.

About this task

If you are using floating or evaluation licenses, you are not required to complete any further configuration steps. If you are changing from using evaluation licenses to using permanent floating licenses, verify that the computers the client applications are installed on have a TELELOGIC_LICENSE_FILE environment variable set and use the correct license path.

If you are using user-based licenses, complete the task below.

Setting up user-based licenses

Create an options file that contains a list of the Rational Publishing Engine users and then specify that file in your licensing data configuration file.

Procedure

  1. Open a new text file with a text editor.
  2. Add individual users or groups of users:
    • To add individual users:
      1. Add the following line to add a user:
        INCLUDE RPE_PUBLISH USER user_name
      2. Repeat by adding the line in the previous step for as many users as you have licenses for. For example, if you have two licenses, you can enter two users. You cannot enter more user names than you have licenses.
    • To add a group of users:
      1. Specify the members of a group:
        GROUP user_name1 user_name2 "user_name2 a"
        Multiple single-name users are entered with spaces in between. If the user names have more than one word or have a comma in them, they must be enclosed by quotation marks.
      2. Add the following line to add the group:
        INCLUDE RPE_PUBLISH GROUP group_name
      3. Repeat to specify as many groups as you choose, but you cannot enter more users than you have licenses. For example, if you have two licenses, you can enter two users, regardless of how many groups you enter.
  3. Save the text file with an .opt extension on the same computer as your License Server. Example: ibmratl.opt
  4. Add the .opt file to the license key file.
    1. Open the license key file, which has a .dat extension, with a text editor. Example: rational_server_perm.dat
    2. Locate the VENDOR line.
    3. Update the ibmratl path to the license server executable file:
      ibmratl "path_to_license_server.exe"
    4. Update the options path to the path of the text file you created.
      OPTIONS="path_to_options_file.opt"
    5. Review your changes and verify that the SERVER and VENDOR information are correct. Example:
      SERVER license_server_name host host_id
      VENDOR ibmratl "path_to_license_server.exe" OPTIONS="path_to_options_file".opt
    6. Save the license key file.
  5. Restart the license key server:
    1. Click the Start/Stop/Reread tab.
    2. Stop the server.
    3. Start the server. Wait for the Server started successfully message to display.
    4. Click Reread License File. Wait for the Reread license file completed message to display.
  6. Verify that there are no errors with the RPE_PUBLISH license.
    1. In the License monitoring tools, click Mode > Configuration using Services.
    2. Click Server Status > Perform Status Enquiry.
    3. Review the information for the RPE_PUBLISH license.

What to do next

Provide the users in your organization with the license key path to connect to the license server from their Rational Publishing Engine clients.

If you are changing from using evaluation licenses to using permanent user-based licenses, verify that the computers the client applications are installed on have a TELELOGIC_LICENSE_FILE environment variable set and use the correct license path.


Feedback