Administrator's Reference

AUDIT LICENSES (Audit Server Storage Usage)

Use the AUDIT LICENSES command to start a process that audits the server storage used by each client node and audits the licensing features that are in use on the server. This process then compares the storage utilization and other licensing factors to the license terms that have been defined to the server to determine if the current server configuration is in compliance with the license terms.

Note:

If you halt the server and then restart it, a license audit is run automatically as specified by the SET LICENSEAUDITPERIOD command to check for license conformance.

If the audit process identifies that the server configuration is not in compliance with the terms of the license, one of the following occurs:

• Warning messages are generated indicating that the server is not in compliance with the license terms. However, operations continue normally.

• Operations fail because the server is not licensed for specific features or device support modules.

After the license audit is complete, you can view the information that has been gathered by using the QUERY LICENSE command.

As part of a license audit operation, the server calculates, by node, the amount of backup, archive, and space management storage in use. For servers managing large amounts of data, this calculation can take a great deal of CPU time and can stall other server activity. You can use the NOAUDITSTORAGE server option to specify that storage is not to be calculated as part of a license audit.

The AUDIT LICENSES command also may be used after new licenses have been registered with the REGISTER LICENSE command so that the new license terms are known to the server before the next automatic license audit is run.

This command creates a background process that can be canceled with the CANCEL PROCESS command. To display information on background processes, use the QUERY PROCESS command.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-AUDit LICenses----------------------------------------------><
 

Parameters

None.

Examples

Task

Issue the AUDIT LICENSES command.

Command:

audit licenses

Related Commands

Table 13. Commands Related to AUDIT LICENSES

Command	Description
CANCEL PROCESS	Cancels a background server process.
QUERY AUDITOCCUPANCY	Displays the server storage utilization for a client node.
QUERY LICENSE	Displays information about licenses and audits.
QUERY PROCESS	Displays information about one or all background server processes.
QUERY STATUS	Displays the settings of server parameters, such as those selected by the SET commands.
REGISTER LICENSE	Registers a new license with the ADSM server.
SET LICENSEAUDITPERIOD	Specifies the number of days between automatic license audits.