222 Problem Determination Using Self-Managing Autonomic Technology
Figure 6-14 Decision tree activity diagram
Refer to 8.7.2, “Registering custom CIM class using Resource Model Builder” on
page 282 for details.
6.3 Simple Agent Reference Application (SARA)
The current version of the Autonomic Management Engine tool is shipped with a
sample embedding application called SARA. This tool can be used as a
replacement for writing your own embedding application, as explained later. This
tool is intended only for demonstration purposes.
The tool comes with the following default plug-ins:
Serviceability: JLog-based implementation plug-ins for logging trace
CIM method invocation action launcher: Plug-in for invoking CIM methods
Shell command action launcher: Plug-in for invoking shell scripts or programs
when run through ShellCmd
EIF event sink: An event sink plug-in that sends EIF formatted events to Tivoli
Enterprise Console or other such servers
The SARA configuration files are located in the <%AME_HOME%>\sara\config
folder, where <%AME_HOME%> is the installation directory of the Autonomic
Management Engine tool.
Chapter 6. Autonomic Management Engine and resource models 223
SARA provides a command-line interface for various actions that can be
programmatically executed by any typical embedding application. The
command-line interface is started by executing the sara.bat or sara.sh file
located in %AME_HOME%\sara.
Figure 6-15 shows the command-line interface of the SARA application. As seen
in the figure, various operations performed by the embedding application can be
executed as commands so that various instances of the resource model types
can be created and started using the command line.
Figure 6-15 The SARA application shipped with Autonomic Management Engine tool
The following list provides a short description of each of the commands:
This is the first command that must be run. It initializes SARA and the
underlying Autonomic Management Engine services. If you do not run the
startrme command first, you will see an error message. If you specify the
–reset option, AME resets its previous configuration; all resource model
instances are deleted, all contexts are removed, and all resource model types
are uninstalled. This option is useful only for test purposes.
224 Problem Determination Using Self-Managing Autonomic Technology
instrmtype <rm-bundle-file> [-replacefiles]
Installs a resource model type based on the resource model package. The
instrmtype command installs the contents of the resource model package in
a well-known directory structure defined by the embedding application (that
is, ./work/rmbundles for SARA). The –replacefiles option allows the
replacement of some files installed with other resource models.
Uninstalls a resource model type. All instances of the type have to be
removed first or you will receive an error.
Lists all installed resource model types.
mkctx <context-name> <properties-file>
Creates a context with a set of properties (key-value pairs) based on the
content of a property file.
Lists the available contexts.
Removes a context.
mkrminstance <rm-name> <rm-type> [<rm-ctx>] [<rm-desc>]
Creates an instance of a resource model. An instance of a resource model is
created from its resource model type associating (optionally) a context and a
Lists resource model instances. If you use the –verbose option, you also get
Starts a resource model instance.
Stops a resource model instance.
Removes a resource model instance. The resource model instance is
removed regardless of its current state (running or stopped).
instnlscat <rm-type> <cat-file> <lang> [-replacefiles]
Installs an additional national language support (NLS) catalog file (Tivoli
message catalogs) for a resource model type.