lgtolic(8)                                                                         lgtolic(8)

NAME

       lgtolic - Legato license utility command

SYNOPSIS

       lgtolic [ -s  server ] -c  enabler_code
       lgtolic -i [ -m  hostfile_dir ]
       lgtolic [ -s  server ] -l
       lgtolic [ -s  server ] -u enabler_code -a authorization_code
       lgtolic [ -s  server ] -v  enabler_code

DESCRIPTION

       The  lgtolic  command  is  used  to manipulate Legato licenses that are
       stored  within  a  license  resource  database.  The  license  resource
       database  is administered by a Legato license daemon. For a description
       of the license daemon, see lgtolmd(8).

OPTIONS

       -a authorization_code
              Authorizes a license with the specified authorization code, mak-
              ing  the license permanent. Specify the license to be authorized
              by using the -u option and the -a option. To  obtain  authoriza-
              tion codes for this product via the World Wide Web, simply point
              your web browser to license.legato.com. You  will  be  asked  to
              enter  the  enabler  code  for  each authorization code that you
              request.  For more details on product licensing, including other
              methods  to  obtain  authorization  codes,  refer to the product
              Installation and Administration Guide  and  the  latest  Release
              Supplement.

       -c enabler_code
              Creates  the  license  indicated  by the specified enabler code.
              Enabler codes are listed on enabler certificates provided to you
              when  you  purchased  this  product.  An  authorization  code is
              required to make each license permanent.

       -i     Prints  out  the  hostid of the machine on which this command is
              running.

       -l     Lists all of the Legato product licenses currently stored within
              the license resource database.

       -m hostfile_dir
	      Specifies the directory where the hostids file resides.  If this
	      option is specified, the program will use the list of  hostid(s)
	      in the hostids file that resides in this directory to generate a
	      composite hostid.	 This option is useful if the  licensing  man-
	      ager is installed on a cluster machine or to force the hostid to
	      be IP address-based instead of machine security ID-based	on  an
	      NT  machine.   For  NetWorker,  the  typical  directory  for the
	      hostids file is /nsr/res.	 For a stand-alone  licensing  manager
	      running  on  a  machine  that does not have the NetWorker server
	      installed, the typical path is /nsr/lic/res.  The format for the
	      list  of	hostids in a hostids file is:  hostid1:hostid2:hostid3
	      where hostid is a hexadecimal string.  This option must be  used
	      to specify a hostid file.
	      
       -s server
              Specifies  the hostname, RPC program number, and version for the
              license daemon whose database you are targeting. License  daemon
              information is displayed in the following format:
                    < hostname >:< rpc_number >:< version >
              Note:  If you do not specify the -s  server option, lgtolic uses
              the default values that map to the daemon used  by  the  product
              shipped.  The current default for the hostname is localhost, the
              default for the RPC program number is 390115,  and  the  default
              for  the  RPC version number is 2.  You can also use environment
              variables to change these three defaults.  LMD_HOSTNAME  changes
              the  default hostname of the machine where the license daemon is
              running.  LMD_PROGNUM changes the default RPC program number for
              connecting  to the license daemon.  You should never have to use
              this.  LMD_VERSION changes the default RPC  version  number  for
              connecting  to  the  license daemon.  The following example uses
              default hostname and RPC program number, but  uses  RPC  version
              number 1 to list all licenses.
              Example: lgtolic -s "::1" -l
              To  specify  a license daemon located on an alternative machine,
              use the -s < hostname > option.

       -u enabler_code
              Updates an installed license with the authorization code  speci-
              fied with the -a option at the command line.

       -v enabler_code
              Deciphers  the  specified  enabler  code.   The generated output
              includes information about the license name, type,  serial  num-
              ber, and count.

NOTES

       The  daemon  information provided by the -s option can also be obtained
       by using the following environment variables:

       LMD_HOSTNAME, The name of the host for the license daemon

       LMD_PROGNUM, The program number for the license daemon

       LMD_VERSION, The version number for the license daemon

DIAGNOSTICS

       Program not registered
                 lgtolmd is not running.

       Unknown host
                 Either the default hostname is invalid or the hostname speci-
                 fied with the -s option is invalid.

SEE ALSO

       lgtolmd(8)
       

 NetWorker 7.6.2			 Jul 14, 11			   lgtolic(8)