NCDware includes Globetrotter Software, Inc.’sFLEXlm license management software for managing floating and site licenses.FLEXlm license management software supports WindowsNT hosts as well asUNIX hosts. The FLEXlm End User Manual and responses to frequently asked questions are provided inHTMLformat in theflexuserandflexfaqfiles in the terminals/ncd/Xncd.5.1.xxxdirectory on theNCDwareCD-ROM. You can also obtain the manual from www.globetrotter.com.
The following sections outline the steps you may need to take to establish floating and site licenses.
For information about license management on WinCenter hosts, see “Setting Up License Management on WinCenter Hosts” on page 3-23.
Tip
Some extensions are not unloaded when the user finishes using them;
therefore, their floating licenses are not released. To release the license, the user must restart the X session.
To establish and manage floating and site licenses, you must perform some or all of the following actions:
❏ If you are not usingncdinstall, install the license
management software on the host(s) that you wish to use as license servers. The software is installed byncdinstall. See “Installing License Management Software” on page 3-19 for more information.
If you do not have a license for a feature that you need, call NCD Sales Support at (650) 694-0650.
❏ When you obtain licenses fromNCD, alicense.dat file containing the required licensing data is supplied. This file must be placed on all license servers or the data in the file must be combined with data in an existinglicense.dat file. See“Setting Up the license.dat File” on page 3-20.
❏ Customize the granting of license privileges based on user, hostname, or display name or control logging of license usage information by using options files. See
“Using an Options File” on page 3-22.
❏ If you did not select thencdinstall option for preparing system services, startncdlicense. For floating licenses, also startlmgrd. Make sure these daemons start when the host system reboots. If you select the option for preparing system services inncdinstall, commands for starting these programs are added to system startup files. See “Starting the License Management Daemons” on page 3-22.
License Management Binaries and Files
Table 3-2 lists the license management binaries and files required for floating or site licenses.
NCDware also includes the license management utilities listed in Table 3-3. To run one of these utilities, includelmutilin the command line; for example:
% lmutil lmstat
Table 3-2 Required Software for Floating and Site Licenses
Name Description Required for
Floating Licenses
Required for Site Licenses
license.dat The license data file yes yes
ncdlicense The FLEXlm client that negotiates with lmgrd for licenses needed by terminals
yes yes
ncdlmd FLEXlm’s vendor daemon, which tracks NCDware licenses that are checked out
yes no
lmgrd FLEXlm’s license manager daemon yes no
If you link the names of the utilities tolmutil, you can specify just the utility name in the command line.
For information about the syntax and usage of these utilities, see the utility man pages or the FLEXlm End User Manual.
Installing License Management Software
For UNIX hosts, ncdinstall automatically installs the license management binariesncdlicense,ncdlmd, andlmgrd in /usr/bin/X11/ncd. If you installNCDware manually, you can place the binaries in any location you choose.
For WindowsNT (WinCenter) hosts,setup installs the license management executables,lmgrd.exe andncdlicense.exe, in c:\winnt.
You also need to install thelicense.datfile. See “Setting Up the license.dat File” on page 3-20.
Table 3-3 License Management Utilities Utility Name Description
lmcksum (1) Prints license checksums
lmdiag (1) Diagnoses license checkout problems lmdown (1) Shuts down all license software
lmhostid (1) Reports the host identification of a system
lmremove (1) Removes specific licenses and returns them to the license pool lmreread (1) Tells the license software to read the license file
lmstat (1) Reports status of the license software and feature usage lmswitchr Switches the report writer log file
lmver (1) Reports the FLEXlm library or binary versions
Specifying License Server Hosts
If you installNCDware or terminals usingncdinstall, the installation program sets the license server to the boot host. If you are setting up other license server hosts, you must list their hostnames orIP addresses in theunit-license-agents parameter. For example:
unit-license-agents = { { eagle }
{ kestrel } }
Setting Up the license.dat File
Thelicense.datfile, which contains the required licensing data, must be installed on each license server host. There are three possible scenarios for setting up this file:
❏ If you are not already using products licensed via FLEXlm software, use thelicense.dat file supplied by NCD. See the following section, “Using the license.dat File from NCD”.
❏ If you have applications from a vendor other thanNCD that useFLEXlm software and you can combine the license.dat files, see “Combining an Existing license.dat File with NCD’s license.dat” on page 3-21.
❏ If you have applications from a vendor other thanNCD that useFLEXlm software, but thelicense.dat files are incompatible because of differences in how you configure the license software, you must install a
separatelicense.dat file and run a separatelmgrd for each file on each license server host. See “Installing More than One License File on a Host” on page 3-21.
Using the license.dat File from NCD
ForUNIX hosts,ncdinstall puts the license.dat file in the /usr/local/flexlm/licenses directory on the boot host. If you change the location of thelicense.dat file, you must set the LM_LICENSE_FILEenvironment variable to the new location.
For WindowsNThosts, copy thelicense.datfile that you obtain from Sales Support toc:\flexlm. See “Setting Up License
Management on WinCenter Hosts” on page 3-23 for
information about how to get and install thelicense.dat file.
If you have multiple license server hosts, install alicense.dat file on each host.
See the lmreread (1) man page for more information about using lmreread.
If the license management binaries are running when you put the license file on the license server, use thelmrereadutility to force the license manager software to read the new license file:
% lmutil lmreread
Combining an Existing license.dat File with NCD’s license.dat If you are already runningFLEXlm software on your network for managing applications other thanNCD’s, check the already existinglicense.dat fileand the file supplied byNCDto see if the files are compatible.
Tip
Always use the newest versions of lmgrd, vendor daemons, and FLEXlm utilities.
If each file has the same number ofSERVER lines and
DAEMON lines, and the files contain identicalhostid fields in eachSERVER line, you can combine the twolicense.dat files and run only onelmgrd. Note thatlmgrdis not required for site licenses.
To combine the two files, use any text editor. Read the contents of all compatible files into one file, and remove the extra set ofSERVER lines.
See the lmreread (1) man page for more information about using lmreread.
If the license management binaries were running when you edited the license file, you must use thelmrereadutility to force the license manager software to read the edited license file:
% /usr/bin/X11/ncd/lmutil lmreread Installing More than One License File on a Host
See the FLEXlm End User Manual for more information about license management software incompatibility.
When you use incompatiblelicense.datfiles, you must run an instance oflmgrdfor each of the license files (not required for site licenses). To do so:
❏ Make sure the port number on theSERVER line of each
— Place the incompatible license files and their respectivelmgrd programs in different directories and start the programs using the following syntax:
% lmgrd -c /pathname/license.dat or
— Rename the incompatible license files andlmgrd programs to product-specific names. Specify the non-standard license file names using the
LM_LICENSE_FILE variable. To include more than one license file in theLM_LICENSE_FILE variable, separate the license file pathnames by colons; for example:
% setenv LM_LICENSE_FILE /usr/local/flexlm/licenses/ncd/license.dat:
/usr/local/flexlm/licenses/misc/license.dat
Using an Options File
The syntax and format of options files are described in detail inFLEXlm documents. This section outlines the steps required to use an options file. To use an options file you must:
1. Create the file.
2. Place the file in/usr/local/flexlm/options.
3. Add the file’s pathname to thelicense.dat file. Place it in the fourth field in theDAEMON line forncdlmd. For example:
DAEMON ncdlmd /etc/ncdlmd /usr/local/flexlm/options/ncdlm.opt
Starting the License Management Daemons
See the lmgrd (1) and ncdlicense (1) man pages for information about command options.
Thencdinstall program starts thencdlicense andlmgrd daemons. If you need to start them manually, use the commands described in this section.
The following commands assume the default locations for the daemons.
❏ For floating licenses and site licenses, startncdlicense: % /usr/bin/X11/ncd/ncdlicense -c /pathname/license.dat
❏ For floating licenses only, startlmgrd:
% /usr/bin/X11/ncd/lmgrd -c /pathname/license.dat If you put thelicense.dat file in a location other than the default, you must either set theLM_LICENSE_FILE
environment variable to name the location or use the-coption and the full pathname of thelicense.dat file to start both daemons.
Thencdinstallprogram adds startup line(s) for the daemon(s) to your system startup files, such as/etc/rc.bootor/etc/rc.local. When you reboot the license server, the daemons start automatically.
If you did not choose to prepare system services while runningncdinstall or you did not usencdinstall, add the relevant startup lines shown in this section to your system startup file.
Setting Up License Management on WinCenter Hosts
This section contains directions for setting up the WinCenter host as a license server for floating and site licenses.
TheFLEXlm License Server and theNCDLicense Proxy Server executables are installed inc:\winnt\system32 when you installNCDware. This section contains directions for uninstalling the executables.
Setting Up the WinCenter Host To set up the WinCenter host:
1. Install theIPX protocol if it is not already installed. This is required for Step 2.
a. In the Control Panel, selectNetwork. b. SelectProtocols and addIPX.
c. When prompted, restart the computer.
2. Get the hostID of the WinCenter host: a. Open aDOS prompt window.
If theIPX protocol is not installed, this command reports a hostID of ffffffff, which is not valid.
3. Give the host ID and hostname toNCD Sales Support—
(650) 694-0650. Sales Support will generate alicense.dat file and e-mail it to you.
4. Copy thelicense.dat file toc:\flexlm\license.dat.
If you put thelicense.dat file somewhere else, you must create a system environment variable for it as follows:
a. In the Control Panel, selectSystem.
b. On the Environment tab, select any system variable.
c. EnterLM_LICENSE_FILE in theVariable: field.
d. Enter the absolute path to thelicense.dat file in the Value: field.
e. ClickOK.
5. Restart the WinCenter host.
6. In about three minutes, terminals can start getting licenses from the WinCenter host.
Uninstalling the License Services
To uninstall theFLEXlm License Server, type:
lminstall remove
To uninstall theNCD License Proxy Server, type:
ncdlicense -remove