Answers Database

Licensing: Forcing XACT License programs to use LM_LICENSE_FILE (Not forM1 version of software)


Record #189

Problem Title:
Licensing: Forcing XACT License programs to use LM_LICENSE_FILE (Not
forM1 version of software)



Problem Description:
This solution record states how to force XACT version 5.2.1 and
earlier versions of the XACT software to use the
LM_LICENSE_FILE variable rather than defaultly searching for
the license.dat file in $XACT/license/license.dat.

This solution does not apply to the M1 version of the software.


Solution 1:




For most programs, the LM_LICENSE_FILE variable is used to tell the
Highland licensing program where to find the license file.
Our software normally IGNORES this environment variable.  This was
done to allow the xlmasu program to automatically start the license
manager if it's not running when a user needs a license.  In order
for this to work, the Xilinx software should use a license file which
contains only Xilinx features.


You can make the Xilinx license manager work in the
    standard way by defining the environment variable
    XLM_ENABLE_LM_LICENSE_FILE as follows:


       # The C Shell, csh (put in your ~/.cshrc file)
       setenv XLM_ENABLE_LM_LICENSE_FILE 1
       if $?LM_LICENSE_FILE then
	 setenv LM_LICENSE_FILE </path/to/xilinx/license>:${LM_LICENSE_FILE}
       else
	 setenv LM_LICENSE_FILE </path/to/xilinx/license>
       endif

       # The KornShell, ksh (put in you ~/.profile file)
       export XLM_ENABLE_LM_LICENSE_FILE=1
       export LM_LICENSE_FILE="</path/to/xilinx/license>:</other/licenses>"

       # The Bourne Shell, sh (put in your ~/.profile file)
       XLM_ENABLE_LM_LICENSE_FILE=1
       export XLM_ENABLE_LM_LICENSE_FILE
       export LM_LICENSE_FILE="</path/to/xilinx/license>:</other/licenses>"

       # The Apollo Aegis /com/sh
       XLM_ENABLE_LM_LICENSE_FILE := "1"
       export XLM_ENABLE_LM_LICENSE_FILE
       export LM_LICENSE_FILE="</path/to/xilinx/license>:</other/licenses>"


    The presence of this environment variable will cause the Xilinx
    programs which are protected by the Xilinx license manager to use the
    LM_LICENSE_FILE variable to locate the license file.  This variable
    also inhibits the program from calling the autostartup program
    (xlmasu) if the license manager is not running.

    This method will work for the situation where the license file
    pointed to by the LM_LICENSE_FILE variable must be different on
    different machines.  However, the disadvantage of the method is that
    all users of Xilinx software have to make sure the two environment
    variables are defined properly.


Note that if you choose to start the license manager program lmgrd at
boot time (by editing the /etc/rc.local file), you should probably move
the lmgrd and XXACTD program to a file system which is guaranteed to be
mounted when the /etc/rc.local file is executed.  The /usr/etc directory
is usually a safe choice.  Be sure that where ever you move the programs
to that you edit the path to the XXACTD program in the license data file.

To start the lmgrd program on a node at boot time, you will have to edit
the /etc/rc.local file.  Add syntax like the following to the file:

    if [ -f /usr/etc/lmgrd]; then
       /usr/etc/lmgrd -c /path/to/license/file > /dev/null & echo -n 'lmgrd'
    fi


XLM_ENABLE_LM_LICENSE_FILE does not need to be set to a value, it
just needs to be set. Remember that in this case LM_LICENSE_FILE must
point to the file, not just the directory.  Normally, xlmasu will
automatically look for the license in the file $XACT/license/license.dat




End of Record #189