Problem Determination Using Self-Managing Autonomic Technology

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

information

򐂰 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:

򐂰 startrme [-reset]

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.

򐂰 uninstrmtype <rm-type>

Uninstalls a resource model type. All instances of the type have to be

removed first or you will receive an error.

򐂰 lsrmtypes

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.

򐂰 lsctx

Lists the available contexts.

򐂰 rmctx <context-name>

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

descriptor.

򐂰 lsrminstances [-verbose]

Lists resource model instances. If you use the –verbose option, you also get

status information.

򐂰 startrminstance <rm-name>

Starts a resource model instance.

򐂰 stoprminstance <rm-name>

Stops a resource model instance.

򐂰 rmrminstance <rm-name>

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.