Windows: Installing the desktop client

Complete the following steps to install the Tivoli Enterprise Portal desktop client from the Base Infrastructure DVD or DVD image.

1. On the computer where you want to install the desktop client, start the installation wizard by launching the setup.exe file in the \WINDOWS subdirectory on the installation media.
2. Click Next on the Welcome window.
   Note: If you have another IBM® Tivoli® Monitoring component 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.
3. Read and accept the software license agreement by clicking Accept.
4. Specify the directory where you want to install the portal desktop client software and accompanying files. The default location is C:\IBM\ITM. Click Next.
   Note: If you specify an incorrect directory name, you will receive the following error:

   The IBM Tivoli Monitoring installation directory cannot exceed 80 characters
   or contain non-ASCII, special or double-byte characters.
   The directory name can contain only these characters:
   "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ _\:0123456789()~-./".

5. Type an encryption key to use. This key must be the same as what was used during the installation of the hub monitoring server to which the client will connect. Click Next and then OK to confirm the encryption key.
6. On the Select Features window, select Tivoli Enterprise Portal Desktop Client from the list of components to install.

   When you select the Tivoli Enterprise Portal Desktop Client check box, all of the check boxes in the attached subtree are automatically selected. The support check boxes in the subtree are for installing application support files for distributed monitoring agents to the portal desktop client. It is best to leave all of the support check boxes selected so you do not need to reconfigure application support as new agent types are added to your environment. However, if you purchased an OMEGAMON XE monitoring product and you did not separately purchase IBM Tivoli Monitoring, you should not install support for the distributed operating system monitoring agents. If you are installing from the Base DVD, you may see application support for components that are not supported on the operating system. For detailed information about application support, see Installing and enabling application support.

   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. Clear a check box only if you want to remove a component.
7. If you want to view IBM Tivoli Enterprise Console events through the Tivoli Enterprise Portal, expand Tivoli Enterprise Portal Desktop Client and ensure that TEC GUI Integration is selected.
8. Click Next.
9. If a monitoring server is not installed on this computer, go to Step 10.

   If you are installing the desktop client on a computer that already has a monitoring server installed, the Agent Deployment window is displayed.

   The Agent Deployment window lists monitoring agents on this installation image that you can add to the agent depot. The agent depot contains agents that you can deploy to remote computers. For information about how to deploy agents in the agent depot to remote computers, see Deploying monitoring agents across your environment.

   Note: By default, the agent depot is located in the itm_installdir\CMS\depot directory on Windows. If you want to use a different directory, create the directory (if it does not exist) and specify the directory using the DEPOTHOME key in the KBBENV file.

   Select the agents, if any, that you want to add to the agent depot. (You can add agents to the agent depot at a later time by updating your installation.) Click Next.

10. If no IBM Tivoli Monitoring component has been previously installed on this computer, a window is displayed for you to select a program folder for the Windows Start menu. Select a program folder and click Next. The default program folder name is IBM Tivoli Monitoring.
11. Review the installation summary details. The summary identifies what you are installing and where you chose to install it. Click Next to start the installation.

    After installation is complete, a configuration window (called the Setup Type window) is displayed.

12. Clear the check boxes for any components that are already installed and configured (at the current release level) on this computer, unless you want to modify the configuration. (For example, clear the check box for the Tivoli Enterprise Monitoring Server if it has already been installed and configured on this computer.) If the desktop client is being installed on the same host as the portal server but as part of a separate installation process, you must reconfigure the portal server.

    Click Next to start configuring all selected components.

13. Type the host name of the portal server and click OK.
14. Click Finish to complete the installation.