ITCAM for SOA 7.2 Fix Pack 1

Installing, upgrading, or updating the monitoring agent

To install, upgrade, or update ITCAM for SOA on a supported Linux and UNIX operating system, complete the following steps on each Linux or UNIX computer system where you plan to monitor services. See the Tivoli® Monitoring documentation for general procedures for installing monitoring agents on these operating systems. If you are installing, upgrading, or updating a monitoring agent on a computer system where Tivoli Monitoring components are already installed, you must also install application support files as part of the installation procedure.
Tip:
  • In the installation process, if you are upgrading to ITCAM for SOA version 7.2, the ITCAM for SOA monitoring agent is displayed as IBM Tivoli Composite Application Manager for SOA V07.20.00.00.
  • If you are installing or updating to ITCAM for SOA version 7.2 Fix Pack 1, the ITCAM for SOA monitoring agent is displayed as IBM Tivoli Composite Application Manager for SOA V07.20.01.00.
  1. Mount the ITCAM for SOA installation media at the location you choose for the local system, following the standard procedures for your operating system.
  2. From the root directory of the installation media, enter the following command to start the installation program: ./install.sh
  3. When prompted for the Tivoli Monitoring home directory, press Enter to accept the default (/opt/IBM/ITM) or type the full path to the installation directory that you used. Type 1 and press Enter when you see OK to use it.
    Remember: If you are installing over an existing installation, you must use the existing installation directory.
  4. The following prompt is displayed: 
    Select one of the following:
1) Install products to the local host.
2) Install products to depot for remote deployment (requires TEMS).
3) Install TEMS support for remote seeding
4) Exit install.
Please enter a valid number:
  5. Type 1 to start the installation and press Enter.
  6. The software license agreement is displayed after the initialization. Enter 1 to accept the agreement and press Enter.
  7. If you are performing a pristine installation on a system where no Tivoli Monitoring components are installed, you are prompted to type a 32 character key for encrypting your Secure Socket Layer (SSL) connections with Tivoli Enterprise Monitoring Server to protect sensitive data that is being transmitted. This key must be the same key that is specified during the installation of the Tivoli Enterprise Monitoring Server to which this monitoring agent connects.
  8. If you are upgrading, you are prompted with a list of prerequisites to install. Enter 1 to install these prerequisites:
    Do you want to install these prerequisites [ 1=Yes, 2=No ; default is "1" ] ?1
  9. A numbered list of available operating systems is displayed:
    Product packages are available for this operating system and 
    component support categories:

	1) IBM Tivoli Monitoring components for this operating system
 2) Tivoli Enterprise Portal Browser Client support
 3) Tivoli Enterprise Portal Desktop Client support
 4) Tivoli Enterprise Portal Server support
 5) Tivoli Enterprise Monitoring Server support
 6) Other operating systems
Type the number or type "q" to quit selection
  10. Type 1 and press Enter.
  11. Type 1 to confirm and press Enter.
  12. A numbered list of available agents is displayed.

    When you install on a supported Linux x86-64 operating system, you select either the ITCAM for SOA V07.20.00.00 for Linux AMD64 R2.6 (64 bit) or ITCAM for SOA V07.20.01.00 for Linux AMD64 R2.6 (64 bit) option. The version you select depends on whether you are upgrading to version 7.2 or you are installing or upgrading to version 7.2 Fix Pack 1 of ITCAM for SOA.

    Find the IBM® Tivoli Composite Application Manager for SOA agent and type the corresponding number and press Enter.

  13. You are asked to confirm your selection. For example:
    The following products will be installed:

	IBM Tivoli Composite Application Manager for SOA V07.20.01.00

Are you selections correct [1=Yes, 2=No ; default is "1"]
    Type 1 to confirm your selection.
  14. If the installer detects that the same version of the ITCAM for SOA agent exists on the computer system, it prompts you to confirm that you want to replace it.
  15. The installation begins. A progress message is displayed while the agent is being installed. For example:
    ... installing "IBM Tivoli Composite Application Manager for SOA 
    V07.20.01.00..."
  16. When all of the components are installed, you are asked if you want to install additional products or application support files:
    Do you want to install additional products or product support packages 
    [ 1=Yes, 2=No ; default is "2" ] ?
  17. If you want to install the Data Collector for WebSphere® Message Broker, type 1. Otherwise, accept the default response of 2, press Enter, and skip to step 24.
    Before you install the data collector, verify that the data collector is not already installed as part of ITCAM for Transactions.
  18. A numbered list of agents and components is displayed.

    Find the Data Collector for WebSphere Message Broker component and type the corresponding number and press Enter.

  19. You are asked to confirm your selection. For example:
    The following products will be installed:

	Data Collector for WebSphere Message Broker V07.40.00.00 

Are you selections correct [1=Yes, 2=No ; default is "1"]
    Type 1 to confirm your selection.
  20. If the installer detects that the same version of the Data Collector for WebSphere Message Broker exists on the computer system, it prompts you to confirm that you want to replace it.
  21. The installation begins. A progress message is displayed while the data collector is being installed:
    ... installing "Data Collector for WebSphere Message Broker
V07.40.00.00..."
  22. When the data collector is installed, you are asked if you want to install additional products or application support files:
  23. Do you want to install additional products or product support packages 
    [ 1=Yes, 2=No ; default is "2" ] ?
  24. If you are installing application support files as part of your installation of the monitoring agent, type 1. Otherwise, accept the default response of 2, press Enter, and skip to step 46.
  25. The numbered list of available operating systems and installation components is displayed. Select the option to install application support for the monitoring server and press Enter.
  26. Type 1 to confirm and press Enter.
  27. The list of the components that are available for the installation of application support for the monitoring server is displayed. For example:
    The following application supports are available for installation:

1) IBM Tivoli Composite Application Manager for SOA V07.20.01.00
2) all of the above.
  28. Enter the number that represents all components and press Enter.
  29. Type 1 to confirm the installation of application support for the monitoring server. The installation begins.
  30. When all of the components are installed, you are asked whether you want to install components for a different operating system. For example:
    Do you want to install additional products or product 
    support packages [ 1=Yes, 2=No ; deafult is "2" ] ?
    Enter 1 to install application support for additional components.
  31. The numbered list of available operating systems and installation components is displayed. Select the option to install application support for the portal server and press Enter.
  32. Type 1 to confirm and press Enter.
  33. The list of the components that are available for the installation of application support for the portal server is displayed.
  34. Enter the number that represents all components and press Enter.
  35. Type 1 to confirm the installation of application support for the portal server. The installation begins.
  36. When all of the components are installed, you are prompted to install components for a different operating system.
    Enter 1 to install application support for additional components.
  37. The numbered list of available operating systems and installation components is displayed. Type 2 to install application support for the browser client or type 3 to install application support for the desktop client and press Enter.
  38. Type 1 to confirm and press Enter.
  39. The list of the components available for the installation of application support for the browser or desktop client is displayed.
  40. Enter the number that represents all components and press Enter.
  41. Type 1 to confirm the installation of application support for the portal server. The installation begins.
  42. When all of the components are installed, you are prompted to install components for a different operating system. Type 2 to confirm that no additional components are to be installed and press Enter.
  43. When the installation program completes, you see a message that indicates that the application support files are installed:
    Following Tivoli Enterprise Monitoring Server product support were installed:
  *) ITCAM for SOA
