IBM
Contents Index Previous Next



Setting up Your License Server


If you want to use floating licenses for your IBM Rational software, you have to install the IBM Rational License Server TL. If you haven't received your floating license from IBM Rational, you can still install the IBM Rational License Server TL. When you receive your license, follow the instructions in Changing the location of your floating license on Windows.

You only need to set up the IBM Rational License Server TL once. The same license server can be used for all your IBM Rational products (formerly Telelogic products). For more information about licensing, see:

Installing the IBM Rational license server TL on Windows

If you have a IBM Rational floating license, copy it to a folder on the license server machine and take a note of its location. If you do not have a floating license yet, you can install the IBM Rational License Server TL and set up the license later.

  1. Double-click setup.exe in the flex directory on the CD-ROM. The Welcome screen is displayed.
  2. Click Next. The Choose Destination Location screen is displayed.
    Enter the path to the folder you want to use for your IBM Rational installations, or leave the default.
    If you want to change the directory:
    • Click the Browse button
    • Browse to the directory you want to install to
    • Click OK
  3. Click Next. The License File Locations screen is displayed.
    If you have your floating license file, type the path to the file, including the file name in the License File box. If you do not have your floating license file yet, leave the default path.
    The IBM Rational License Server TL also creates a log file that records the all the actions concerning the license server. If you want the log file to be created in a different location, type the new location in the License Log box.
  4. Click Next.

Note:

If the installer cannot find the license file you specified, a message is displayed stating that the license file could not be found. This happens if you do not have your license yet, or if you have your license but typed the path incorrectly. Click OK in the message.

  1. The Start Copying Files screen is displayed. Click Next if you are happy with the settings.
  2. The IBM Rational License Server TL is configured, and the Finish screen is displayed.
    If you want to register the license server service, leave the check box selected. A service called Flexlm License Manager is created. To start it, you must either reboot your machine, or start the service manually.
  3. Click Finish.

Changing the location of your floating license on Windows

If you installed the IBM Rational License Server TL before you received your floating license, or if you move your floating license to a different folder, you have to modify the license manager using the LMTOOLS utility.

  1. Copy your floating license file to a folder on the license server machine and take a note of its location.
  2. On the task bar, click Start, then select IBM Rational> IBM Rational License Server > LMTOOLS from the Programs menu.
    The LMTOOLS by Acresso window is displayed.
  3. Click the Config Services tab.
  4. Click the Browse button next to the Path to the license file box, and browse to the folder containing your license file.
  5. Select the file and click Open.
  6. Click the Start/Stop/Reread tab, saving the changes when prompted.
  7. Click Start Server.
    The IBM Rational License Server TL is started.

Setting up the IBM Rational License Server TL on UNIX

  1. Unpack the flex.tar file from .../license_server/<arch> to a directory of your choice, for example /flex/<arch>, where <arch> is the architecture of your system.

Note:

Any directory can be used to store the unpacked files, as long as the license server can access the files. However, we recommend not to put the files in the same directory as the IBM Rational installation (or in a subdirectory to the installation directory). Having the FLEXnet files stored on a directory separate from the installation directory will simplify administration tasks when upgrading to future versions, and will also make it easier to co-exist with other products that use FLEXnet.

  1. The FLEXnet license management software does not require root privileges to operate. The FLEXnet license management daemon should be run from a non-privileged user account.
    If the license management daemon is currently executing with root, or some other system account permission, modify it. For example, create a non-privileged user account, flexnet, for running the FLEXnet license management daemon.
  2. Save or copy the FLEXnet license file you received from IBM Rational into a text file called license.dat.
  3. Make sure that the information in the license.dat file is correct according to your server and installation.
    • The SERVER line in the license file must contain the correct hostname and hostID.
    • The FLEXnet license server uses the port number specified on the SERVER line of the license.dat file. By default, this is 19353. If this clashes with a port already defined on your system, edit license.dat to specify the port number you want to use.
    • The DAEMON line contains the correct path to the telelogic daemon in the /flex/<arch>, where <arch> is the architecture of your server.
  4. Start the FLEXnet license server on UNIX.
    Make sure no license servers for IBM Rational tools are currently running. Search for the license daemons lmgrd and telelogic in the current process list, for instance by using the command:
    ps -ae | egrep '(lmgrd|telelog)'
    
    If you have any license daemons running, terminate them using the lmutil lmdown command.
  5. Change to your installation directory:
    cd /flex/<arch>
  6. Start the license server:
    lmgrd -local -c license.dat -l license.log
  7. Check that the license server has been started correctly with the following command:
    lmutil lmstat -c license.dat
    The license server statistics are displayed containing the server, the vendor daemon telelogic and the features available in your license.dat file.
  8. If the startup has failed, check the license.dat file for errors and omissions; see Common problems. Double-check your file with the original sent from IBM Rational.
  9. There is also a license.log file in the installation directory, where all actions concerning the license server are logged.

Note:

The log file can grow rapidly. You must switch logs and/or delete the head of the file on a regular basis.


http://www.ibm.com/rational
Contents Index Previous Next