Document Number SC30-4079-03
| Note |
|---|
|
Before using this information and the product it supports, read the general information in Appendix B, Notices. |
Third Edition (September 2005)
This edition applies to Release 3.0 of the Autonomic Computing Toolkit and to all subsequent releases and modifications until otherwise indicated in new drafts.
(C) Copyright International Business Machines Corporation 2005. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Introduction to the Autonomic Computing Toolkit
Autonomic Computing Toolkit technologies and tools
Autonomic Computing Toolkit scenarios
Obtaining and installing the Autonomic Computing Toolkit components
Appendix A. Getting help, service, and information
This guide provides installation and user information for the Autonomic Computing Toolkit.
This edition of the User's Guide describes Release 3 of the Autonomic Computing Toolkit. This release highlights significant enhancements to the Toolkit components including performance and usability improvements, and additional support of industry standards. Standards support includes support of the following.
This guide is for system architects and designers, software developers, and testers interested in:
The latest softcopy versions of documentation are available on the autonomic computing IBM developerWorks Web site at:
www.ibm.com/developerworks/autonomic
Refer to Documentation for a comprehensive list of available publications.
The HTML version of this guide and other related publications is accessibility-enabled for use with the IBM Home Page Reader.
For the latest news and tips on general autonomic computing topics, go to the autonomic computing Web site at:
You can also download the Autonomic Computing Toolkit, documentation, and access additional information from the developerWorks Web site at:
www.ibm.com/developerworks/autonomic
Here you will find information about general autonomic computing concepts, an overview of the Autonomic Computing Toolkit, and most importantly, articles, and tutorials that show you how to apply the tools from the Autonomic Computing Toolkit in real-life situations. After you decide which pieces of the Autonomic Computing Toolkit you need, you can easily download the code right from this Web site.
Your feedback is important to help us provide the highest-quality information. If you have any comments about this guide, you can submit them on the IBM autonomic computing Web site at:
www.ibm.com/developerworks/autonomic
and click on Support for Toolkit forum.
This chapter provides an introduction to the general terms of autonomic computing and explains the required attributes of an autonomic environment.
The concept of autonomic maturity levels is also introduced. Understanding autonomic maturity levels is important to realizing how the Autonomic Computing Toolkit can help you develop capabilities using IBM Self-Managing Autonomic Technology(TM) components that make IT environments easier to manage.
The autonomic computing reference architecture is then explained. The architecture provides an integrating framework for the technology content of the Autonomic Computing Toolkit.
Autonomic computing is a term used by IBM to describe an initiative to create a computing environment with the ability to manage itself and dynamically adapt to change in accordance with business policies and objectives. The autonomic environment will shift the burden of managing IT systems from IT professionals to the systems themselves. The term autonomic comes from the autonomic nervous system of the human body, the system that regulates the basic functions of the human body without one's conscious awareness. For instance, when you need to run to catch a train, you cannot consciously decide to produce adrenaline, reallocate oxygen to the muscles in your legs, and increase your heart rate. These important and necessary physical adjustments are handled for you automatically. In a similar way, autonomic computing systems handle more and more tasks on their own, without the need for intervention on the part of the IT staff. Autonomic computing behavior is necessary for building effective on demand operating environments that adapt and adjust quickly to the changing computing needs of organizations.
Autonomic computing was conceived as a way to help reduce the cost and complexity of owning and operating an IT infrastructure. In an autonomic environment, system components--from hardware such as desktop computers and mainframes to software such as operating systems and business applications--become self-configuring, self-healing, self-optimizing, and self-protecting. These self-managing attributes are defined as follows:
These self-managing attributes are the core of an autonomic computing environment. They suggest that the tasks involved in configuring, healing, optimizing, and protecting the IT system are initiated due to situations that the technologies themselves detect, and that these tasks are performed by those same technologies. Collectively, these intuitive and collaborative characteristics can help enable enterprises to operate efficiently with fewer human resources, while decreasing costs and enhancing the organization's ability to react to change. For instance, in a self-managing system, a new resource is simply deployed and then optimization occurs. This is a notable shift from traditional implementations, in which a significant amount of analysis is required before deployment, to ensure that the resource runs effectively.
Incorporating IBM Self-Managing Autonomic Technology components into a computing environment is an evolutionary process enabled by technology, but it is ultimately implemented by each enterprise through the adoption of these technologies, supporting processes, and skills.
Products, systems, and IT environments can be classified in the following five levels of maturity that show how a business is evolving its use of autonomic capabilities and supporting processes and skills:
At the basic level, IT professionals manage each infrastructure element independently and set it up, monitor it, and eventually replace it.
At the managed level, systems management technologies can be used to collect information from disparate systems onto fewer consoles, helping to reduce the time it takes to collect and synthesize information as the IT environment becomes more complex.
At the predictive level, analysis capabilities are introduced in the system to monitor situations that arise in the environment, and analyze the situations to provide possible courses of actions. The IT professional makes a determination on what course of action to take.
At the adaptive level, the IT environment can automatically take actions based on the available information and the knowledge of what is happening in the environment. As analysis and algorithmic technologies improve and as people become more comfortable with the advice and predictive power of such technologies, systems can progress to the adaptive level.
At the autonomic level, business policies and objectives govern the IT infrastructure operation. IT professionals interact with the autonomic technology tools to monitor business processes, alter the objectives, or both.
The autonomic concepts presented in this section form the basis for a common approach and the base set of terminology needed in the architecture of self-managed autonomic computing systems in a heterogeneous environment.
The autonomic computing reference architecture starts from the premise that implementing self-managing attributes involves an intelligent control loop. This loop collects information from the system, makes decisions and then adjusts the system as necessary. An intelligent control loop can enable the system to have the self-configuring, self-healing, self-optimizing, and self-protecting attributes described before.
The architecture describes three types of system components -- autonomic managers, managed resources, and managed resource touchpoints. An autonomic manager is a component that implements all or part of a particular control loop. A touchpoint is a component that delivers access to the managed resource. A managed resource is what the autonomic manager is controlling. Figure 1 illustrates the relationship between the different components.
Figure 1. Autonomic computing reference architecture

The autonomic manager is a component that implements the control loop and automates the management of a set of manageable resources.
The architecture splits the loop into four parts that share knowledge. They are:
The four parts work together to provide the control loop functionality. They consume and generate knowledge. This knowledge builds on known information about the system and grows as the autonomic manager learns more about the characteristics of the managed resources. The knowledge is continuously shared among the four parts, leading to more informed decisions being made by the parts. Figure 1 shows a structural arrangement of the parts--not a control flow. The bold line that connects the four parts should be thought of as a common messaging bus rather than a strict control flow. In other words, there can be situations where the plan part might ask the monitor part to collect more or less information. There could also be situations where the monitor part may trigger the plan part to create a new plan.
The managed resource is a controlled system component. There can be a single managed resource (a server, database server, or router) or a collection of resources (a pool of servers, cluster, or business application).
An autonomic manager communicates with a managed resource through the manageability interface. A touchpoint is the implementation of the manageability interface by a specific managed resource. For example, a database server might implement a touchpoint for communicating with an autonomic manager.
The touchpoint, one of the three main elements of the autonomic computing architecture, delivers the manageability interface to the autonomic manager.
The manageability interface between an autonomic manager and a managed resource is organized into sensor and effector operations.
In the simplest terms, sensor operations are typically used to transmit events or properties to an autonomic manager, whereas effector operations are typically used to cause some sort of change in a managed resource, such as altering state data or setting property values.
Sensor and effector operations are organized into a set of interaction styles that formalize and define how an autonomic manager and its managed resources interact. Sensor and effector operations each can have two interaction styles:
Interaction styles are differentiated by whether the autonomic manager or the managed resource makes contact first. In both the sensor retrieve-state interaction style and the effector perform-operation interaction style, the autonomic manager makes first contact. In the sensor receive-notification and effector call-out-request interaction styles, it is the managed resource that makes contact first.
The combination of sensor and effector operations forms the manageability interface that is available to an autonomic manager. As shown in Figure 1, by the black lines connecting the sensor and effector sides of the diagram, the architecture encourages the idea that sensor and effector operations are linked together. For example, a configuration change that occurs through an effector should be reflected as a configuration change notification through the sensor interface.
Further details of the manageability interface and interaction styles are described in the Autonomic Computing Toolkit Developer's Guide.
As described in Levels of autonomic maturity, autonomic maturity levels demonstrate that self-managing attributes are achieved in an evolutionary manner that permeates all aspects of a system. As an example, different parts of the autonomic manager could be implemented at each maturity level.
The monitor and execute parts of the autonomic manager could be implemented at the basic and managed levels. So, at these two levels, IT professionals would be responsible for performing the function of the analyze and plan parts.
The analyze part of an autonomic manager can be supplied at the predictive maturity level. At this level, the IT professional would be responsible for the plan function.
In the adaptive and the autonomic level, all of the parts of the autonomic manager are implemented so that the IT professional could delegate the work to the system.
The Autonomic Computing Toolkit is a collection of technologies, tools, examples, scenarios, and documentation that is designed for users who want to learn, adapt, and develop autonomic capabilities in their products and systems.
This release of the Autonomic Computing Toolkit provides the second phase of autonomic computing technologies that enable the development of autonomic capabilities. The content of the Autonomic Computing Toolkit can be divided into four main categories:
The IBM Self-Managing Autonomic Technology components provided in the Autonomic Computing Toolkit can be used to develop or enhance certain capabilities in products and systems. These capabilities include problem determination, common systems administration, and solution installation and deployment.
Problem determination autonomic capabilities can be developed with the Autonomic Management Engine (AME), the Generic Log Adapter (GLA), and the Log and Trace Analyzer (LTA) tool.
The Integrated Solutions Console is used to build effective common systems administration capabilities.
The dependency checker and change manager are technologies that provide autonomic capabilities for solution installation and deployment.
The IBM Self-Managing Autonomic Technology components, available in the Autonomic Computing Toolkit, is described in detail in Autonomic Computing Toolkit technologies and tools.
In addition to delivering these technologies, the Autonomic Computing Toolkit provides the tooling necessary to customize the technologies so that solutions can be created to meet the specific needs of each user. The Autonomic Computing Toolkit provides Eclipse-based tools such as the Integrated Solutions Console toolkit, Resource Model Builder (RMB), and the Adapter Configuration Editor tool.
The Autonomic Computing Toolkit also provides log parsers for several IBM products. These parsers, along with the parsers that you develop for your own products with the Adapter Configuration Editor tool, can be used to debug complex problems in a system environment.
These tools are described in detail in Autonomic Computing Toolkit technologies and tools.
Scenarios are also provided that show how the technologies work together and how they can be used in realistic situations. All the scenarios in the Autonomic Computing Toolkit are built using the technologies and tools available in the Autonomic Computing Toolkit. This release of the Autonomic Computing Toolkit includes a problem determination scenario performing self-healing tasks, as well as several automated installation scenarios performing self-configuring tasks.
These scenarios are described in detail in Autonomic Computing Toolkit scenarios.
The Autonomic Computing Toolkit also focuses on educating users on autonomic computing. Detailed individual technology and tooling documentation is provided along with documentation to help you begin developing autonomic solutions customized to your products.
This section outlines what you can do with the Autonomic Computing Toolkit and how to do it.
Before you try to develop capabilities using IBM Self-Managing Autonomic Technology components, it is best to get a good understanding of the concepts behind autonomic computing. See Autonomic computing concepts for more background information on the base concepts. The information in the documentation bundle of the Autonomic Computing Toolkit, (see Autonomic computing information) and on the Autonomic Computing Toolkit Web pages, also includes tutorials, articles, and other documents that you might find helpful.
After you gain an understanding of the basic concepts of autonomic computing, you can use the scenarios in the Autonomic Computing Toolkit to see how these technologies work together to achieve a Self-Managing Autonomic Technology Solution.
The Autonomic Computing Toolkit includes a problem determination scenario demonstrating self-healing tasks, Solution Installation, and Deployment scenarios that demonstrate self-configuration tasks through automated installation scenarios.
The problem determination scenario represents a simple self-healing system that uses an intelligent control loop to collect system information, analyze it, plan appropriate responses, and then make necessary adjustments to resolve problems. For more information on this scenario, see the Problem Determination Log/Trace Scenario Guide. Additional documentation is also included in the scenario bundle.
The Solution Installation and Deployment scenarios demonstrate how autonomic solution installation and deployment technologies can be used to improve the packaging and installation of a simple application. Two scenarios are provided, demonstrating similar capabilities; however, each uses a different vendor software installation package. This shows the versatility and flexibility of the solution installation and deployment technologies. For more information on these scenarios, see the Autonomic Computing Toolkit Solution Installation and Deployment Scenario Guide. Additional documentation is also included in the scenario bundles.
An additional scenario is provided that focuses on specific areas of solution installation and deployment by using a collection of samples. Each sample demonstrates a specific feature of the technology and how it can be applied to solutions.
With an understanding of autonomic concepts and the way components in IBM Autonomic Computing Technology work together to achieve a self-managing solution, you can now begin to develop capabilities into your own products and help your customers increase the level of autonomic maturity in their IT environments.
The technologies and tools presented in this release of the Autonomic Computing Toolkit are intended to assist product developers in beginning to develop IBM Self-Managing Autonomic Technology components in their products, to help their IT environments achieve higher autonomic maturity levels. The technologies in the Autonomic Computing Toolkit can be divided into four categories, as shown in Figure 2.
Figure 2. Autonomic Computing Toolkit technologies and tools

Several examples of autonomic manager implementations are provided.
AME includes built-in capabilities for the four parts of the autonomic manager control loop (monitor, analyze, plan, and execute).
The LTA is an example of a partial implementation of the autonomic manager, covering the monitor and analyzing parts of the control loop.
The Autonomic Computing Toolkit provides several technologies and tools to help developers create touchpoints that enable managed resources to communicate with autonomic managers. The Generic Log Adapter is included in the Autonomic Computing Toolkit to translate product log messages into the Common Base Event data format.
The Autonomic Computing Toolkit also contains tools to allow you to customize autonomic managers and managed resource touchpoint implementations. The RMB is used to customize the AME. The Adapter Configuration Editor is used with the GLA. The Integrated Solutions Console toolkit allows you to build custom portlets for the Integrated Solutions Console.
The Integrated Solutions Console component provides user access to the self-management capabilities. It is a Web-based infrastructure based on industry-standard technologies.
The Autonomic Computing Toolkit includes the Autonomic Management Engine (AME), an IBM Self-Managing Autonomic Technology component, an example of an implementation of an autonomic manager (see Autonomic manager for a definition of an autonomic manager).
AME monitors system resources, sends aggregated events, and performs corrective actions for problems. AME constantly monitors the system looking for events to handle.
AME can run in two modes:
AME is available in the Autonomic Computing Toolkit in the AME bundle.
A scenario demonstrating AME is included in the Autonomic Computing Toolkit. The scenario shows how AME can monitor for a situation, detect the situation, and provide corrective action. See the Problem Determination Scenario bundle information found in Autonomic Computing Toolkit scenarios, which describes the scenario and AME's involvement in more detail.
For additional information on developing solutions with AME, see the AME 1.2 Developer's Guide, provided in the bundle.
By defining a resource model for each managed resource, you provide AME with the knowledge needed to manage that resource. Resource models contain specific metrics, events, thresholds, and parameters, which are used to determine the health of your resources along with specifications for corrective actions in the event of failures. AME provides services for installing, starting, and stopping a resource model, and querying its state.
There are two styles of resource models that can be executed by AME:
The Autonomic Computing Toolkit provides an Eclipse plug-in that you can use to create your own custom AME resource models, the RMB.
A sample AME resource model (CMM based) is provided in the Autonomic Computing Toolkit for educational and demonstration purposes. You can use this sample to learn how AME resource models are written and how they get tied into AME. The resource model sample is available in the Problem Determination scenario downloadable bundle.
For additional information on developing and using AME resource models, see the Autonomic Computing Toolkit Developer's Guide. For an example of an actual AME resource model, see the Autonomic Computing Toolkit Problem Determination Log/Trace Scenario Guide.
Solution installation and deployment technologies provide another implementation of an autonomic manager, as well as managed resource touchpoint implementations (see "Autonomic computing reference architecture" for a definition of these concepts). The autonomic manager functionality is provided by two components, a dependency checker and a change manager. Touchpoint implementations are provided for several operating environments. These technologies combine to provide a means by which software can be bundled and deployed across most operating environments.
The Autonomic Computing Toolkit provides scenarios that demonstrate these technologies and how you can use them to improve the packaging and installation processes for software solutions. Using these technologies can help you consistently plan for and deploy IBM and non-IBM solutions in less time and with fewer resources. See the "Automated installation scenarios".
The Log and Trace Analyzer (LTA), an IBM Self-Managing Technology component, is an example of a partial implementation of the autonomic manager, covering the monitor and analyze parts of the control loop (see Autonomic computing reference architecture for a definition of an autonomic manager).
The LTA enables viewing, analysis, and correlation of log files. This tool makes it easier and faster to debug and resolve problems within multitiered systems by consuming data in the Common Base Event format, providing specialized visualization and analysis of the data.
The LTA contains a log-analysis engine. The role of this engine is to provide an algorithm that takes an incident that is recorded in a log file as an input parameter, matches this incident based on a predefined rules against the symptoms of an available symptom database and returns an array of objects representing the solutions and directives for the matched symptoms. The LTA provides a default implementation of an analysis engine and a set of instruments that could be used to implement a custom analysis engine.
The Autonomic Computing Toolkit contains a default correlation engine as part of the LTA bundle. The capabilities include timestamp and record ID correlation. Also provided is the ability to create custom correlation engines.
The LTA is available in the Autonomic Computing Toolkit in the GLA and LTA bundle.
For additional information on using the LTA, see the Log and Trace Analyzer User's Guide and other documentation provided in the bundle.
The Autonomic Computing Toolkit provides parsers for several IBM products. They are included in the Generic Log Adapter Runtime and Rule Sets bundle. The complete list of parsers and rules is provided in the online documentation for the GLA Configuration Editor contained in the Generic Log Adapter Runtime and Rule Sets bundle.
These parsers, together with the parsers you develop for your own product logs, could be used for debugging complex problems as you develop self-managing applications in a multiproduct system environment.
The agent controller can be used to import any type of log file remotely from any platform that the agent controller supports. The supported platforms of the agent controller include:
The agent controller provides the convenience of analyzing a log file from
a remote machine without having to transfer a copy of the file to a local
machine. For example, by installing the agent controller on an IBM
machine, users can use the LTA running on a Windows machine to
import and analyze a log file that is continuously updated by an application
running on the server.
For more information, see Agent controller .
The Generic Log Adapter (GLA), an IBM Self-Managing Autonomic Technology component, is an example of a technology that helps a product create an autonomic computing resource model touchpoint (see Managed resource touchpoint for a definition of a resource model touchpoint).
The GLA provides the ability to take an IBM or non-IBM product log file and convert the messages into the Common Base Event data format so that the product can become a managed resource. GLA translates product log entries into Common Base Events for consumption by an autonomic manager. The Autonomic Computing Toolkit includes the GLA to help products adapt to the autonomic reference architecture without requiring the product to change the way it creates its log files.
A single GLA runtime can be used to parse the log files of multiple products as long as the rules have been defined for each log message format. The adapter includes a handler that passes the Common Base Event information to the autonomic manager on the manageability interface.
The GLA is available in the Autonomic Computing Toolkit in the Generic Log Adapter Runtime and Rule Sets bundle.
A scenario demonstrating the GLA in a self-healing application is included in the Autonomic Computing Toolkit. In this scenario, GLA reads actual product log files in real time. By using a set of supplied parser rules specifically for the products in the scenario, the adapter translates each log message into Common Base Event format. GLA is demonstrated in the Problem Determination scenario bundle.
For additional information on using the GLA, see the GLA online help files and other documentation provided in the bundle.
The Adapter Configuration Editor Eclipse plug-in is used in conjunction with the GLA. It provides the tooling to create the specific parser rules that are used by the GLA at runtime to create Common Base Event objects.
The Adapter Configuration Editor is available in the Autonomic Computing Toolkit in the Generic log adapter and Log trace analyzer bundle.
For additional information on using the Adapter Configuration Editor, see the GLA online help files and other documentation provided in the bundle.
The central goal of the Integrated Solutions Console, an IBM Self-Managing Technology Component, is to create a platform on which IBM and non-IBM products can build administrative user interfaces. Standardizing products to run on the Integrated Solutions Console platform gives them a more common look and feel and a more consistent behavior, because you are using common building blocks. Administrators can interact with multiple IBM and non-IBM products from a single browser-based console.
Integrated Solutions Console is based on IBM WebSphere Portal, so administrative functions are handled through portlets, or components, within a single system. When an administrator adds new software, its administrative functions and help files are added to the common administrative system.
The Integrated Solutions Console Toolkit is the development environment for creating Integrated Solutions Console plug-ins and is included in the Integrated Solutions Console packaging. It includes the Integrated Solutions Console runtime, Integrated Solutions Console Developer Info Center, Sample Integrated Solutions Console Components, an Integrated Solutions Console plug-in for IBM Rational Application Developer, and an Integrated Solutions Console Eclipse plug-in to help you create console plug-ins.
The Autonomic Computing Toolkit console is set up to respond to AME resource model scripts. These scripts adjusts status indicators as situations occur, keeping the administrators informed on their product's condition. It also functions as an example of how plug-ins might be created for other user-specific product administration applications. The Autonomic Computing Toolkit console is only an educational example and illustrates only one possible approach.
The Integrated Solutions Console component, an IBM Self-Managing Autonomic Technology, provides a full set of online documentation for the runtime as well as the Integrated Solutions Console Toolkit. The following documentation is also available when the Integrated Solutions Console component is installed.
Refer to the Integrated Solutions Console documentation for more information on how to create your own portlets and the Problem Determination scenario to see an actual example.
A specific Integrated Solutions Console component portlet is provided in the Autonomic Computing Toolkit to support the Problem Determination scenario and the Solution Installation and Deployment Technology Samples scenario. This custom portlet supports the JSR-168 standard.
One of the primary objectives of the Autonomic Computing Toolkit is to provide easy-to-understand samples of how IBM Self-Managing Autonomic Technology components can be used to solve real-world problems. These samples are provided as a collection of scenarios that focus on specific attributes of an autonomic computing environment.
The scenarios included in the Autonomic Computing Toolkit are simple representations of typical problem areas that can be addressed using IBM Self-Managing Autonomic Technology components.
The purpose of these scenarios is to demonstrate how the components of the Autonomic Computing Toolkit work together in order to solve real-world problems. These scenarios are supported with documentation and can be used as examples to help you develop your autonomic solution.
The Problem Determination scenario demonstrates the self-healing attribute that autonomic computing brings to a computing environment. In order for a system to be self-healing, it needs to be able to recognize that a problem has occurred, determine the cause, and then take the appropriate action to correct the problem. One method of achieving this is through a product's existing log files. One of the Autonomic Computing Toolkit technologies used in the scenario is the Generic Log Adapter that transforms product log file events into the Common Base Event data format.
The Problem Determination scenario shows how an autonomic manager, represented here by AME, can be used to detect an error situation between two IBM products by analyzing log/trace files and applying a corrective action.
The scenario uses two IBM products interacting with each other to demonstrate how a common Web-based problem is detected and resolved. A simple database product is included to perform basic database access queries. The queries originate from a Web application, also included in the scenario.
The Integrated Solutions Console is another IBM Self-Managing Autonomic Technology component that is used in this scenario. The scenario includes an administration console built with the Integrated Solutions Console technology. It is used to start and stop the scenario and also provides a method of inducing the condition for failure and status monitoring capabilities. The administration console starts the scenario in a steady state showing the normal operation of the two products. It then allows you to induce a database failure that gets picked up from the Web application's log files. The included AME resource model is programmed to recognize the database failure. After the situation has been detected by AME, corrective action is issued to the managed resource. Each stage of the control loop operation is displayed in the status panel of the administrative console. After it has been corrected, the Web application begins functioning again and the scenario returns to steady state.
The Problem Determination scenario illustrates the use of the IBM Self-Managing Autonomic components in the Autonomic Computing Toolkit to accomplish the following tasks:
Running and observing the Problem Determination scenario, you will be able to apply the same techniques to your own applications and design your own autonomic solution for Problem Determination. See the Autonomic Computing Toolkit Problem Determination Log/Trace Scenario Guide for further details on installing, using, and modifying the scenario.
Self-configuration attributes can be demonstrated using the solution installation and deployment technologies available in the Autonomic Computing Toolkit. The benefits and versatility of the autonomic solution installation and deployment technologies are demonstrated by providing three different scenario bundles. Two of the scenarios use different installation software products from industry vendor Macrovision to demonstrate a typical installation, while the third scenario provides hands on interaction of specific features of the technology.
The purpose of the scenarios is to demonstrate the concepts behind the solution installation and deployment technologies by showing installations of realistic software packages.
Each scenario consists of code along with a descriptor package that explains the contents and prerequisites. This descriptor package is an installable unit, and multiple units are grouped into solution modules. The installer software application reads the descriptor file before performing the actual installation and checks a database of installed software and hardware to determine if all of the prerequisites have been met. If they have, the software is installed and its information is added to a solution installation and deployment database. If not, the installer notifies the user of the failed dependency so corrective action can be taken.
Two of the scenarios provided are based on two different underlying packaging software applications. One scenario uses FLEXnet Publisher Installation Module (FNPIM) from Macrovision as the packaging software, whereas the other scenario uses Solution Architect and InstallAnywhere from Zero G. The third scenario does not use vendor packaging software, but rather a simple test client to perform basic installations.
See the Autonomic Computing Toolkit Solution Installation and Deployment Scenario Guide, included in the bundle, for scenario-specific information.
For more information on Solution Architect and InstallAnywhere, go to the Zero G Web site at:
www.zerog.com/solutionarchitect-solution-architect-install-autonomic.html
For more information on FNPIM, go to the Macrovision Web site at:
www.macrovision.com/products/flexnet_publisher/installation_module/index.shtml
This scenario uses samples to demonstrate specific features of the solution installation and deployment technologies. The samples are included as part of the Autonomic Computing Toolkit's integration solutions component plug-in console using the Integrated Solutions Console. This provides a common look and feel to the problem determination scenario operation.
The purpose of the scenario is to avoid the overall complexity of a complete self-configuring solution by focusing on certain aspects of the technology. Each sample can be executed and evaluated independently. The listIU feature is also included so that the Solution Installation and Deployment registry can be examined after both installing and uninstalling the samples.
The following Solution Installation and Deployment samples are bundled in the scenario:
For each sample, the user is presented with a complete description of the sample, the deployment descriptor file specific to the feature being demonstrated, a dynamic log output, as well as the ability to install and uninstall the sample for re-evaluation.
See the Autonomic Computing Toolkit Solution Installation and Deployment Scenario Guide, included in the bundle, for scenario specific information.
In addition to the content, an infrastructure has been built around the Autonomic Computing Toolkit components to provide accessibility, packaging, and installation and support of the IBM Self-Managing Autonomic Technology components. The Autonomic Computing Toolkit is accessible to users through an IBM Web site at:
www.ibm.com/developerworks/autonomic
The Web site provides access to the contents of the Autonomic Computing Toolkit as well as a support structure for aiding you in using that content. Because the Autonomic Computing Toolkit includes a large amount of content, a packaging approach has been provided that allows areas of interest to be obtained quickly and easily, and without having to have knowledge of the individual components. The download bundles are set up to accommodate users at varying levels of autonomic expertise. The Web site guides you to the appropriate bundle based on your area of interest. Experienced users can go directly to the bundle of interest for quick downloading. The packaging has been set up to minimize the number of downloads by organizing the technologies, tools and other components into commonly used bundles. Technologies and tools are available as separate downloads for those wishing to get a specific component.
The content of the Autonomic Computing Toolkit is too large and varied to be downloaded as a whole; therefore, the large amount of content has been broken down into a handful of easy-to-obtain bundles. These bundles help you to get the right content without having to know all of the specifics of the Autonomic Computing Toolkit and to avoid downloading more content than you want or need. The bundles are available on the autonomic computing Web site at:
www.ibm.com/developerworks/autonomic
The Autonomic Computing Toolkit bundles use the solution installation and deployment technologies along with Macrovision's FLEXnet Publisher Installation Module (FNPIM) to provide packaging and installation of the bundles.
The following bundles are available in the Autonomic Computing Toolkit:
The following sections describe each of the available bundles in detail.
This bundle contains all the pertinent autonomic computing references, documentation, and tutorials that describe the Autonomic Computing Toolkit. It is a good starting point for those who want to find out more about autonomic computing and the Autonomic Computing Toolkit. Much of the content provided here is available in HTML-viewable format on the Autonomic Computing Toolkit Web site at:
www.ibm.com/developerworks/autonomic
This bundle includes documentation only.
The Adobe reader is a prerequisite. It can be obtained from the Adobe Website at www.adobe.com/products/acrobat/readstep2.html.
This documentation describes the Autonomic Computing Toolkit as a whole.
This bundle contains the AME component. For more information on AME, see Autonomic management engine.
This bundle includes:
If installing AME in Web service mode, then you must install the Embedded Version of IBM WebSphere Express bundle first, or already have WebSphere 6.0 Base installed. If installing AME in stand-alone mode, this bundle has no prerequisites.
The following bundles are related:
This bundle contains the Integrated Solutions Console component. For more information on the Integrated Solutions Console, see Integrated Solutions Console.
This bundle includes:
The Integrated Solutions Console requires that your system have a Domain Name System (DNS) entry and that the host name can be resolved. If your system does not have a DNS entry, you can update the following line in the host's file:
127.0.0.1 your.server.name
where your.server.name is the name of your server if you do not have a DNS entry for your server.
The following bundles are related:
This bundle contains the GLA and LTA tooling plug-in. For more information on the GLA, see Generic log adapter for autonomic computing. For more information on the LTA tooling plug-in, see Log and Trace Analyzer.
This bundle includes:
The GLA and LTA plug-ins require Eclipse 3.0.3. Eclipse 3.0.3 can be obtained from the Eclipse Tooling bundle.
The following bundles are related:
This bundle contains the runtime needed to produce Common Base Events from log files based on user-written rules. Predefined rule sets are also provided for various IBM products. For more information on the GLA, see Generic log adapter for autonomic computing.
This bundle includes:
If installing GLA to use Web service mode to send Common Base Events to AME, then the Embedded Version of IBM WebSphere Express bundle must be installed first, or already have WebSphere 6.0 Base installed.
The following bundles are related:
This bundle contains the Remote Agent Controller (RAC) for multiple platforms to allow processing of remote log files using the Log Trace Analyzer tool. For more information on RAC, see Agent controller.
The RAC is packaged as a single .zip file. The RAC is provided in the Autonomic Computing Toolkit as a single package which includes support for the following runtimes:
None
This bundle can be used with the GLA and the Log Trace Analyzer Tooling bundle (See Generic Log Adapter and Log and Trace Analyzer Tooling plug-ins) and with the GLA Runtime and Rule Sets bundle.
This bundle contains the base Eclipse needed to run the Autonomic Computing Toolkit tooling plug-ins.
This bundle includes:
None.
The GLA/LTA tooling bundle (page "Generic Log Adapter and Log and Trace Analyzer Tooling plug-ins") and the RMB bundle (page "Resource Model Builder") are provided as plug-ins to an Eclipse base. If the user does not already have an Eclipse 3.0.3 environment installed, then these bundles provide the necessary base tooling support.
This bundle contains the Web services stack needed by GLA and AME to pass Common Base Events asynchronously in a control loop as demonstrated in the Problem Determination scenario. For more information on AME, see "Autonomic Management Engine", and for more information on GLA, see "Generic log adapter for autonomic computing".
This bundle includes:
None.
The following bundles are related:
This bundle contains the Resource Model Builder (RMB) component plug-in. For more information on RMB and AME resource models see Autonomic management engine
This bundle includes:
This RMB plug-in requires Eclipse 3.0.3. Eclipse 3.0.3 can be obtained from the Eclipse Tooling bundle.
The following bundles are related:
This bundle contains the Problem Determination scenario. For more information on the Problem Determination scenario, see Problem Determination scenario.
This bundle includes:
You must have the following components installed in order to use this bundle:
This bundle uses technologies contained in the following bundles:
This bundle contains the Solution Installation and Deployment scenario using FNPIM. For more information on this scenario, see Automated installation scenarios.
This bundle is comprised of a single executable that installs the scenario, which includes:
None.
The following bundles are related:
This bundle contains the Solution Installation and Deployment scenario using InstallAnywhere. For more information on this scenario, see Automated installation scenarios.
This bundle is comprised of a single executable that installs the scenario, which includes:
None.
The following bundles are related:
Solution Installation and Deployment samples are related samples of solution installation features that are demonstrated and controlled using the AC Toolkit Integrated Solutions Console component plug-in.
This bundle includes:
Integrated Solution Console (not required if running the samples from command line mode)
The following bundles are related:
When you are ready to try using a tool, technology, or scenario from the Autonomic Computing Toolkit, you will need to decide which bundle you need, ensure that you have the required prerequisites, and then download the code from the developerWorks Web site at:
www.ibm.com/developerworks/autonomic
To download the code, perform the following steps:
If you have any trouble with this process, post a question to the support forum.
Before you use the forum for the first time, you will need to create a user ID and password, but you will be able to reuse this ID each time you post to the forum.
This section describes installing the Autonomic Computing Toolkit bundles.
The Autonomic Computing Toolkit bundles are generally installed the same way for consistency. However, some bundles contain single components, whereas others contain multiple components, which means the installations are presented differently.
Bundles are executable files utilizing the solution installation and deployment technologies that perform their own installation; this helps create consistent installations and minimizes user error. The Solution Installation and Deployment component is installed only on the first Autonomic Computing Toolkit bundle, and then is reused on subsequent installations.
Registration information is logged into the Solution Installation and Deployment registry when you install the bundles. This registry information is then used for future installations and dependency checking.
The following items are required to run the Autonomic Computing Toolkit:
Table 1. Disk space needed for installations
| Component | Disk space required | Temp space required |
|---|---|---|
| Agent Controller | 314 MB | NA |
| Autonomic Management Engine | 65 MB | 130 MB |
| Eclipse tooling | 93 MB | 130 MB |
| IBM WebSphere Express | 223 MB | 320 MB |
| GLA/Log Trace Analyzer tooling plug-ins | 52 MB | NA |
| GLA Runtime/Rule Sets | 23 MB | 130 MB |
| Integrated Solutions Console (Win, Linux, AIX, Solaris) | 1.48 GB | 727 MB |
| Integrated Solutions Console (OS 400) | 835 MB | 28 MB |
| Problem Determination scenario | 25 MB | 130 MB |
| Resource Model Builder plug-in | 16 MB | NA |
| Solution Installation and Deployment Samples scenario | 7 MB | 130 MB |
| Solution Installation and Deployment scenario using InstallAnywhere | 2 MB | 130 MB |
| Solution Installation and Deployment scenario using FNPIM | 8 MB | 130 MB |
For information on Supported platforms and the Application server, go to www.ibm.com/developerworks/autonomic/table.html.
To install an Autonomic Computing Toolkit bundle, perform the following steps:
www.ibm.com/developerworks/autonomic
To uninstall an Autonomic Computing Toolkit on Windows platforms, perform the following steps:
To uninstall an Autonomic Computing Toolkit bundle for Linux, Solaris and AIX platforms, perform the following steps:
On the OS/400 platform, only command line installation is supported. The installer for this platform is a JAR file. Follow the instructions below for installation and uninstallation.
Java --jar <jar file name>
Follow the instructions.
Java --jar <install-location>/_uninst/uninstalljar
Follow the instructions.
The Autonomic Computing Toolkit includes an abundance of documentation. Most of the publications and all of the tutorials are available on the Autonomic Computing Toolkit Web site at:
www.ibm.com/developerworks/autonomic
The recommended document flow is shown in Figure 3. The documentation will be most helpful if you begin with the Autonomic Computing Toolkit User's Guide (this guide) and work your way through the publications as shown below.
Figure 3. Recommended document flow

