[size 2]TotalView Technologies (TVT) distributes the complete license.src file for each flexlm license server that is registered in our database. This file will be used as the input to the TVT provided Configure_License script to generate a new license.dat file. The license.dat file is the primary license key file used directly by the flexlm license server.

[/size]
The flexlm license system can provide redundancy when arranged in a three host quarum configuration. The process of generating the license.dat file for[size 2] redundant servers is essentially identical to that of a single license server configuration except that the generated license.dat files must be manually edited to include additional information on the other servers that comprise the quarum.

The default location of the Configure_License script is <InstallDirBase>/toolworks/flexlm-10.8.0-3/bin/Configure_License
The default location of the 'toolworks_lmreread' script is <InstallDirBase>/toolworks/flexlm-10.8.0-3/bin/toolworks_lmreread

Note: It is suggested that you make a temporary backup of your existing ${FLEXLM}/license.dat file, until your new license installation has been completed.

NOTE: the FLEXlm hostid is unique for each license server regardless of hostname and IP address changes.
[/size]

TUTORIAL - INSTALLING YOUR TOTALVIEW LICENSE KEY(S) IN A REDUNDANT SERVER CONFIGURATION.


__________________________________________________
STEP 1: Install the FLEXlm v10.8.0-3 license management software on all three servers.

The first step is to install the FLEXlm v10.8.0-3 license management
software required by TotalView on the three machines you have
selected as your license servers. FLEXlm is included in the
TotalView distribution and installed by TotalView's installation
script[size 2] or is contained within the application bundle for Mac OS X. [/size]
You may download the latest version of TotalView from:

http://www.totalviewtech.com/Download/index.php

Read the README file included in each distribution for more
information about installing TotalView and FLEXlm v10.8.0-3.


__________________________________________________
STEP 2: Locate the "flexlm-10.8.0-3" directory on each license server

Locate the directory named "flexlm-10.8.0-3" on each license server that
was installed in STEP 1. This directory should be located in the
directory "<INSTALL PATH>/toolworks". The default values for
"<INSTALL PATH>" are "/usr" and "/opt" depending on your platform.

Set the environment variable FLEXLM to
"<INSTALL PATH>/toolworks/flexlm-10.8.0-3".

For example:

% setenv FLEXLM /usr/toolworks/flexlm-10.8.0-3

NOTE: The FLEXLM environment variable is only required for this
installation process and not by the license management daemons.


__________________________________________________
STEP 3: Delete all license.dat files which are no longer valid.

If you received new licenses key(s) due to a maintenance renewal -OR-
a server-move of existing license key(s) -OR- you traded in existing
license key(s), the affected license.dat files are no longer valid and must be
removed to be in compliance with the TotalView Technologies Permanent License Agreement.

NOTE: in the redundant server case, you must perform this step on
all three license servers.


__________________________________________________
STEP 4: Generate your new TotalView license.dat files

This step describes how to create the license.dat files used
by the three license managers to enable TotalView.

TotalView Technologies provides a script named "Configure_License" (in the directory
${FLEXLM}/bin) that creates a "license.dat" file, license management
scripts, and other configuration files. "Configure_License" requires
an input file named "license.src" containing the host information for
the license server and the TotalView Technologies provided TotalView license key(s).
[size 2]The contents of "license.src" were delivered in an email (both in-line and as an
attachment). Save a copy of license.src in the flexlm-10.8.0-3 directory
on all intended license servers.
[/size]


Note: Configure_License does not support complete creation of the redundant
server style license.dat file. In this procedure, you will be
required to run the Configure_License script on each server
independently to generate intermediate/template license.dat files
which must be edited to support the redundant license server
configuration.

For each license server, use the following procedure to
generate a "license.src" file just as if you were configuring a single
server style configuration.

1. Change directory to flexlm-10.8.0-3 on the license server

Code:
   % cd ${FLEXLM} 
2. [size 2]Copy and paste the new [/size] TotalView Technologies[size 2] license.src delivered in
this email message into a file named license.src in the
flexlm-10.8.0-3 directory. Duplicate this operation on all servers.

A license.src with multiple TotalView license keys may look like
this:
Code:
[size 2]% cat ${FLEXLM}/license.src           
## BEGIN ETNUS TOTALVIEW KEY -- fce5d358321b3f7538a2e5d5cd908ae4          
## HOSTID=0001032e23ae          
INCREMENT TotalView_Enterprise toolworks 2007.0101 1-jan-2007 2 \          
    VENDOR_STRING="processors=32 platform=linux-x86" \          
    ISSUED=4-aug-2006 SN=fce5d358321b3f7538a2e5d5cd908ae4 \          
    START=3-aug-2006 SIGN=XXXXXXXXXXXX          
## END ETNUS TOTALVIEW KEY -- fce5d358321b3f7538a2e5d5cd908ae4          
## BEGIN ETNUS TOTALVIEW KEY -- 679015ff8e036666c58d083885aa0e36          
## HOSTID=0001032e23ae          
INCREMENT TotalView_Enterprise toolworks 2007.0101 1-jun-2007 4 \          
    VENDOR_STRING="processors=16 platform=aix-power" \          
    ISSUED=4-aug-2006 SN=679015ff8e036666c58d083885aa0e36 \          
    START=3-aug-2006 SIGN=XXXXXXXXXXXX          
