UNIX License Manager Installation Instructions - CD-ROM

CONTENTS:

This directory includes the following:

        lmgrd           The License Manager        

        compuwar        The vendor-specific
                        License Manager           

        lmutil          A utility used for        
                        administrating the License
                        Management System 
	
        install         Install script             

        readme.txt      Installation directions    
                        (this document)


INSTALLATION INSTRUCTIONS:

1. Ensure that the CD-ROM is mounted on your system
   (you must be root to do this).

2. Change to the CD-ROM directory. For example, if /cdrom is the
   mount directory, type the following:

   cd /cdrom

3. Install the License Manager on your system.

   Type the following:

       install

   The install script will ask the name of the target directory for
   the License Manager. We suggest "/usr/local/cwlm" (you will need
   root access to create the directory).  If install has a problem
   creating the directory, you will be notified of the error and
   exit. You will be notified when install is complete.

   Before you can start the License Management System, you must
   supply Compuware with the "host ID"  of the node on which you
   plan to run the License Manager. To get this ID, type the
   following command within the directory created previously.

   "lmutil lmhostid"

   The ID the Licensing System uses for validation is displayed. You
   must send this ID to Compuware. Compuware will then send back a
   license file that replaces the demo "license.dat" in the license
   file directory (usually /usr/local/flexlm/licenses).

   NOTE: You must receive a new license file from Compuware before
         proceeding to the next step.


STARTING THE LICENSE MANAGEMENT SYSTEM

- To start the License Manager, type the following command:

     "lmgrd"

If your license file is located in a directory other than
"/usr/local/flexlm/licenses", you must either set the environment
variable LM_LICENSE_FILE to the full pathname of the license file
as in the following:

   export LM_LICENSE_FILE=/full/path/of/license.dat (ksh)
   setenv LM_LICENSE_FILE /full/path/of/license.dat (csh)

OR issue the following command:

   lmgrd -c /full/path/of/license.dat"

NOTE:   If you choose to set the environment variable LM_LICENSE_FILE,
        you should consider putting the "set" command in your rc.boot
        or rc.local file. AIX users must put the command in
        /etc/innittab.file or /etc/inittab.

- To start the License Manager at boot time for all UNIX system except
  IBM RS6000, enter the following command in /etc/rc.local or
  /etc/rc.boot:

     nohup lmgrd -c /full/path/of/license.dat  > license.log &

- The following pertains only to the RS6000:

   - In /etc/inittab enter the following:

      rclocal:2:wait:/etc/rc.local > /dev/console/ 2>&1 &

   - In addition, add the following line in /etc/rc.local:

     nohup /etc/lmgrd -c /full/path/of/license.dat >license.log 2>&1 &



LICENSE ADMINISTRATION UTILITY

The utility lmutil allows you to perform administrative tasks for the
license management system. The format for this utility follows:

   lmutil command [option1 option 2 ...]

   for example,  "lmutil lmstat -a"

Where you enter one of the following commands and its particular options.
                
Command         Arguments     Description

lmdown          -c pathname   Performs a graceful shutdown of the License
                              Manager. This argument is needed if you
                              specified a location for the license file
                              other than the default and you have not set
                              the LM_LICENSE_FILE environment variable.

lmhostid                      Returns the hostid of the machine on which
                              you are currently running.  This is the ID
                              that must be sent to Compuware in order for
                              you to receive a permanent license file for
                              your License Manager machine.

lmstat                        Monitors current licensing activities.

                -a            Displays all information

                -A            Lists all active licenses

                -c pathname   This argument needed if you specified a
                              location for the license file other than the
                              default and you have not set the environment
                              variable LM_LICENSE_FILE.

lmver           [file]        Reports what version of security a product
                              (binary file) has.  

                              For example, lmutil lmver dx.exe

lmdiag                        Performs diagnostics to troubleshoot problems
                              with the License Management System.

                -c pathname   This argument needed if you specified a
                              location for the license file other than the
                              default and you have not set the environment 
                              variable LM_LICENSE_FILE.

                [feature]     Diagnose this feature only.

                -n            Run in non-interactive mode.
