Licensing Problems

If you see a message like this:

There is a problem with one license code.

or this:

There are problems with <N> license codes.

This means that the license codes 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, 16 or 20 digit hexadecimal code 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, vendor_info, NOTICE and ck (checksum).

If you see a message like:

It appears that Rose 2002 for UNIX is not licensed.

This means that there is a problem with the license server. It could be that:

1 . The license server was never started.

2 . The license server failed to start. This happens when the license codes are inconsistent.

3 . There is already a license server running but it is not using the Rose 2002 for UNIX license file

Check the license server log file which is kept in /rational_dir/config/server-name.log.

If you see a message like:

Users of Rose98_Unix: Cannot get users of Rose98_Unix: No such feature exists
(-5,222)

This could mean that multiple Rational servers are running, or a stale lock file was not cleaned up. This error could result from either:

1 . Another copy of lmgrd running.

2 . A prior lmgrd was killed with "kill -9" which would leave the vendor daemon running.

To correct this, kill the lmgrd and rational processes and remove the Rational lock file:

a . Use this ps command or equivalent to find the process IDs:

ps -ax | egrep "lmgrd|rational"

b . Kill those processes:

kill Process-ID-of-lmgrd Process-ID-of-rational

c . Remove the lockrational file which can be found at either:

/usr/tmp/lockrational

or

/tmp/lockrational

You may need to reboot the license server computer if this fails to correct the problem.

If you see a message like:

You do not have remote access to license-server-name from local-host-name, so it cannot be used as a license server.

It may be that the license server is not the same computer you are installing on. You must have remote shell access (rsh or remsh) to the license server computer.

If you see a message like:

Host, license-server-name does not have access.

If the license server is not the same computer you are installing on, it must have access to the rational_dir directory where Rose has been installed.

If you see a message like:

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 run on your local host. If so, enter the host id number in the License Server Host ID Menu (choice number 2).

If you see a message like:

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 did not get installed from the CD-ROM.

If you see a message like:

Host ID <nnn> not valid. Less than 4 digits.

This means that the host ID number will not work. Check again using the lmhostid to see what the host ID is. It should be at least 4 or more hexadecimal digits.

If you see a message like:

Port number <pn> was found in /etc/services.

If you entered a port number and it appears that the number is in use in your /etc/services file, you may have a problem with licensing. Rational products use FLEXlm which uses 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 will not be able to open a socket on a port that is already in use. Rational recommends you use the default port number, 27000.

If you see a message like:

Could not find this string: 'begin .* license.*.upd'
or this string:
'INCREMENT rose_unix rational' in this file: name-of-file-you-are-importing-license-information-from
Failed to import license information.

This means that you did not receive any uuencoded or plain text e-mail from Rational containing your license keys. If you did, you need to save the message in a file and use that file as the import file. Do this from rs_install or from the license_setup Enter License Key Menu.

---

Automatic Traceback if Rose should Crash or Hang on SUN Solaris or HP-UX

An automatic traceback mechanism is available for Rose for SUN Solaris and HP-UX. If Rose (rose_exe) should crash, provide the automatically produced traceback data to Rational Technical Support as described below: