Quick installation of the adapter

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

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

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

Installing on a UNIX system

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

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

Table 2. Installed UNIX file structure for the JText adapter

Subdirectory of $ProductDir Description
connectors/JText/CWJText.jar
Contains the connector and the formatters
connectors/JText/start_JText.sh
System startup script for the connector. This script is called from the generic connector manager script.
repository/JText/ Contains the CN_JText.txt file and the MO_JText_Default.txt.
connectors/JText/Dependencies /LICENSE License agreement.
connectors/JText/Dependencies /README_()_() Translated README files for localized versions of the adapter.
connectors/JText/Dependencies /NetComponents.jar Third party dependency file for FTP functionality
connectors/JText/Dependencies/NetComponents /1.3.8/src/java/com/oroinc/net/ftp /DefaultFTPFileListParser.java Open source file for NetComponents
connectors/JText/Dependencies/NetComponents /1.3.8/src/java/com/oroinc/net/ftp /FTPClient.java Open source file for NetComponents
connectors/JText/Dependencies/NetComponents /1.3.8/src/java/com/oroinc/net/ftp /FTPFileListParser.java Open source file for NetComponents
connectors/messages/ Contains the JTextConnector.txt file.

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

  1. Use Connector Configurator to generate the customized connector (connector_manager_JText) required to start the connector. Refer to the System Installation Guide for UNIX or the Implementation Guide for WebSphere MQ Integrator Broker for more information.
  2. Log in as root and run the dbenable.sh script in the JText/ bin directory.

Installing on a Windows system

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

Table 3 describes the Windows file structure used by the JText Adapter.

Table 3. Installed Windows file structure for the JText adapter

Subdirectory of%ProductDir% Description
connectors\JText\CWJText.jar
Contains the connector and the formatters
connectors\JText\start_JText.bat
System startup script for the connector. This script is called from the generic connector manager script.
repository\JText\ Contains the CN_JText.txt file and the MO_JText_Default.txt.
connectors\JText\Dependencies \LICENSE License agreement.
connectors\JText\Dependencies \README_()_() Translated README files for localized versions of the adapter.
connectors\JText\Dependencies \NetComponents.jar Third party dependency file for FTP functionality
connectors\JText\Dependencies\NetComponents \1.3.8\src\java\com\oroinc\net\ftp \DefaultFTPFileListParser.java Open source file for NetComponents
connectors\JText\Dependencies\NetComponents \1.3.8\src\java\com\oroinc\net\ftp \FTPClient.java Open source file for NetComponents
connectors\JText\Dependencies\NetComponents \1.3.8\src\java\com\oroinc\net\ftp \FTPFileListParser.java Open source file for NetComponents
connectors\messages\ Contains the JTextConnector.txt file.

The installer adds an icon for the connector file to the business-integration product 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 the instructions in the sectionComprehensive install and uninstall instructions for adapters.

Verifying installation of the data handler

In addition to the files loaded specifically for the JText Adapter when it is installed, the installation program automatically selects the Data handlers installation option to load the product-delivered data handlers. Ensure that these files have also been loaded.

Table 4 describes the file structure used by the data handlers.

Table 4. Data handler files

Subdirectory of %ProductDir% or $ProductDir Description
DataHandlers
Contains CWDataHandler.jar file for compiled versions of the product-provided data handlers. Also contains the empty CustDataHandler.jar file for custom data handlers.

Copyright IBM Corp. 1997, 2003