IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Add ITCAM Agent for WebSphere Applications remotely using command line - WAS agent


Overview

You can use the tacmd CLI on a Tivoli Enterprise Monitoring Server (TEMS) host to install the agent remotely on any host running the IBM Tivoli Monitoring OS Agent.

You can also configure remote TEM monitoring agents usiing the GUI.

Before installing or upgrading the agent, you need to add its installation bundles to the TEMS.

For details on using tacmd, and for other available options (including installation from a remote TEMS), see IBM Tivoli Monitoring Command Reference.


Add the installation bundles

In most cases, it is best practice to add both the Windows bundle and the Linux and UNIX systems bundle to a TEMS host. In this way you will be able to deploy the agent on hosts with both platform types. However, you can choose to add only the Windows bundle or only the Linux and UNIX systems bundle.

Perform the following procedure:

  1. Copy or mount the agent installation images on the TEMS host.

  2. Log on:

      cd ITM_HOME/bin
      ./tacmd.sh login -s localhost -u sysadmin -p password

    Use the password for the SYSADMIN user of IBM Tivoli Monitoring.

  3. To add the installation bundle for Windows target hosts, enter the command:
    ./tacmd addBundles -i path_to_Windows_image/WINDOWS/Deploy -t yn

  4. To add the installation bundle for Linux or UNIX system target hosts:
    ./tacmd addBundles -i path_to_Linux_UNIX_package/unix -t yn


Install the agent on a remote host

To install the agent on a remote host on the TEMS host:

  1. cd ITM_HOME/bin

  2. Log on:

      ./tacmd.sh login -s localhost -u sysadmin -p password

    Use the password for the SYSADMIN user of IBM Tivoli Monitoring.

  3. To list the available Operating System agents on remote hosts, enter the command:
    ./tacmd listSystems -t UX LZ NT
    Find the necessary remote host in the list, and note the name of the Operating System agent on it.

    The Operating System agent must be running. This is indicated by Y in the list. If the Operating System agent on the target host is not running, start it before performing the installation.

  4. To install ITCAM Agent for WebSphere Applications on a remote host, enter the command:
    ./tacmd addSystem -t yn -n OS_agent_name
    OS_agent_name is the name of the Operating System agent, for example, lrtx228:LZ. The node identifier displayed in the Tivoli Enterprise Portal navigation tree will be set to "Primary", and the port for incoming data collector connections will be set to 63335.

    Alternatively, you can install ITCAM Agent for WebSphere Applications on a remote host and configure custom settings for the node identifier and port at the same time. To do this, enter the command:

    ./tacmd addSystem -t yn -n OS_agent_name  --properties 
      CONFIGURATION_TYPE.configure_type="tema_configure" 
      KYN_Tema_Config.KYN_ALT_NODEID="node_id" 
      KYN_Tema_Config.KYN_PORT=port_number
    OS_agent_name is the name of the Operating System agent, for example, lrtx228:LZ.

    node_id is an alternative Node ID for identifying the agent. This identifier that determines how the agent is displayed in the Tivoli Enterprise Portal navigation tree. Default "Primary", used with the host name of the computer where the agent is installed is used.

    port_number is the TCP socket port that the monitoring agent will use to listen for connection requests from the data collectors. Default 63335. The port will only be used for local communication on the host (except if you use the monitoring agent to support data collectors on IBM i hosts, see IBM Tivoli Composite Application Manager: Agent for WebSphere Applications data collector Installation Guide for IBM i).

To monitor the remote deployment status, enter the command:

./tacmd getDeployStatus
When the agent is successfully installed, it will automatically connect to the Tivoli Enterprise Monitoring Server, and the Tivoli Enterprise Portal will show it.


Upgrade the agent on a remote host

To upgrade the agent on a remote host (from the Tivoli Enterprise Monitoring Agent of ITCAM for WebSphere 6.1, or the WebSphere Tivoli Enterprise Monitoring Agent of ITCAM for Web Resources 6.2) on the TEMS host:

  1. cd ITM_HOME/bin

  2. Log on:

      ./tacmd.sh login -s localhost -u sysadmin -p password

    Use the password for the SYSADMIN user of IBM Tivoli Monitoring.

  3. To list the available Operating System agents on remote hosts, enter the command:
    ./tacmd listSystems -t UX LZ NT
    Find the necessary remote host in the list, and note the name of the Operating System agent on it.

    The Operating System agent must be running. This is indicated by Y in the list. If the Operating System agent on the target host is not running, start it before performing the installation.

  4. To install ITCAM Agent for WebSphere Applications on a remote host, enter the command:
    ./tacmd updateagent -t yn -n OS_agent_name
    OS_agent_name is the name of the Operating System agent, for example, lrtx228:LZ.

To monitor the remote deployment status, enter the command:

./tacmd getDeployStatus
When the agent is successfully installed, it will automatically connect to the Tivoli Enterprise Monitoring Server, and the Tivoli Enterprise Portal will show it.


Configure the agent on a remote host

To configure Monitoring Agent settings on a remote host where the agent is installed on the TEMS host:

  1. cd ITM_HOME/bin

  2. Log on:

      ./tacmd.sh login -s localhost -u sysadmin -p password

    Use the password for the SYSADMIN user of IBM Tivoli Monitoring.

  3. To list the available Agents on remote hosts, enter the command:
    ./tacmd listSystems -t yn
    Find the necessary remote host in the list, and note the name of the agent on it.

    The Agent must be running. This is indicated by Y in the list. If the Operating System agent on the target host is not running, start it before performing the installation.

  4. To configure ITCAM Agent for WebSphere Applications on a remote host, enter the command:
    ./tacmd configureSystem --system Agent_name --properties 
      CONFIGURATION_TYPE.configure_type="tema_configure" 
      KYN_Tema_Config.KYN_ALT_NODEID="node_id" 
      KYN_Tema_Config.KYN_PORT=port_number
    Agent_name is the name of ITCAM Agent for WebSphere Applications on the remote host, for example, Primary:tivm40:KYNA;

    node_id is an alternative Node ID for identifying the agent. This identifier that determines how the agent is displayed in the Tivoli Enterprise Portal navigation tree. Default "Primary", used with the host name of the computer where the agent is installed is used.

    port_number is the TCP socket port that the monitoring agent will use to listen for connection requests from the data collectors. Default 63335. The port will only be used for local communication on the host (except if you use the monitoring agent to support data collectors on IBM i hosts, see IBM Tivoli Composite Application Manager: Agent for WebSphere Applications data collector Installation Guide for IBM i).

    Alternatively, you can create a response file with the settings, and then run the tacmd command on the response file. The content of the response file is:

    --system
    Agent_name
    --properties
    CONFIGURATION_TYPE.configure_type="tema_configure"
    KYN_Tema_Config.KYN_ALT_NODEID="node_id"
    KYN_Tema_Config.KYN_PORT=port_number
    For example:
    --system
    Primary:tivm40:KYNA
    --properties
    CONFIGURATION_TYPE.configure_type="tema_configure"
    KYN_Tema_Config.KYN_ALT_NODEID="mynode"
    KYN_Tema_Config.KYN_PORT=63336
    To use the response file, enter the following command:
    ./tacmd configureSystem response_file_name

When the agent is successfully configured, it will automatically connect to the Tivoli Enterprise Monitoring Server using the new settings, and the Tivoli Enterprise Portal will show it.

To perform other configuration tasks on a remote Agent installation, see Configure ITCAM Agent for WebSphere Applications remotely using Tivoli Enterprise Portal.


Parent topic:

Install ITCAM Agent for WebSphere Applications remotely