Configuring environments without IBM App Connect Enterprise installed

Install and run custom integration applications and other utilities on computers, when you are using a local ID only, on which you have not installed IBM® App Connect Enterprise.

About this task

You can run Java™ applications that use the IBM Integration API even where you have not installed IBM App Connect Enterprise. These applications include your own custom integration applications, and some of the command utilities.

To install Java applications that use the IBM Integration API in an environment that does not have IBM App Connect Enterprise installed, complete the following steps:

Procedure

  1. Ensure that the target computer has a compatible Java Runtime Environment (JRE).
    Because you are not installing IBM App Connect Enterprise, which includes a JRE, you must use an alternative option.

    Note, that you must also set MQSI_JREPATH to the installation path of your JRE.

    Java support is defined in the IBM App Connect Enterprise system requirements; see IBM App Connect Enterprise system requirements.

  2. Copy the following set of files from a computer that has IBM App Connect Enterprise installed to the target computer:
    1. The IntegrationAPI.jar file from the install_dir/common/classes directory.
    2. All the .jar files from the install_dir/common/jackson/lib directory.
    3. All the .jar files from the install_dir/common/jnr/lib directory.
    4. Your custom integration applications and all configuration files, for example .broker files.
  3. On the target computer, use system facilities to update the CLASSPATH environment variable to include the following files:
    • The JAR file that contains the definitions of the IBM Integration API classes: IntegrationAPI.jar.
    • The JAR files that you copied from the install_dir/common/jackson/lib directory and the install_dir/common/jnr/lib directory.
    • Your applications that import the IBM Integration API classes.
    • The JAR files that contain the definitions of the IntegrationNodeConnectionParameters classes.
    • Any other required JAR files and directories. For example, if you require any of the available command utilities on the target computer, include brokerutil.jar; if you require the integration node (BIP) messages to be displayed in locales other than US English, include a directory that contains BIPmsgs*.properties.
  4. Ensure that the user ID that the target computer uses has the following authorities:
    • Authority to manipulate integration node objects.

What to do next

You can run your custom integration applications, and the supported command utilities, on the target computer.