Installing the WebSphere Business Integration adapter for Ariba Buyer

Before you install this version of the adapter, IBM recommends that you back up and uninstall the previous version. This section describes how to:

Uninstalling WAAB

IBM recommends that you back up your WAAB instance by copying the entire adapter installation directory to an archive location before you uninstall the adapter.

After you have backed up the adapter installation directory, follow the instructions for uninstalling the adapter that are given in the WebSphere Adapter for Ariba Buyer User Guide.

Note:
It is important that you remember the location of your MQCSVMapping.xml file(s), as you will need to manually migrate any customized CSV mappings from this file to the new Ariba IntegrationMappings.aml file later in the migration process.

Installing WebSphere Business Integration Adapter for Ariba Buyer

To install the new adapter, refer to "Installing the adapter"of this guide.

Note:
Stop when you reach the sectionBroker compatibility. You do not need to run the Ariba Buyer Configure tool for the migration.

Configuring the adapter migration utility

IBM provides a utility to assist customers migrating from WAAB to WebSphere Business Integration Adapter for Ariba Buyer. The migration utility is included as part of the adapter installation.

To configure the migration utility:

  1. Modify the <Ariba Buyer 8 Server dir>/classes/classpath.txt file by appending this line to it:
    classes/BIA_IBMMigration.jar
     
    
  2. Create the following directory in your Buyer 8.1 installation directory:
    \Server\channels\MQSeries
     
    

    You may delete this directory after running the migration task harness successfully.

The utility is now installed. You will run it as one of the integration channel migration tasks described below.

Table 23 lists the files included in the migration utility package and provides a brief description of each one.

Table 23. Contents of migration utility package

Subdirectory Description
\channels\IBM\migration\
WBIAABMigrationTaskList.xml
File that describes the list of tasks to be run as part of the adapter
migration. This file is used as input to the migration harness.
\channels\IBM\migration\
UpdateIBMParameters.txt
File that describes the changes to be performed on the
Parameters.table file.
\channels\IBM\migration\
loaddb_removelist.txt
List of integration events that must be removed from the
config\LoadDB.txt file. These events are not required by the
new adapter.
\classes\BIA_IBMMigration.jar File that contains all the code required to migrate the adapter.

Copyright IBM Corp. 1997, 2003