HP Systems Insight Manager 6.0 Command Line Interface Guide

# mxtoolbox –r tbname ; remove toolbox “tbname”
• The –d description option 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 guide does not discuss the details of creating and managing tools. For more information, see the HP
Systems Insight Manager 6.0 user guide on the www.hp.com. However, this guide discusses the highlights
of toolboxes.
The “Managing toolboxes” 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:
<toolbox toolbox-name="My 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
The first example creates a node authorization that enables username to use the tools in toolboxname to
manage system nodename. The second example creates a group authorization that enables username to
use the tools in toolboxname to manage all the systems in system group groupname. The third example
creates authorizations as defined in the XML file authfile.xml. The following example shows what an
XML file would look like when creating three system authorizations:
<?xml version="1.0" encoding="UTF-8"?>
<auth-list>
Managing users and authorizations 129