Installing the license server and license keys on redundant UNIX servers

Learn how to install the license server and license key files manually on redundant servers.

Before you begin

Request for license key files before you configure the redundant servers.

To configure the license server on redundant UNIX servers, you must have the licensing executable files from the IBM download site and a license key file for redundant UNIX servers from IBM License Key Center. Configure a start script and start each server.

The license_setup script cannot import license key files for redundant servers, and the script cannot start redundant servers. Instead, you must manually install the license file and server on each computer.

You must meet these requirements for configuring redundant servers:

If you have configured a license server and plan to use that server in the redundant server configuration, the License Key Server must be removed from the computer. See Removing the License Key Server from UNIX.
1. Return the license keys to the IBM License Key Center: Returning or moving license keys.
2. Follow instructions for installing the license server and license keys in a redundant server configuration.
You must have the license key file for redundant UNIX servers. Go to the IBM License Key Center and request a license for redundant servers. IBM License Key Center asks you for the primary, secondary, and backup servers. Be sure to specify the redundant servers in the correct order:
- Host Name 1 is the primary server
- Host Name 2 is the secondary server
- Host Name 3 is the backup server
The license server can be installed on all of the UNIX platforms that IBM® Engineering Lifecycle Management (ELM) or IBM Rational® supports.
The license file must have the file name format similar to license_for_server.upd. The IBM License Key Center sends the license file to an email account when you request a license.
To check the connection between the servers and clients, use the following UNIX commands: ping, arp, rsh, rlogin, or telnet.
The servers should be on the same subnet.
The license server must be installed locally. Each server uses a Flexera FlexNet Publisher lmgrd process and a vendor daemon process to manage licenses. For more information about these processes, see Getting started with IBM Common Licensing.

Note: If you are upgrading the License Key Server from 8.1.6 or earlier to v 9.0, you might encounter a warning message similar to, "The IBM License Key Server package does not support one of more of the translations that are selected for the IBM Rational RLKS package group. For unsupported translations, the language that is used by the package is either the language that is used for the operating system or English" . This warning message is caused by the difference in the way translations are installed in the new version release, and can be safely ignored. Support for the translated languages remain the same in v9.0.

About this task

The license_setup script cannot import a redundant license key file. You must install the license server and license key file manually on each redundant server.

Procedure

Place a copy of the license file that you receive from IBM License Key Center on each of the three license servers. Verify that the order of the server lines is the same in each file.
1. You can verify the order of the server lines by opening the license file and checking for three server lines.
  - If you do not have a three-server license file, return your license file to IBM License Key Center by using a return transaction. Request a new license file for redundant UNIX servers. If you have problems, when you receive, return, or work with the redundant server license file, contact IBM Software Support for ELM or IBM Rational products.
  - If the server lines are not in the correct order, you can change the order. You can change the server name (not the host ID) and the port number. You cannot add or delete server lines.
2. The license_for_primary.upd license file must be copied to the rational_dir/config directory. You must maintain this file on all three servers. Copy and rename the file to rational.dat as shown in this example:
  cp license_for_primary.upd rational_dir/config/rational.dat
3. Assign a TCP/IP port to each server. You must assign a TCP/IP port number to each server by modifying the port assignment in each server line.
  
  Important: All the redundant servers must have same port number. You can use any port number, but Flexera suggests 27000 for lmgrd daemon. Use ports in the 27001 - 27009 range for ELM or IBM Rational and ibmratl daemon.
4. Verify that the port is not already in use.
  Port 1706 is used in the following sample commands.
  1. Check the file etc/services. For example, grep “[ ]1706/” /etc/services
  2. Check the NIS services by using the ypcat services command. For example, ypcat services | grep “[ ]1706/”
    Remember: There is a tab and a space character between the braces, [ ].
  3. Edit the license file to use the port numbers. For example, cd rational_dir/config vi rational.dat
  4. Verify that your license file looks like this example:
```
SERVER primary 8001d410 1706
SERVER secondary 8001d625 1706
SERVER backup 8001d873 1706
```
Locate the FlexNet utilities in the ELM or IBM Rational License Server package. The files are in one of the extras/flexlm.* directories. The directory name depends on the FlexNet version and operating system.
Example file names are as follows:
- extras/flexlm.10.8.0.1.i386_linux2
- extras/flexlm.i386_linux2
Copy the FlexNet files to the rational_dir/config directory on all three servers. The term rational_dir/config is used to represent the location of the license server.

Remember: Copy the appropriate .tar file for the operating system that you are installing on.

What to do next

You can install the Server Administration and Reporting Tool application to administer license servers on Windows and UNIX operating systems. By using the reporting feature of the application, you can generate license usage reports for ELM or IBM Rational products that are served by the License Key Server and IBM Engineering Lifecycle Management(ELM) license server.