Infrastructure management using the HP SIM command line interface (436331-002, January 2009)
• The –u and –p options specify the account on the systems identified with the –n option. If you do
not specify the –p option, then the command prompts you for the password of the user specified in
the -u option.
• The –o option enables you to choose host-based authentication, -o host, or user key-based
authentication, -o user. If you do not specify the –o option, host-based authentication is used.
To verify whether or not the hosts specified have been authenticated for CMS access by the user
specified in the –u option, use the command:
# mxagentconfig –c [–n host] [–u username]
If you do not specify the host, CMS authentication is checked. If you do not specify the user name, the
command verifies the user name for the user executing the command.
To remove authentication, use the –r option:
# mxagentconfig –r [–n host]
This removes the host key for system host from the CMS known hosts file. If a host is not provided, the
CMS removes authentication to itself.
Managing tasks
The mxtask command enables you to create, remove, execute, list, and change ownership of HP
SIM tasks, either from the command line or through XML files. See the mxtask man page for a
description for the mxtask command, and the mxtask(4) man page for a description of the XML
syntax required to manage users.
To create a new task in HP SIM, the task must have a name, the name of a collection to use to create
the list of systems executing the selected tool, any parameters required by the tool, scheduling
information, the name of a time filter (if required, specifying timeframes for tool execution), and the
name of the owner of the task (optional).
To create a task, use the following command example:
# mxtask –c tname –q qname –t toolname –w sched [–A tparams | –f tpf.xml]
\ [–o towner] [–i tfilter]
• The –c tname option creates a task with name tname.
• The –q qname option identifies the collection to use for the task, and –t toolname identifies the
name of the tool to execute. Both qname and toolname must exist in HP SIM. If the tool toolname
requires any parameters, then you must use one of the –A or –f options.
– Use the –A option to list the task parameters, tparams, on the command line.
– Use the –f tpf.xml if the parameters defined in the tpf.xml file. As the file name implies, the
parameters are defined in XML format as defined in the man page mxtask(4). If you use the –o
towner parameter, the new task is owned by towner. The default owner is the user that is
running the mxtask command.
• Use the –i tfilter parameter to have the task use the time filter tfilter to define when the task
executes.
• The –w sched parameter defines the execution schedule for the task. The general format for the –w
sched parameter is:
-w T<tasktype>.I<intervaltype>.P<periodic>.D<day|date>.M<time>
Where <tasktype> defines the type of task:
– add—runs the task when the query criteria are met
– remove—runs the task when query criteria are no longer met
– manual—runs the task only when manually invoked
– schedule—runs the task based on the P and D time definitions
16