Error messages on Windows and UNIX system platforms

Suggested actions for licensing error messages.
Table 1 explains licensing error messages for Windows® and Table 2 explain licensing error messages for UNIX® systems.
Table 1. Licensing error messages for Windows
Message or Description Action
  • Cannot find SERVER host name in network database
  • Cannot connect to license SERVER
  • NO SUCH FEATURE EXISTS
  • Failed to check out a product_name key
Confirm on the client:
Confirm on the license server:

In all cases, if you do not see any problems with the network connection or the license file, yet applications cannot acquire license keys, stop and start the license server from the License Manager (See Starting the Windows license server). It may also be helpful to reboot the server, particularly if the license manager is started as a service. If all else fails, contact IBM Software Support for Rational products.

License keys are not for this machine.

or

The license was not intended for this server.

  • You are installing the license key on a computer other than the one for which the license key was generated. The file license.upd specifies the computer name and host ID that you entered in the license key request to License Key Center. Import the file on the correct computer.
  • Confirm that the license key file you received contains the correct host ID and host name of the license server or client. To find this information, use a text editor to view the license key (*.dat) file in install_path\IBM Rational\Common\.
  • Compare the Disk Volume Serial Number found in License Tools > System Settings, with what is displayed in the SERVER line in the license key file. These two numbers should match. Occasionally 0 or a dash will be found in the license file.
The license for this product will expire... Your temporary or Term License Agreement (TLA) license key is nearing its expiration date. This warning message is displayed every time you start the application until you install a permanent license key or another TLA license key. To continue using the product, contact your IBM sales representative to purchase the product or extend your TLA.

You can turn off the warning by clicking Settings > Display Expiration Warnings in LKAD.

Table 2. Licensing error messages for UNIX systems
Message Explanation/Action
There is a problem with one license key.

or

There are problems with N license keys.

This means that the license keys in the license file do not match and are inconsistent with the text of the license. The licenses consist of several parameters and a 12-digit hexadecimal key that was created using these parameters. The parameters are in ASCII text but they cannot be changed or it will invalidate the license. The parameters used to create the license are the server host ID, license name, vendor daemon name, expiration date, number of users (quantity), VENDOR_STRING, OVERDRAFT, SUPERSEDE, DUP_GROUP, and NOTICE.
You do not have remote access to license_server_name from local_host_name, so it cannot be set up as a license server. It may be that the license server is not the same computer on which you are installing. You must have remote shell access (rsh or remsh) to the license server.
Host license_server_name is running Solaris.

Host local_host_name> is running HP-UX.

They do not match so license_server_name cannot be used as a license server.

It may be that the license server is not the same computer on which you are installing. If so, it must use the same operating system that the product you are installing requires.
Host license_server_name does not have access. If the license server is not the same computer on which you are installing, it must have access to the Rational directory where IBM Rational products have been installed.
Cannot set license_server_name's host ID with this command:

rational_dir/base/cots/

flexlm.7.0f/lmhostid

The lmhostid command failed. Check to see if the lmhostid command shown will start on your local host. If so, enter the host ID number in the License Server Host ID Menu (choice number 2).
Cannot access

rational_dir/base/cots/

flexlm.7.0f/lmhostid

on license_server_name.
There was a problem accessing the rational_dir directory or the lmhostid command was not installed from the CD.
Host ID nnn not valid. Less than 4 digits. This means that the host ID number will not work. Check again using lmhostid to see what the host ID is. It should be at least four or more hexadecimal digits.
Port number pn is in use in /etc/services.

or

Port number pn is in use under NIS services.

If you entered a port number and it seems that the number is in use in your /etc/services file or under NIS services, you may have a problem with licensing.

IBM Rational products that use FLEXlm use TCP/IP sockets to communicate with a license server using a specific port number. This port number is specified in the license file on the SERVER line. The license server cannot open a socket on a port that is already in use. Use the default port number: 27000.


Feedback