Installing the license server on UNIX

Follow the applicable installation steps for the version of the license server that you are installing.

Before you begin

Before you install the product, read the System Requirements for License Key Server technical document to ensure that you understand the requirements.

Know how to download installation files from the IBM® Website.

To understand the general steps that are required to configure floating or named-user floating licenses on a UNIX license server, see Configuring floating and named-user keys on a UNIX server.

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.

Installing with Installation Manager

Procedure

  1. Download the software from the Fix Central.
  2. Select License Key Server Version 9.0.0 eAssembly and follow the download instructions.
  3. Extract the compressed file into an appropriate directory.
  4. Go to the disk1 directory.
  5. Extract the installation files for License Key Server. The extracted files are the repository for License Key Server. The installation files include IBM Installation Manager. You do not need to download Installation Manager separately.
  6. Run launchpad.sh. The IBM License Key Server window opens.
  7. Click IBM License Key Server version to open the Installation Manager interface. Installation Manager is not yet installed.
  8. Select both Installation Manager and IBM License Key Server and click Next.

    To install License Key Server, you must also install Installation Manager.

  9. After the prerequisites are validated, click Next. To validate prerequisites again, click Recheck Status in the lower-right corner. Four validation checks occur automatically during the prerequisite step:
    • A check that all applications are closed and that your anti virus software is disabled.
    • A check to determine whether you are installing as a root user. If you install as a root user, you receive a warning message. Click Show Details to receive more information and instructions on next steps.
    • A check to determine whether earlier versions of License Key Server or Telelogic license key servers are installed. If older versions are installed, you receive a warning message. Click Show Details to receive more information and instructions on next steps.
    • A check to determine whether earlier versions of IBM Engineering Lifecycle Management (ELM) or IBM Rational® or Telelogic license key servers are running. If older versions are running, you receive a warning message. Click Show Details to receive more information and instructions on next steps.
  10. Accept the license agreement and click Next.
  11. For both the Shared Resources directory and Installation Manager directory locations, either accept the default value or enter a different directory location. Click Next.
  12. Accept the default installation directory for the license server or enter a different installation directory. The default installation directory is /opt/IBM/LKS/bin.
  13. Select more languages to install and click Next.
  14. Review the features to install and click Next.
  15. Click Install.
  16. When the installation is complete, select start IBM License Key Server or None.

    The default is set to start IBM License Key Server. To do so, copy your license file contents into the license file: LKS_installation_Dir/bin/LKS_License.dat.

  17. Click Finish.

Importing licenses to the UNIX license server for License Key Server version 9.0.0 post installation

Procedure

  1. Stop the License Key Server.
    1. From a command line, change your directory to Server_Installation_DIR/config.
    2. Run the ./start_lmgrd stop command.
  2. Go to the LKS_installation_Dir/bin directory and locate the LKS_License.dat file.
  3. Save a backup of the LKS_License.dat file in another location.
  4. In the LKS_installation_Dir/config directory, open the LKS_License.dat file.
  5. From your new license key, copy all the contents of the license key file to the LKS_License.dat file.
  6. Save the LKS_License.dat file in the LKS_installation_Dir/bin directory.
  7. Start the License Key Server.
  8. Use the lmutil lmstat utility to confirm that the new keys are served by the License Key Server:
    1. Go to the bin folder in the installation directory.
      For example: /opt/IBM/LKS/bin
    2. Run this command: 
      ./lmutil lmstat -a -c port@host
      Example: 
      ./lmutil lmstat -a -c 27000@localhost