Installing the Tivoli Monitoring agent in a remote environment

Before you begin

Before installing the Tivoli Monitoring agent in a remote environment, where HCL Workload Automation for Z is installed on workstation different from theTivoli Enterprise Monitoring Server, you must first install the Tivoli Monitoring OS agent. When installing the OS agent, select the Tivoli Enterprise Monitoring Agent for your OS and all of its associated subcomponents.

About this task

To install and configure the Tivoli Monitoring agent on a workstation different from the Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server, perform the procedure that applies to the operating system you are using.

Installing and configuring on Windows workstations

Procedure

  1. Extract the TWA_home\ITMZ\TWSzItmAgent.zip file on the Tivoli Enterprise Monitoring Server.
  2. From the directory where you extracted the file, enter the following command to install the Tivoli Monitoring agent for HCL Workload Automation for Z: 
    installIraAgent.bat OS_Agent_install_dir
    where OS_Agent_install_dir is the complete path to the OS Agent installation directory.
  3. Log in to the Tivoli Enterprise Portal. The Monitoring Agent for HCL Workload Automation for Z is now listed in the Manage Tivoli Enterprise Monitoring Services window.
  4. To create an instance of the agent, double-click Monitoring Agent for HCL Workload Automation for Z. The Monitoring Agent for HCL Workload Automation for Z window opens.
  5. Specify a name for the instance and click OK. The Agent Configuration window opens.
  6. Specify an available port number nd click OK. You are returned to the Manage Tivoli Enterprise Monitoring Services window.
  7. Right-click Monitoring Agent for HCL Workload Automation for Z and select Reconfigure. The Agent Advance Configuration window opens.
  8. In the Protocol 1 field, specify the host name or IP address of the remote Tivoli Enterprise Monitoring Server and click OK. You are returned to the Manage Tivoli Enterprise Monitoring Services window.
  9. To start the agent, right-click Monitoring Agent for HCL Workload Automation for Z and select Start.
  10. Configure HCL Workload Automation for Z to send events to the Tivoli Monitoring agent, as described in Configuring the controller to work with Tivoli Enterprise Portal.
  11. Launch the Tivoli Enterprise Portal. The agent is displayed in the Navigator pane together with any agent configuration settings.

Installing and configuring on UNIX and Linux workstations

Procedure

  1. Untar the TWA_home\ITMZ\TWSzItmAgent.tar on the Tivoli Enterprise Monitoring Server.
  2. From the directory where you untar the file, enter the following command to install the Tivoli Monitoring agent for HCL Workload Automation for Z: 
    installIraAgent.sh OS_Agent_install_dir
    where OS_Agent_install_dir is the complete path to the OS Agent installation directory.
  3. To configure the Tivoli Monitoring agent, enter the following command from the OS_Agent_install_dir/bin directory: 
    ./itmcmd config –A 20
    where 20 is the product code of the Tivoli Monitoring agent for HCL Workload Automation for Z.

    You are prompted to set the values for the agent configuration parameters.

  4. Specify a name for the agent instance and press Enter.
  5. Specify 1 to edit the Monitoring Agent for HCL Workload Automation for Z and press Enter.
  6. Specify 1 to edit the Socket Settings and press Enter.
  7. Specify an available Port Number and press Enter. The default is 6789.
  8. Specify 1 to connect the agent to the Tivoli Enterprise Monitoring Server and press Enter.
  9. Specify the host name of the remote Tivoli Enterprise Monitoring Server and press Enter.
  10. Accept the default value ip.pipe as the Network Protocol by pressing Enter.
  11. Accept the default value 0 as the Network Protocol 2 by pressing Enter.
  12. Accept the default value ip.pipe as the Port Number by pressing Enter.
  13. Accept the default value null as the KDC_PARTITION by pressing Enter.

    The Tivoli Monitoring agent is now installed and configured in the Tivoli Enterprise Portal.

  14. To start the agent, enter the following command from ITMagent_install_dir\bin: 
    ./itmcmd agent -o ITMagent_instance_name_remote start 20
  15. To stop the agent, enter the following command from ITMagent_install_dir\bin: 
    ./itmcmd agent -o ITMagent_instance_name_remote stop 20
  16. To verify that the agent is running, enter the following command from ITMagent_install_dir\bin: 
    ./cinfo agent -r