Installing Floating Licenses on a PC Server

Manuals >Installation and Customization Guide >Setting up Licenses on Windows Systems
Print version of this Book (PDF file)

Installing Floating Licenses on a PC Server

Use the following sections to install your IC-CAP floating licenses. You should have installed IC-CAP before you complete these steps. For details on installing IC-CAP on a PC running Windows, please refer to Installing IC-CAP.

Note

Be sure to use the following information to update all existing license servers with the latest version of the FLEXnet software (e.g., lmgrd and lmutil). The software is installed with IC-CAP 2008. Using older versions may cause license-encryption errors, invalid hostid results, and unsupported feature errors.

Verify that all multiple and redundant servers are updated including any license administration scripts in use. Run lmutil directly from the IC-CAP 2008 installation location (<installation folder>\licenses\bin) for information to help modify the scripts.

You will need to stop, then restart, the license server to make these updates.

Installing the License File

The license.lic file that implements FLEXnet security must be installed to run IC-CAP. The default install path is <installation folder>\licenses; for example: C:\ICCAP_2008\licenses\license.lic. Copy the license.lic file that you received via e-mail to the <installation folder>\licenses folder.

If your licenses will be served by a central server, have your system administrator install the license.lic file on the license server.

Entering the Hostname

Change the default hostname setting in your license file to the actual hostname of your license server. The license server is the computer that will serve the licenses on the network, and whose Ethernet address or FLEXID hardware key number, appears on the SERVER line.

For example, lets assume that a computer with FLEXID hardware key number 8-5E700059B957 has a hostname of joshua. The SERVER line should read:

   SERVER joshua FLEXID=8-5E700059B957

License files are generated with SERVER lines with the following format:

   SERVER <hostname> <hostid>

where

<hostname> is set to unknown by default

<hostid> is the FLEXID hardware key number or Ethernet address of the license server.

You can also specify a specific TCP port number for license requests as follows:

SERVER <hostname> <hostid> <tcp_port>

Any computer that runs IC-CAP and wants to checkout licenses from this license server will need to set AGILEESOFD_LICENSE_FILE as follows:

AGILEESOFD_LICENSE_FILE=2100@joshua

If you do not specify a TCP port number on the SERVER line in your license.lic file, the license server will automatically use the first available TCP port in the range 27000 to 27009. In this case, you should set AGILEESOFD_LICENSE_FILE as follows:

AGILEESOFD_LICENSE_FILE=@joshua

Note


		Enter a specific port address on the SERVER line for improved license check-out performance. You may enter a port address outside the range of 27000 to 27009, as long as the address is not used elsewhere. Then set the environment variable AGILEESOFD_LICENSE_FILE.

Setting the Vendor Daemon Path

By default, no path is specified to the agileesofd vendor daemon executable. This is acceptable as long as lmgrd and agileesofd are in the same folder when you start FLEXnet.

In the typical license configuration, lmgrd and agileesofd are both located in the \ICCAP_2008\licenses\bin folder. When lmgrd is started from the \ICCAP_2008\licenses\bin folder, it looks for agileesofd in the same folder. If agileesofd is not in the same folder as lmgrd, you must specify a path to it using the following syntax:

 VENDOR agileesofd C:\ICCAP_2008\licenses\vendors\agileesofd

Starting FLEXnet

FLEXnet can be started either manually or automatically. You must start the FLEXnet license manager daemon (lmgrd) on the license server(s) first. Once the license server(s) is running lmgrd and has started the vendor daemon(s), you can configure the other computers (clients) and user login accounts that need to access IC-CAP.

To start FLEXnet you need the following.

•	FLEXnet software installed in the <installation_location>\licenses folder. This is done when you install IC-CAP.

•	The license server computer connected to the network using the TCP/IP network protocol.

•

