How do you configure an Authorized user (USER_BASED) license for IBM Rational Publishing Engine?
Rational Publishing Engine has two types of licenses that it can work with:
- Floating (server) license.
- Authorized user license (USER_BASED)
This Technote describes the detailed steps for configuring the USER_BASED license for IBM Rational Publishing Engine.
Determining if the Rational Publishing Engine license you have is USER_BASED or not?
Open the License file (example: license.dat) and check in the "FEATURE" line for "RATIONAL_PUBLISH", whether it contains a key word "USER_BASED".
Only if the license contains the key word "USER_BASED" for "RPE_PUBLISH" you would have to use an Options file on the License Server machine in order to get the license working as described in the steps below:
Note: No additional steps are required if you are using a regular Floating (Server)license for IBM Rational Publishing Engine.
- Create a new text file anywhere on the License Server's hard drive and name it as "Options.opt".
Example: "Options.opt" can be created in "C:\Program Files\Rational"
- Open the newly created "Options.opt" file using a Notepad and enter:
INCLUDE RPE_PUBLISH USER "<system user name of the user who intends to use Rational Publishing Engine>"
Example: Let’s assume the system user name of the user who would be using RPE is "indpaho", then the Options.opt file should have the following: INCLUDE RPE_PUBLISH USER indpaho
- If in your license file, the quantity of licenses for IBM Rational Publishing Engine is one it means that at any given point in time only one user can use IBM Rational Publishing Engine.
The number of users that you can specify in the Options file is limited by the number of licenses you have. Hence, if you have two IBM Rational Publishing Engine licenses, you can specify a maximum of two names in the Options file.
For adding multiple users into the options file, you can create a GROUP, name it appropriately and add the list of users into the GROUP.
Example: Lets assume John, David and Mary are all part of a team named 'Publishers' in an organization. We can create a group named 'Publishers' and have these users added into the group. The syntax would be: GROUP Publishers John David Mary
Subsequently, this group can be included to allow access to IBM Rational Publishing Engine license.
Hence, the final syntax in the Options file would appear as follows:
GROUP Publishers John David Mary
INCLUDE RPE_PUBLISH GROUP Publishers
If the system usernames in your organization have a space OR comma in them, then the names need to be enclosed within double quotes.
Example: Lets assume the usernames are <USER A>, <USER B> and <USER C>. Then the Options.opt file would have: INCLUDE RPE_PUBLISH USER "USER A" "USER B" "USER C"
Alternatively, you can utilize the same concept of adding all the users into a GROUP and then specifying the name of the GROUP in the INCLUDE line of the options file.
Also, if you have only one USER_BASED license for IBM Rational Publishing Engine in your license file, you would be able to specify only one user's name in the Options file.
- Once the Options.opt file has been updated as per the format of the system usernames, please save the same while making sure that the file is saved as "Options.opt" and doesn't have a .txt extension.
- Open the License.dat and add the complete path of the newly created Options.opt file at the DAEMON line. The DAEMON line should be the next line (one soon after the) SERVER line in the license.dat file. If you don't have a word DAEMON instead have Vendor, please perform the following changes in the License.dat file.
- The first line of the license.dat file should remain intact i.e. it should be SERVER <name of the license server> <host id> 19353.
- If DAEMON word isn't present instead Vendor exists as the second line, remove the entire line and add the following as the second line in the License.dat file:
DAEMON telelogic "complete path to telelogic.exe" OPTIONS="C:\Program Files\Rational\Options.opt"
SERVER LicenseServerName 12AcDe 19353
DAEMON telelogic "C:\Program Files\Telelogic\Tools\Licensing_11\Server\telelogic.exe" OPTIONS="C:\Program Files\Rational\Options.opt"
- After performing the above changes, save the License.dat file while making sure it's saved with only (.dat) extension.
- Launch LMTOOLS and click on "Start/Stop/ReRead" tab, Stop the server, start it and wait till it says Server Started successfully.
- After the server has started successfully, please click on "ReRead License File" and wait till it displays, ReRead license file completed.
- Once the above message is displayed, click on "Server Status" and click on "Perform Status enquiry" and check if there is any error with the RPE_PUBLISH license. Ideally there shouldn't be any.
With the above steps performed, your License Server is ready to serve USER_BASED licenses for IBM Rational Publishing Engine.
In order to fetch a license from the License Server machine, please ensure that the machine's System Environment Variable 'TELELOGIC_LICENSE_FILE' has the correct port@server details.
Here is how you can add (or confirm existing entries).
- Right Click on My Computer icon -- Properties -- Advanced -- Environment Variables.
- Under the 'System Variables' check if you have 'TELELOGIC_LICENSE_FILE' already listed. If yes, appended the existing License details by adding a semi colon soon after the last entry (if it doesn't already have one) and add the port@<License Server hostname/IP Address>.
Example: Assuming that your 'TELELOGIC_LICENSE_FILE' entry already has 19353@LicServer1 and if this Server is not the one serving IBM Rational Publishing Engine licenses, you would have to append the entry as follows: 19353@LicServer1; 19353@LicServer2 (where LicServer2 is the server which has Rational Publishing Engine licenses). Once done, click on Apply and OK to exit out of the window.
- If you don't find 'TELELOGIC_LICENSE_FILE' listed in System Variables, please create a new variable with the name 'TELELOGIC_LICENSE_FILE' without the quotes and add the correct port@<License Server hostname/IP Address> details.
Example: 19353@LicServer2 (where LicServer2 is the server which has Rational Publishing Engine licenses). Once done, click on Apply and OK to exit out of the window.
With the above steps performed, IBM Rational Publishing Engine should now be able to successfully fetch a USER_BASED license from the License Server.