Installing WebSphere Business Integration Express Plus for Item Synchronization

This chapter contains the following sections:

Installing WebSphere Business Integration Express Plus for Item Synchronization software

The IBM WebSphere InterChange Server installation CD provides a GUI-based setup program that guides you through the installation of the software.

Before you perform the procedures described in this chapter, ensure that your system meets the Installation requirements.

To start the installation process, do the following:

  1. From the WebSphere Business Integration Express for Item Synchronization Launchpad, select Install Product.

    The Install product screen appears.

    Note:
    This procedure assumes installation from a CD. If you plan to obtain the electronic download version from Passport Advantage, refer to your Passport Advantage information for those downloading instructions.

    Figure 7. The Install Product screen


  2. Click Launch Product Installation.
  3. At the Welcome screen, Click Next.

    The License Agreement screen appears.

  4. Read and accept the terms of the Software License Agreement, then click Next.
  5. Accept the default installation location or browse for a different location, then click Next.

    The Setup type screen appears.

    Figure 8. The Setup Type screen


  6. Select the setup type and click Next.

    You can select either a Typical setup or a Custom setup. The Websphere Business Integration Express and Express Plus for Item Synchronization solution only allows the e-mail adapter plus an additional three adapters to be installed and deployed. This means that a maximum of four adapters can be installed and deployed.

    Typical setup includes:

    Custom setup allows you to choose which features to install. Custom setup defaults to the features installed with Typical setup. You should be familiar with with your Enterprise Resource Planning application data before selecting additional components. Custom setup is recommended for advanced users.

    Custom setup allows you to select the following:

    If you select Custom setup, the Feature screen will appear. Select specific features to be installed, confirm your selections, then click Next.

    Figure 9. The Summary screen


  7. If you selected any tools, you will be prompted for an HTTP port, SSL port, and a WebSphere Port Block. Use the following command to check for available ports on your system:

    netstat *cnn
     
    Note:
    The WebSphere Block Port field needs the first port number for an available block of 12 consecutive ports.

    The Summary screen appears.

  8. Review the features and installation location and click Next.

    A number of informational screens are presented. Click Next.

Before starting InterChange Server for the first time (for both Express and Express Plus versions)

After installing WebSphere Business Integration Express for Item Synchronization on your OS/400 system, you must perform the following steps before you start InterChange Server for the first time:

  1. Sign on to OS/400 with a user profile that has *SECADM authority.
  2. Run the following, which is case-sensitive. Type it exactly as shown.
    CL command: STRSEU SRCFILE(QWEBBIICS/QWEBBIICS) SRCMBR(QWEBBISTR)
     

    Note:
    Make the following changes, then press F3 followed by Enter to save the changes.
    1. Change line 8 to be the following, making sure -design is in lower case:
      DCL VAR(&DESIGN) TYPE(*CHAR) LEN(10) VALUE('-design ')
       
    2. After line 16 add the following lines:
      /*********************************************************************/ 
       /* START THE MQ QUEUE MANAGER */ 
       /*********************************************************************/ 
       ADDLIBLE QMQM 
       STRMQM MQMNAME(QWEBBIICS.QUEUE.MANAGER) 
       MONMSG MSGID(CPF0000) EXEC(GOTO AGAIN1) 
       GOTO NEXT1 
       AGAIN1: ADDLIBLE QSYS2924 
       STRMQM MQMNAME(QWEBBIICS.QUEUE.MANAGER) 
       NEXT1:
       
  3. Run CL Command: CRTCLPGM PGM(QWEBBIICS/QWEBBISTR) SRCFILE(QWEBBIICS/QWEBBIICS) AUT(*EXCLUDE) REPLACE(*YES)
  4. Run CL Command: CHGOBJOWN OBJ(QWEBBIICS/QWEBBISTR) OBJTYPE(*PGM) NEWOWN(QWEBBIICS) CUROWNAUT(*REVOKE)
  5. Run CL Command: CHGOWN OBJ('/QIBM/UserData/WebBIICS/logs') NEWOWN(QWEBBIICS)
  6. Run CL Command: ENDSBS SBS(QWEBBIICS) OPTION(*IMMED)
  7. Run CL Command: STRSBS SBSD(QWEBBIICS/QWEBBIICS)
  8. Wait about 5 minutes for the InterChange Server to come up.
  9. Run CL Command: QSH
  10. Run QShell command: cd /QIBM/UserData/WebBIICS
  11. Run QShell command: bin/deploy.sh QWEBBIICS -cleanServer
  12. Press F3 to exit QSH.