Note: This operation causes the monitoring server to restart.
  44. You are asked whether you want to seed application support on the Tivoli Enterprise Monitoring Server:
    Do you want to seed product support on the Tivoli Enterprise Monitoring Server?
     [ 1=Yes, 2=No ; default is "1" ] ?
    Enter 1 to automatically seed the monitoring agent with the monitoring server.
  45. If you are installing application support files as part of the installation or upgrade of the agent, you are prompted to add the default managed system groups to monitoring agents situations:
    Choose one of the following options to add or update the situation 
    distribution definition to include the default 
    managed system groups:

 1) ALL - This option adds the default managed system groups to all 
    the applicable situations. Note that not all situations have 
     the default managed group setting. For some, you 
    might need to manually define the distribution in the Tivoli
     Enterprise Portal due to the specific content 
    of the agent support package.
 2) NONE - The default managed system group is not added to any situation.

    The All selection provides an option to add the default managed system groups to all applicable situations. Enter 1 to add the default managed system groups to all applicable situations and press Enter.

  46. The installation program completes the installation and exits.
  47. The installer detects that some additional procedures might have to be performed and presents a message that indicates that a data collector might have to be installed and configured.
    Installation step complete.
Installer has found additional procedures for following products:
 *)  ITCAM for SOA

These procedures will be run now.

Calling exit point for ITCAM for SOA:
  48. The Data Collector Configuration utility automatically starts in console mode to configure your data collector and prompts you to select a language to use for the Data Collector Configuration utility:
    Select a language to be used for this wizard.

[X] 1  - English
[ ] 2  - French
[ ] 3  - German
[ ] 4  - Italian
[ ] 5  - Japanese
[ ] 6  - Korean
[ ] 7  - Portuguese (Brazil)
[ ] 8  - Simplified Chinese
[ ] 9  - Spanish
[ ] 10 - Traditional Chinese

To select an item enter its number, or 0 when you are finished: [0]
    Enter the number that represents the language to use and selected Enter.
  49. The Data Collector Configuration utility welcome window is displayed:
    Data Collector Configuration Utility - InstallShield Wizard - Console Mode

Welcome to the InstallShield Wizard for the Data Collector Configuration
Utility. The Data Collector Configuration Utility helps you to enable or
disable data collection in your supported runtime environments. To continue,
choose Next.
Data Collector Configuration Utility
IBM
http://www.ibm.com


Press 1 for Next, 3 to Cancel or 5 to Redisplay [1]
  50. Enter 1 to proceed to the next step. The list of runtime environments for which data collection can be configured are displayed:
    Data Collector Configuration Utility - InstallShield Wizard - Console Mode

   1. IBM WebSphere Application Server
   3. BEA WebLogic Server
   4. JBoss
   5. SAP NetWeaver
   6. WebSphere Message Broker
   7. Configure Transaction Tracking settings
   8. DataPower SOA Appliance
   9. WebSphere Community Edition

   10. Exit the Data Collector Configuration Utility.

Select the runtime environment to enable or disable for data collection: 1

Press 1 for Next, 3 to Cancel or 5 to Redisplay [1]
    Tip: You cannot configure Data Collector for WebSphere Message Broker with this utility. The option WebSphere Message Broker is provided for disabling a previous version of the WebSphere Message Broker data collector.
  51. If you are upgrading to ITCAM for SOA 7.2, or you want to postpone the configuration of data collectors, you can enter 2 to cancel and skip to step Verify completion of installation procedure to complete the installation task.

    If you are updating to ITCAM for SOA version 7.2 Fix Pack 1 and you are configuring data collection for a WebSphere Application Server environment, enter 1 to install and configure the ITCAM Data Collector for Websphere and press Enter.

    The ITCAM Data Collector for WebSphere in ITCAM for SOA version 7.2 and later is a component that is shared with the following products:
    • ITCAM Agent for WebSphere Applications version 7.2
    • ITCAM for WebSphere Application Server version 7.2 support for WebSphere Application Server version 8.5
    • IBM Application Performance Diagnostics Lite
    • ITCAM for Transactions
    If ITCAM Agent for WebSphere Applications version 7.2 is already installed under the ITM_home directory or if you are performing a reinstallation, the same version, release, and maintenance level of the ITCAM Data Collector for WebSphere might be installed under ITM_home. If the installer detects that the ITCAM Data Collector for WebSphere is already installed under ITM_home, the installation of the data collector is skipped and the data collector configuration utility is displayed. Skip to step Step 19: Configure the ITCAM Data Collector for WebSphere.
    Remember: The same version, release, and maintenance level of ITCAM Data Collector for WebSphere might be installed and configured for the same WebSphere profile, but the data collector installation might not be under the ITM_home directory:
    • If the data collector is installed by WebSphere Application Server version 7.2 support for WebSphere Application Server version 8.5 or Application Performance Diagnostics Lite, the data collector installation is outside of the ITM_home directory. The installer does not detect that the data collector already exists. When prompted, you must specify the location of the data collector installation.
    • If the data collector is installed by ITCAM Agent for WebSphere Applications version 7.2 outside of ITM_home, the installer does not detect that the data collector exists. When prompted, you must specify the location of the data collector installation.
  52. When the same version, release, and maintenance level of the data collector is not already installed under the ITM_home directory, the installer opens a command prompt window.
    The installer prompts you to specify whether you want to:
    • Install the data collector in the DC_home directory (default install)
    • Reuse an existing data collector home directory (custom install)
    • Create a new data collector home directory (custom install)
    Choose the type of install to perform.
      1. default install
      2. custom install
[default is: 1]:

    Enter 1 to install the data collector in the DC_home directory.

    Otherwise, enter 2 and specify the location of the data collector home directory. If the installer finds that the data collector home directory does not exist, it asks you whether you want to create the directory.
    Directory /opt/IBM/ITM/dchome/7.2.0.0.4 does not exist.  Is it ok to create? 
[1 - YES, 2 - NO]

    Enter 1 to create the directory. If you enter 2, you can enter a different data collector home directory or exit the command prompt.

    Restriction: You must not install the data collector in the same directory where version 7.1.1 of the ITCAM for SOA WebSphere Application Server data collector is installed.

    If the data collector installation does not already exist, the installer starts the installation of the data collector.

  53. The installer starts the ITCAM Data Collector for WebSphere Configuration utility.

    If you are configuring the data collector only for an ITCAM for SOA environment, you must integrate the data collector at least with ITCAM for SOA, and optionally, integrate the data collector with ITCAM for Transactions. For description of the steps to follow when configuring the data collector with the ITCAM Data Collector for WebSphere Configuration utility, see Configuring ITCAM Data Collector for WebSphere.

    If you are installing ITCAM for SOA and you want to postpone the configuration of the ITCAM Data Collector for WebSphere until later, you can exit the utility. At a later time, use the ITCAM Data Collector for WebSphere Configuration utility to configure the data collector.

    If the data collector component of an older version of any of the following products is configured within the same profile, exit the utility, and migrate the data collector:
    • Older versions of the ITCAM Agent for WebSphere Applications, including:
      • ITCAM Agent for WebSphere Applications version 7.1
      • ITCAM for WebSphere version 6.1.0.4 or later
      • WebSphere Data Collector version 6.1.0.4 or later component of ITCAM for Web Resources version 6.2.0.4 or later
    • ITCAM for WebSphere Application Server version 7.2
    For the migration procedure, see Migrating data collectors to ITCAM Data Collector for WebSphere.

    If an older version of ITCAM for SOA is configured for the same profile, exit the utility, and migrate the data collector (see Migrating data collectors to ITCAM Data Collector for WebSphere).

    If an earlier maintenance level of the ITCAM Data Collector for WebSphere is configured for the same profile, exit the utility, and migrate the data collector (see Migrating data collectors to ITCAM Data Collector for WebSphere.

    For a description of considerations when you install and configure IBM Business Process Monitoring considerations, an overview of installation and upgrade scenarios, and procedures for running the configuration utilities in interactive and silent modes, see Configuring data collection: WebSphere Application Server.

Parent topic: Installing, upgrading, and updating the monitoring agents and data collectors

Feedback