AcuLmg

Network license manager start, stop, and status query.

Syntax

acuLmg [options]

Type

AcuSolve License Manager Program

Description

AcuLmg is used to start, stop, query, and test the network license manager. Even though the network license manager daemon (AcuLmd) runs only on the license server, AcuLmg may be issued from any machine on the network.

The option lm_checkout specifies the address of the license co-processor AcuLmco. This executable is launched on the local host by the module requesting a license, such as AcuLmg, issued with checkout_license option, and AcuSolve. Note that AcuLmco automatically starts the daemon AcuLmd if it is not already running.

The amount of time, in seconds, to camp in the license queue while waiting for a license is set by the option lm_queue_time.

Commands that need to communicate with the license server usually do so with rsh, or remesh on HP-UX. But if only ssh is supported, then the remote_shell parameter should be used:

acuLmg -start -rsh "ssh"

The daemon acuLmd logs its messages into the system .log file. Consult the system file /etc/syslog.conf for the location of the system .log file on your system.

In the following, the full name of each option is followed by its abbreviated name and its type. For a general description of option specifications, see Command Line Options and Configuration Files. See below for more individual option details:

help or h (boolean)

If set, the program prints a usage message and exits. The usage message includes all available options, their current values and the source of their current values.

start_daemon or start (boolean)

Start the network license manager daemon, AcuLmd, on the server machine. If the daemon is already running the program does not start a new one.

stop_daemon or stop (boolean)

Stop the network license manager daemon, AcuLmd. If a daemon is servicing a license, after it is stopped via this command, it is automatically restarted again by the job(s) being serviced.

restart_daemon or restart (boolean)

Restart the network license manager daemon, AcuLmd, on the server machine. If the daemon is already running the program does not restart a new one. May be used in both stopped and started states.

query_license or query (boolean)

Query the status of the network license manager.

report or stats (boolean)

Report the usage statistics of the licenses.

checkout_code or code (enumerated)

Name of the code being queried, reported on, or checked out:

AcuSolve: AcuSolve
AcuView: acuView
AcuTrace: AcuTrace
AcuFwh: AcuFwh
AcuMeshSim: AcuMeshSim
AcuCatia2Acis: AcuCatia2Acis (deprecated)
AcuToken: AcuToken (deprecated)
LesLib: Linear algebra module\
_all: All licensed programs

checkout_license or co (boolean)

Checkout a license. This option simulates checking out a license for a period specified by checkout_time option. The purpose of this option is to test the license manager, to ensure proper operation.

checkout_time or cot (integer)

The time, in seconds, to wait before checking in the license which was checked out by the checkout_license option.

checkout_num_processors or np (integer)

Number of processors to checkout.

lm_daemon or lmd (string)

Full address of the network license manager daemon, AcuLmd, that runs on the server host. When this option is set to _auto, the value is internally changed to $ACUSIM_HOME/$ACUSIM_MACHINE/bin/acuLmd.

lmtype or lm_service_type (enumerated)

Type of the license manager service:

hwu: Altair Units licensing
token: Token based licensing
classical: Classical Acusim style licensing

lm_server_host or lmhost (string)

Name of the server machine on which the network license manager runs. When this option is set to _auto, the local host name is used.

lm_port or lmport (integer)

TCP port number that the network license manager uses for communication.

lm_license_file or lmfile (string)

Full address of the license file. This file is read frequently by the network license manager. When this option is set to _auto, the value is internally changed to $ACUSIM_HOME/$ACUSIM_MACHINE/license.dat.

lm_log_file or lmlog (string)

Full path to the file in which to record licensing check-out and check-in events. When this value is set to _none, the messages are directed to the system log.

lm_restricted_access or lmra (boolean)

Restrict access to the license manager start/stop/restart operations.

lm_checkout or lmco (string)

Full address of the license checkout co-processor, AcuLmco. This process is spawned by AcuLmg on the local machine. When this option is set to _auto, the value is internally changed to $ACUSIM_HOME/$ACUSIM_MACHINE/bin/acuLmco.

lm_queue_time or lmqt (integer)

The time, in seconds, to camp on the license queue before abandoning the wait. Up to a maximum of seven days is allowed.

remote_shell or rsh (string)

Remote shell executable for starting AcuLmd on a remote machine. Usually this is rsh (or remesh on HP-UX) but can be set to ssh if needed. If _auto, executable is determined internally.

