HP Systems Insight Manager 5.3 Command Line Interface reference guide

Linux
mxexec(8)
mxauth
Adds, removes, or lists authorizations in HP SIM.
Synopsis
mxauth -a|r -u username -R toolboxname -n nodename
mxauth -a|r -u username -R toolboxname -g groupname
mxauth -a|r -f filename
mxauth [-l t]
mxauth -l f [-b encoding ]
Description
mxauth is used to manage authorizations. These associations between users, toolboxes, and nodes or node
groups can be added or removed only by full configuration rights users. Any HP SIM user can list
authorizations. Authorizations formed from users, toolboxes, and nodes are called node authorizations .
• mxauth -a|r -u username -R toolboxname -n nodename
This command allows full configuration rights users to add or remove one node authorization.
Asterisks are supported for the nodename parameter. HP SIM recognizes the asterisk as a wildcard
character to indicate adding the node authorization for all currently configured nodes. When using the
wildcard character on the command line, enclose it in quotation marks to prevent the shell interpreter
from preprocessing it.
• mxauth -a|r -u username -R toolboxname -g groupname
This command allows full configuration rights users to add or remove one node group authorization.
Asterisks are supported for the groupname parameter. HP SIM recognizes the asterisk as a wildcard
character to indicate adding the node group authorization for all currently configured node groups.
When using the wildcard character on the command line, enclose it in quotation marks to prevent the
shell interpreter from preprocessing it.
• mxauth -a|r -f filename
This command allows full configuration rights users to add or remove multiple authorizations by specifying
an input file containing node and node group authorizations. The file must be formatted in the required
XML format. See XML file support, Examples, and the mxauth(4)manpage for more information.
• mxauth [-l t]
This command lists information about one or more authorizations in simple or tabular format.
When you run mxauth with no options, the output lists all authorization names in simple form with the
authorization fields separated by colons (:).
Node authorizations are listed in the format:
user:toolboxname:n:nodename
Node group authorizations are listed in the format:
user:toolboxname:g:groupname
When you use -l t, mxauth lists all authorizations in a table with column headings identifying each
field.
For HP SIM 5.1 and later, the enabled/disabled state of the Auto Update feature is displayed for node
group authorizations. Auto Update allows you to configure authorizations that can be automatically
updated (systems added or removed from the associated node group list) in the background at a
configurable interval, for example, every five minutes.
Linux 19