Installing Performance Manager for Windows Installing on the Microsoft Windows operating system Installing Replication Manager for Windows

You can use these procedures to install Performance Manager.

Prerequisites
  1. Log on to your system as a local administrator.
  2. Ensure that the user name has the required user rights.

    Performance Manager must be installed by a user name that is logged on as a local administrator (for example, as the administrator user) on the system where the Performance Manager will be installed. The user name must have the following system privileges, called user rights, to successfully complete the installation:

    • Act as part of the operating system
    • Create a token object
    • Increase quotas
    • Replace a process-level token
    • Debug programs
    Note:Note: The installation program checks the user privileges and asks the user to set these privileges in Step 13.

    These user rights are governed by the local security policy and are not initially set as the defaults for administrators. They might not be in effect when you log on as the local administrator. If the Performance Manager installation program does not detect the required user rights for the logged-on user name, the program can optionally set them. The program can set the local security policy settings to assign these user rights.

    Alternatively, you can manually set the user rights prior to performing the installation. Perform the following steps to manually set these privileges:

    1. Click Start -> Settings -> Control Panel.
    2. Double-click Administrative Tools.
    3. Double-click Local Security Policy. The Local Security Settings window opens.
    4. Expand Local Policies.
    5. Click User Rights Assignments to see the policies in effect on your system. For each policy that you want to add, perform the following steps:
      1. Highlight the policy to be checked.
      2. Double-click the policy and look for the user name in the Assigned To column of the Local Security Policy Setting window to verify the policy setting. Ensure that both the Local Policy Setting and the Effective Policy Setting check boxes are selected.
      3. If the user name does not appear in the list for the policy, you must add the policy for the user. Perform the following steps to add the user name to the list:
        1. Click Add on the Local Security Policy Setting window. The Select Users or Groups window opens.
        2. Highlight the user or group in the Name column.
        3. Click Add to put the name in the lower window.
        4. Click OK to add the policy to the user or group.
  3. After these user rights are set (either by the installation program or manually), log off the system, and then log on again so that the user rights can take effect.
  4. The SSH client is used to connect to the SSH server software in the SAN Volume Controller cluster. This software is preinstalled on the SAN Volume Controller management node.

    Windows platform: for the Windows platform, this SSH client support must be provided by PuTTY. If PuTTY is not already installed on your system, you can find the installation software on your Performance Manager CD. The installation program is in the <CD root>SSHClient\PuTTY directory. The wizard to install PuTTY is started using the putty-0.53b-installer.exe file. Accept all default settings as you run the PuTTY installation wizard.

    Refer to the section explaining how to customize Performance Manager to run San Volume Controller cluster data collection tasks for information about PuTTY keys.

  5. Stop the IBM WebSphere Application Server, if it exists on the system: Start->Programs->IBM WebSphere->Application Server v5.1->Stop the Server, if the WebSphere Application Server has the global security disabled. Otherwise stop WebSphere Application Server by running from a separate Command Prompt window the following command:
    <WAS_dest-path>\bin\stopServer.bat server1 -username <username> 
    -password <password>
    where:

    <WAS_dest-path> is the destination path, where IBM WebSphere Application Server v5.1 was installed

    <username> is the name of a Console user having an Operator or Administrator role, when Global Security is enabled

    <password> is the password of the entered user

    Note:Note: If WebSphere Application Server was installed as part of the Multiple Device Manager installation:
    • You can use the Multiple Device Manager superuser ID or a Console user having an Operator or Administrator role to stop WebSphere Application Server.
    • <WAS_dest-path> is <dest-path>\WebSphere\AppServer

      where <dest-path> is the installation location for the Multiple Device Manager.

  6. Next, you must stop the IBM Director services by selecting each on the Service panel in Administrative tools, then selecting stop in the Action menu:
    1. Click Start ->Settings and click the Control Panel icon.
    2. In the Control Panel window, double-click the Administrative Tools icon.
    3. In the Administrative Tools window, double-click the Services icon.
    4. In the Services window, find and single-click the IBM Director Server icon.
    5. Select the Stop option from the Action menu.
    6. In the Services window, single-click the IBM Director Support Program icon.
    7. Select the Stop option from the Action menu.
    8. In the Services window, single-click the IBM HTTP Administration 1.3.28 service.
    9. Select the Stop option from the Action menu.
    10. In the Services window, single-click the IBM HTTP Server 1.3.28.
    11. Select the Stop option from the Action menu.
    12. Close the Services window.
    13. Close the Administrative Tools window.

    When you complete these steps, the IBM Director icon that is located in the start tray (lower right corner of the screen) changes to a red diamond indicating that the server has stopped.

Steps
  1. Insert the Performance Manager CD into the disk drive.

    If you have AutoRun mode set on your system, the Performance Manager installation program should start within 15 - 30 seconds.

    If the LaunchPad window does not open or you do not have AutoRun set on your system, use a Command Prompt to change to the W2K directory on the CD and type:

    LaunchPad
    
  2. 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 this installation guide.
    Installation guide
    Provides instructions on how to install Performance Manager (a softcopy of this document).
    License agreement
    Provides information about the license for Performance Manager.
    IBM 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 users and device communications.
    Exit
    Exits the Performance Manager LaunchPad program.
  3. Click Readme from the LaunchPad window or from the README.txt file located in the doc or W2K directory on the Performance Manager CD. Check for information that might supersede the information in this guide.
  4. Click Installation wizard from the LaunchPad window to start installing 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.
  5. There might be a slight delay while the software loads on your system. After the software loads, a DOS prompt window displays the following message:
    +-----------------------------------------------------------------------+
    |Initializing InstallShield Wizard...                                   |
    |Searching for Java (tm) Virtual Machine ............................. .|
    |......................................................                 |
    +-----------------------------------------------------------------------+
  6. The Welcome window opens suggesting what documentation you should review prior to installation. Click Next to continue, or click Cancel to exit the installation.
  7. Read the license agreement information when the License Agreement window opens.

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

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

  8. Select one of the following options in the Destination Directory window:
    1. Click Next to accept the default directory.
    2. Click Browse to select a different directory for the installation and then click Next to continue the installation process.
    3. Click Cancel to exit the installation process.
    Note:Note: The Multiple Device Manager Director extensions files will not be installed under the specified destination directory. They will be automatically installed under the IBM Director installation location.

    If you want to reinstall the product, this window is skipped.

  9. In the Select Product Type window, select one of the following two types of installations:
    • Performance Manager Server

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

      Performance Manager Application
      Installs the Performance Manager WebSphere Application Server applications.
      Director Server Extensions
      Installs the Performance Manager extensions for IBM Director Server 4.12 or greater.
      Director Console Extensions
      Installs the Performance Manager extensions for IBM Director Console 4.12 or greater.
      Command Line Client
      Installs the Performance Manager Command Line Client.

      If you select Performance Manager Server (all the product features listed above), the Features Selection window is skipped.

      Note:Note: If you select to install Performance Manager Server on a system where you have installed only IBM Director Console, an error message is displayed and the installation program will stop.
    • Performance Manager Client

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

      Note:Note: If you select Performance Manager Client on a system where you have installed IBM Director Server and also IBM Multiple Device Manager Server, an error message is displayed and the installation program will stop.

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

    Note:Note: This window is skipped in the following cases:
    1. If you want to reinstall Performance Manager Server on a system with Performance Manager Server installed;
    2. If you want to reinstall Performance Manager Client, on a system where one or both clients (Performance Manager Director Console Extension and Performance Manager Command Line Client) are installed.
  10. If you selected to install the Performance Manager Client in the previous window or if you want to reinstall Performance Manager Client on a system where one client is installed, you can select one or more from the following features:
    Director Console Extensions
    This feature must be selected if you want to install Performance Manager console extensions (or Performance Manager Console) on a system, where both IBM Director Console 4.12 or greater and IBM Multiple Device Manager Console are installed.
    Command Line Client
    This feature must be selected if you want to install Performance Manager Command Line Client (Performance Manager CLI Client).

    If you have previously installed one Performance Manager Client feature (for example, Director Console Extension) you will be given the opportunity to add additional features to the current install 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 Performance Manager Client on a system where Performance Manager Client was previously installed with all clients, this window is skipped.

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

  11. The installation program verifies that the following prerequisite products and product versions are installed on your system:
    1. For Performance Manager Server:
      • IBM DB2 8.1 (or greater)
      • IBM Director Server 4.12 (or greater)
      • IBM WebSphere Application Server V5.1
      • IBM Multiple Device Manager Server
      • Secure Shell (SSH) Client
    2. For Performance Manager Client:
      • IBM Director Console 4.12 or greater (only for Performance Manager Console client).
      • IBM Multiple Device Manager Console (only for Performance Manager Console client).
  12. The Checking Prerequisite Products window displays any problems that were found when the program checked for the prerequisite products. If the prerequisite products are not installed or the wrong version is installed, the installation program cannot continue and you must correct the problem.

    Click Cancel to exit the Performance Manager installation program.

  13. If the installation program detects the user, who is logged onto Windows, does not have all of the required privileges (user rights) needed to perform the installation, a message window opens, asking the user to set these privileges.

    If you want to manually set these privileges, click No to quit the installation program. See Step 1 for instructions on how to manually set these privileges. Then, log off and log on again to make these privileges take effect.

    Click Yes to permit the installation program to update the user rights. When this action is completed, a new pop-up window opens that tells you to log off and log on again to make the privileges take effect. When you log on again, you must restart the installation from the very beginning (from Step 2).

  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 you selected to install Performance Manager Server, the PuTTY Configuration window opens. This window contains information about generating the private key file, using the PuTTYgen utility, if you want to manage IBM San Volume Controllers at Performance Manager installation time.

    You must enter the private key file name, generated before, or select it using the Browse button and then click the Next button to continue the installation. The program will check whether the type of key is correct.

    If you do not use a SSH Client, you do not need a SSH2 RSA private key, then you can skip this step by selecting the "Skip this step" check box. If you decide to use a SSH Client later, after Performance Manager installation, you have to generate manually the private key file icat.ppk in the location where PuTTY utility is installed under the pmgrkey sub-directory. For example:

    <PuTTY_home>\pmgrkey\icat.ppk
    

    where, <PuTTY_home> is the location where the PuTTY utility is installed on your system.

    You can click Cancel to exit the installation process or click Back to go back to the previous window.

  16. Note:Note: The following screen will only appear if you chose the advanced installation path.
    If you selected Performance Manager Server, the Select Database window requires you to select what type of database you want to be dedicated to the Performance Manager Server from the following:
    • Create a new Performance Manager local database
    • Use existing Performance Manager database

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

  17. If you chose either the typical install path, or to create a new local database in the advanced path, enter parameters for the new database in the following fields of the Create Local Database window:
    • 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 drive
      Note:Note: If the database name that you entered already exists with the same alias on the same specified path/drive, a warning message will display. Please choose: Use if you want to use the existing database. Drop then create if you want the installer to drop and then recreate a new database with the same name and alias on the specified path/drive, or Cancel if you want to change the database name or the path/drive.

    If you want to also create the database tables, select the Create the database tables check box.

    After completing all the fields, click Next to continue the installation. Click Back to review what you previously selected. Click Cancel to exit the installation program.

  18. 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.

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

    Click Install to continue the installation. Click Cancel to exit the installation wizard. Click Back to review what you previously selected.

  20. The installation program begins to install the selected features of the Performance Manager, as follows:
    • If you previously selected the creation of a new database, the Create Database Progress window displays a progress bar that indicates the status of the database creation. 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: Cancel the current operation? Yes No. If you click Yes to confirm the cancellation, 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 the creation of a new database and this creation has failed, the Error on Create Database window indicates the cause of the errors during creation of the database.

      See the log file for details. The most frequent source of failure is naming a preexisting database. If this is the case, click Back to select another database name to create or to select an existing database. Click Cancel to exit the installation wizard.

    • If you previously selected the creation of a new database and you selected the Create the database tables check box or, if you selected an existing database and 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. 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: Cancel the current operation? Yes No. If you click Yes to confirm the cancellation, 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 indicates how much of the installation has completed.

      This phase of the installation usually takes under 5 minutes, depending on the configuration of your machine. 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: Cancel the current operation? Yes No. If you click Yes to confirm the cancellation, the information you entered or selected in previous windows is not saved. You must start the installation again from the first step.
  21. 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 xxx\logs\pmlog.txt file, where xxx is the destination directory where the Performance Manager was installed. The pmlog.txt file contains a trace of the installation actions.

    Click Finish to exit the installation wizard.

    Note:Note: Ordinarily, you do not need to restart your system during or after the installation of the Performance Manager. However, the installation wizard might determine that a restart is necessary. Restart your system if required.
  22. Click Exit on the LaunchPad window to end the LaunchPad program if you have not already done so.
