Installing Performance Manager for Linux Installing on the Linux operating system Installing Replication Manager for Linux

You can use these procedures to install Performance Manager on a Linux operating system.

Prerequisites
Note:Note: Do not interrupt the program by abnormal methods (such as the CTRL-C key sequence, closing the application windows, or shutting down the power source) during the installation process. An interruption caused by something other than clicking the Cancel button in the application window can have unpredictable effects on the system.
Steps

Perform the following steps to install Performance Manager:

  1. If the Performance Manager CD is not already mounted, insert it into the CD-ROM drive, and mount it using the previous mounting procedure.
  2. Type the following command to run the installation program launcher (launchpad_linux) from the LINUX directory of the CD-ROM:
    ./launchpad_linux
    This command starts the Performance Manager LaunchPad, which is a small graphic program that launches the installation setup program.

    The Performance Manager installation program should start within 15 - 30 seconds.

  3. The following options are displayed when the LaunchPad window opens:
    Performance Manager overview
    Provides information about Performance Manager.
    Readme file
    Provides any last minute product information that did not make it into these procedures.
    Installation guide
    Provides a copy of these instructions for installing Performance Manager
    License agreement
    Provides information about the license for Performance Manager.
    Performance Manager Web site
    Provides information from the product Web site.
    Installation wizard
    Starts the Performance Manager installation program.
    Post installation tasks
    Provides information about configuring Performance Manager.
    Exit
    Exits the Performance Manager LaunchPad program.
  4. Click Readme file from the LaunchPad window or from the README file located in the doc or LINUX directory on the Performance Manager CD to check for information that might supersede these procedures.
  5. Click Installation wizard from the LaunchPad window to start the installation of Performance Manager.
    Note:Note: The LaunchPad window remains open behind the installation wizard so that you can access product information during the installation process. Click Exit if you want to close the LaunchPad.
  6. There might be a slight delay while the software loads on your system. After the software loads, a command prompt window opens to display the following message:
    Initializing InstallShield Wizard...
    Preparing Java (tm) Virtual Machine ............................. .
    ......................................................
  7. The Welcome window opens suggesting what documentation you should review prior to installation. Click Next to continue, or click Cancel to exit the installation.
  8. The License Agreement window opens. Read the license agreement information.

    Select I accept the terms of the license agreement , and then click Next to accept the license agreement.

    Otherwise, keep the selection I do not accept the terms of the license agreement (the default), and click Cancel to exit the installation.

  9. The Destination Directory window opens. Select one of the following options:
    • Click Next to accept the default directory.
    • Click Browse to select a different directory for the installation, and then click Next to continue the installation process.
    • Click Cancel to exit the installation process.
    Note:Note: If you want to reinstall the product, this window is skipped.
  10. The Select Product Type window opens. You can select one of the following two types of installations:
    • Performance Manager Server

      This option installs both Performance Manager server and client extensions, including all the following product features, on a system where you have installed both IBM Director Server 4.12 or greater and Multiple Device Manager Server:

      Performance Manager Application
      The program installs the Performance Manager WebSphere Application Server applications.
      Director Server Extensions
      The program installs Performance Manager extensions for IBM Director Server 4.12 or greater.
      Director Console Extensions
      The program installs Performance Manager extensions for IBM Director Console 4.12 or greater.
      Command Line Client
      The program installs the command-line client.
      Notes:
      Notes:
      1. If you select the Performance Manager Server option (including all the product features listed above), the Features Selection window is skipped.
      2. If you select the Performance Manager Server option on a system where you have installed only IBM Director Console, an error message is displayed in the Checking Prerequisite Products window, and the installation program stops.
    • Performance Manager Client

      This option installs the client product features on a system where you have installed IBM Director Console 4.12 or greater and, partially, Multiple Device Manager Console. The client product features selection is described in the next window.

      Note:Note: If you select the Performance Manager Client option on a system where you have installed both IBM Director Server and Multiple Device Manager Server, an error message is displayed in the Checking Prerequisite Products window; and the installation program stops.

    Select an option, and then click Next to continue with the installation. If you want to exit the installation program, click Cancel.

    Note:Note: This window is skipped in the following cases:
    • If you want to reinstall the Performance Manager server on a system where the Performance Manager server is already installed
    • If you want to reinstall the Performance Manager client on a system where one or both clients (Performance Manager Director Console Extension and Performance Manager Command Line Client) are installed
  11. The Features Selection window opens in the following cases:
    • If you selected thePerformance Manager Client option in the previous window
    • If you want to reinstall the Performance Manager client on a system where one client is installed

    You can select one or more of the following features:

    • Director Console Extensions

      This feature must be selected if you want to install the Performance Manager console extensions (or Performance Manager Console) on a system where both IBM Director Console 4.12 or greater and the Multiple Device Manager Console are installed.

    • Command Line Client

      This feature must be selected if you want to install the Performance Manager command-line client (or Performance Manager CLI Client).

    If you have previously installed one Performance Manager client feature (for example, Director Console Extensions), you will be given the opportunity to add additional features to the current installation or to reinstall the selected features. These already installed features are marked as (installed) (in our example, Director Console Extension (installed)).

    Note:Note: If you want to reinstall the Performance Manager client on a system where the Performance Manager client was previously installed with all clients, this window is skipped.

    After you select the desired features (one or more), click Next to continue with the program installation; or click Cancel to exit the installation program.

  12. The installation program verifies that the following prerequisite products and product versions are installed on your system:
    1. For installation of the Performance Manager server:
      • IBM DB2 V8.1 with the DB2 V8.1.2 update (FixPak 2)
      • IBM Director Server 4.12 (or greater)
      • IBM WebSphere Application Server Version 5.1
      • IBM TotalStorage Multiple Device Manager Server
      • Secure Shell (SSH) Client
    2. For installation of the Performance Manager client:
      • IBM Director Console 4.12 (or greater)
      • IBM TotalStorage Multiple Device Manager Console (only for the Performance Manager console client).

    If the required products are installed, the installation program continues, skipping the next step.

    Otherwise, the results are displayed in the Checking Prerequisite Products window (next step).

  13. The Checking Prerequisite Products window opens and displays the problems that were found while checking for the prerequisite products. If the prerequisite products are not installed or the wrong version is installed, the installation program cannot continue. You must exit the program and correct the problem.

    Click Cancel to exit the Performance Manager installation program.

  14. You can now choose whether you would like to perform a typical or advanced installation.

    Click Next to continue with the installation, click Back to review what you previously selected or click Cancel to exit the installation program.

  15. If your selected Typical in the Installation Type window, you will skip this step and go directly to step 16.

    If you selected Performance Manager Server, the Select Database window opens. You must select the type of database want you to be dedicated to the Performance Manager server from the following options:

    • Create a new local database
    • Use an existing database

    Click Next to continue with the installation, click Back to review what you previously selected, or click Cancel to exit the installation program.

  16. If you selected Create a new local database in the previous window or if you selected Typical in the Installation Type window, the Create Local Database window opens. You must enter parameters for the new database in the following fields:
    • Database name
      Note:Note: The database name must be unique to Performance Manager. You cannot share the Performance Manager database with any other applications.
    • Database path
    If you want the program to also create the database tables, select the Create the database tables check box.

    Click Next to continue with the installation, click Back to review what you previously selected, or click Cancel to exit the installation program.

  17. If you chose Typical in the Installation Type window, or if you created a new local database in the advanced installation path, you will skip this step.

    If you chose to use an existing database in the advanced install path, you will see the Select Existing Database window. Select a database from the list of the existing databases.

    If you want to create other tables in the selected database, select the "Drop the tables, if existing, and create new tables" check box.

    After completing all of the fields, click Next to continue with the installation. You can click Back to review what you previous selected or click Cancel to exit the installation program.

  18. At this point, you have answered all the customization questions and the verification steps are successfully completed. The Preview window opens and displays a summary of all of the choices that you made on the previous panels.

    Click Install to continue with the installation, click Back to review what you previously selected, or click Cancel to exit the installation program.

  19. The installation program begins to install the selected features of the Performance Manager server, or client, or both, as follows:
    • If you previously selected to create a new database, the Create Database Progress window opens.

      A progress bar indicates the status of creating the database. You can click Cancel to exit the installation wizard.

      Note:Note: If you click Cancel, a window opens asking you to confirm the cancellation of the installation wizard, for example: Cancel the current operation? Yes No. If you confirm the cancellation by clicking Yes, the information you entered or selected in previous windows is not saved. You must start the installation again from the first step.
    • If you previously selected to create a new database and the creation failed, the Error on Create Database window opens.

      An error message is displayed indicating the cause of the errors that occurred during the creation of the database. See the log file for details. The most frequent source of failure is naming a preexistent database. If this is the case, click Back to select another database name to create or to select an existing database. Alternatively, click Cancel to exit the installation wizard.

    • If you previously selected to create a new database or you selected an existing database and also selected the Drop the tables, if existing, and create new tables check box, the Create Database Objects Progress window opens.

      A progress bar indicates the status of creating the database objects. You can click Cancel to exit the installation wizard.

      Note:Note: If you click Cancel, a window opens asking you to confirm the cancellation of the installation wizard, for example: Cancel the current operation? Yes No. If you confirm the cancellation by clicking Yes, the information you entered or selected in previous windows is not saved. You must start the installation again from the first step.
    • The Installation Progress window opens indicating the progress of the installation.

      This phase of the installation usually takes less than 5 minutes, depending on the configuration of your machine. You can click Cancel to exit the installation wizard.

      Note:Note: If you click Cancel, a window opens asking you to confirm the cancellation of the installation wizard, for example: Cancel the current operation? Yes No. If you confirm the cancellation by clicking Yes, the information you entered or selected in previous windows is not saved. You must start the installation again from the first step.
  20. The Finish window opens. Before proceeding, you might want to review the log file for any possible error messages. The log file is located in the following file:
    xxx/logs/dmlog.txt

    where:

    xxx is the destination directory where the Performance Manager server or client was installed.

    The pmlog.txt file contains a trace of the installation actions.

    Click Finish to exit the installation wizard.

  21. Click Exit on the LaunchPad window to end the LaunchPad program if you have not already done so.
  22. If you want to work with Performance Manager immediately, you must manually start the servers by performing the following steps:
    1. To start IBM Director, type the following command:
      twgstart
    2. To start IBM WebSphere Application Server, type the following command:
      <WAS_dest-path>/bin/startServer.sh server1

      where:

      <WAS_dest-path> is the destination path where the IBM WebSphere Application Server was installed. If it was installed by MDM, the default destination path is as follows:

      /opt/IBM/mdm/Websphere/AppServer
    3. To start IBM HTTP Server, type the following command:
      <httpServer_dest-path>/bin/apachectl start

      where:

      <httpServer_dest-path> is the destination path where the IBM HTTP Server was installed. If it was installed by MDM, the default destination path is as follows:

      /opt/IBM/mdm/IBMHTTPServer
    4. To start IBM HTTP Admin, type the following command:
      <httpServer_dest-path>/bin/adminctl start

      where:

      <httpServer_dest-path> is the destination path where the IBM HTTP Server was installed. If it was installed by MDM, the default destination path is as follows:

      /opt/IBM/mdm/IBMHTTPServer
  23. Start the IBM Director Console and log on to verify if the Performance Manager installation was successful.
    1. To start IBM Director Console, enter the following command:
      twgcon
    2. Log on to the IBM Director Server. When you log on to the IBM Director Server through the IBM Director Console, the user ID and password are validated against the security subsystem for the operating system where the IBM Director Server component is installed, not on the workstation where the IBM Director Console is running. The user ID and password must be valid on the operating system where the IBM Director Server is running, and the user must be authorized as an IBM Director administrator.
      Server name
      Identifies the IBM Director Server that you want to log on to.
      User ID
      Identifies the user ID of the person opening the console.
      Password
      Specifies the password for the user ID entered.
