Setting up user-based licenses

Create an options file that contains a list of the IBM® Engineering Lifecycle Optimization - Publishing users and then specify that file in your licensing data configuration file.

1. Open a new text file with a text editor.
2. Add individual users or groups of users:
   • To add individual users, complete the following steps:
     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 usernames than you have licenses.
   • To add a group of users, consider the following steps:
     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 usernames 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.
   For 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.
      For 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 that you created.

      OPTIONS=path_to_options_file.opt

   5. Review your changes and verify that the SERVER and VENDOR information are correct.
      For 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 the RPE_PUBLISH license is error-free.
   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.