Post-processing requirements
  1. To manually start the IBM Director Support Program services, perform the following steps:
    1. Click Start -> Settings, and then double-click the Control Panel icon.
    2. From the Control Panel, double-click the Administrative Tools icon.
    3. From the Administrative Tools, double-click the Services icon.

      Perform the following steps to select and start each desired service (according to the selected features at installation time):

    4. From the Services window, single-click the IBM Director Support Program icon, and then select the Start option from the Action menu.
    5. From the Services window, single-click on the IBM Director Server icon, and then select the Start option from the Action menu.

      When you have completed these steps, the IBM Director icon that is located in the start tray (lower right corner of the screen) changes to a green circle indicating that the server has started.

    6. Start WebSphere by selecting the Start -> Programs -> IBM WebSphere -> Application Server V5.1 -> Start the Server.
    7. You must stop and restart the IBM Director server.
  2. Start the Director Console and log in to verify successful installation.
    1. Click Start -> Programs -> IBM Director -> IBM Director Console.
    2. Log in to the IBM Director server. When you log in 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.
      IBM Director Server
      Identifies the IBM Director server you wish to log in to.
      User ID
      Identifies the user ID of the person opening the console.
      Password
      Specifies the password for the user ID that was entered.
    3. After you are logged into IBM Director, look for Multiple Device Manager in the Tasks pane. Expand the Multiple Device Manager task and look for the Manage Performance task.
Result

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

You can continue with the post installation tasks for the Performance Manager using the procedures in the topic addressing MDM username and password restrictions and in the topics related to configuring Multiple Device Manager.

You can also click Post installation tasks on the LaunchPad window to view the post installation tasks.

Only after a successful installation of the Performance Manager you can also install Replication Manager.

Related topics Installing on the Microsoft Windows operating system Installing Replication Manager for Windows

(C) Copyright International Business Machines Corporation 2004