Installing the adapter

The adapter is available only as an ESD (electronic software delivery) download from the Web. Use Passport Advantage to download the setup files for IBM WebSphere Business Integration adapter for Maximo MEA to your system. The product part number also refers to the ESD image. The release notes for the installation are available on the InfoCenter Web site at: http://www.ibm.com/websphere/integration/wbiadapters/infocenter.

Installed file structure

Table 3 shows the file structure used by the adapter and lists the files that are installed on the system.

Notes:

  1. This document uses (\) backslashes as the convention for directory paths. For UNIX installations, substitute slashes (/) for backslashes.

  2. All product path names are relative to the directory where the product is installed on your system.


Table 3. Adapter files installed on system
Subdirectory of %Mro% Description

Contains:
  • CustDataHandler.jar - .jar file containing the WBIX-specific XML data handler.
  • MRO.jar - .jar file containing application-specific adapter classes.
  • start_MRO.bat and start_MRO.sh - startup scripts for the adapter.
  • WBIX.jar - .jar file containing WBIX-framework adapter class.
  • mroicl.zip - ICL .zip file for import into customer user project (in System Manager).
translations Directory for object mapping translations. Contains schemaTypes.xml, which is a translation manager configuration file.
translations\xslt Directory containing actual translation mapping files (XSL stylesheets).
conf Directory containing adapter XML profile.
lib Directory containing Java library classes for the adapter.

Installing the adapter on a Windows system

For a Windows system, the file download utility copies an executable file containing a set of installation files onto your machine. To install the adapter:

  1. Double-click the executable file in your setup directory. It extracts several files, including the setup file.
  2. Run the setup file for your platform from the setup directory.
  3. Select the language and click OK.
  4. Click Next to follow the steps in the installation program.
  5. Accept the license agreement terms and click Next.
  6. Specify a directory:
    1. If you are running ICS, you must install these files in the same product directory in which you installed ICS, for example, C:\IBM\WebSphereICS. In these steps, the ICS directory is called ICSdir.
    2. If you are running WebSphere MQ Integrator Broker, you must install these files in the same product directory in which you installed the WebSphere Business Integration adapter package. This is C:\WebSphereAdapters by default.

    Use the Browse button to locate the correct directory and select it.

  7. Click Next.
  8. Click Finish.

Installing the adapter on other platforms

If you are installing the adapter on an AIX platform:

  1. Download the .tar executable file to your setup directory.
  2. Extract the setup and README files:
     tar -xvf filename.tar
       
  3. Run the setup file:
    setupAIX.bin
       
  4. Specify a directory for the files:
    1. If you are running ICS, you must install these files in the same product directory in which you installed ICS. This is IBM/WebSphereICS by default.
    2. If you are running WebSphere MQ Integrator broker, you must install these files in the same product directory in which you installed the WebSphere Business Integration adapter package. This is /WebSphereAdapters by default.

Configuring the application for the adapter

This guide assumes that the Maximo Enterprise Adapter (MEA) application has already been configured to send and receive messages externally from MQseries queues.

Copyright IBM Corp. 1997, 2003