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 Rational® 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:
  • You cannot upgrade from an earlier release of IBM Common Licensing. If you have Rational License Server 7.1 or earlier installed, you must uninstall the license server before you install Rational License Key Server 8.x. You cannot upgrade license server versions 7.1 or earlier to version 8.x.
  • IBM Common Licensing version 8.x cannot be on the same machine as IBM Rational Common License version 7.1 or earlier and IBM Rational License Server TL 2.0
  • You cannot upgrade IBM Common Licensing 8.1.1 or 8.1.2 to IBM Common Licensing 8.1.3 on UNIX platforms. You must uninstall the 8.1.1 or 8.1.2 license server before you install IBM Common Licensing 8.1.3.

Installing with IBM Installation Manager

Procedure

  1. Download the software from the Fix Central.
  2. Select Rational License Key Server Version 8.1.3 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 Rational License Key Server. The extracted files are the repository for Rational License Key Server. The installation files include 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 Rational 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 Rational 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 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.
    Important: You cannot change the location of the Shared Resources directory after Installation Manager is installed.
    The default directories are as follows:
    • Shared Resources: /opt/IBM/IBMIMShared
    • Installation Manager: /opt/IBM/Installation Manager/eclipse
  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.
    Note: License files that are used with IBM Common Licensing version 7.1.x and earlier or IBM Rational License Server TL version 2.0 must be migrated to the IBM Common Licensing version 8.1.3 in the required format. The format requires VENDOR ibmratl as the vendor line. Installation of the license server automatically runs the migration utility. You can also use the License Migration Utility to migrate the license files. The utility is included with IBM Common Licensing version 8.1.3 at /config/migrationutility/licmigrationUtility.sh.

Installing with the license_setup script

Procedure

  1. Download the IBM IBM Common Licensing 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 Rational directory, such as the rational_dir/config directory.

  4. Choose to accept or not accept the 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 IBM Common Licensing version 8.1.3 postinstallation

Procedure

  1. Stop the IBM Common Licensing.
    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 IBM Common Licensing.
  8. Use the lmutil lmstat utility to confirm that the new keys are served by the IBM Common Licensing:
    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