Installing and configuring the Tivoli Monitoring agent in a local environment

About this task

To install and configure the Tivoli Monitoring agent on the same workstation where the Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server are installed, 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: 
    installIra.bat [[-h HUB_TEMS_hostname]
   -u HUB_TEMS_username [-p HUB_TEMS_password]] [-r]?
    where:
    TEMS_install_dir
    The complete path to the Tivoli Enterprise Monitoring Server installation directory.
    -h HUB_TEMS_hostname
    The host name of theTivoli Enterprise Monitoring Server. The default value is the local host.
    -u HUB_TEMS_username
    The name of the user accessing the Tivoli Enterprise Monitoring Server. The default value is the local user name.
    -p HUB_TEMS_password
    The password for the user accessing the Tivoli Enterprise Monitoring Server. The default value is the password associated with the local user.
    -r
    Restarts the Tivoli Enterprise Portal.
  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 and click OK.
  7. 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.
  8. Launch the Tivoli Enterprise Portal. The agent is displayed in the Navigator pane together with any agent configuration settings.

    You can create as many agent instances as you want by performing steps 5 to 7

Installing and configuring on UNIX and Linux workstations

Procedure

  1. Untar the TWA_home\ITMZ\TWSzItmAgent.tar file 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: 
    installIra.sh TEMS_install_dir [[-h HUB_TEMS_hostname]
   -u HUB_TEMS_username [-p HUB_TEMS_password]] [-r]?
    where:
    TEMS_install_dir
    The complete path to the Tivoli Enterprise Monitoring Server installation directory.
    -h HUB_TEMS_hostname
    The host name of theTivoli Enterprise Monitoring Server. The default value is the local host.
    -u HUB_TEMS_username
    The name of the user accessing the Tivoli Enterprise Monitoring Server. The default value is the local user name.
    -p HUB_TEMS_password
    The password for the user accessing the Tivoli Enterprise Monitoring Server. The default value is the password associated with the local user.
    -r
    Restarts the Tivoli Enterprise Portal.
  3. To configure the Tivoli Monitoring agent, enter the following command from the ITMagent_install_dir/bin directory: 
    ./itmcmd config –A 20
    where:
    ITMagent_install_dir
    The complete path to the Tivoli Monitoring agent for HCL Workload Automation for Z.
    20
    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 name of the local host as the TEMS Host Name 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 start 20
  15. To stop the agent, enter the following command from ITMagent_install_dir\bin: 
    ./itmcmd agent -o ITMagent_instance_name stop 20
  16. To verify that the agent is running, enter the following command from ITMagent_install_dir\bin: 
    ./cinfo agent -r