Result

If you can successfully log on to the IBM Director, expand the Multiple Device Manager task, and see the Manage Performance task, Performance Manager is properly installed.

You can continue with the post installation tasks for Performance Manager using the procedures in the section titled: Configuring.

You can also see the post installation tasks by clicking Post installation tasks on the LaunchPad window.

Post-processing requirements

If you want to do SAN Volume Controller Performance Data Collection, you will need to create an SSH key pair. Perform the following steps to create an SSH key pair:

  1. Check if you already have a key pair in the ~/.ssh directory.
  2. If you do not have a key pair, generate the SSH key pair by typing the following command in a command window:
    ssh-keygen -t rsa

    Accept the default key location by pressing enter without entering a different location.

    When prompted for a passphrase, press enter without typing anything for an empty passphrase.

    Press enter again to confirm the empty passphrase.

    The key pair will be generated and stored in files called id_rsa and id_rsa.pub.

  3. When SAN Volume Controller Performance Data Collection runs, the SSH facility will find the private key in the ~/.ssh directory.
  4. You must provide the public key to the SAN Volume Controller Console to store it on the SAN Volume Controller Cluster. The following steps are a summary of this procedure:
    1. Start the browser to access the SAN Volume Controller Console.
    2. Log onto the SAN Volume Controller Console.
    3. Select Clusters in the left hand frame.
    4. Select the cluster in which you are interested and select Launch the SAN Volume Controller application to open a secondary browser window to manage your specific cluster.
    5. Expand Service and Maintenance in the left hand frame.
    6. Select Maintain SSH Keys to get to the panel where you can input the SSH public key.
    Attention: Attention: If you do not do store the SSH public key on the SAN Volume Controller cluster, the Performance Manager cannot connect to the cluster.
Related topics Installing on the Linux operating system Installing Replication Manager for Linux

(C) Copyright International Business Machines Corporation 2004