Quick install of the XML adapter

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

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

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

Installing on a UNIX system

To install the adapter on a UNIX system, run the Installer for IBM WebSphere Business Integration Adapters and select the IBM WebSphere Business Integration Adapter for XML. Installer installs the UNIX file structure shown in Table 1..

Table 1. Installed UNIX file structure for the adapter

Subdirectory of $ProductDir Description
connectors/XML Contains the connector and protocol handler class files as well as a folder that contains JSSE package files. It also contains the connector start file.
connectors/messages Contains the XMLConenctor.txt file, as well as XMLConenctor_ll_TT.txt files (message files specific to a language (_ll) and a country or territory (_TT)).
DataHandlers Contains the data handler class file and the IBM XML4J package (SAX parser)
DevelopmentKits/edk Contains subfolders that contain makefiles, and stub source files.
/lib
Contains the WBIA. jar file.
/bin
Contains the CWConnEnv.sh file.

After you have installed theadapter on a UNIX system, you must do the following:

  1. Use the connector configuration tool to generate the customized connector wrapper (connector_manager_XML) required to start the connector. Refer to the System Installation Guide for UNIX or the WebSphere Business Integration Implementation Guide for WebSphere MQ Integrator Broker for more information.
  2. Log in as root and run the dbenable.sh script in the XML/ bin directory.

Installing on a Windows system

To install the adapter on a Windows system, run Installer, and select the IBM WebSphere Business Integration Adapter for XML. Installer installs standard files associated with the adapter and files that can be used to develop custom components for the adapter.

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


Table 2. Installed Windows file structure for the adapter

Subdirectory of %ProductDir% Description
\connectors\XML Contains the connector and protocol handler class files as well as a folder that contains JSSE package files. It also contains the connector start file.
\connectors\messages Contains the XMLConenctor.txt file, as well as XMLConenctor_ll_TT.txt files (message files specific to a language (_ll) and a country or territory (_TT)).
\DataHandlers Contains the data handler class file and the IBM XML4J package (SAX parser).
\DevelopmentKits\edk Contains subfolders that contain makefiles, and stub source files.
\lib
Contains the WBIA. jar file.
\bin
Contains the CWConnEnv.bat file.

Installer adds a menu option for the connector's application-specific component to the IBM WebSphere Business Integration Adapters menu (if WebSphere MQ Integrator Broker is the integration broker) or to the IBM WebSphere menu (if WebSphere ICS is the integration broker). For a fast way to start the connector, create a shortcut to this component 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 the instructions in the section.Comprehensive install and uninstall instructions for adapters

Security of JSSE files

The JSSE files (jcert.jar, jnet.jar, jsse.jar) from Sun Microsystems are the international versions, which have weaker security than their U.S. counterparts. If you are in the U.S. and wish to use stronger security, download the U.S. version of JSSE from the Sun Micosystems website (http://java.sun.com/products/jsse). Make sure you read the license agreement and export restrictions.

Copyright IBM Corp. 1997, 2003