Installing a connector in IBM Integration Bus

Install the connector on the integration node on which you want to test its function.

Before you begin

Package your connector. For more information, see Packaging a connector for the runtime environment.

Procedure

To install the connector on the integration node, complete the following steps:

  1. Stop the integration node on which you want to install your connector.
  2. Save the JAR file that contains your connector in workpath/connectors.
    For example, the default workpath directory on Windows is C:\ProgramData\IBM\MQSI.
    You can find the location of the work path by running the following command:
    mqsireportbroker integrationNodeName
    If the connector JAR file contains other JAR files, extract the connector JAR file to a folder with the same name as the parent JAR file under workpath/connectors. For example:
    The image describes the text in the preceding paragraph.
  3. Restart the integration node to ensure that the integration node picks up the new file.
    The connector is available to all integration servers on that integration node.

Results

The integration node loads the connector files during initialization. After the files are loaded, the integration node calls the registration functions in the connector and records what nodes or parsers the connector supports.

What to do next

Install the user-defined node for your connector by following the instructions in Installing the user-defined node for a connector in the IBM Integration Toolkit.