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® Integration Bus.
About this task
You can run Java™ applications
that use the IBM Integration
API even where
you have not installed IBM Integration Bus.
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 Integration Bus installed, complete
the following steps:
Procedure
- Ensure that the target computer has a compatible Java Runtime Environment (JRE).
Because you are not installing
IBM Integration Bus,
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 Integration Bus system
requirements; see IBM Integration Bus system requirements.
- Copy the following set of files from a computer that has IBM Integration Bus installed to the target computer:
- The IntegrationAPI.jar file from the install_dir/common/classes directory.
- All the .jar files from the install_dir/common/jetty/lib directory.
- All the .jar files from the install_dir/common/jackson/lib directory.
- Your custom integration applications and all configuration files,
for example .broker files.
- If you want to run the integration node
commands on the target computer, complete the following steps:
- Copy brokerutil.jar from the install_dirserver/classes directory.
- Copy the script files that start with mqsi,
from the install_dirserver/bin directory.
Scripts have a
.bat
extension on Windows or no extension on UNIX platforms.Note: Not all of
these script files can be used to perform remote administration tasks.
Check the documentation for the command that is associated with the
script file to verify whether the command can be used remotely. For
example, the command mqsibackupbroker can be used
to administer only a local integration node.
- If you want to display integration node
(BIP) messages in English environments other than US English,
copy all BIPmsgs*.properties files from the messages directory.
- 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/jetty/lib directory
and the install_dir/common/jackson/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.
- Ensure that the user ID that the target computer uses has
the following authorities:
- Authority to connect to the queue manager that the integration
node uses.
- 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.