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.
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:
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
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.