Article Title	 	: setting up licenses
Creation Date		: 01/15/97
Message ID		: CGTNPQ
Last Update		: 01/15/97
Expiration Rules	: none
Location		: NCD-Articles/NCD_X_Terminals/License
=================================================================

                        Setting Up Licenses

Here are the complete steps on how to set up Node-Lock, Site and Floating
licenses, and how to configure the NC unit to obtain the license:

Node-Lock License:
=================

1. Use the following parameter to enter the new 16 character or old 12
   character license string into a remote configuration file:

        unit-license-key = the_key

        Where:  "the_key" is the real license key.


  Or, use the NCD User Services Console=>Setup=>Change Setup Params=>Licenses
  and enter the new 16 character key in the License Key field.  Then, 
  click on Apply.  However, the old 12 character keys can only be entered
  from the remote configuration file.  New 16 character keys require the
  the NC to boot NCDware 4.1 or greater.


2. Reboot the NC.



Setting up Site and Floating Licenses:
=====================================

1. You need the NC to boot the NCDware 4.1.141 or later release. 

   To check for the NCDware version, use the NCD Services Console
   and under the Statistics menu, please select Show Version.

2. A license.dat file will be provided by NCD when you purchase this
   type of license.

   The location for the license.dat file is the /usr/local/flexlm/licenses
   directory.

   a. If you change the location of the license.dat file, you must use the
      LM_LICENSE_FILE environment variable to specify the file location.

   b. If you want to combine the NCD license.dat file with the license
      file from some other vendor, please make sure the SERVER (hostid)
      lines in each of the files are identical.  Please also remove the 
      extra SERVER lines once the files are combined.

   c. If the other license.dat file is not compatible or it cannot be  
      combined, you can run a separate copy of "lmgrd" for each of the    
      license files.

3. Define the NCD license server host in the NCD remote configuration file.

   For example:

        unit-license-agents = {{ 1.2.3.4 }}

   Please use the IP address of your NCD license host in place of 1.2.3.4
   in the example above.  You can use the host name instead of the IP 
   address, if you have defined a name server for the NC.

4. If you have a SGI host or an AIX host and NCDware 4.1.141, you will need 
   to download a more recent ncdlicense binary from the NCD FTP site.
   This will fix a problem in the 4.1.141 version of ncdlicense for SGI
   and AIX.

   Here is how to get the newer ncdlicense files:

                ftp ftp.ncd.com
                Name: anonymous
                Password: (your email address)
                bin
                cd /pub/ncd/Archive/Bin.4.1.x/SGI
                get ncdlicense

   For AIX:

           get /pub/ncd/Archive/Binaries/AIX/Bin.4.1.x/ncdlicense
   For SGI:

           get /pub/ncd/Archive/Binaries/SGI/Bin.4.1.x/ncdlicense

4. To start the license daemons, type:

        /usr/bin/X11/ncd/lmgrd -c /full_path_to_license.dat

        /usr/bin/X11/ncd/ncdlicense -c /full_path_to_license.dat


   For example:

        /usr/bin/X11/ncd/lmgrd -c /etc/opt/licenses/license.dat
        /usr/bin/X11/ncd/ncdlicense -c /etc/opt/licenses/license.dat

   Please use the proper "ps" command to verify the daemons are running.

5. For the host system to have the License daemons started when the  
   system boots up, please run "ncdinstall" option #2 (Prepare System  
   Services). This program will automatically install the license management
   binaries and it adds the startup line(s) to the system startup files,
   such as /etc/rc.local or /etc/rc.boot.   
 
   Or, please consult the System's Manual Guide for more information.