Using the Launchpad

This section contains the following topics:

Installation overview

This chapter provides a high-level view of the WebSphere Business Integration Express for Item Synchronization installation process.

The following tasks are described in detail in this guide:

  1. Confirm that your system meets the minimum hardware requirements.
  2. Confirm that all third-party software is installed or is available for installation as described in the installation process.
  3. Run the Launchpad to confirm that your system has the prerequisite software installed. If your system is missing any of the prerequisite software, you can use Launchpad to install the missing software.
  4. Install WebSphere Business Integration Express for Item Synchronization software.

Getting started

The WebSphere Business Integration Express for Item Synchronization installation CD provides a GUI-based setup launchpad and installation program that guides you through the installation and configuration of the software. IBM WebSphere Business Integration Express for Item Synchronization Launchpad provides a graphical user interface to check software prerequisites and the database setup on your computer. Installer provides a graphical user interface to guide you through the installation of WebSphere Business Integration Express for Item Synchronization.

If you have previously installed the appropriate version of the prerequisite products, you might not need to reinstall it for use with IBM WebSphere Business Integration Express for Item Synchronization. However, you should check the configuration instructions for the specific software.

To invoke the WebSphere Business Integration Express for Item Synchronization Launchpad:

Note:
If you are installing WebSphere Business Integration Express for Item Synchronization from an electronic software distribution, all electronic software distribution files for WebSphere MQ, DB2, and WebSphere Business Integration Express for Item Synchronization must be extracted into the same directory before you run the Installer.
  1. Insert the WebSphere Business Integration Express for Item Synchronization CD.
  2. Mount the CD:

    /mnt/cdrom
     
  3. Run the following command to start the Launchpad:

    /mnt/cdrom/start_launchpad.sh 
     
  4. At the Welcome screen, select Software Prerequisites.

    The Software Prerequisites screen appears.

Software prerequisites

The WebSphere Business Integration Express for Item Synchronization Launchpad checks the queries the RPM package database to see if the prerequisite software is installed on your machine. See Installation requirements for a list of the required software.

After Launchpad checks your machine for prerequisite software, Launchpad displays the prerequisite software and the status. Statuses include Not Installed, Optional, or OK. WebSphere Business Integration Express for Item Synchronization requires the installation of the IBM Java Development Kit 1.3.1_05 and WebSphere MQ 5.3.0.2 CSD3. If these items are not installed, you can use the Launchpad to install them on your machine. Depending on your requirements, optional software does not have to be installed. Optional software includes Apache Tomcat 4.1.18 or 4.1.24, and IBM WebSphere Application Server Express v5.0.2. For more information on software prerequisites, see Installation requirements.

Installing the Java compiler

The Java compiler that is compatible with WebSphere Business Integration Express for Item Synchronization is contained within the IBM Java Development Kit 1.3.1_05 and is required for Java-based adapters and collaboration and mapping development.

Note:
If you have already installed the JDK, remove or move the following files before proceeding with the installation process: java_sdk.sh.rpmorig java_sdk.sh and java_jre.sh.rpmorig java_jre.sh.

To install the IBM Java Development Kit 1.3.1_05:

  1. From the Software Prerequisites screen, expand IBM Java Development Kit 1.3.1_05.
  2. Click install to start the silent installation of IBM Java Development Kit 1.3.1_05.
  3. After IBM Java Development Kit 1.3.1_05 silent installation, verify that the status in the Launchpad changed from Not Installed to OK.

Installing WebSphere MQ

WebSphere MQ is messaging software that enables communication between InterChange Server Express and connectors. InterChange Server Express accesses the WebSphere MQ Server as an MQI Java client or JMS.

Note:
If you are installing from the CD and Launchpad prompts you to insert the CD for WebSphere MQ or DB2, insert the CD and make sure it is mounted successfully before you choose OK. If Launchpad does not detect the installation program, it will display an "Open" dialog box, in which you must select the location to which the CD is mounted.

To install IBM WebSphere MQ 5.3.0.2 CSD3:

  1. From the Software Prerequisites screen, expand IBM WebSphere MQ 5.3.0.2 CSD3.
  2. Click install to start the silent installation of IBM WebSphere MQ 5.3.0.2 CSD3.
    Note:
    If you do not plan to install the Tool components then select the I do not intend to install the Tools component box. Selecting this box changes the status from Not Installed to Optional in the Launchpad and allows you to continue with the installation process.
  3. After IBM WebSphere MQ 5.3.0.2 CSD3 silent installation, verify that the status in the Launchpad status changed from Not Installed to OK.

Installing Apache Tomcat

This guide does not provide installation instructions for Apache Tomcat 4.1.18 or 4.1.24. For a description of the installation process, expand Apache Tomcat 4.1.18 or 4.1.24 and click the link to the Apache Web site.

Installing WebSphere Application Server Express

This guide does not provide installation instructions for IBM WebSphere Application Server Express v5.0.2. For a description of the installation process, expand IBM WebSphere Application Server Express v5.0.2 and click the link to the IBM Web site.

Database setup

IBM WebSphere Business Integration Express for Item Synchronization supports IBM DB2 Universal Database v8.1 Express. In order to use IBM WebSphere Business Integration Express for Item Synchronization, you must have one of the supported databases installed on your machine. You must also have administrator privileges to create a new database and add new users. If you do not have one of the supported databases on your machine, you can use Launchpad to install IBM DB2 Universal Database v8.1 Express.

DB2 Express

Installing IBM DB2 Universal Database v8.1 Express

To install IBM DB2 Universal Database v8.1 Express, do the following:

  1. From Launchpad, click Database Setup.

    The Database Setup screen appears.

    Note:
    If you are installing from the CD and Launchpad prompts you to insert the CD for WebSphere MQ or DB2, insert the CD and make sure it is mounted successfully before you choose OK. If Launchpad does not detect the installation program, it will display an "Open" dialog box, in which you must select the location to which the CD is mounted.
  2. Click Install IBM DB2 Universal Database v8.1 Express to start the silent installation.
  3. After IBM DB2 Universal Database v8.1 Express is successfully installed, you should see a message that the database setup is complete. See Installing WebSphere Business Integration Express Plus for Item Synchronization for instructions on how to install WebSphere Business Integration Express for Item Synchronization.

Existing IBM DB2 Universal Database v8.1

To configure an already existing IBM DB2 Universal Database v8.1 database:

  1. From Launchpad, click Database Setup.

    A screen appears indicating that IBM DB2 Universal Database v8.1 was found on the computer.

  2. Click Continue.
  3. Do the following at the Setup DB2 SQL Procedures Environment screen:

    1. Type full pathname of the C/C++ compiler that DB2 uses to compile stored procedures in the Compiler Path field. If the compiler's executable is on the search path of commands, then you can leave this field blank.
    2. Either leave the Use the default value for DB2_SQLROUTINE_COMPILE_COMMAND box selected to use the default compiler command or clear the box and type the desired compiler command in the Compile Command field.
  4. Click Continue.

    After IBM Install IBM DB2 Universal Database v8.1 is successfully configured, you should see a message that the database configuration is complete. See Installing WebSphere Business Integration Express Plus for Item Synchronization for instructions on how to install WebSphere Business Integration Express for Item Synchronization.

Copyright IBM Corp. 2003, 2004