WebSphere Business Integration Express Plus for Item Synchronization files and directories

Once WebSphere Business Integration Express for Item Synchronization is installed, you can view the file system and its contents. The server files and adapter files are loaded onto the OS/400 machine in the root file system in the /QIBM/ProdData/WebBIICS and /QIBM/UserData/WebBIICS directories.

The client directories are located under the IBM\WebSphereItemSync directory and they contain the files listed in Table 3.

Table 9. WebSphere Business Integration Express for Item Synchronization directory structure
Directory name Contents
_jvm This directory contains the Java Virtual Machine (JVM) that is used by Installer.
_uninstItemSync This directory contains the uninstaller.exe file that is used to remove WebSphere Business Integration Express for Item Synchronization 4.3.
a_unistWinClientItemSync This directory contains the uninstaller.exe file that is used to remove OS/400 files for WebSphere Business Integration Express for Item Synchronization 4.3.
_uninstZip This directory contains a listing of the unzipped System Manager files that are removed when the Uninstaller is run.
bin This directory contains the executable files, .dll files, and .bat files that the InterChange Server system uses.
collaborations This directory contains subdirectories that contain .class files and message files for installed collaborations.
connectors This directory contains files specific to each adapter in the system. It also contains adapter-specific files that you may need to install in the application that the adapter supports.
DataHandlers This directory contains the .jar files for data handlers that InterChange Server Express uses.
DevelopmentKits This directory contains sample files to assist the developer in creation of various system components. Samples provided include: Server Access for EJB, Server Access for J2EE Connector Architecture, connectors (C++ and Java), and Object Discovery Agents.
DLMs This directory contains subdirectories that contain Dynamic Loadable Modules (DLMs) and other files for InterChange Server maps.
legal This directory contains the license files.
lib This directory contains .jar files for the system.
messages This directory contains the generated message files.
mqseries This directory contains files specific to WebSphere MQ, including certain executable files.
ODA This directory contains the Object Discovery Agent .jar and .bat files for each agent.
repository This directory contains the definitions for the WebSphere Business Integration Express for Item Synchronization components.
Samples This directory contains component definitions for benchmarking samples and sample mail files for WebSphere Business Integration Express for Item Synchronization collaborations.
src This directory contains samples of Relationship Service APIs for cross-referencing.
Tools This directory contains the Workbench files if selected during installation.
WBSM This directory contains the Web-based System Monitor files.

Installing WebSphere Business Integration Express Toolset

Once you have completed this installation, you will need to install WebSphere Business Integration Express for Item Synchronization on your Windows client. The Toolset component only runs on a Windows client and is required to complete the configuration necessary to use the product. See "Installing WebSphere Business Integration Express Plus for Item Synchronization on a Windows system"for instructions. In order to use the toolset, select the same installation options you used during the OS/400 installation.

Uninstalling WebSphere Business Integration Express Plus for Item Synchronization

IBM provides an Uninstall program that you can use to remove your entire Websphere Business Integration Express for Item Synchronization installation, or select specific components for removal.

  1. Click Start > Settings > Control Panel.
  2. Double-click Add/Remove Programs.
  3. Scroll down and select IBM WebSphere Express for Item Synchronization. Click the Change/Remove button.
  4. The Uninstaller window appears. Click Next.

    The Select the features for IBM WebSphere Express for Item Synchronization you would like to uninstall window appears. The installed components appear with check marks next to them.

  5. Leave any components checked that you want removed and click Next.
  6. Click Next to confirm your selections.

    The Uninstaller window appears and removes the selected components.

  7. Click Finish.

Copyright IBM Corp. 2003, 2004