Upon starting Rational Publishing Engine (RPE) Document Studio or generating a document using RPE Launcher, RPE checks out a license. If RPE does not successfully obtain a license, you will get a licensing error. This post explains how to resolve common RPE licensing errors. While this post is specific to RPE, these troubleshooting techniques can be used to resolve licensing problems in other Rational products that use FLEXnet licenses.
Usually, the RPE licensing error will be in a pop-up window titled "No License Available" with an error like:
Cannot read data from license server system.
The license server system appears to be running, but is not responding. If this persists, notify the System Administrator.
(The license server manager (lmgrd) and vendor daemon processes should be terminated and restarted.)
Hostname: license server host name
License path: port@host, full path to license file, or a combination of these; multiple items are delimited by a semi-colon
FLEXnet Licensing error:-16,287
For further information, refer to the FLEXnet Licensing documentation, available at "www.macrovision.com".
Licensing errors are more common in complex licensing environments -- for example, if USER_BASED licenses are used or in environments with firewalls that can block the license server ports. The following are common causes of licensing problems:
- A firewall is blocking access to the license server port(s).
- The license server is not running.
- If you are using USER_BASED licenses, syntax errors in the license server options file can also prevent RPE from obtaining a license.
- RPE can also fail to get a license if the license server or the licenses themselves are too old for that version of RPE.
Troubleshooting the issue
Before you can fix the licensing error, you need to figure out what is causing it:
- Verify that all the information displayed in the error you get is correct. The information in the error will help you uncover problems resulting from an incorrect configuration -- for example, if the port or host name is wrong. You should also verify that the host name -- exactly as spelled in the error -- successfully resolves on the network from the RPE machine having the problem.
- Look at the license server's license.log file to see what is going wrong. The errors in the license.log file will help you find problems with the licensing environment. The errors in the license.log file will uncover problems like:
- The license server or license files are too old.
- There are syntax problems with the license server options file.
- The license server is not running.
- The client workstation cannot reach the license server (this happens when you get a licensing error in the client but there are no corresponding entries in the license.log file).
- If you see an error like the following:
(lmgrd) Failed to open the TCP port number in the license.
That would indicate that either the port in the license server configuration (or license file) is incorrect, or that the license server port is being blocked by a firewall. It could also indicate that the license server is not running.
- If you use USER_BASED licenses, check your license server's options file. Syntax errors in this file can prevent RPE from checking out a license. Generally, there will be errors in the license.log file (reflecting license denials) if there are options file syntax errors.
Fixing the problem
There are several things you can do to resolve licensing problems, depending on what is causing them:
- In some environments, it is possible to swap out the USER_BASED licenses for regular floating licenses. If you are in such an environment and do not need the extra features from USER_BASED licenses, go ahead and make the switch, as floating licenses are easier to get working.
- Whether you switch to floating licenses or not, make sure that the license server is pointing at the correct license file and that the port in the license file is available on your system (use netstat to check).
- If needed, regenerate your license files or upgrade your license server.
- Make sure the RPE workstation can reach the license server on the network. Some commands you can use to verify this:
Resolve any network problems found.
- If you need to use USER_BASED licenses, resolve any syntax errors in the license server options file.
- Start (or restart) your license server:
- if it is not running
- if you changed the license file or the license server options file
- If needed, reconfigure the RPE workstation to find the license server -- you would need to do this if you had to change the license server port. If the license server port is wrong, you will see that in the error details of the licensing error. To fix it, you will need to update the TELELOGIC_LICENSE_FILE environment variable on the RPE workstation.