When you install the IBM Tivoli Composite Application Manager for SOA monitoring agent on one or more
computer systems in your environment where you plan to monitor services,
you must also install application support files containing agent specific
information for the monitoring agent on the computer system where
the Tivoli Enterprise Portal desktop client is installed. When you install the application
support on your Tivoli Enterprise Portal desktop client, you should be logged in as the user
who installed Tivoli Enterprise Portal.
Use the following sections to install application support on the
desktop client in your environment:
Windows: Installing
application support on the desktop client
Use the following steps to install application support for IBM Tivoli Composite Application Manager for SOA on
theTivoli Enterprise Portal desktop client installed on a supported Windows® operating system:
Note:The desktop
client is stopped during this process.
Use the following steps to install required application support
on a Windows desktop client:
Stop the Tivoli Enterprise Portal desktop client, either by exiting the client
console, or by opening the Manage Tivoli Enterprise Monitoring Services utility and by right-clicking on
the desktop client and clicking Stop.
Insert the IBM Tivoli Composite Application Manager for SOA installation media into
the appropriate drive. The installation program
starts automatically.
If the installation program does not start automatically, open
a command prompt window, navigate to the appropriate drive,
open the \WINDOWS folder, and issue the following command:
setup.exe
One
or more welcome pages are displayed. Click Next.
A Software License Agreement page might be displayed. Read the
terms in the license agreement as presented in the scrollable window
and, if you agree to abide by those terms, click Accept.
You must accept the terms of the license agreement to continue the
installation.
The Select Features page is displayed, similar to Figure 17, showing the available features that you can
install for this product. If you have already installed a monitoring
agent or other IBM Tivoli Monitoring components on this computer, the check boxes
for these features are already selected. Select Tivoli Enterprise Portal Desktop Client
and click Next.
Figure 17. The Select Features page for installing application support on the desktop client
Is the Tivoli Enterprise Monitoring Server or Tivoli Enterprise Portal Server also installed
on this computer?: If so, you can also select those components
to install application support for IBM Tivoli Composite Application Manager for SOA now, or follow the
procedures in this publication to separately install application support
for these components at a later time.
The Start Copying Files page is displayed, similar to Figure 18. Review the installation summary details and
verify your selections. Click Next to start
the installation.
Figure 18. The Start Copying Files page for installing application support on Tivoli Enterprise Portal desktop client.
After installation is complete, the Setup Type configuration page
is displayed, as shown in Figure 19.
Figure 19. The Setup Type page
This page offers several configuration options to install
and configure application support for the desktop client:
Select Configure Tivoli Enterprise Portal to add application
support for IBM Tivoli Composite Application Manager for SOA workspaces and situations in Tivoli Enterprise Portal desktop client.
Select Launch Manage Tivoli® Monitoring Services to automatically
launch the Manage Tivoli Enterprise Monitoring Services utility after these configuration steps are completed,
to support additional configuration tasks and to start monitoring
functions.
By default, all of the setup types are already selected
for configuration. In most cases, accept the default selection of
these configuration options, and click Next to
continue. You can clear any of the selections to postpone these configuration
tasks until after the installation is completed.
Because you installed the Tivoli Enterprise Portal desktop client on this computer, the TEPS
Hostname page is displayed, as shown in Figure 15.
Specify the host name for the computer system where the Tivoli Enterprise Portal Server is
installed. Click Next.
The InstallShield Wizard Complete page is displayed as shown in Figure 10, indicating that the installation was successful,
and offering you the option to view the README file for the product,
which might contain additional information of interest to you. The
check box for displaying the README file is already selected. Leave
the check box selected to automatically display the README, or clear
this check box to not display the README file if you have already
seen it (this readme.txt file is also available in the \WINDOWS directory
on the installation media), and click Finish to close the installation program.
Because you selected the Launch Manage Tivoli Monitoring Services check
box in Figure 14, the Manage Tivoli Enterprise Monitoring Services utility is displayed,
showing the Tivoli Enterprise Portal desktop client (see Figure 20). If additional
components of IBM Tivoli Monitoring are installed on this system, they are also displayed.
Figure 20. The Tivoli Enterprise Portal desktop client in the Manage Tivoli Enterprise Monitoring Services utility
If you did not select the option to launch the Manage Tivoli Enterprise Monitoring Services utility,
you can launch it manually by selecting Start ->
All Programs -> IBM® Tivoli Monitoring ->
Manage Tivoli Monitoring
Services.
Verify that the Configured column
shows Yes, meaning that the Tivoli Enterprise Portal desktop client is
successfully configured and started.
Linux: Installing application
support on the desktop client
Use the following steps to install application support for IBM Tivoli Composite Application Manager for SOA on
the Tivoli Enterprise Portal desktop client installed on a supported Linux® operating system. Refer to the IBM Tivoli Monitoring documentation
for general procedures for installing application support for the Tivoli Enterprise Portal desktop client on
this operating system.
Change to the <ITM_Home>/bin directory.
Stop the Tivoli Enterprise Portal desktop client by running the following command:
./itmcmd agent stop cj
Close the Manage Tivoli Enterprise Monitoring Services utility if it is open.
Mount the IBM Tivoli Composite Application Manager for SOA installation media at
the location you have chosen on the local system, following the standard
procedures for your operating system.
From the root directory of the installation media,
run the following command to start the installation program:
./install.sh
When prompted for the IBM Tivoli Monitoring home directory, press Enter to accept
the default (/opt/IBM/ITM) or type the full
path to the installation directory that you used.
The following prompt is displayed:
Select one of the following:
1) Install products to the local host.
2) Install products to depot for remote deployment (requires TEMS).
3) Exit install.
Please enter a valid number:
Type 1 to
start the installation and press Enter.
Type the number that corresponds to the language in which you
want to display the software license agreement and press Enter.
Press Enter to display the agreement.
Type 1 to accept the agreement and press
Enter.
A numbered list of available operating systems and installation
components is displayed. Type the number that corresponds to Tivoli Enterprise Portal Desktop Client support and press Enter.
Type y to confirm and press Enter.
A list of the components to install is displayed. Type the number
that corresponds to selecting all components to install and press
Enter.
Type y to confirm the installation. The
installation begins.
After all of the components are installed, you are asked whether
you want to install components for a different operating system. Type n and press Enter.
Run the following command to configure the Tivoli Enterprise Portal desktop client with the
new agent information:
./itmcmd config -A cj
Complete
the configuration as prompted. For information regarding configuring
the Tivoli Enterprise Portal desktop client, see the section on Configuring
the portal desktop client on Linux,
in the IBM Tivoli Monitoring: Installation and Setup Guide.
Start the Tivoli Enterprise Portal desktop client by running the following command: