The main prerequisite for this integration is the installation
of the Universal Agent on the same workstation where the Tivoli Workload Scheduler instance
to be monitored is installed.
Tivoli Workload Scheduler installation
provides you with two scripts used as data providers to configure
the Universal Agent that monitors Tivoli Workload Scheduler. For
information about the operating systems supported by this integration,
refer to the IBM® Tivoli Monitoring 6.1 documentation.
During the installation of
Tivoli Workload Scheduler, the
following configuration scripts are copied into the
ITM directory
of the
Tivoli Workload Scheduler workstation
to be monitored:
- ITMconfig.sh for UNIX and ITMconfig.cmd for Windows
This script configures
the Universal Agent to monitor
Tivoli Workload Scheduler. The
syntax is the following:
ITMconfig –ua_home_dir ua_home_dir
where:
- -ua_home_dir
- Specifies the home directory of the Universal Agent. This script
runs on the workstation where the Universal Agent is installed.
Note: Make sure that the user running the Tivoli® Universal Agent has read access to
the pobox directory.
- ITMCreateSituations.sh for UNIX and ITMCreateSituations.cmd for Windows
This script configures
the Tivoli Enterprise Portal
Console to create and display the
Tivoli Workload Scheduler situations.
Copy this script, the baseNameSituation.xml file, and ITM_TWS_84metafile_win.mdl
for Windows or ITM_TWS_84metafile_ux.mdl
for UNIX, onto the Tivoli Enterprise Monitoring Server and run
it using the following syntax:
ITMCreateSituations -user username -password passwd -host host -ITMHome ITMHome
[-TWSHome TWSHome]
where:
- username
- Specifies the user ID of the IBM Tivoli Monitoring user.
- passwd
- Specifies the password of the IBM Tivoli Monitoring user.
- host
- Specifies the host name of the Tivoli Enterprise
Monitoring Server.
- ITMHome
- Specifies the home directory of the Tivoli Enterprise Monitoring Server.
- TWSHome
- Specifies the home directory of the Tivoli Workload Scheduler. Use
this option only if, on the workstation where the Tivoli Enterprise Portal is installed, Tivoli Workload Scheduler is also
installed.
Note: If Tivoli Workload
Scheduler version 8.5 is installed as an upgrade to a Tivoli Workload Scheduler version 8.4.
x instance
that is already configured for integration with IBM Tivoli Monitoring,
perform the following steps before running the
ITMCreateSituation script.
This ensures that IBM Tivoli Monitoring situations
are created correctly.
- Delete the situations created with the Tivoli Workload Scheduler version 8.4 fix
pack 1 integration with IBM Tivoli Monitoring. See the documentation
for IBM Tivoli Monitoring 6.1.
- Edit the ITMCreateSituations.sh or ITMCreateSituations.bat scripts
installed with the Tivoli Workload
Scheduler version 8.5 upgrade. Change any entry with the name CUSTOM_ITM_TWS_APPL00 to CUSTOM_ITM_TWS_APPL01.
Save the files to the Tivoli Enterprise
Monitoring Server.
These steps ensure that the situations are created for the
correct Tivoli Workload Scheduler
application name. In this case, it is ITM_TWS_APPL01.
When you log on to Tivoli Enterprise
Portal for the first time, you find the following situations:
Figure 1. Tivoli Workload Scheduler situations
After the creation of the Tivoli Workload Scheduler situations,
in the Tivoli Enterprise
Portal Desktop you can see the events associated to each situation:
Figure 2. Situation content
Note: The time-to-live <TTL> value, indicating the time
that the monitored data will be kept by the Tivoli Enterprise Portal, is set
to 86400 seconds (default value of 1 day). To change this value, you
must manually edit the universal agent metafile: ITM_TWS_84metafile_win.mdl (Windows environments) or ITM_TWS_84metafile_ux.mdl(UNIX environments). For further
information refer to the Tivoli Universal
Agent User's Guide.