![]() |
![]() |
![]() |
![]() |
![]() |
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:
- Understanding IBM Rational Licenses.
- FLEXnet Licensing End User Guide, which is available from the support area of the Acresso website at www.acresso.com.
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.
- Double-click setup.exe in the flex directory on the CD-ROM. The Welcome screen is displayed.
- 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.- 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.
- Click Next.
- The Start Copying Files screen is displayed. Click Next if you are happy with the settings.
- The IBM Rational License Server TL is configured, and the Finish screen is displayed.
- 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.
- Copy your floating license file to a folder on the license server machine and take a note of its location.
- On the task bar, click Start, then select IBM Rational> IBM Rational License Server > LMTOOLS from the Programs menu.
- Click the Config Services tab.
- Click the Browse button next to the Path to the license file box, and browse to the folder containing your license file.
- Select the file and click Open.
- Click the Start/Stop/Reread tab, saving the changes when prompted.
- Click Start Server.
Setting up the IBM Rational License Server TL on UNIX
- 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.
- 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.
- Save or copy the FLEXnet license file you received from IBM Rational into a text file called license.dat.
- 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.
- 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.
- Change to your installation directory:
cd /flex/<arch>- Start the license server:
lmgrd -local -c license.dat -l license.log- Check that the license server has been started correctly with the following command:
lmutil lmstat -c license.dat- 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.
- There is also a license.log file in the installation directory, where all actions concerning the license server are logged.
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 |
![]() |
![]() |
![]() |
![]() |