Configuring environments without the integration node component installed

Install and run Java™ independent programs that use the IBM® DFDL API on systems that do not have the IBM Integration Bus runtime component installed.

About this task

You can run Java programs that use the IBM DFDL API on systems where you have not installed the IBM Integration Bus runtime component, but you must ensure that you have purchased a IBM Integration Bus license for each computer on which you intend to run Java programs that use the IBM DFDL API.

The following instructions use the Windows path separator; but apply equally to other operating systems, if you change the separator.

Procedure

To install and run IBM DFDL independent programs in an environment that does not have the integration node component installed, complete the following steps:

  1. Ensure that the target system has a compatible Java Runtime Environment (JRE) installed.
    Because you are not installing the IBM Integration Bus runtime component, which includes a JRE, you must use an alternative option. For more information about Java support, see IBM Integration Bus system requirements.
  2. Copy the following files from a system that has the IBM Integration Bus runtime component installed, to the target system:
    1. ibm-dfdl-java.zip from install_dir\server\tools, where install_dir is the directory that you specified as the installation directory for IBM Integration Bus.
    2. Your Java independent program that uses the IBM DFDL API.
  3. On the target system, extract the contents of ibm-dfdl-java.zip to a location of your choice; for example, C:\dfdl.

    Important: Extracting the contents of ibm-dfdl-java.zip installs license and entitlement files onto the target computer for use by IBM License Metric Tool (ILMT). You can use ILMT to monitor the usage of IBM (and other) software products.

    To ensure that ILMT reflects the correct license entitlement, you must choose the correct ILMT license for the edition of IBM Integration Bus that you have purchased. For more information about IBM Integration Bus licenses, see Operation modes.

    For more information about ILMT, see the IBM License Metric Tool website.

Update the class path environment variable:

  1. Add all of the JAR files that are required for IBM DFDL.
    For example:
    set CLASSPATH = %CLASSPATH%;C:\dfdl\lib\ibm-dfdl.jar
    Repeat this step for each JAR file in your extract_dir\lib directory, where extract_dir is the directory to which you extracted ibm-dfdl-java.zip. Alternatively, to add all of the required JAR files, run the dfdlprofile utility that is provided in your extract_dir\bin directory.
  2. If you want to run and explore the IBM DFDL sample, add the dfdlsample_java.jar JAR file in your extract_dir\samples directory.
    For example:
    set CLASSPATH = %CLASSPATH%;C:\dfdl\samples\dfdlsample_java.jar
  3. Add your DFDL independent program JAR file.
  4. Add any other JAR files and directories that you require.

Results

Next: You can now run your DFDL independent programs on the target computer.