Agent Controller is a daemon that allows client applications to launch and manage local or remote applications and provides information about running applications to other applications. You must install Agent Controller separately before you can use the following tools:
Notes:
Refer to the instructions below for more information on silently installing Agent Controller.
Note for Linux: The Agent Controller is compiled using libstdc++-libc6.2-2.so.3 shared library. Ensure that this shared library exists under the /usr/lib directory. If it does not exist, you have to install the RPM package compat-libstdc++ that comes with the operating system installation media.
Agent Controller 8.0.2 has been tested on
the following platforms:
|
OS |
Processor Architecture |
JRE |
1 |
AIX v5.2, v5.3, and 5L |
PowerPC (32-bit) |
J2RE 1.4.1 IBM AIX build ca1411-20040301 |
2 |
AIX v5.2, v5.3, and 5L |
PowerPC (32-bit) |
J2RE 1.5.0 IBM AIX build pap32devifx-20060310 (SR1) |
3 |
Linux Red Hat Advanced Server v2.1 |
Intel x86 (32-bit) |
BEA JRockit v5.0 Update 6 |
4 |
Linux Red Hat Enterprise Linux (RHEL) AS v2.1 with 2.4.9-e.57 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Linux on Intel architecture, Java 2
Technology Edition v1.4.2 SR8 |
5 |
Linux Red Hat Enterprise Linux (RHEL) AS v2.1 with 2.4.9-e.57 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Linux on Intel architecture, Java 2
Technology Edition v1.5.0 SR5 |
6 |
Linux SuSE Enterprise Server (SLES) v9 with 2.6.5-7.97 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Linux on Intel architecture, Java 2
Technology Edition v1.4.2 SR8 |
7 |
Linux SuSE Enterprise Server (SLES) v9 with 2.6.5-7.97 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Linux on Intel architecture, Java 2
Technology Edition v1.5.0 SR5 |
8 |
Windows |
Intel x86 (32-bit) |
IBM 32-bit SDK for Windows, Java 2 Technology Edition v1.4.2 SR8 |
9 |
Windows Vista |
Intel x86 (32-bit) |
IBM 32-bit SDK for Windows, Java 2 Technology Edition v1.5.0 SR5 |
10 |
Windows Vista |
Intel x86 (32-bit) |
Sun Java 2 Runtime Environment, Standard Edition v1.4.2 Update 14 |
11 |
Windows Vista |
Intel x86 (32-bit) |
Sun Java 2 Runtime Environment, Standard Edition v1.5.0 Update 11 |
12 |
Windows XP with SP2 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Windows, Java 2 Technology Edition v1.4.2 SR8 |
13 |
Windows XP with SP2 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Windows, Java 2 Technology Edition v1.5.0 SR5 |
14 |
Windows XP with SP2 |
Intel x86 (32-bit) |
IBM 32-bit SDK for Windows, Java 2 Technology Edition v1.6 SR1 |
15 |
Windows XP with SP2 |
Intel x86 (32-bit) |
Sun Java 2 Runtime Environment, Standard Edition v1.4.2 Update 14 |
16 |
Windows XP with SP2 |
Intel x86 (32-bit) |
Sun Java 2 Runtime Environment, Standard Edition v1.5.0 Update 11 |
In general, Agent Controller works with JavaTM Virtual Machine (JVM) version 1.5 and above. Here are the JVM versions (java -fullversion) that Agent Controller has been tested on:
Note:
Starting from RAC 8.0.0, you do not need to uninstall the previous version of Agent Controller before installing the new version anymore. However, RAC v8.0.2 will not start if another installed RAC server is running.
In order to install RAC 8.0.2, you need to install IBM Installation Manager (IM) 1.2 and RAC 8.0.0/8.0.1 first. Then you can upgrade RAC to RAC 8.0.2 using IM.
If you don't have IM installed, then you can install RAC 8.0.2 from the RAC 8.0.2 zip file. This would install both IM 1.2 and RAC 8.0.2 for you.
If you are working on Linux or AIX and don't have access to the GUI, you can following the instruction in Install Agent Controller sliently.
Under Access List, the choices are:
Under WebSphere Application Server, select the version you want to use.
Under Security, the choices are:
If you selected "Any computer" in Access List, then security is disabled by default.
Click Next to proceed.
Agent Controller 8.0.2 is bundled with IBM JDK 1.6
SP1 for win_ia32 and linux_ia32. The
IBM JDK will be installed under <
If you don't have access to GUI on a AIX or Linux machine, or you don't want to invoke the GUI, you can follow these steps to install RAC 8.0.2 silently from the zip file
<agent-input acceptLicense='true' clean='true'>
This would install IM under /opt/IBM/InstallationManager and its associated data files under /var/ibm/InstallationManager for non-Windows platforms.
./install -silent -nosplash -input <path to input file> -log <path to the log file>
Here is a sample input file to install RAC 8.0.2. You need to update it with the correct path on your machine:
<agent-input acceptLicense='true' clean='true' >
<server>
<repository location='/home/john/RAC8/RAC/disk1/diskTag.inf'/>
</server>
<profile installLocation='/opt/IBM/SDP' id='IBM Rational Agent Controller'>
<data key='eclipseLocation' value='/opt/IBM/SDP'/>
<data key='cic.selector.nl' value='en'/>
<data key='user.RAC_DefaultType,com.ibm.rational.agent.controller' value='DEFAULT'/>
<data key='user.RAC_WASType,com.ibm.rational.agent.controller' value='NONE'/>
<data key='user.RAC_WAS_HOME_V51,com.ibm.rational.agent.controller' value=''/>
<data key='user.RAC_WAS_HOME_V5,com.ibm.rational.agent.controller' value=''/>
<data key='user.RAC_ALLOW,com.ibm.rational.agent.controller' value='ALL'/>
<data key='user.RAC_HOSTS,com.ibm.rational.agent.controller' value=''/>
<data key='user.RAC_SECURITY,com.ibm.rational.agent.controller' value='false'/>
<data key='user.RAC_USERS,com.ibm.rational.agent.controller' value=''/>
</profile>
<install modify='false'>
<offering profile='IBM Rational Agent Controller' version='8.0.2.20080919_0411' features='rac feature' id='com.ibm.rational.agent.controller'/>
</install>
<preference value='/opt/IBM/SDPShared' name='com.ibm.cic.common.core.preferences.eclipseCache'/>
<preference value='30' name='com.ibm.cic.common.core.preferences.connectTimeout'/>
<preference value='30' name='com.ibm.cic.common.core.preferences.readTimeout'/>
<preference value='0' name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount'/>
<preference value='true' name='offering.service.repositories.areUsed'/>
<preference value='false' name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode'/>
<preference value='true' name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts'/>
<preference value='false' name='PassportAdvantageIsEnabled'/>
</agent-input>
RAC 8.0.2 installation no longer installs RAC as a Windows service. However, you can do it by following the instruction in the geting _started.html in <RAC install dir>. You can uses the RAStart.bat and RAStop.bat under <RAC install dir>>\bin to start and stop RAC.
Please refer to geting _started.html for more information on this topic.
On non-Windows platforms, the Agent Controller process (RAServer) does not start automatically. You must start it yourself.
./RAStart.sh
./RAStop.sh
Please refer to geting _started.html for more information on this topic.
If you want to uninstall RAC 8.0.2 without invoking the GUI, you can use the silent mode.
./launcher -silent -nosplash -input <uninstall input file> -log <uninstall log file>
Here is a sample input file to uninstall RAC 8.0.2.
You need to update it with the correct path on your machine:
<?xml version="1.0"
encoding="UTF-8"?>
<agent-input>
<uninstall modify='false'>
<offering profile='IBM Rational Agent Controller'
version='8.0.2.20080919_0411' features='rac feature'
id='com.ibm.rational.agent.controller'/>
</uninstall>
<preference value='/opt/IBM/IBMIMShared'
name='com.ibm.cic.common.core.preferences.eclipseCache'/>
<preference value='30'
name='com.ibm.cic.common.core.preferences.connectTimeout'/>
<preference value='30'
name='com.ibm.cic.common.core.preferences.readTimeout'/>
<preference value='0'
name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount'/>
<preference value='true'
name='offering.service.repositories.areUsed'/>
<preference value='false'
name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode'/>
<preference value='true'
name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts'/>
<preference value='false'
name='PassportAdvantageIsEnabled'/>
</agent-input>
Agent Controller version 8.0.2 prevents mutliple instances of the product from being installed on a single workstation. When additional installations are performed, either by stand-alone install or as an embedded install inside a product, Agent Controller records a reference to the name of the product that is initiating the new installation.
If Agent Controller has been installed multiple times - in other words, there are multiple reference counts - either by stand-alone install or as an embedded install inside a product, it can be uninstalled only when the last referencing product is uninstalled; the last referencing product still requires Agent Controller.
If you attempt to uninstall Agent Controller while it is still required by another product, the uninstallation will not proceed and you will receive a message "This product cannot be uninstalled as it is required by another product."
The following list contains hints and tips for using the Agent Controller security feature on all platforms:
1. Authentication is provided by the operating system. Only users specified at installation time will be allowed to authenticate. If the user name ANY is provided, any valid user name and password pairs will be forwarded to the operation system for authentication, otherwise only listed pairs will be forwarded.
2. When security is enabled, the users you specified at installation time are required to authenticate with the operating system before any information can be exchanged with Agent Controller. The workbench user must provide a valid user name and password combination that is an operating system user name and password.
3. (Windows only) Domain name passwords will not be authenticated. You must provide local user name and password pairs.
4. There are no key management capabilities provided. Agent Controller uses Java keystores for security.
5. A default keystore and exported certificate are in the Agent Controller directory <rac_install_dir>\security for Windows, and <rac_install_dir>/security for Linux. Where <rac_install_dir> is the installation directory of Agent Controller.These are samples only. You should replace these with a keystore containing meaningful certificates.
In Agent Controller 6.0.0.1 (and earlier), communication between the workbench and Agent Controller was conducted through two channels:
Only the former of these, the control channel, could be encrypted by turning on the security feature. Information on the data channel was always unencrypted. Also, only the control channel could negotiate firewalls between the workbench and Agent Controller.
In version 6.0.1, Agent Controller introduces the notion of multiplex mode, in which data collected from agents can be communicated back to the workbench along the control channel, which can be optionally encrypted and can negotiate firewalls.
This raises some compatibility matters: Can you use an earlier workbench (specifically version 6.0.0.1) with a newer Agent Controller (version 6.0.1 or later)? In general the answer is ‘Yes’, but not if you want to take advantage of the multiplexing features in version 6.0.1 or later. That is, if you want to use the multiplex mode so that the channel that your data is using is encrypted and can negotiate firewalls, then you must also upgrade the workbench to version 6.0.1 or later.
Backward compatibility (using an older workbench with a version 6.0.1 Agent Controller): Yes, they are compatible, in that the new Agent Controller supports all the features in previous versions (for example, Security on the control channel). However, you will not be able to use new features, including multiplexing (returning data via the control channel so that it can be secure).
Forward compatibility (using a 6.0.1 or later workbench with an older Agent Controller): No, in general, is not supported.
Cross-version Inter-Agent-Controller compatibility: Some products or tools (such as IBM Performance Optimization Toolkit) require that Agent Controllers on multiple hosts (apart from the workbench) "discover" and communicate with each other. Changes made from one version to the next surrounding this function mean that if you need to use this function, you must use either Agent Controller version 6.0.0.1 or Agent Controller version 6.0.1 or later on all involved hosts. That is, you cannot mix and match versions when using dynamic discovery between Agent Controller instances.
This section covers known problems and limitations related to installing and uninstalling Agent Controller. Except where otherwise noted, the following information applies to all operating systems that are supported for Agent Controller.
Agent Controller may fail to start on non-Windows platforms with the following message:
RAServer failed to start.
This failure is usually caused when TCP/IP port 10002 is not free. Agent Controller listens on this port by default. Another process running on the system may be using this port when Agent Controller is started or perhaps Agent Controller was just stopped and then restarted before the port could be released.
If Agent Controller failed to start, you can start it as follows:
Note:
If the communication port number that is configured in the serviceconfig.xml file has been changed, then the property INSTANCE_RAC_PORT_NUM_ID that is defined in the WebSphere Application Server configuration needs to be changed to the same port number.
If you encounter errors during installation or uninstallation, this may be due to the fact that the object files of Agent Controller are loaded by running processes. To ensure the object files can be modified, do the following:
This information was developed for products and services offered in the U.S.A.
IBM 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 grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingFor license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia CorporationThe following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: 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 states 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 information 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.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM CorporationSuch information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2008. All rights reserved.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Programming interface information is intended to help you create application software using this program.
General-use programming interfaces allow you to write application software that obtain the services of this program's tools.
However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.
Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.
The following terms are trademarks of the IBM Corporation in the United States or other countries or both:
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
Intel, Intel Xeon, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product, or service names may be
trademarks or service marks of others.
(C) Copyright IBM Corporation 2000, 2008. All Rights Reserved.