A local copy of the license.lic file that contains the FLEXnet codewords. Every computer that will run IC-CAP must be able to access the license.lic file used by the license server(s) to check out a license. Access to the license.lic file can be via a local copy of the license.lic file or through a network drive.

•	Properly configured SERVER and VENDOR lines in your license.lic file.

If you have a three-server redundant configuration, you must start FLEXnet on all three servers before the licenses will be available on the network. Once you have FLEXnet running, you can configure the other computers (clients) and user login accounts that need to access IC-CAP by setting AGILEESOFD_LICENSE_FILE.

Starting FLEXnet Manually

While starting FLEXnet manually is a good way to verify that FLEXnet starts correctly, it is generally not recommend for a server, because it requires a dedicated MS-DOS Command Prompt to be open at all times and it requires re-starting after rebooting the license server. Use the following steps to start the FLEXnet executable file, lmgrd.exe:

1 From a MS-DOS Command Prompt, change to
<installation_directory>\licenses\bin, where <installation_directory> is the folder where you installed IC-CAP.

2 Type the following command specifying the full path and location of the license file.

lmgrd -app -c <installation_directory>\licenses\
license.lic  -l  <inst_dir>\licenses\flex.log

To shut down the license manager, enter the following at a command prompt, from the < installation_directory>\licenses\bin folder:

 lmutil lmdown -c <installation_directory>\licenses\license.lic

Starting FLEXnet Automatically

Ideally you should configure FLEXnet to start up automatically each time your system is booted by installing the license manager as a Control Panel service.

To start the license manager automatically:

1 From a MS-DOS Command Prompt, change to <installation_directory>\licenses\bin, where <installation_directory> is the folder where you installed IC-CAP.

2 Enter the full path and filename of both the license executable file and the license.lic file. The default location for the executable file is <installation_directory>\licenses\bin\lmgrd.exe. (The flex.log file is useful for troubleshooting.)

install -e <path to lmgrd> -c < path to license file> -l
<path to flex.log>

For example:

install -e d:\ICCAP_2008\licenses\bin\lmgrd.exe -c 
d:\ICCAP_2008\licenses\license.lic -l 
d:\ICCAP_2008\licenses\flex.log

If you did not specify a flex.log file using the "-l" option when you ran install.exe in step 2, FLEXnet creates a default log file in the system 32 folder. While this default log file does not contain as much information, it can still be useful. This file is typically located in c:\winnt\system32\ and is named lmgrd.log or lmgrd.xxxx where xxxx is the process ID number of lmgrd.

3 Activate the license server by starting the FLEXnet service using the Control Panel or by rebooting the system:

Start > Settings > Control Panel > Administrative Tools > Services

Double-click on the FLEXnet License Manager service and click on the Start button.

To remove the license manager from the service list and cancel the automatic FLEXnet startup:

From your system prompt, change to the license folder and enter: install -r

To change the path to your license file, first remove the existing FLEXnet service using the installs -r command, reinstall FLEXnet using the new location, and then reboot your system.

Ensure Access to the License File

You need to configure each PC client to access the license server and to check out a license. You can do this by using one of two methods:

•	Place a copy of the license.lic file in the <installation_directory>\licenses folder of each local computer.

•	Configure the AGILEESOFD_LICENSE_FILE to point to the license file.

Typically, it is best to use the port@host syntax to set the AGILEESOFD_LICENSE_FILE to point to the license server.

set AGILEESOFD_LICENSE_FILE=27000@joshua

Where 27000 is the TCP port number on the SERVER line in the license.lic file and joshua is the hostname of the license server.

If your license server is set up to search for an available port, use the @host syntax to set the AGILEESOFD_LICENSE_FILE to point to the license server.

set AGILEESOFD_LICENSE_FILE=@joshua

You can also set AGILEESOFD_LICENSE_FILE to the full path and filename of the license.lic file used by the license server:

 set AGILEESOFD_LICENSE_FILE=C:\ICCAP_2008\licenses\license.lic