verbose or v (integer)

Set the verbose level for printing information to the screen. Each higher verbose level prints more information. If verbose is set to 0 (or less), only warning and error messages are printed. If verbose is set to 1, basic processing information is printed in addition to warning and error messages. This level is recommended. verbose levels greater than 1 provide information useful only for debugging.

Examples

To start the network license manager issue the command

acuLmg -start

This starts the daemon on the license server if it is not already running. Otherwise it simply returns with a message indicating that the daemon has already started.

To stop the network license manager issue the command

acuLmg -stop

This will stop the daemon which is running on the license server. Note that any process that has already checked out a license will attempt to restart the daemon.

To restart the network license manager issue the command

acuLmg -restart

This may be used in either stopped or started states. In the latter it simply returns with a message indicating that the daemon has already started.

To query the status of the network license manager issue the command

acuLmg -query

This will produce a message such as:

acuLmg: License server: pelican
acuLmg: Product: acuSolve
acuLmg: Number of licenses: 10
acuLmg: Last expiration date: Jul-05-2007
acuLmg: Licenses checked out (2):
acuLmg: (13273) 4p Sun Apr 29 23:23:13 2007 jaiman@oriole
acuLmg: (1308) 16p Sun Apr 29 23:23:28 2007 farzin@tern
acuLmg: Licenses queued (0):
acuLmg: None

indicating that five jobs are running and none are waiting on the queue.

To report statistics on license usage, issue the command:

acuLmg -stats

This will produce a message like:

acuLmg: License server: pelican
acuLmg: Product: acuSolve
acuLmg: Number of licenses: 10
acuLmg: Last expiration date: Jul-05-2007
acuLmg: Daemon start time: Tue Apr 10 15:10:34 2007
acuLmg: Current server time: Sun Apr 29 23:24:43 2007
acuLmg: Ave. lic. checked out: 0.3814
acuLmg: Max. lic. checked out: 5
acuLmg: Ave. lic. elapsed time: 1068 Sec
acuLmg: Max. lic. elapsed time: 1.204e+05 Sec
acuLmg: Ave. lic. processors: 3.443
acuLmg: Max. lic. processors: 16
acuLmg: Ave. lic. queued: 0
acuLmg: Max. lic. queued: 0
acuLmg: Ave. lic. queue time: 0 Sec
acuLmg: Max. lic. queue time: 0 Sec

To simulate checking out a license, issue the command:

acuLmg -co -cot 1000

This checks out a license and sleeps for 1000 seconds.

The above examples assume that the license manager options are already placed in the (system) configuration file Acusim.cnf by the system administer. This file will contain options such as:

lm_daemon= /acusim/SGI/latest/bin/acuLmd
lm_server_host= eagle
lm_port= 41994
lm_license_file= /acusim/license.dat
SGI.lm_checkout= /acusim/SGI/latest/bin/acuLmco
HAL.lm_checkout= /acusim/HAL/latest/bin/acuLmco
HP.lm_checkout= /acusim/HP/latest/bin/acuLmco
lm_queue_time= 3600

In this example, the network license daemon, acuLmd, runs on the SGI server host called eagle. The SGI executable is located at /acusim/SGI/latest/bin/acuLmd. The TCP port used for communication between all licensing modules is 41994. The license keys are placed in the file /acusim/license.dat. This file may contain any number of license keys for any number of network license daemons. Only the applicable entries are processed; all others are ignored. The above file may look like the following:

Table 1.
# key	code	no.lic	expiration	uid	hostid	host
bqPC3K2KxhMNZOFegrqwFA	AcuSolve	5	Jan-01-2012	4753	0x690a13bf	eagle
bqPC3K2KxhMNZOFegrqwFA	AcuSolve	3	Jun-01-2013	4753	0x690a13bf	eagle
n0BGLUJ5/imf88k06M1SDQ	AcuSolve	2	Jan-01-2011	6435	0x73c43ad1	hawk

where, for the network license server eagle with host ID 0x690a13bf, there are 5 simultaneous network licenses valid until January 1, 2012, and 3 simultaneous network licenses valid until June 1, 2013.

The executable acuLmi may be used to get the host ID of a machine. Simply run this command on the server with no argument, such as:

acuLmi

This produces results similar to the following:

machine: SGI64
host: eagle
hostid: 0x690a13bf