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.

Installing with Installation Manager

Procedure

  1. Download the software from the Fix Central.
  2. Select License Key Server Version 8.1.6 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 Rational License Key Server window opens.
  7. Click IBM Rational License Key Server version to open the Installation Manager interface. Installation Manager is not yet installed.
  8. Select both Installation Manager and IBM Rational 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 antivirus 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/RationalRLKS.
  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 Rational License Key Server or None.

    The default is set to start IBM Rational License Key Server. To do so, copy your license file contents into the license file: RLKS_installation_Dir/config/server_license.lic.

  17. Click Finish.

Installing with the license_setup script

Procedure

  1. Download the License Key Server from the IBM Website.

    The download contains a tar.gz file. The file name indicates the intended installation platform. Download the files for your installation platform.

  2. Unpack the files. You can use gzip or gtar as shown in the following example that uses the C85W8JA tar file:

    gzip –dc C85W8JA.tar.gz | tar –xf –.

    A directory that is named RLS.8.0.0.PLATFORM_x86 is created, where PLATFORM is either AIX®, Linux, Solaris, or HP-UX.

    If you have GNU tar (gtar), use the -z option to decompress the file. For example:

    gtar –xzf C85W8JA.tar.gz.

  3. Start the license_setup script in the directory where you unpacked the files. For example:

    cd RLS.8.0.0.PLATFORM_x86.

    ./license_setup.

    The script starts by providing instructions and prompts you for a ELM or IBM Rational directory, such as the rational_dir/config directory.

  4. Choose to accept or not accept the IBM ELM or IBM Rational license agreement.
    • If you accept the license agreement, the script continues.
    • If you do not accept the license agreement, the script exits and does not change the server.
  5. Provide your license file information. Import the information from the license file by providing a path. For example: /var/IBM/lic/license.
  6. View the license information and click Enter.
  7. Define the location for the license.dat file that is created from the information that is supplied by the file. By default, the license_setup script creates the license.dat path as: /var/IBM/Rational/license.dat.

    Choose either the default path or specify an alternative path.

  8. Proceed to the License Check menu.

    Complete options 1 to 3 sequentially and continue to the next menu. If you are setting up a permanent authorized user license, complete only option 1. The options are default settings that are provided by the license_setup script.

Importing licenses to the UNIX license server for License Key Server version 8.1.6 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 RLKS_installation_Dir/config directory and locate the server_license.lic file.
  3. Save a backup of the server_license.lic file in another location.
  4. In the RLKS_installation_Dir/config directory, open the server_license.lic file.
  5. From your new license key, copy all the contents of the license key file to the server_license.lic file.
  6. Save the server_license.lic file in the RLKS_installation_Dir/config 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/RationalRLKS/bin
    2. Run this command: 
      ./lmutil lmstat -a -c port@host
      Example: 
      ./lmutil lmstat -a -c 27000@localhost
Feedback