HP Systems Insight Manager 7.1 Command Line Interface Guide

of the XML syntax required to manage toolboxes using an XML file, see the mxtoolbox(4) man
page.
Toolboxes are an integral part of creating authorizations in HP SIM. A toolbox contains a set o
fHP SIM tools that one or more users can run on the systems they are authorized to manage. An
example of using toolboxes is to create a toolbox containing tools that apply only to HP-UX systems
and a toolbox containing tools that apply only to Windows operatng systems. This enables HP-UX
and Windows administrators using HP SIM to only see the tools they need.
HP SIM has four predefined toolboxes, All Tools, Monitor Tools, Full Rights, and Limited Rights.
• All Tools contains all the predefined tools, and cannot be modified.
• Monitor Tools contains tools that monitor, display, view, and report information, and can be
modified.
• Full Rights toolbox contains all the tools in the Central Management Server.
• Limited Rights toolbox contains only the create and edit reports and tools.
When you install HP Storage Essentials, a toolbox for Storage Essentials tools is added to HP SIM.
The following examples add, modify, and remove toolboxes, respectively:
# mxtoolbox –a tbname [-d description] [-e t|f]; add toolbox tbname
# mxtoolbox -m tbname [-d description] [-N newtbname] [-e t|f]; modify
toolbox tbname
# 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.
152 Infrastructure management using CLI