Full text search

License manager installation procedure (UNIX)

------

What you need before installing

Before installing the license manager, you will need the following:

• the license manager installation software
• "root" access
• the name of a non-"root" account which will be used to run the license manager

Uncompressing your FLEXlm software

FLEXlm usually comes compressed, either on the OmniMark installation CD-ROM or downloaded from the OmniMark Technologies software download page . For UNIX platforms, the file "omflex40.tar.Z" contains the compressed form of FLEXlm.

To uncompress the license manager package, copy the "omflex40.tar.Z" file into a temporary working directory. Use the following commands to uncompress the software:

• for an HP-UX system -- zcat omflex40.tar.Z | tar xvf -
• for any other UNIX system -- zcat omflex40.tar.Z | tar xvpf -

Determining the hostname and hostid of your computer

To determine the hostname and hostid of the computer you are installing FLEXlm on, you need to do the following:

• Type "hostname" on the command line. This will give you the full hostname of your computer.
• Type "lmutil lmhostid" to determine the hostid of your Ethernet adapter. This utility is provided as part of FLEXlm, and can only be run if the FLEXlm software has been uncompressed.

Obtaining authorization codes

You can obtain authorization codes from your OmniMark Technologies sales representative. To get your authorization codes, you will need the hostid of the computer you will be installing FLEXlm on.

Configuring your UNIX workstation

To prepare your computer to install FLEXlm, follow these steps:

1. Create a new installation directory in which you want the license manager to reside. For example:
   

     mkdir /opt/local/flexlm-5.12a/bin
   

2. Copy the unpacked software from the temporary working directory previously created, into the installation directory.
   

     cp lmutil lmgrd omnilm_setup omnimarkd /opt/local/flexlm-5.12a/bin/ 
   

3. Go to the installation directory and create the license manager utilities:
   

     cd /opt/local/flexlm-5.12a/bin/
     ln lmutil lmcksum
     ln lmutil lmdown
     ln lmutil lmhostid
     ln lmutil lmremove
     ln lmutil lmreread
     ln lmutil lmstat
     ln lmutil lmver
     ln lmutil lmdiag
   

4. Return to your working directory.

Installing the license manager for UNIX workstations

To install FLEXlm on your computer, follow these steps:

1. Create a new license in your current directory file by running omnilm_setup:
   

     /opt/local/flexlm-5.12a/bin/omnilm_setup
   

2. You will need to refer to the Authorization Key Information Sheet to answer the questions that "omnilm_setup" will ask. The "omnilm_setup" file is available from the OmniMark Technologies software download page . Authorization codes are available from your OmniMark Technologies sales representative. Running omnilm_setup will create a file called "license.dat" in the current directory.
3. Important: The keys shown on the Information Sheet must be typed exactly as shown. Please note that the only characters present in these codes are the digits 0 through 9 and the letters A through F.
4. Create a directory to keep the OmniMark license file in. It should be a directory that is visible on each platform that will run OmniMark. For instance:
   

     mkdir /opt/local/flexlm-5.12a/licenses
   

5. Copy the license file into that directory. We recommend that you change the name of the license file to something that other products are not likely to use:
   

     cp license.dat /opt/local/flexlm-5.12a/licenses/omnimark.dat
   

6. Note: Wherever you place the license file, each process that will run OmniMark will need "read" access to the file.

Starting the license manager

The license manager should not be run as a "root" process, as this introduces a security hole into your system. You should direct the output into a log file for debugging; it can be valuable later if you have trouble with the license manager. For instance, if your log file is /tmp/flexlm.log, the following code will start the license manager and run it in the background:

  su non-root-username

  nohup /opt/local/flexlm-5.12a/bin/lmgrd \
     -c /opt/local/flexlm-5.12a/licenses/omnimark.dat \
     -l /tmp/flexlm.log & 

  exit

The backslash character ( "\" ) indicates that the command is continued on the next line. You may enter the whole command on one line without the backslash, or you may enter it as two lines with the backslash character at the end of the first line.

The "&" is necessary to make the license file run in the background. The "nohup" command is necessary to make sure that the license manager server does not shut down when you log out.

The "su" command starts a new process using the specified user account "non-root-username". The final exit terminates the non-root process.

Note that only port addresses within the range 1024 - 64000 allow a non-superuser to start the license manager software.

Examine the log file to ensure that the license manager started correctly. If the log is empty, you should wait a few minutes and check again. Resource contention problems may only show up after a timeout has expired.

Change your startup file to start lmgrd. If you are not sure where lmgrd should be started from, check with your system administrator.

The form of the command to use in your startup file should be:

  su non-root-username -c "umask 022; \
  nohup /opt/local/flexlm-5.12a/bin/lmgrd \
     -c /opt/local/flexlm-5.12a/licenses/omnimark.dat \
     -l /tmp/flexlm.log &"

To test that your FLEXlm installation is working properly once you have installed OmniMark, you may test it by typing the following from your OmniMark directory: omnimark -s test.om. You should receive "success" as an output.

Uninstalling FLEXlm

Uninstalling FLEXlm is a straightforward procedure.

1. Stop the license manager, if it is currently running, by typing lm down.
2. Remove all directories and files associated with the license manager in the normal fashion, using the "rm" command.

------

----

[CONTENTS] [CONCEPTS] [SYNTAX] [LIBRARIES] [SAMPLES] [ERRORS] [INDEX]

Copyright © OmniMark Technologies Corporation, 1988-1999.