## END ETNUS TOTALVIEW KEY -- 679015ff8e036666c58d083885aa0e36
NOTE: the text in your license.src will vary depending on your
host information, number of license keys, and license
configurations. [/size]
[/size]


3. As the root user on the license server, run the script
"./bin/Configure_License" from the flexlm-10.8.0-3 directory. The
script will create the following files:
  • ${FLEXLM}/license.dat
  • ${FLEXLM}/license.opt
  • ${FLEXLM}/license.client
  • ${FLEXLM}/license.log
  • ${FLEXLM}/bin/toolworks_init
4. The ${FLEXLM}/license.dat file is not yet complete for your
redundant license server configuration. To complete the
generation of ${FLEXLM}/license.dat on each server, add the two
other SERVER lines corresponding to the two additional license
servers. The SERVER lines added should mimic the SERVER lines in
the ${FLEXLM}/license.dat files on all other hosts. Depending
on the installation paths chosen on each license server, it's
possible that you will have one consistent license.dat or you may
have to maintain three unique versions due to file path
differences.

After completing this step, each license server should have a
${FLEXLM}/license.dat file with three SERVER lines. For example,
a redundant server style license.dat file may look like this.

Code:
% cat ${FLEXLM}/license.dat    
SERVER myhost_1.mydomain.com 012345abcdef 7127    
SERVER myhost_2.mydomain.com 112345abcdef 7127    
SERVER myhost_3.mydomain.com 212345abcdef 7127    
DAEMON toolworks \    
     /usr/toolworks/flexlm-10.8.0-3/./i386-linux/bin/toolworks \    
     /usr/toolworks/flexlm-10.8.0-3/./license.opt    
## BEGIN ETNUS TOTALVIEW KEY -- fce5d358321b3f7538a2e5d5cd908ae4    
## HOSTID=0001032e23ae    
INCREMENT TotalView_Enterprise toolworks 2007.0101 1-jan-2007 2 \    
   VENDOR_STRING="processors=32 platform=linux-x86" \    
   ISSUED=4-aug-2006 SN=fce5d358321b3f7538a2e5d5cd908ae4 \    
   START=3-aug-2006 SIGN=XXXXXXXXXXXX    
## END ETNUS TOTALVIEW KEY -- fce5d358321b3f7538a2e5d5cd908ae4    
## BEGIN ETNUS TOTALVIEW KEY -- 679015ff8e036666c58d083885aa0e36    
## HOSTID=0001032e23ae    
INCREMENT TotalView_Enterprise toolworks 2007.0101 1-jun-2007 4 \    
   VENDOR_STRING="processors=16 platform=aix-power" \    
   ISSUED=4-aug-2006 SN=679015ff8e036666c58d083885aa0e36 \    
   START=3-aug-2006 SIGN=XXXXXXXXXXXX    
## END ETNUS TOTALVIEW KEY -- 679015ff8e036666c58d083885aa0e36    
 
You will also need to modify the ${FLEXLM}/license.client files
generated by Configure_License on each license server by adding the
other two SERVER lines similar to the license.dat edits. For a
redundant server style license, a valid ${FLEXLM}/license.client
file may look like this.
Code:
 
   % cat ${FLEXLM}/license.client    
   SERVER myhost_1.mydomain.com 012345abcdef 7127    
   SERVER myhost_2.mydomain.com 112345abcdef 7127    
   SERVER myhost_3.mydomain.com 212345abcdef 7127    
   USE_SERVER    

__________________________________________________
STEP 5: Start the license server

In order to initialize a redundant server style license, all three license
servers must first establish a quorum by running all license managers at the
same time. If you configured your license server to run as a non-privileged
user, the initialization script will ensure that the license management
daemons are started and run under the non-privileged user even if you run
the script as root.

On each license server, use the following command to start the license
manager.

Code:
 % ${FLEXLM}/bin/toolworks_init start    
To stop the license manager, use the following command.

Code:
 % ${FLEXLM}/bin/toolworks_init stop
If you would like the license manager to automatically start each time the
system is booted, run the following script as root.
Code:
 
 % ${FLEXLM}/bin/Configure_Autostart    

__________________________________________________
STEP 6: Configure TotalView to use the license server

TotalView must be able to find the ${FLEXLM}/license.dat file in order to
connect to the license server and checkout licenses. If you plan to run
TotalView on the active license server, no additional configuration should
be needed.

If TotalView and the license manager are not running on the same machine,
you will need to have a ${FLEXLM}/license.dat file for each additional
installation. Copy the file ${FLEXLM}/license.client from the license
server into the flexlm-10.8.0-3 directory on each remote machine and rename
the file license.dat.

Alternatively, you may configure your LM_LICENSE_FILE environment variable
to point to the client-style license.dat file (specify the full path to the
file).

A client-style license.dat has the following form:
Code:
 
 SERVER <hostname1> <hostid1> <port-number1>    
 SERVER <hostname2> <hostid2> <port-number2>    
 SERVER <hostname3> <hostid3> <port-number3>    
 USE_SERVER