Infrastructure management using the HP SIM command line interface (436331-002, January 2009)

• The -d description displays a description of the toolbox. In the modify toolbox example, -

N newtbname renames the toolbox from tbname to newtbname. Both -d and -N are optional

parameters.

• The –e [t|f] switch is an optional parameter used to enable or disable a toolbox.

Toolbox names are limited to a length of 16 characters, and must start with an alphanumeric

character and can contain alphanumeric characters, embedded spaces, underscores (_), or

hyphens (-).

Instead of providing toolbox information on the command line, you can create an XML file as defined

in the mxtoolbox(4) man page.

• Use the -f tbfile option to specify the XML file to add, modify, or remove toolboxes. This is

useful when managing multiple toolboxes. For example, to add toolboxes defined in the file

tbfile.xml:

# mxtoolbox –a –f tbfile.xml

• Use the mxtoolbox –l command to produce a columnar list of all the toolboxes in HP SIM. To

view the information in a different format or display toolbox attributes, use one of the following

options:

– The –n option displays a columnar list of the toolbox names.

– The –t option displays a tabular list of toolbox attributes.

– The -f option displays the XML format of toolbox attributes.

Adding tools to toolboxes

The mxtool command enables you to add, modify, remove, or list tools in HP SIM. For a complete

description of mxtool, see the mxtool man page. For a complete description of the XML syntax

required to manage toolboxes from an XML file, see the mxtool(4) man page.

This paper does not discuss the details of creating and managing tools. For more information, see the

white paper “Creating custom tool definition files for HP SIM 5.1 or greater” on the HP website

However, this paper discusses the highlights of toolboxes in the white paper.

The previous section discussed how to create toolboxes used in creating authorizations. When

creating tools, use the following XML entry to place the tool in a specific toolbox:

To include the tool in more than one toolbox, you can enter additional <toolbox…/> entries.

Do not add tools to the Monitor Tools toolbox that provide root or administrator level functionality.

This toolbox is assigned to the operator and user templates, and these tools run with root or

administrator access on the CMS.

Managing authorizations

The mxauth command enables you to add, remove, or list authorizations in HP SIM. For a complete

description of mxauth, see mxauth man page. For a complete description of the XML syntax required

to manage authorizations from an XML file, see the mxauth(4) man page.

Before creating authorizations, the users, system groups (optional), and toolboxes must exist as

described in the Managing users, Managing system groups and Managing toolboxes sections. After

creating the users, tools, and toolboxes, you can create the authorizations.

The commands to create a node authorization are:

# mxauth –a –u username –R toolboxname –n nodename

# mxauth –a –u username –R toolboxname –g groupname

# mxauth –a –f authfile.xml