unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



lmf(8)								       lmf(8)



NAME

  lmf -	License	Management Facility (LMF)

SYNOPSIS

  /usr/sbin/lmf	[-d dir] [command [argument...]]

OPTIONS

  -d dir
      Defines the directory containing the License Database file and the his-
      tory file. If you	do not use the -d option, the default LMF directory
      (/usr/var/adm/lmf) is used. The -d option	allows you to have more	than
      one License Database on your system.

DESCRIPTION

  The lmf utility maintains a file of registered software licenses called the
  License Database.  The lmf utility creates the License Database from infor-
  mation on the	Product	Authorization Key (PAK)	that is	supplied with
  software products. (The PAK is a valuable proof of purchase and represents
  your license from Compaq to use a software product.)

  The lmf utility also updates the kernel cache. The kernel cache contains
  the active license information that is read by license-checking functions
  in products that provide full	LMF support. The license-checking functions
  check	that a product has a valid license before making the product avail-
  able for use.

  For more information about LMF, see the Software License Management.

  LMF contains the following three types of commands:

    +  Information and general commands, which you use to monitor your
       licensing actions, to monitor the status	of the License Database	and
       kernel cache, and to leave LMF.

    +  License Database	maintenance commands, which you	use to modify the
       contents	of the License Database

    +  Service commands, which you use to communicate with the kernel cache.
       These commands might have an immediate effect on	users' access to
       licensed	software.

  Some commands	have the product, producer, or authorization arguments.
  Replace product, producer, and authorization with the	information from the
  corresponding	fields on your PAK. Specify the	arguments exactly as they
  appear on the	PAK. Use the producer and authorization	arguments when the
  License Database contains more than one record for a given product name.




  Information and General Commands


  exit
      Exits from the lmf utility. You can also enter CTRL/D to leave the lmf
      utility.

  help [ command ]
      Displays the syntax of the command specified in the argument list. If
      no command is specified, help lists all the LMF commands.

  history [ length ] [ from date ] [ for product [ producer ] ]
      Lists data from the license management history file. The history data
      is displayed with	the most recent	operations first.

      The history file is a record of the License Database maintenance com-
      mands (amend, cancel, delete, disable, enable, issue, modify, and
      register)	that have been issued on your system. LMF also records the
      creation of a new	License	Database in the	history	file.

      For each maintenance command you issue, LMF records the product iden-
      tity, the	date and time the command was issued, and the information in
      the License Database that	was changed.

      Replace length with one of the following:

      short
	  Displays a one-line summary of the history data for each command
	  issued.

      full
	  Displays the history data for	each command issued and	the license
	  as it	appeared before	the command was	issued.

      The from date argument displays history data for commands	issued after
      the specified date. You must specify the date argument in	this order:
      day, month, year.	You can	use most common	formats	to specify the date.
      You do not need to use a separator between the day and the month or the
      month and	the year.  For example,	the first day of July 1993 could be
      specified	as: 1-jul-1993,	1/7/93,	010793,	or 1.july.93.

  list [ full ]	[ source ] [ for product [ producer ] ]
      Displays details of the registered products on the system.  If you do
      not supply any arguments,	list displays a	one-line summary of the	PAK
      data for each product in the License Database.

      The full argument	displays the complete license details for each pro-
      duct.

      Replace source with one of the following:

      ldb Displays a summary for each product in the License Database.

      cache
	  Displays a summary for each product in the kernel cache.

      all Displays a summary for each product in the License Database and the
	  kernel cache.








  License Database Maintenance Commands


  amend	product	[ producer [ authorization ] ]
      Amends the protected fields on a license.	You must use this command
      only to register the license data	from a Product Authorization Amend-
      ment (PAAM). The fields you can change have a colon (:) after the	field
      name. You	must make all the changes shown	on the PAAM, including enter-
      ing a new	checksum.  Changes made	to fields without a colon after	the
      field name are ignored. The editor used is the same as that used for
      the register command.

      The command does not have	an immediate effect on the kernel cache.  Use
      the load command to update the license for the product in	the kernel
      cache.

  cancel date product [	producer [ authorization ] ]
      Cancels the license on the date you specify in the date argument.	You
      can use this command to stop use of a product earlier than the date
      shown in the Key Termination Date	field on the PAK.  You can change the
      cancellation date	more than once by reissuing the	cancel command with a
      different	date argument.

      You must specify the date	argument in the	order day, month, year.	You
      can use most common formats to specify the date.	You do not need	to
      use a separator between the day and the month or the month and the
      year. For	example, the first day of July 1993 could be specified as:
      1-jul-1993, 1/7/93, 010793, or 1.july.93.

      The cancel command does not affect the kernel cache.  To update the
      cancellation date	in the kernel cache, use the load command.

  delete product [ producer [ authorization ] ]
      Deletes a	license	from the License Database and the kernel cache.
      Before you issue this command, be	sure you have a	record of the license
      either in	a file on your system or in hardcopy format.

  disable product [ producer [ authorization ] ]
      Prevents a license from being loaded into	the kernel cache when you
      issue the	load or	the reset command or when you start the	system.	The
      license data remains in the License Database.

  enable product [ producer [ authorization ] ]
      Enables a	license	to be loaded into the kernel cache when	you issue the
      load or the reset	command	or when	you start the system. LMF automati-
      cally enables a license when you register	it.

  issue	file product [ producer	[ authorization	] ]
      Issues a reconstructed PAK for the product and removes the license from
      the kernel cache and the License Database. LMF writes the	reconstructed
      PAK to the file you specify in the file argument.

      You can use the reconstructed PAK	with the register - <&lt; file command to
      transfer a license from one system to another.

  modify product [ producer [ authorization ] ]
      Modifies the unprotected fields on a license. You	can modify only	the
      Comments field and, if the license has the MOD_UNITS Key Option, the
      Number of	Units field. LMF ignores changes to fields other than Com-
      ments or Number of Units.

      LMF invokes an editor as defined by the EDITOR environment variable. If
      the environment variable is undefined, LMF invokes the vi	editor.

      The modify command does not affect the kernel cache.  To update the
      data in the kernel cache,	use the	load command.

  register [ input ]
      Registers	data from a PAK	in the License Database. If you	specify	no
      arguments, the command displays a	template that includes the fields
      that occur on the	PAK. LMF invokes an editor so that you can add the
      license data to the appropriate fields. The utility invokes an editor
      as defined by the	EDITOR environment variable.  If the environment
      variable is undefined, the utility invokes the vi	editor.	When you
      leave the	editor,	LMF scans the completed	template to make sure you
      entered the license data correctly. If you entered data incorrectly,
      LMF displays the appropriate error message and gives you an opportunity
      to reenter the editor and	correct	any mistakes.

      Replace input with one of	the following:

      file
	  Displays a copy of the file specified	and invokes an editor so you
	  can fill in any additional license details before registering	the
	  license data in the License Database.

      -	  Registers license data directly from standard	input to the License
	  Database.

      Use the register file command to register	license	data from a file on
      your system that contains	a partially complete PAK. When you finish
      editing the license data,	LMF scans the file and gives you the oppor-
      tunity to	correct	any mistakes.

      Use the register - command to register license data directly from	stan-
      dard input.

  Service Commands


  load users product [ producer	[ authorization	] ]
      Loads enough license units into the kernel cache to enable use of	the
      product by the number of users specified.	The number of license units
      required for the specified number	of users is calculated by LMF. You
      must register the	appropriate number of units in the License Database
      before you issue the load	command.

      If you specify zero (0) as the users argument, all the license units
      for the product are loaded into the kernel cache.	If the product is
      Availability Licensed, you must always specify zero (0) as the users
      argument.

  reset
      Copies the license details for all enabled products from the License
      Database to the kernel cache.

  unload users product [ producer ]
      Unloads enough license units from	the kernel cache to reduce the use of
      the product by the number	of users specified. The	number of license
      units required for the specified number of users is calculated by	LMF.
      After you	have issued the	command, any existing users of the product
      are allowed to finish using it before the	new limit is imposed.

      If you specify zero (0) as the users argument, all the license units
      for the product are removed from the kernel cache. If the	product	is
      Availability Licensed, you must always specify zero (0) as the users
      argument.





EXAMPLES

   1.  When you	use LMF	commands you can type them on a	single line, for
       example:
	    # lmf register

   2.  Alternatively, you can enter the	lmf utility and	type the commands
       after the prompt, for example:
	    # lmf
	    lmf>&gt; register

   3.  To register a PAK from a	file that contains valid license data, issue
       the following command:
	    # lmf register - <&lt;	PAK_file

       In response to this command, LMF	scans the file PAK_file	to make	sure
       its format and data are correct.	LMF does not display the contents of
       the file	or allow you to	edit the file. If the license data is
       correct,	LMF registers the license in the License Database. If not,
       the utility displays the	appropriate error message.

       You can abbreviate LMF commands,	but you	must be	sure the abbreviation
       is not ambiguous. For example, you can abbreviate lmf register to lmf
       reg but not lmf re.

SEE ALSO

  Command: lmfsetup(8)

  Software License Management