samlicm

Name

samlicm - Use this command to install, list, and upgrade the product license or a feature license.

Synopsis

samlicm [-h]

samlicm [-p [XDR|SAP]]

samlicm [-s]

samlicm [-t]

samlicm [-i license_file]

Description

The samlicm command installs, lists, and upgrades the product license for System Automation for Multiplatforms or a feature license. Since every node in the cluster checks for a license, the license must be installed on every node in the cluster. Depending on the installation medium, a try-and-buy or full license is already installed during product installation. Use the samlicm command to check your license status or upgrade a try-and-buy license to a full license.

Options

-h: Writes the command's usage statement to standard output.
-p [XDR|SAP]: Checks for permanent or feature licenses. The result is given as an exit status only.
-s: Prints the license status to standard output. Use this option to see when your license expires.
-t: Tests the license. Use this option to check the installed license.
-i license_file: Installs or upgrades the product license or feature license with the specified license file. Use the -i option for both the initial license installation and license upgrade.

Exit Status

0: The command ran successfully. Returned for option -p if a permanent license is installed.
1: Error occurred during command processing.
2: Returned for option -p if a try-and-buy license is installed.

Security

This command requires root authority.

Examples

Install a license or upgrade a license:
```
samlicm -i try_buy.lic
```
If everything works fine you, do not get any output from the command. If an error occurs, the error message is written to standard error, and the corresponding exit status is returned.
Print the license status:
```
samlicm -s
```
Sample Output:

The following output indicates that the System Automation for Multiplatforms product license is installed.
Note: Product licenses might have no qualifier on the associated 'Product Annotation' line.
```
Product ID: 101
Product Annotation:
Creation date: Thu Oct 25 02:00:00 2007
Expiration date: Fri Jan  1 00:59:59 2038
```
The following output indicates that two licenses are installed: the System Automation for Multiplatforms product license, and an Extended Disaster Recovery for Linux® on System z® License.
```
lnxxdr43:~ # samlicm -s
Product: IBM Tivoli System Automation for Multiplatforms 3.2
Product ID: 101
Product Annotation: SA for MP xDR for Linux on System z
Creation date: Wed Aug 19 02:00:00 2009
Expiration date: Fri Jan  1 00:59:59 2038
```

Files

/usr/sbin/rsct/bin/samlicm: Location of the samlicm command.