The following information is available on autonomic computing:
The following information is available on the Autonomic Computing Toolkit:
The following documentation is available on AME:
The following documentation is available on Integrated Solutions Console:
The following documentation is available on the Solution Installation and Deployment technologies:
The following documentation is available on the GLA and the LTA:
In addition to the technologies available in the Autonomic Computing Toolkit, IBM continues to make available products and offerings which include autonomic technologies that help you add self-management capabilities to your IT solutions. An example of such a technology is the Enterprise Workload Manager (EWLM), which provides self-optimizing capabilities. Enterprise Workload Manager, EWLM, enables customers to identify work requests based on service class definitions, track performance of those requests across server and subsystem boundaries, and manage the underlying physical and network resources to achieve specified performance goals for service class. Consequently, EWLM provides the IT resource management capability to manage existing resources based on business priority requirements and enables end to end performance monitoring and management among servers or among logical partitions. The following documentation is available on the EWLM:
If you need help, service, technical assistance, or just want more information about IBM products, you will find a wide variety of sources available from IBM to assist you.
IBM maintains pages on the World Wide Web where you can get information about IBM products and services and find the latest technical information.
If you need help using the Autonomic Computing Toolkit, use the support forum on the developerWorks Web site at:
www.ibm.com/developerworks/autonomic
This publication was developed for products and services offered in the U.S.A.
IBM(R) may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this publication to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product, and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
The following are trademarks of International Business Machines Corporation
in the United States, other countries, or both:
|
| AIX | PS/2 |
|
| BladeCenter | Redbooks |
|
| Chipkill | ServerProven |
|
| eServer | TechConnect |
|
| the IBM logo | X-Architecture |
|
| Lotus | xSeries |
|
| Predictive Failure Analysis |
|
Intel and Xeon are trademarks of Intel Corporation in the United States, other countries, or both.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Other company, product, or service names may be trademarks or service marks of others.
Processor speeds indicate the internal clock speed of the microprocessor; other factors also affect application performance.
CD-ROM drive speeds list the variable read rate. Actual speeds vary and are often less than the maximum possible.
When referring to processor storage, real and virtual storage, or channel volume, KB stands for approximately 1000 bytes, MB stands for approximately 1 000,000 bytes, and GB stands for approximately 1 000,000,000 bytes.
When referring to hard-disk-drive capacity or communications volume, MB stands for 1 000 000 bytes, and GB stands for 1 000,000,000 bytes. Total user-accessible capacity may vary depending on operating environments.
Maximum internal hard-disk-drive capacities assume the replacement of any standard hard disk drives and population of all hard-disk-drive bays with the largest currently supported drives available from IBM.
Maximum memory may require replacement of the standard memory with an optional memory module.
IBM makes no representation or warranties regarding non-IBM products and services that are in the ServerProven(R) program, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. These products are offered and warranted solely by third parties.
IBM makes no representations or warranties with respect to non-IBM products. Support (if any) for the non-IBM products is provided by the third party, not IBM.
Some software may differ from its retail version (if available), and may not include user manuals or all program functionality.