Installing Replication Manager for Linux Installing on the Linux operating system

You can use these procedures to install Replication 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 Replication 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 Replication Manager LaunchPad, which is a small graphic program that launches the installation setup program.

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

  3. The following options are displayed when the LaunchPad window opens:
    Replication Manager overview
    Provides information about Replication 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 Replication Manager.
    License agreement
    Provides information about the license for Replication Manager.
    Replication Manager Web site
    Provides information from the product Web site.
    Installation wizard
    Starts the Replication Manager installation program.
    Post installation tasks
    Provides information about configuring users and device communication.
    Exit
    Exits the Replication Manager LaunchPad program.
  4. Click Readme file from the LaunchPad window or from the README.txt file located in the doc or LINUX directory on the Replication Manager CD to check for information that might supersede these procedures.
  5. Click Installation wizard from the LaunchPad window to start the installation of Replication 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 an 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, accept 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.
  10. The Select Product Type window opens. You can select one of the following two types of installations:
    • Replication Manager Server

      This option installs both Replication 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 are installed, and contains all the product features:

      Replication Manager Application
      The program installs the Performance Manager WebSphere Application Server applications. If this feature is selected, the Replication Manager installation program checks if IBM WebSphere Application Server 5.1 is installed on your system. If it is not installed, an error message is displayed.
      Director Server Extensions
      The program installs Replication Manager extensions for IBM Director Server 4.12 or greater.
      Director Console Extensions
      The program installs Replication 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 Replication Manager Server option (including all the product features listed above), the Features Selection window is skipped.
      2. If you select the Replication 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.
    • Replication Manager Client

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

      Note:Note: If you select the Replication Manager Client option on a system where you have installed 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 Replication Manager server on a system where the Replication Manager server is already installed
    • If you want to reinstall the Replication Manager client on a system where one or both clients (Replication Manager Director Console Extension and Replication Manager Command Line Client) are installed
  11. The Installation Type window opens. You can now choose whether you would like to perform a typical or advanced installation. In the typical installation, you will create a new database for each subcomponent. In the advanced installation, you can choose either to create a new database or to use an existing database for each subcomponent.

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

  12. The Features Selection window opens in the following cases:
    • If you selected theReplication Manager Client option in the previous window
    • If you want to reinstall the Replication Manager client on a system where only one Replication Manager client was previously 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 Replication Manager extensions (or Replication 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 Replication Manager command-line client (or Replication Manager CLI Client).

    If you have previously installed some Replication Manager features (for example, Director Console Extensions), you will be given the opportunity to add additional features to the current instalationl or to reinstall the selected features. These already installed features are marked as (installed) (in our example, Director Console Extensions (installed)).

    Note:Note: If you want to reinstall the Replication Manager client on a system where the Replication Manager client was previously installed with all clients (console and CLI), 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.

  13. The installation program verifies that the following prerequisite products and product versions are installed on your system:
    1. For installation of the Replication Manager server:
      • IBM DB2 8.1 (or greater)
      • IBM Director Server 4.12 (or greater)
      • IBM WebSphere Application Server 5
      • IBM TotalStorage Multiple Device Manager Server
    2. For installation of the Replication Manager client:
      • Only IBM Director Console 4.12 (or greater)
      • IBM TotalStorage Multiple Device Manager Console

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

    Otherwise, the result is displayed in the Checking Prerequisite Products window (next step).

  14. 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 Replication Manager installation program.

  15. If you chose the typical installation, you will skip this step and go directly to step 16.

    If you chose the advanced installation, the Select Database for Hardware Subcomponent window opens. You must select what type of hardware database you want to be dedicated to the Replication Manager from the following:

    • 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. The Create Local Database for "Hardware" Subcomponent 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 the Hardware subcomponent. You cannot share the Hardware database with any other applications or subcomponents of Replication Manager.
    • Database path
    If you want the program 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; or click Back to review what you previously selected; or click Cancel to exit the installation program.

  17. If you selected the typical installation, or if you selected the Create a new Hardware local database option in the Select Database window, this step is skipped.

    Otherwise, the Select Existing Database for "Hardware" Subcomponent window opens. You must select the database from the list of available databases.

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

  18. If you chose the typical installation, you will skip this step and go directly to step 19.

    If you chose the advanced installation, the Select Database for "ElementCatalog" Subcomponent window opens. You must select what type of element catalog database you want to be dedicated to the Replication Manager 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.

  19. The Create Local Database for "ElementCatalog" Subcomponent window opens. You must enter parameters for the new element catalog database in the following fields:
    • Database name
      Note:Note: The database name must be unique to the ElementCatalog subcomponent. You cannot share the ElementCatalog database with any other applications or subcomponents of Replication Manager.
    • Database path
    If you want the program 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; or click Back to review what you previously selected; or click Cancel to exit the installation program.

  20. If you selected the typical installation, or if you selected the Create a new ElementCatalog local database option in the Select Database for "ElementCatalog" Subcomponent window, this step is skipped.

    Otherwise, the Select Existing Database for "ElementCatalog" Subcomponent window opens. You must select the database from the list of available databases.

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

  21. If you chose the typical installation, you will skip this step and go directly to step 22.

    If you selected the advanced installation, the Select Database for "ReplicationManager" Subcomponent window opens. You must select what type of Replication Manager database you want to be dedicated to the Replication Manager 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.

  22. The Create Local Database for "ReplicationManager" Subcomponent window opens. You must enter parameters for the new Replication Manager database in the following fields:
    • Database name
      Note:Note: The database name must be unique to the ReplicationManager subcomponent. You cannot share the ReplicationManager database with any other applications or subcomponents of Replication Manager.
    • Database path
    If you want the program 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; or click Back to review what you previously selected; or click Cancel to exit the installation program.

  23. If you selected the typical installation, or if you selected the Create a new ElementCatalog local database option in the Select Database for "ReplicationManager" Subcomponent window, this step is skipped.

    Otherwise, the Select Existing Database for "ReplicationManager" Subcomponent window opens. You must select the database from the list of available databases.

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

  24. If you chose the typical installation, you will skip this step and go directly to step 25.

    The Select Database for "svcHardware" Subcomponent window opens. You must select what type of SVC hardware database you want to be dedicated to the Replication Manager 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.

  25. The Create Local Database for "svcHardware" Subcomponent window opens. You must enter parameters for the new Replication Manager database in the following fields:
    • Database name
      Note:Note: The database name must be unique to the svcHardware subcomponent. You cannot share the svcHardware database with any other applications or subcomponents of Replication Manager.
    • Database path
    If you want the program 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; or click Back to review what you previously selected; or click Cancel to exit the installation program.

  26. If you selected the typical installation, or if you selected the Create a new svcHardware local database option in the Select Database for "svcHardware" Subcomponent window, this step is skipped.

    Otherwise, the Select Existing Database for "svcHardware" Subcomponent window opens. You must select the database from the list of available databases.

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

  27. If you selected IBM Replication Manager CLI Client, you are required to enter the co-server host name, port value, user name and user password to enable Performance Manager CLI access in CoServer Parameter window.

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

  28. 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 begin the installation, click Back to review what you previously selected, or click Cancel to exit the installation program..

  29. The installation program begins to install the selected features of Replication Manager, as follows:
    1. If you previously selected the creation of a new database for the hardware subcomponent:
      • The Create Database for Hardware Subcomponent 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 the creation of a new database has failed, the Error on Create Database for Hardware Subcomponent 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 for the hardware subcomponent and you selected the Create the database tables check box, or if you selected an existing database for the hardware subcomponent and selected the Drop the tables, if existing, and create new tables check box, the Create Database Objects for hardware Subcomponent 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.
    2. If you previously selected to create a new database for the ElementCatalog subcomponent:
      • The Create Database for ElementCatalog Subcomponent 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 the creation of a new database for the ElementCatalog subcomponent failed, the Error on Create Database for ElementCatalog Subcomponent 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 for the ElementCatalog subcomponent and you selected the Create the database tables check box, or if you selected an existing database for the ElementCatalog subcomponent and selected the Drop the tables, if existing, and create new tables check box, the Create Database Objects for ElementCatalog Subcomponent 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.
    3. If you previously selected the creation of a new database for the ReplicationManager subcomponent:
      • The Create Database for ReplicationManager Subcomponent 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 the creation of a new database has failed, the Error on Create Database for Replication Manager Subcomponent 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 for the Replication Manager subcomponent and you selected the Create the database tables check box, or if you selected an existing database for the Replication Manager subcomponent and selected the Drop the tables, if existing, and create new tables check box, the Create Database Objects for Replication Manager Subcomponent 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.
    4. If you previously selected the creation of a new database for the svcHardware subcomponent:
      • The Create Database for svcHardware Subcomponent 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 the creation of a new database has failed, the Error on Create Database for svcHardware Subcomponent 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 preexisting 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 for the svcHardware subcomponent and you selected the Create the database tables check box, or if you selected an existing database for the svcHardware subcomponent and selected the Drop the tables, if existing, and create new tables check box, the Create Database Objects for svcHardware Subcomponent 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.
    5. 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.
  30. 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 Replication Manager was installed.

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

    Click Finish to exit the installation wizard.

  31. The postinstall.txt file is open automatically, displaying the information about the tasks to be performed after a successful installation of Replication Manager.
  32. Click Exit on the LaunchPad window to end the LaunchPad program if you have not already done so.
  33. 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
  34. Start the IBM Director Console and log on to verify if the Replication 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 Replication task, Replication Manager is properly installed.

You can continue with the post installation tasks for Replication 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.

Related topics Installing on the Linux operating system

(C) Copyright International Business Machines Corporation 2004