Upgrading from WebSphere Business Integration Connect - Express Version 4.2.1 to WebSphere Partner Gateway - Express Version 6.0 -- all platforms

This section describes how to upgrade from Business Integration Connect - Express version 4.2.1 to WebSphere Partner Gateway - Express version 6.0. The upgrade procedure uses a graphical user interface (GUI) and applies to all platforms on which Business Integration Connect - Express version 4.2.1 is installed.

Note:
If you are installing WebSphere Partner Gateway - Express for the first time, refer to the installation instructions in one of the following sections, depending on the type of installation you are performing:

The following steps describe how to perform the upgrade:

  1. Shut down version 4.2.1 of Business Integration Connect - Express.
    1. If your existing version of Business Integration Connect - Express is running, ensure that any documents that are in progress have finished processing.
    2. Close all open Web browser sessions that are connected to the WebSphere Partner Gateway - Express console.
    3. Stop the WebSphere Partner Gateway - Express server.
  2. Install the WebSphere Partner Gateway - Express version 6.0 using the installer.
    Note:
    The installer detects version 4.2.1 of Business Integration Connect - Express and backs up its data.
    1. Launch the installer, using Launchpad.

      On a Windows platform: Insert the WebSphere Partner Gateway - Express 6.0 CD-ROM into the CD-ROM drive on your computer. The Launchpad window opens.

      Note:
      If the Launchpad does not start automatically, you can start it manually by executing LaunchPad.bat, located in the root directory of the CD.

      On a Linux platform: Insert the WebSphere Partner Gateway - Express 6.0 CD-ROM into the CD-ROM drive on your computer. Open the Launchpad by executing LaunchPad.sh, located in the root directory of the CD.

      Note:
      Alternatively, you can bypass the Launchpad and run the installer by changing directories to the WebSphere Partner Gateway - Express directory and executing setupLinux. If you do this, the installation wizard window opens, followed by a message panel telling you that an older version of Business Integration Connect - Express was detected. Proceed to 2c.

      On a system running i5/OS or OS/400: Insert the WebSphere Partner Gateway - Express 6.0 CD-ROM into the CD-ROM drive on the Windows PC that is connected to the system running i5/OS or OS/400. The Launchpad window opens.

      Note 1:
      If the Launchpad does not start automatically, you can start it manually by navigating to the express folder and double-clicking Launchpad.bat.

      Note 2:
      Alternatively, if you want to bypass the Launchpad, you can start the installer by executing the setup.exe -os400 command. If you do this, the Sign on to the Server window appears. Proceed to 2c.

      Caution:
      If you omit the -os400 parameter in the setup.exe -os400 command, the installation will occur on the Windows machine.

      The Launchpad window offers five options:

      • Product Overview, which utilizes your Web browser to take you to the IBM Web site containing product information about WebSphere Partner Gateway - Express.
      • ReadMe File, which opens the ReadMe file on the installation disk.
      • InfoCenter Documentation, which utilizes your Web browser to take you to the IBM WebSphere Partner Gateway - Express library Web site where you can download documentation for any edition of WebSphere Partner Gateway - Express.
      • Install the product, which starts the installation wizard.
      • Exit, which closes the Launchpad window.
    2. Click Install the product.

      The installation wizard window opens, followed by a message panel telling you that an older version of Business Integration Connect - Express was detected.

    3. Click Next on the "older version detected" panel.

      The Automated Backup window opens, asking whether you want to copy Business Integration Connect - Express version 4.2.1 data to a backup directory.

    4. Click the Yes button and ensure that the displayed path to the current Business Integration Connect - Express version 4.2.1 installation location is correct.
    5. Click Next.

      The data from Business Integration Connect - Express version 4.2.1 begins copying to the 421_backup subdirectory under the WebSphere Partner Gateway - Express version 6.0 installation directory. A status box opens to show the progress of the backup operation. When data copying has finished, the status box closes.

    6. Click Next. The HTTP Port window appears. The installation wizard detects ports that are currently in use, then assigns default unused ports for use by WebSphere Partner Gateway - Express.

      The following types of ports are displayed:

      • HTTP Port -- The default communications port for normal communications
      • HTTPS1 Port -- The communications port used for secure (encrypted) communications.
      • HTTP2 Port -- A duplicate of the default communications port for normal communications
      • HTTPS2 Port -- A duplicate of the communications port used for secure (encrypted) communications.
      • Bootstrap Port -- A port that is used internally by WebSphere Partner Gateway to start the embedded version of WebSphere Application Server
      • SOAP Address Port -- A port that is used internally by WebSphere Partner Gateway to start the embedded version of WebSphere Application Server
    7. Make sure that the HTTP port number is the same port number used in the 4.2.1 installation. If the other default ports shown (HTTPS1, HTTP2, HTTPS2, Bootstrap, and SOAP) do not conflict with other resources on the computer, accept them.
      Note:
      If you specify an HTTP port that is already in use, the system generates a warning and an Exception when you start the server. If this occurs, re-install WebSphere Partner Gateway - Express and choose a different HTTP port.
    8. Click Next. The Default Folder Name window appears.
    9. The Default Folder Name window shows the name of the shortcut menu folder that WebSphere Partner Gateway - Express will install on your Start > Programs menu. Either accept the default name or change it.
    10. Click Next. The Service Settings window appears.
    11. Click Next. The Windows Service Installation window appears. If you would like to register WebSphere Partner Gateway - Express as a Windows service, select the Install as a Windows Service check box.
      Note:
      You must have administrator privileges in order to configure WebSphere Partner Gateway - Express to run as a service. If you do not have administrator privileges, you will see the Administrator check window. You must click Back and clear the Install WebSphere as a service check box.
    12. Click Next. The Summary window appears.
    13. Review your selections in the Summary window. If you need to change any of them, click the Back button to return to the appropriate window, make your changes, and click Next until you return to the Summary window.
    14. Click Next. The Installer installs the WebSphere Partner Gateway - Express software (this can take several minutes).
      Note:
      WebSphere Application Server 6.0 is automatically installed with the WebSphere Partner Gateway - Express product.
    15. When the installation process is complete, the First Steps application options window appears, asking whether or not you want to launch the First Steps application. To learn how to get started with WebSphere Partner Gateway - Express, select Yes. Otherwise, click No.
      Note:
      If you have installed WebSphere Partner Gateway - Express version 6.0 as an upgrade from a previous version, select No to avoid starting the First Steps application.
    16. Click Next. The Installation Confirmation window appears.
    17. Click Finish on the installation confirmation window to complete the installation process. If Yes was selected in the First Steps Application launch window, the First Steps application window opens. See Using the First Steps application for information on using this feature.
      Note:
      On particularly fast PCs, the First Steps window may open on top of the installation confirmation window before you have clicked Finish. If this happens, make the installation confirmation window the current window and click Finish to close it before proceeding to First Steps.
  3. Start the WebSphere Partner Gateway - Express server, using the desktop shortcut provided during the installation of WebSphere Partner Gateway - Express 6.0.
    Note:
    It can take several minutes for the WebSphere Partner Gateway - Express server to become fully operational.
  4. Run the pre- data migration tool to convert the version 4.2.1 security data to data that is compatible with the 6.0 environment. Security data can include: The following steps describe how to run the pre- data migration tool.
    1. Open a command prompt window.
    2. Change the directory to WebSpere_Partner_Gateway_Express_Install_Dir.
    3. Run the shell script bcgMigrateConvertor.bat or bcgMigrateConvertor.sh, depending on your operating system.
      Note:
      If the 421_backup directory is not a subdirectory of the WebSpere_Partner_Gateway_Express_Install_Dir directory, you must specify the full path to the 421_backup directory as the first parameter d.
    4. When the migration tool has finished, close the command prompt window.
  5. Run the data migration tool to migrate the Business Integration Connect - Express version 4.2.1 data saved earlier to your new WebSphere Partner Gateway - Express version 6.0 installation. To run the tool:
    1. Open a command window.
    2. Change the current directory to: WebSpere_Partner_Gateway_Express_Install_Dir/bin
    3. Run shell script bcgMigrate.bat or bcgMigrate.sh, depending on your operating system.
      Note:
      If the 421_backup directory is not a subdirectory of the WebSpere_Partner_Gateway_Express_Install_Dir directory, you must specify the full path to the 421_backup directory as the first parameter
    4. When the migration tool has finished running, close the command window.
  6. Run WebSphere Partner Gateway - Express version 6.0 to confirm that it is installed and configured properly.
    1. Start the console.
      If the login screen opens in a Web browser session, the server is operational. (If the login window does not open, wait a few minutes and then try starting the console again.) Do not log in.
    2. Close the Web browser to exit the login screen.
    3. Stop the WebSphere Partner Gateway - Express server, using the desktop shortcut provided during the installation of WebSphere Partner Gateway - Express 6.0.
    4. Start the WebSphere Partner Gateway - Express server, using the desktop shortcut provided during the installation.
    5. Start the WebSphere Partner Gateway - Express console, using the desktop shortcut provided during the installation.

      WebSphere Partner Gateway - Express version 6.0 is now ready for use.

  7. Uninstall Business Integration Connect - Express version 4.2.1. Refer to Appendix C. Uninstalling WebSphere Partner Gateway - Express for instructions.

Copyright IBM Corp. 2003, 2005