HP Systems Insight Manager 6.3 Command Line Interface Guide

description 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 Systems Insight Manager. A toolbox
contains a set o fSystems Insight Manager 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 Systems Insight Manager
to only see the tools they need.
Systems Insight Manager 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 Systems
Insight Manager.
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 Systems
Insight Manager. 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 Systems Insight Manager.
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.
150 Infrastructure management using CLI