Go to the previous, next chapter.

The License Management Facility (LMF)

After installing the Supported subsets and before installing any layered products you should install all of the Product Authorization Keys (PAKs) that you have. Many licensed products will not run unless you have registered a license for them and in some cases the license has to be loaded before you install the product. The license database is automatically created when you register a license. This chapter gives a brief description of how to register and load licences on your system. For further information on the LMF refer to the "Guide to Software Licensing". (16) NB: The PAK should be stored in a safe place for future reference.

Registering a License

Use the lmf command to invoke the license management utility as follows:
	   #/etc/lmf register

Alternatively you may enter the lmf utility and type the commands after the prompt, for example:

	   #lmf
	   lmf> register                                  

The lmf register command is used to register license details from a Product Authorization Key (PAK) in the License Database. The LMF checks the information that you are trying to register. Some of the fields on the PAK are blank and these should be left blank when you type in the information. If the Producer field is left blank, the LMF assumes the Producer to be "DEC". The following fields always require an entry:

  1. Issuer
  2. Authorization Number
  3. Product Name
  4. Availability Table Code or Activity Table Code, or both.
  5. Checksum

If you use the lmf register command with no arguments you will be presented with an empty template which includes all the fields on a PAK and an additional field for your comments. An editor is invoked in order that you may modify the template. Unless you have set the environment variable EDITOR to your favourite editor vi is used. Use the editor to fill in the information from the PAK in the appropiate field (you may type the data in uppercase or lowercase):

                Licensed Software Product
                Product Authorization Key

 Enter data on lines terminated with :

                 Issuer:dec
   Authorization Number:tpq-pk-88229-23

           Product Name:ultrix
               Producer:dec

        Number of units:1600

                Version:
   Product Release Date:1-jul-1991

   Key Termination Date:

Availability Table Code:
    Activity Table Code:constant=100

            Key Options:no_share,p_family
          Product Token:
            Hardware-Id:
               Checksum:1-afap-icfd-bcpj-fcgl

Comment:This is an example license

Enter the information exactly as it appears on your PAK otherwise the checksum at the end will fail. If the license data has been entered correctly it is copied into the License Database when you leave the editor.

Loading the License

Once the license has been registered it must be copied from the LDB to the kernel cache in order that it becomes "active". This may be done using either the lmf load or the lmf reset commands. The lmf load command loads a specified license and has the following syntax:

	   #lmf load  "users product" "[producer [authorization]]"

For example to load all of the units for the product ULTRIX you should type:

	   #lmf load 0 ULTRIX

You will need to supply enough arguments to uniquely identify the license that you wish to load. The lmf reset command is used to copy the license details for all products from the License Database to the kernel cache. To invoke the lmf reset command type:

	   #lmf reset

Go to the previous, next chapter.