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:
-
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.
-
Copy the following files from a system that has the IBM Integration Bus
runtime component installed, to the target system:
-
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.
-
Your Java independent program that uses the IBM DFDL API.
- 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:
- 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.
- 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
- Add your DFDL independent program JAR file.
- Add any other JAR files and directories that you require.
Results
Next: You can now run your DFDL independent programs on the target computer.