Installing the Z Monitoring agent in a remote environment

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

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

Extract the TWA_home\ITMZ\TWSzItmAgent.zip file on the Tivoli Enterprise Monitoring Server.
From the directory where you extracted the file, enter the following command to install the Z Monitoring agent for IBM Z Workload Scheduler:
```
installIraAgent.bat OS_Agent_install_dir
```
where OS_Agent_install_dir is the complete path to the OS Agent installation directory.
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.
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.
Specify a name for the instance and click OK. The Agent Configuration window opens.
Specify an available port number nd click OK. You are returned to the Manage Tivoli Enterprise Monitoring Services window.
Right-click Monitoring Agent for IBM Z Workload Scheduler and select Reconfigure. The Agent Advance Configuration window opens.
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.
To start the agent, right-click Monitoring Agent for IBM Z Workload Scheduler and select Start.
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.
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

Untar the TWA_home\ITMZ\TWSzItmAgent.tar on the Tivoli Enterprise Monitoring Server.
From the directory where you untar the file, enter the following command to install the Z Monitoring agent for IBM Z Workload Scheduler:
```
installIraAgent.sh OS_Agent_install_dir 
```
where OS_Agent_install_dir is the complete path to the OS Agent installation directory.
To configure the Z 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 Z Monitoring agent for IBM Z Workload Scheduler.
You are prompted to set the values for the agent configuration parameters.
Specify a name for the agent instance and press Enter.
Specify 1 to edit the Monitoring Agent for IBM Z Workload Scheduler and press Enter.
Specify 1 to edit the Socket Settings and press Enter.
Specify an available Port Number and press Enter. The default is 6789.
Specify 1 to connect the agent to the Tivoli Enterprise Monitoring Server and press Enter.
Specify the host name of the remote Tivoli Enterprise Monitoring Server and press Enter.
Accept the default value ip.pipe as the Network Protocol by pressing Enter.
Accept the default value 0 as the Network Protocol 2 by pressing Enter.
Accept the default value ip.pipe as the Port Number by pressing Enter.
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.
To start the agent, enter the following command from ITMagent_install_dir\bin:
```
./itmcmd agent -o ITMagent_instance_name_remote start 20
```
To stop the agent, enter the following command from ITMagent_install_dir\bin:
```
./itmcmd agent -o ITMagent_instance_name_remote stop 20
```
To verify that the agent is running, enter the following command from ITMagent_install_dir\bin:
```
./cinfo agent -r
```