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 amount of time, in seconds, to camp in the license queue while waiting for a license is set by the option lm_queue_time.
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
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.
acuLmg -stop
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.
acuLmg -query
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.
acuLmg -stats
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
acuLmg -co -cot 1000
This checks out a license and sleeps for 1000 seconds.
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
# 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.
acuLmi
machine: SGI64
host: eagle
hostid: 0x690a13bf