Quick install of the TPI adapter

The following subsections describe how to install the adapter on a UNIX or Windows system.

After your business integration system has been installed, you can install additional adapters from the product CD-ROM at any time. To do this, insert the product CD-ROM, run the installation program, and choose the adapterrs that you want to install.

Note:
Unless otherwise indicated, the remaining sections in this chapter apply to both UNIX and Windows installations of the adapter.

Installing on a UNIX system

To install the adapter on a UNIX system, run the Installer for IBM WebSphere Business Integration Adapter and select the IBM WebSphere Business Integration Adapter for TPI.

For more information on installing the connector component, refer to one of the following guides, depending on the integration broker you are using:

Table 1 describes the UNIX file structure used by the connector.

Table 1. Installed UNIX file structure for the TPI adapter

Subdirectory of $ProductDir Description
connectors/TPI Contains the connector CWTPI.jar and the start_TPI.sh files. The start_TPI.sh file is a system startup script for the connector. It is called from the generic connector manager script. When you click Install from Connector Configurator (WebSphere MQ Integrator Broker as the integration broker) or the Connector Configuration screen of System Manager (WebSphere ICS as the integration broker), the installer creates a customized wrapper for this connector manager script. When the connector works with WebSphere ICS, use this customized wrapper to start and stop the connector. When the connector works with WebSphere MQ Integrator Broker, use this customized wrapper only to start the connector. Use the mqsiremotestopadapter command to stop the connector.
connectors/messages Contains the TPIConnector.txt file, as well as the TPIConnector_ll_TT.txt files (message files specific to a language (ll) and to a country or territory (TT).
connectors/TPI/dependencies Contains DTD files specific to CIDX and RosettaNet.
repository/TPI Contains the CN_TPI.txt file.
/lib
Contains the WBIA. jar file.
/bin
Contains the CWConnEnv.sh file.
connectors/TPI/Samples/ WebSphereICS Contains the sample files that demonstrate how the connector is used with an WebSphere ICS integration broker. The directory contains a Readme.txt file that describes the sample, as well as the following subdirectories:
  • /IBM--Contains the sample business objects, collaboration templates and objects, connector definitions, and trading partner profiles.
  • /IBMTP--Contains trading partner profiles and sample data used for polling.
connectors/TPI/Samples/ WebSphereMQIntegratorBroker Contains the sample files that demonstrate how the connector is used with WebSphere MQ Integrator Broker integration broker. The directory contains a Readme.txt file that describes the sample, as well as the following subdirectories:
  • /IBM--Contains connector configuration files, sample business objects, sample data, and trading partner profiles.
  • /IBMTP--Contains trading partner profiles and sample data used for polling.

After you have installed the connector, you must do the following:

  1. Use the Connector Configuration Tool to generate the customized connector wrapper (connector_manager_TPI) required to start the connector. Refer to the System Installation Guide for UNIX or the IBM WebSphere Business Integration Adapters Implementation Guide for WebSphere MQ Integrator Broker for more information.
  2. Log in as root and run the dbenable.sh script in the CycloneInterchange/bin directory.

Installing on a Windows NT system

To install the adapter on a Windows system, run the Installer for IBM WebSphere Business Integration Adapter and select the IBM WebSphere Business Integration Adapter for TPI. All standard files associated with the adapter are installed.

Table 2 describes the Windows NT file structure used by the TPI adapter.

Table 2. Installed Windows NT file structure for the TPI adapter

Subdirectory of $ProductDir$ Description
connectors\TPI Contains the connector CWTPI.jar and the start_TPI.bat files.
connectors\messages Contains the TPIConnector.txt file, as well as the TPIConnector_ll_TT.txt files (message files specific to a language (ll) and to a country or territory (TT).
connectors\TPI\dependencies Contains DTD files specific to CIDX and RosettaNet.
repository\TPI Contains the CN_TPI.txt file.
connectors\TPI\Samples\ WebSphereICS Contains the sample files that demonstrate how the connector is used with the WebSphere ICS integration broker. The directory contains a Readme.txt file that describes the sample, as well as the following subdirectories:
  • \IBM--Contains the sample business objects, collaboration templates and objects, connector definitions, and trading partner profiles.
  • \IBMTP--Contains trading partner profiles and sample data used for polling.
connectors\TPI\Samples\ WebSphereMQIntegratorBroker Contains the sample files that demonstrate how the connector is used with WebSphere MQ Integrator Broker integration broker. The directory contains a Readme.txt file that describes the sample, as well as the following subdirectories:
  • \IBM--Contains connector configuration files, sample business objects, sample data, and trading partner profiles.
  • \IBMTP--Contains trading partner profiles and sample data used for polling.
\lib
Contains the WBIA. jar file.
\bin
Contains the CWConnEnv.bat file.

Installer adds an icon for the connector file to the IBM WebSphere Business Integration Adapters menu. For a fast way to start the connector, create a shortcut to this file on the desktop.

For more information on installing the connector component, refer to one of the following guides, depending on the integration broker you are using:

or see the section Comprehensive install and uninstall instructions for adapters.

Copyright IBM Corp. 1997, 2003