Installing and configuring the Z Monitoring agent in a local environment

To install and configure the Z 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

  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 Z Monitoring agent for IBM Z Workload Scheduler: 
    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 IBM Z Workload Scheduler is now listed in the Manage Tivoli Enterprise Monitoring Services window.
  4. To create an instance of the agent, double-click Monitoring Agent for IBM Z Workload Scheduler. The Monitoring Agent for IBM Z Workload Scheduler 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 IBM Z Workload Scheduler to send events to the Z 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

  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 Z Monitoring agent for IBM Z Workload Scheduler: 
    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 Z 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 Z Monitoring agent for IBM Z Workload Scheduler.
    20
    The product code of the Z Monitoring agent for IBM Z Workload Scheduler.
    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 IBM Z Workload Scheduler 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 Z 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