LUM - Quick Install of Concurrent Nodelocked License in AIX 4 and 5

Contents

About this document
Installing a concurrent nodelocked license

About this document

This document applies to AIX Versions 4.1.5 through 5.1. It describes how to quickly install a concurrent nodelocked license for the "C for AIX" compiler as well as how to test the compiler. This document assumes the license server has not been previously configured and that the license daemons are not currently running. This can be verified with the i4cfg -list command. On AIX 4, LUM commands can be found in /var/ifor. With AIX 5, the LUM commands are located in /usr/opt/ifor/bin.

A concurrent nodelocked license is one that is only good for that node/machine.

License certificate files are installed with the compiler and can be found in the following directories: 

     C for AIX:                                    /usr/vac
     C/C++ for AIX, OS/2 and WindowsNT:            /usr/ibmcxx
     XL Fortran:                                   /usr/lpp/xlf/DOC
     VisualAge for C++:                            /usr/vacpp
     VisualAge for Java:                           /usr/IBMVJava

NOTE: License certificate files for concurrent nodelocked licenses are named with the format XXXX_cn.lic, where XXXX is the name of the product.

Installing a concurrent nodelocked license

Steps

  1. Check the version of License Use Management (LUM) installed and enter the following commands: 
         cd /var/ifor
     more VERSION

    NOTE: If the version of LUM is 4.6.0 or greater, continue with step 3. If not, download the latest version from www-4.ibm.com/software/is/lum/download. Select "Administration Runtime Kit (ARK) V4.6.0" as the component choice.

    1. Select and download the tar file for your desired language.
    2. You MUST install the following files: 
              ifor_ls.base
	ifor_ls.client
	ifor_ls.compat
	ifor_ls.libraries
        ifor_ls.msg
    3. Install this file ONLY if your operating system is AIX 4.3.3. 
      	bos.net
  2. Install images from step 1 via SMIT.

  3. Change the permissions on /var/ifor. Enter: 
       chmod 1777 /var/ifor

  4. Start the concurrent nodelock server and set it to restart on a system reboot. Enter: 
         i4cfg -a n -S a
     i4cfg -start
  5. Verify that the nodelock license server daemon, i4llmd, is running (others may start). Enter: 
         i4cfg -list
  6. Enroll the concurrent nodelock license by entering the following command: 

         i4blt -a -f </path/to/license/certificate> -T
     <number of licenses to enroll> -R "<admin_name or company_name>"

    Example (this may take several minutes): 

         i4blt -a -f /usr/vac/cforaix_cn.lic -T 1 -R "MyCompany"

    NOTE: This will enroll one concurrent nodelocked license for the C for AIX v5 compiler.

  7. Verify the enrolled license by viewing the concurrent nodelocked licenses currently held in the LUM database. Enter: 
         i4blt -s -lcn
  8. Now, test the C for AIX compiler by issuing the following sequence of commands: 
         cd /tmp
     touch junk.c
     /usr/vac/bin/cc junk.c

    The output should read: 

         line 1: 1506-229 (W) File is empty.
     line 1.1: 1506-356 (W) Compilation unit is empty.
     ld: 0711-317 ERROR: Undefined symbol: .main
     ld: 0711-345 Use the -bloadmap or -bnoquiet option to
         obtain more information.

    The absence of license errors indicates that the compiler received a valid license and is working. Errors listed are a result of compiling an empty file.

  9. Setting a default compiler (optional).

    Because C for AIX and C and C++ for AIX, OS/2, and WindowsNT can exist on the same system, it is possible to choose the default C compiler by running the shell script replaceCSET.

    1. To make C for AIX the default C compiler, enter: 
           cd /usr/vac/bin
     replaceCSET

      This will create the necessary symbolic links from /usr/bin to /usr/vac/bin.

    2. To make C and C++ for AIX, OS/2 and WindowsNT the default C compiler and create symbolic links to the C++ compiler, enter: 
           cd /usr/ibmcxx/bin
     replaceCSET

      This will create the necessary symbolic links for the C and C++ compilers from /usr/bin to /usr/ibmcxx/bin.

Further information can be found in the file /usr/vac/README.password. HTML documentation for LUM is located in the /usr/opt/ifor/ls/doc directory or on the Internet at http://www-4.ibm.com/software/is/lum/library.html.




[ Doc Ref: 95115345316482     Publish Date: Dec. 04, 2001]