Configuring application support for nonbase monitoring agents
The term nonbase is used here to refer
to distributed monitoring agents for which support is included on the current
Agents DVD, and to other products such as IBM Tivoli Monitoring for Applications, OMEGAMON XE monitoring agents,
and IBM® Tivoli® Composite Application Manager monitoring agents that
provide their own support files.
Some monitoring agents that run on z/OS® or z/VM® are packaged with their own
CD that contains the data files for adding application support to
distributed components. Other monitoring agents that run on z/OS are packaged with a CD that contains data files
for a number of agents. If in doubt, refer to the configuration guide
for each of your monitoring agents to find the exact name of the CD to use.
The following table shows you which installation media to use and
where to find instructions for installing application support, according
to the type of agent (distributed or z/OS)
and whether the agent reports to a distributed or z/OS monitoring server.
Follow the instructions in this section to install
application support on the monitoring server, portal server, and desktop client.
Distributed
z/OS
IBM Tivoli Monitoring V6.2: Agents
DVD
Agent product installation CDs
Follow the instructions in this section to install application
support on the portal server and desktop clients.
Follow the instructions in Configuring the Tivoli
Enterprise Monitoring Server on z/OS to
install application support on the monitoring servers.
z/OS
Distributed
Data Files CD
Follow the instructions in this section to install
application support on the monitoring server, portal server, and desktop client.
z/OS
z/OS
Data Files CD
Follow the instructions in this section to install application
support on the portal server and desktop clients.
Follow the instructions in Configuring the Tivoli
Enterprise Monitoring Server on z/OS to
install application support on the monitoring servers.
Use the instructions in the following sections to install application
support for nonbase distributed or z/OS monitoring agents
on the distributed monitoring servers, portal server, and portal desktop clients in your
environment:
Each of these sections provides information for installing application
support files to a single component, such as the monitoring server. If you have
multiple components on the same computer (such as the monitoring server and the portal server),
combine steps from the individual sections to install application
support to all components.
Installing application support on monitoring servers
Use the following procedures to install application support for
nonbase monitoring agents on distributed monitoring servers (hub or remote) in your environment:
Windows: Installing
application support on a monitoring server
Complete the following steps to install application support for monitoring agents
on Windows® monitoring servers.
Notes:
The monitoring server is stopped during this process.
If you are running in a Hot Standby environment, shut down your
Hot Standby (that is, mirror) monitoring server before completing this procedure.
Restart the Hot Standby monitoring server only after you have seeded the hub server.
In the \WINDOWS subdirectory on the agent product CD (for distributed
products) or data files CD (for z/OS products),
double-click the setup.exe file to launch the installation.
Click Next on the Welcome window.
Note:
If a monitoring agent is already installed on this computer, select Modify on the Welcome window to indicate that you
are updating an existing installation. Click OK on
the message telling you about preselected items. Then skip to Step 6.
On the Install Prerequisites window, read the information about
the required levels of IBM Global
Security Toolkit (GSKit) and IBM Java™.
The check box for each
prerequisite is cleared if the correct level of the software is already
installed. Otherwise, the check box is selected to indicated that
the software is to be installed. If you are
installing support from the data files CD for z/OS agent products, you might be prompted to install
Sun Java Runtime Environment
(JRE) 1.4.2, even if you have already installed IBM JRE 1.5 with the distributed components of Tivoli Management Services. The
two versions can coexist, and installation of application support
for some monitoring agents requires Sun Java 1.4.2.
You might also see a message indicating that you can decline the installation
of JRE 1.4.2 and that accepting installation of JRE 1.4.2 results
in uninstallation of other Java versions.
Ignore this message, because you cannot proceed without accepting
the installation of Sun Java 1.4.2,
and accepting the installation does not uninstall IBM Java 1.5.
Click Next. The prerequisite software is
installed if necessary.
If the installation program installs IBM GSKit or IBM JRE, you might be prompted to restart the computer
when the installation is complete. If so, you receive an abort message
with a Severe error heading. This is normal
and does not indicate a problem.
If you are prompted to reboot,
do the following:
Click OK on the window prompting you to
reboot.
Click No on the window asking whether you
want to view the abort log.
Restart the computer.
Restart the installation program.
Click Accept to accept the license agreement.
If you see a message regarding installed versions
being newer than the agent installation, click OK to
ignore this message.
Select the application support packages that
you want to install:
On the Select Features window, select Tivoli
Enterprise Monitoring Server.
Expand the Tivoli Enterprise Monitoring Server node
to display a list of application support packages that you can install
on the monitoring server.
The following example shows the application support
packages available with the IBM Tivoli Monitoring for Databases
product:
Initially, all application support packages are selected.
Clear the check boxes for application support packages that you
do not want to install.
Note:
If you are updating an existing
installation (you selected Modify on the Welcome
window), all check boxes on the Select Features window reflect your
choices during the initial installation. Clearing a check box has
the effect of uninstalling the component (for
example, the Tivoli Enterprise Monitoring Server) or product
package. Clear a checkbox for an application support package only
if you want to remove the application support.
If you have other components installed on the same computer, such
as the desktop client, also select those components to install the
component-specific application support.
Click Next.
(Distributed agents only) If you want
to add the agent to the deployment depot, select the agent and click Next.
This step does not occur for z/OS agents. z/OS agents cannot be added to the deployment depot.
On the Start Copying Files window, read the list of actions to
be performed and click Next to start the installation.
The
application support packages that you selected are installed.
On the Setup Type window, do the following:
Select Install application support for a local/remote Tivoli
Enterprise Monitoring Server.
Optionally, select the check box for launching the Manage Tivoli Enterprise Monitoring Services window.
(If selected, this window is displayed when the installation procedure
is finished.)
Clear the check boxes for any components that you have already
installed on this computer, such as the monitoring server.
Click Next.
On the two Tivoli Enterprise Monitoring Server configuration
windows that are displayed, make sure the information is correct and
click either Next or OK.
Enable application support on the monitoring server:
In Step 7, you selected the application support packages
that you wanted to install on the monitoring server. In this step, you activate
the application support through a process known as seeding the monitoring server.
Specify the location of the monitoring server to which to add application support.
You have two choices:
On this computer
On a different computer
Click OK.
For additional
information about these parameters, press the Help button.
If you are updating a hub Tivoli Enterprise Monitoring Server, you are asked
to choose whether you want to add the default managed system groups
when you process the application-support files:
All
Add the default managed system groups to all applicable situations.
New
Add the default managed system groups to all applicable situations
from the product support packages being seeded for the first time.
Modifications are not made to managed system groups in previously
upgraded product support packages.
None
The default managed system group is not added to any situation.
Note:
Not all situations support the default managed
group setting. For some, you might need to manually define the distribution
using the Tivoli Enterprise Portal due to the specific content of the agent support package.
Click OK on the Select
the Application Support to Add to the TEMS window.
This window
lists the application support packages that you selected in Step 7. Click OK to begin
seeding the monitoring server (using the SQL files listed on this window). This
process can take up to 20 minutes.
Click Next on the message
that provides results for the process of adding application support
(see Figure 28).
A return code of 0 (rc=0) indicates that the process
succeeded.
Note:
If the Application Support Addition Complete
window is not displayed after 20 minutes, look in the IBM\ITM\CNPS\Logs\seedkpp.log files (where pp is
the two-character code for each monitoring agent) for diagnostic messages that
help you determine the cause of the problem.
Click Finish to close the installation wizard.
Linux or UNIX: Installing application support
on a monitoring server
Complete the following steps to install application support for monitoring agents
on a UNIX® or Linux® monitoring server:
Stop the monitoring server by running the following command:
./itmcmd server stop tems_name
Note:
If you are running
in a Hot Standby environment, shut down your Hot Standby (that is,
mirror) monitoring server before completing this procedure. You may restart the
Hot Standby monitoring server only after you have seeded the hub server.
Run the following command from the installation media (the agent
product CD for distributed agent products or the data files CD for z/OS agent products):
./install.sh
When prompted for the IBM Tivoli Monitoring home directory, press Enter to accept
the default directory (/opt/IBM/ITM)
or type the full path to the installation directory you used.
The following prompt is displayed:
Select one of the following:
1) Install products to the local host.
2) Exit install.
Please enter a valid number:
Enter 1 to start the
installation.
The software license agreement is displayed.
Read through the agreement, then type 1 and press Enter
to accept it.
The installer presents a list of installable components
for the operating system you are currently running.
(Distributed agent products only, optional)
If you are using a distributed agent product CD, optionally install monitoring agents
to this computer. For example, you can install an OS monitoring agent to monitor
the operating system. Complete the following steps if you want to
install monitoring agents. If you do not want to install monitoring agents, skip to Step 8.
Enter 1 to install the IBM Tivoli Monitoring components for your current
operating system.
Enter 1 to confirm your selection.
The installer
presents a numbered list of monitoring agents that you can install.
Enter the numbers of the monitoring agents that you want to install or enter
the number that corresponds to All of the above. Enter
more than one number on the same line separated by spaces or commas
(,).
A list of the monitoring agents to be installed is displayed.
Enter 1 to confirm the installation.
After the monitoring agents are installed, the installer asks if you want
to install additional products or support packages. Enter 1 and
go to Step 8.
(z/OS agent
products only, required) If you are using a data files CD, complete
the following steps to install required metaprobes. (helper programs)
for the monitoring agents that you want to support.
Enter the number of the operating system. The default value is
the current operating system.
Enter y to confirm your selection.
The installer
presents a numbered list of monitoring agents.
Enter the numbers of the monitoring agents for which you want to install application
support, or enter the number that corresponds to All of the above.
Enter more than one number on the same line separated by spaces or
commas (,).
The installer displays the list of monitoring agents that you selected.
For example:
The following products will be installed:
OMEGAMON XE for CICS on z/OS v 4.1.0
OMEGAMON XE for DB2 PE and PM on z/OS v 4.1.0
OMEGAMON XE for IMS on z/OS v 4.1.0
OMEGAMON XE on z/OS v 4.1.0
Note:
The prompt (The
following products will be installed) seems to indicate that
the installer is about to install the listed monitoring agents, which is true
for distributed agents. However, for z/OS agents,
only metaprobes for the monitoring agents are installed. You cannot install z/OS agents on a monitoring server on Linux or UNIX (and you cannot install monitoring agents from a data files
CD).
Enter 1 to confirm the installation.
After the metaprobes are installed, the installer asks if you
want to install additional products or support packages. Enter y.
Install the application support package for the Tivoli
Enterprise Monitoring Server:
Enter the number for Tivoli Enterprise Monitoring Server
support.
A list of the monitoring agents for which you can install application
support is displayed.
Enter the numbers of the monitoring agents for which you want to install application
support, or enter the number that corresponds to All of the above.
Enter the numbers on the same line separated by spaces or commas (,).
Enter 1 to confirm the installation.
The installation
begins.
You are asked if you want to install application support on the Tivoli Enterprise Monitoring Server.
If you reply yes, application support is automatically added.
If you are updating a hub Tivoli Enterprise Monitoring Server, you are asked
to choose whether you want to add the default managed system groups
when you process the application-support files, as shown in Figure 27:
All
Add the default managed system groups to all applicable situations.
New
Add the default managed system groups to all applicable situations
from the product support packages being seeded for the first time.
Modifications are not made to managed system groups in previously
upgraded product support packages.
None
The default managed system group is not added to any situation.
Note:
Not all situations support the default managed
group setting. For some, you might need to manually define the distribution
using the Tivoli Enterprise Portal due to the specific content of the agent support package.
After you have added application support for one
or more agents, you must refresh the monitoring server configuration:
Windows: Installing
application support on a portal server
Complete the following steps to install application support for monitoring agents
on a Windows portal server:
Stop the portal server:
Open Manage Tivoli Enterprise Monitoring Services.
Right-click Tivoli Enterprise Portal Server and
click Stop.
In the /WINDOWS subdirectory on the agent product CD (for distributed
products) or data files CD (for z/OS products),
double-click the setup.exe file to launch the installation.
Click Next on the Welcome window.
Note:
If a monitoring agent is already installed on this computer, select Modify on the Welcome window to indicate that you
are updating an existing installation. Click OK on
the message telling you about preselected items. Then skip to Step 7.
On the Install Prerequisites window, read the information about
the required levels of IBM Global
Security Toolkit (GSKit) and IBM Java.
The check box for each
prerequisite is cleared if the correct level of the software is already
installed. Otherwise, the check box is selected to indicated that
the software is to be installed. If you are
installing support from the data files CD for z/OS agent products, you might be prompted to install
Sun Java Runtime Environment
(JRE) 1.4.2, even if you have already installed IBM JRE 1.5 with the distributed components of Tivoli Management Services. The
two versions can coexist, and installation of application support
for some monitoring agents requires Sun Java 1.4.2.
You might also see a message indicating that you can decline the
installation of JRE 1.4.2 and that accepting installation of JRE 1.4.2
results in uninstallation of other Java versions.
Ignore this message, because you cannot proceed without accepting
the installation of Sun Java 1.4.2,
and accepting the installation does not uninstall IBM Java 1.5.
Click Next. The prerequisite software is
installed if necessary.
If the installation program installs IBM GSKit or IBM JRE, you might be prompted to restart the computer
when the installation is complete. If so, you receive an abort message
with a Severe error heading. This is normal
and does not indicate a problem.
If you are prompted to reboot,
do the following:
Click OK on the window prompting you to
reboot.
Click No on the window asking whether you
want to view the abort log.
Restart the computer.
Restart the installation program.
Click Accept to accept the license agreement.
If you see a message regarding installed versions
being newer than the agent installation, click OK to
ignore this message.
Select the application support packages that you want to install:
On the Select Features window, select Tivoli
Enterprise Portal Server.
Expand the Tivoli Enterprise Portal Server node
to display a list of application support packages that you can install
on the portal server.
Initially, all application support packages are selected.
Clear the check boxes for application support packages that you
do not want to install.
Note:
If you are updating an existing
installation (you selected Modify on the Welcome
window), all check boxes on the Select Features window reflect your
choices during the initial installation. Clearing a check box has
the effect of uninstalling the component (for
example, the Tivoli Enterprise Portal Server) or product
package. Clear a checkbox for an application support package only
if you want to remove the application support.
If you have other components installed on the same computer, such
as the desktop client, also select those components to install the
component-specific application support.
Click Next.
On the Start Copying Files window, read the list of actions to
be performed and click Next to start the installation.
The
application support packages that you selected are installed.
On the Setup Type window, clear any components that you have already
installed and configured on this computer. Click Next.
Type the host name for the portal server and click Next.
Click Finish to complete the installation
wizard.
Restart the portal server.
Linux or AIX: Installing application support
on a portal server
Complete the following steps to install application support for monitoring agents
on a Linux or AIX® portal server:
Stop the portal server by running the following command:
./itmcmd agent stop cq
Run the following command from the installation media (the agent
product CD for distributed agent products or the data files CD for z/OS agent products):
./install.sh
When prompted for the IBM Tivoli Monitoring home directory, press Enter to accept
the default directory (/opt/IBM/ITM) or enter the full
path to the installation directory you used.
The following prompt is displayed:
Select one of the following:
1) Install products to the local host.
2) Exit install.
Please enter a valid number:
Enter 1 to start the
installation.
The software license agreement is displayed.
Read through the agreement, then type 1 and press Enter
to accept it.
The installer presents a list of installable products
for the operating systems you are currently running.
(Distributed agent products only, optional)
If you are using a distributed agent product CD, optionally install monitoring agents
to this computer. For example, you can install an OS monitoring agent to monitor
the operating system. Complete the following steps if you want to
install monitoring agents. If you do not want to install monitoring agents, skip to Step 7.
Enter 1 for your current operating system.
Enter 1 to confirm your selection.
The installer
presents a numbered list of monitoring agents that you can install.
Enter the numbers of the monitoring agents that you want to install or enter
the number that corresponds to All of the above. Enter
more than one number on the same line separated by spaces or commas
(,).
A list of the monitoring agents to be installed is displayed.
Enter 1 to confirm the installation.
After the monitoring agents are installed, the installer asks if you want
to install additional products or support packages. Enter 1.
Install the application support packages for the portal server and
browser client. Install application support packages for the portal
desktop client if a desktop client is installed on this computer.
The
numbered list of items presented by the installer includes the following
application support packages. (The numbers might vary from this example.)
28) Tivoli Enterprise Portal Browser Client support
29) Tivoli Enterprise Portal Desktop Client support
30) Tivoli Enterprise Portal Server support
Note:
The Tivoli
Enterprise Portal Browser Client support package is portal server code
that supports the browser clients. You must install
the browser client support package on the computer where you install
the portal server.
Repeat the following steps for each
support package:
Enter the number that corresponds to the support package (for
example, 28).
A numbered list of monitoring agents is displayed.
Enter the numbers that correspond to the monitoring agents for which you want
to install the application support package, or enter the number that
corresponds to All of the above. Type the numbers on the
same line separated by spaces or commas (,).
Enter 1 to confirm the installation.
The installation
begins.
After the support package is installed, you are asked whether
you want to install additional products or product support packages.
Enter 1 to install an additional package and repeat the
preceding steps. Enter 2 if you are finished installing
support packages.
Stop the portal server by running the following command:
./itmcmd agent stop cq
Run the following command to configure the portal server with the new agent
information:
Restart the portal server by running the following command:
./itmcmd agent start cq
Installing application support on the Tivoli Enterprise Portal desktop client
Use the following procedures to install application support for
nonbase monitoring agents on each computer where you are running a desktop client.
Note:
You must install application support on desktop clients
that were installed from the installation media. You do not need to
install application support on desktop clients that were obtained
by using IBM Web Start for Java to download the client from
the Tivoli
Enterprise Portal Server.
Windows: Installing
application support on a desktop client
Complete the following steps to install application support for monitoring agents
on a Windows desktop client:
Stop the portal desktop client:
Open Manage Tivoli Enterprise Monitoring Services.
Right-click Tivoli Enterprise Portal Desktop
Client and click Stop.
In the /WINDOWS subdirectory on the agent product CD (for distributed
products) or data files CD (for z/OS products),
double-click the setup.exe file to launch the installation.
Click Next on the Welcome window.
Note:
If a monitoring agent is already installed on this computer, select Modify on the Welcome window to indicate that you
are updating an existing installation. Click OK on
the message telling you about preselected items. Then skip to Step 7.
On the Install Prerequisites window, read the information about
the required levels of IBM Global
Security Toolkit (GSKit) and IBM Java.
The check box for each
prerequisite is cleared if the correct level of the software is already
installed. Otherwise, the check box is selected to indicated that
the software is to be installed. You might
be prompted to install Sun Java Runtime
Environment (JRE) 1.4.2, even if you have already installed IBM JRE 1.5 with the distributed
components of Tivoli Management
Services. The two versions can coexist, and installation of application
support for some monitoring agents requires Sun Java 1.4.2.
You might also see a message indicating that you can decline the
installation of JRE 1.4.2 and that accepting installation of JRE 1.4.2
results in uninstallation of other Java versions.
Ignore this message, because you cannot proceed without accepting
the installation of Sun Java 1.4.2,
and accepting the installation does not uninstall IBM Java 1.5.
Tip
If you are installing support from the data files CD for z/OS agent products, you might
be prompted to install Java Runtime
Environment (JRE) 1.4.2, even if you have already installed IBM JRE 1.5 with the distributed
components of Tivoli Management
Services. You might also see a message indicating that you can decline
the installation of JRE 1.4.2 and that accepting installation of JRE
1.4.2 results in uninstallation of other Java versions.
Ignore this message, because you cannot proceed without accepting
the installation of Java 1.4.2,
and accepting the installation of Java 1.4.2
does not uninstall IBM Java 1.5. The two versions can coexist.
However, the most recently installed version of Java becomes the active version, and the distributed
components of Tivoli Management
Services V6.2.0 require that JRE 1.5 be the active version.
To change the active version back to JRE 1.5 after you complete
installation of application support, follow these steps:
Open the Windows Control
Panel by selecting Start > Settings > Control Panel.
From the Windows Control
Panel, select IBM Control
Panel for Java.
On the Java tab of the Java Control Panel, click the View button in the Java Application
Runtime Settings section.
On the JNLP Runtime Settings window, select version 1.5, and make
sure the Enabled checkbox is selected.
Click OK twice to save your settings and
exit the Java Control Panel.
From the Windows Control
Panel, select Java Plug-in.
On the Advanced tab of the Java Plug-in Control Panel, make sure that JRE 1.5.0 is selected. If you change the setting,
click Apply.
Close the Java Plug-in Control
Panel window and the Windows Control
Panel.
Click Next to continue. The prerequisite
software is installed if necessary.
If the installation program
installs IBM GSKit or IBM JRE, you might be prompted to
restart the computer when the installation is complete. If so, you
receive an abort message with a Severe
error heading. This is normal and does not indicate a problem.
If
you are prompted to reboot, do the following:
Click OK on the window prompting you to
reboot.
Click No on the window asking whether you
want to view the abort log.
Restart the computer.
Restart the installation program.
Read the software license agreement and click Accept.
If you see a message regarding installed versions
being newer than the agent installation, click OK to
ignore this message.
Select the application support packages that you want to install:
On the Select Features window, select Tivoli
Enterprise Portal Desktop Client.
Expand the Tivoli Enterprise Portal Desktop
Client node to display a list of application support packages
that you can install on the portal server.
Initially, all application support
packages are selected.
Clear the check boxes for application support packages that you
do not want to install.
Note:
If you are updating an existing
installation (you selected Modify on the Welcome
window), all check boxes on the Select Features window reflect your
choices during the initial installation. Clearing a check box has
the effect of uninstalling the component or
product package. Clear a check box for an application support package
only if you want to remove the application support.
Click Next.
On the Start Copying Files window, read the list of actions to
be performed and click Next to start the installation.
The
application support packages that you selected are installed.
On the Setup Type window, clear any components that you have already
installed and configured on this computer. Click Next.
Type the host name for the portal server and click Next.
Click Finish to complete the installation
wizard.
Linux: Installing application
support on a desktop client
Complete the following steps to install application support for monitoring agents
on a Linux desktop client:
Note:
Stop the desktop client before performing this procedure.
Stop the desktop client by running the following command:
./itmcmd agent stop cj
Run the following command from the installation media (the agent
product CD for distributed agent products or the data files CD for z/OS agent products):
./install.sh
When prompted for the IBM Tivoli Monitoring home directory, press Enter to accept
the default directory (/opt/IBM/ITM) or enter the full
path to the installation directory you used.
The following prompt is displayed:
Select one of the following:
1) Install products to the local host.
2) Exit install.
Please enter a valid number:
Enter 1 to start the
installation.
Read the software license agreement; then type 1 and
press Enter to accept it.
The installer presents a list of installable
components for your current operating system.
(Distributed agent products only, optional)
If you are using a distributed agent product CD, optionally install monitoring agents
to this computer. For example, you can install an OS monitoring agent to monitor
the operating system. Complete the following steps if you want to
install monitoring agents. If you do not want to install monitoring agents, skip to Step 7.
Enter 1 for your current operating system.
Enter 1 to confirm your selection.
The installer
presents a numbered list of monitoring agents that you can install.
Enter the numbers of the monitoring agents that you want to install or enter
the number that corresponds to All of the above. Enter
more than one number on the same line separated by spaces or commas
(,).
A list of the monitoring agents to be installed is displayed.
Enter 1 to confirm the installation.
After the monitoring agents are installed, the installer asks if you want
to install additional products or support packages. Enter 1.
Install the application support package for the portal
desktop client:
Enter the number that corresponds to Tivoli Enterprise Portal
Desktop Client support.
A numbered list of monitoring agents is displayed.
Enter the numbers that correspond to the monitoring agents for which you want
to install the application support package, or enter the number that
corresponds to All of the above. Type the numbers on the
same line separated by spaces or commas (,).
Enter 1 to confirm the installation.
The installation
begins.
After application support for all monitoring agents is installed, you are
asked whether you want to install additional products or product support
packages. Enter 2.
Run the following command to configure the desktop client with
the new agent information:
