HP Systems Insight Manager 7.2 Technical Reference Guide

Remote tools require environment variables, which are parameters passed to the launched
application to make it perform as expected. The launch command string includes system variables
and user-defined variables for your application. For example, you could pass an environment
variable that runs a script to check on the status of your mail server.
DOS environment variables are supported in custom tool parameters and work as parameters on
the New Custom Tool page or the Manage Custom Tools page. Unless you use DOS environment
variables in a batch or script file, you must surround them with double percent (%) signs. For
example, to pass in the NOTICELABEL environment variable as a parameter on the parameter line,
enter %%NOTICELABEL%%. If you use DOS environment variables in a batch file or script file, use
only a single percent (%) sign before and after the environment variable name. For a list of other
substitutable environment variables, see the HP Systems Insight Manager User Guide, at http://
www.hp.com/go/insightmanagement/sim/docs.
Custom tools you create appear under Tools→Custom Tools menu option.
You have multiple scheduling options. For more information about scheduling options, see
Scheduling a task.
IMPORTANT: The application must be able to execute in the security context provided to HP SIM
(the default is LocalSystem).
• New Custom Tools
Select Tools→Custom Tools→New Custom Tool. The New Custom Tool page appears.
• Manage Custom Tools
Select Tools→Custom Tools→Manage Custom Tools. The Manage Custom Tools page appears.
Use custom tools that run on target SSA systems create a temporary .XML tool definition file under
/var/tmp, the loads the tool with the mxtool -affilename. You enter only data in required
fields.
WARNING! If you define a custom tool to run as root, any user authorized to run the tool might
gain full access to the managed system, depending on how you define the command, and what
its capabilities are. Otherwise, the tool runs as the HP SIM user and that user's SSH public key
must be configured on the managed system using the mxagentconfig command.
Custom tools 373