Installing the portal server on Linux or AIX

Complete the following steps to install the portal server.

1. In the directory where you extracted the installation files, run the following command:

   ./install.sh 

2. 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 a different directory.
   Note:

   1. 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()~-./".

   2. You must not specify the path of the directory containing ./install.sh as your IBM Tivoli Monitoring home directory. On certain platforms, this can cause the plug-in JAR files to overwrite themselves and become zero length files. The installation will fail as a result.
3. If the installation directory does not already exist, you are asked if you want to create it. Type y to create this directory and press Enter.
4. 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) Install TEMS support for remote seeding
   4) Exit install.
   
   Please enter a valid number:

   Type 1 to start the installation and display the software license agreement.
5. Press Enter to read through the agreement.
6. Type 1 to accept the agreement and press Enter.
7. Enter a 32-character encryption key or press Enter to accept the default key. This key should be the one used during the installation of the monitoring server to which this portal server will connect.

   A numbered list of available operating systems is displayed.

8. Type 4 to install the portal server for your current operating system. Press Enter.
   A message is displayed indicating that the Tivoli Enterprise Portal Server is about to be installed.

   Note: The Eclipse Help Server is automatically installed when you install the Tivoli Enterprise Portal Server.
9. Type 1 to confirm the installation.

   The installation begins.

10. After the Tivoli Enterprise Portal Server is installed, you are asked whether you want to install additional products or product support packages. Type 1 and press Enter.

    The installer presents a numbered list of products and application support packages.

11. Install the required application support packages.

    All monitoring agents require that application support files be installed on the monitoring servers (hub and remote), portal server, and portal desktop clients in your environment. Application support files contain the information required for agent-specific workspaces, helps, predefined situations, and other data.

    This step installs the application support files for base monitoring agents. The base monitoring agents are included with the base IBM® Tivoli® Monitoring installation package. For detailed information about application support, see Installing and enabling application support.

    When you entered 1 in the preceding step, the installer presents a numbered list of items, including the following application support packages:

       Tivoli Enterprise Portal Browser Client support
       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 if you want to connect to it using a browser client.

    Complete the following steps to install the portal server and browser client support packages for the base monitoring agents:

    1. Type the number that corresponds to Tivoli Enterprise Portal Browser Client support and press Enter.

       A numbered list of base monitoring agents is displayed.

    2. Type the numbers that correspond to the base monitoring agents for which you want to install the application support package, or type the number that corresponds to All of the above. Type the numbers on the same line separated by spaces or commas (,). Press Enter.

       It is best to select all of the base monitoring agents (All of the above) so you do not need to reconfigure application support as new agent types are added to your environment.

    3. Type 1 to confirm the installation and press Enter.

       The installation begins.

    4. After the support package is installed, you are asked whether you want to install additional products or product support packages. Enter 1 and repeat the preceding steps for the Tivoli Enterprise Portal Server support package.
    Note: This step installs the application support files. However, you must enable the application support by configuring the portal server. The next two sections show you how to configure the portal server.
12. After you are finished installing the portal server and browser client packages, you are asked whether you want to install additional products or product support packages. Type 2 and press Enter.
13. If your IBM Tivoli Monitoring environment is not already secured you will be asked at this point if you want to secure it. If your IBM Tivoli Monitoring environment is already secured this question is skipped. The product installation process creates the majority of directories and files with world write permissions. IBM Tivoli Monitoring provides the secureMain utility to help you keep the monitoring environment secure. You can secure your installation now, or manually execute the secureMain utility later. For more information, see Securing your IBM Tivoli Monitoring installation on Linux or UNIX.