Setting Up the Third-Party Library Installer
This section includes information for installing and configuring the Third-Party Library Installer provided
by Java CAPS to complete the installation of certain adapters. Third-party libraries are
required for the following components:
-
Oracle Java CAPS Adapter for CICS
-
Oracle Java CAPS Adapter for WebSphere MQ
-
Oracle Java CAPS Adapters for SAP BAPI and SAP ALE
-
Oracle Java CAPS Adapter for Siebel EAI
-
Oracle Java CAPS Adapter for DB2 Connect
-
Oracle Java CAPS Adapter for VSAM
The Installer script requires the installation of Apache Ant version 1.7 or above,
which can be downloaded from the following location:
http://ant.apache.org/
You can also use the ant version distributed with Java CAPS.
To Set Up the Third-Party Installer
- On the Java CAPS Uploader, click the Download tab.
- Click Adapter's Third Party Library Installer and extract it into a working directory.
- Set the environment variable ANT_HOME to point to the home directory of your
ANT installation. For example:
set ANT_HOME=C:\JavaCAPS6\netbeans\java2\ant
- Set the environment variable JAVA_HOME to point to your JDK installation. For example:
set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_03
- Set your PATH to include the bin directory of your ANT installation.
set PATH=C:\JavaCAPS6\netbeans\java2\ant
To Configure the Build File
The installer uses the build.properties file to determine where to install the JAR
files and where to obtain the JAR files to install. This file contains
information specific to each JAR file, so you should make a backup copy
before making any changes.
- Make a backup copy of the build.properties file.
- Modify the properties listed in the following table. For more information on the
product.name and third-party files properties, refer to the third-party JAR installation instructions for each
Adapter.
- When you are done modifying properties, save and close the file.
|
|
|
netbeans.home |
The location
of the NetBeans installation in Java CAPS. |
For a default installation of
Java CAPS, the location is C:/JavaCAPS63/netbeans/ for Windows, or ~/JavaCAPS63/netbeans/ for UNIX. This
property is automatically set. Only change this value if you changed the location
of the Java CAPS installation. |
glassfish.home |
The location of the GlassFish installation in
Java CAPS. This allows third-party libraries to be installed to the right location in
the runtime environment. |
For a default installation of Java CAPS, the location
is C:/JavaCAPS63/appserver for Windows, or ~/JavaCAPS63/appserver for UNIX. This property is automatically set.
Only change this value if you changed the location of the Java CAPS
installation. |
installation.domains |
The name of the domains in the GlassFish installation where the third-party libraries
will be placed. |
The default is domain1, which is the name of the
default domain that is created when you install Java CAPS. |
product.name |
A list of products
that you are installing third-party jar files for. You can add or remove
indicators, but do not change the actual indicator text. |
A list of product indicators
separated by semicolons. Each Adapter has one or more indicators that let the
installer know which components are being updated. To find out which indicators to
use for an Adapter, see the instructions for that Adapter. |
thirdpartyfiles |
For each Adapter, a
list of absolute paths and filenames to the JAR files that will be
installed. Separate the files by a semicolon. |
For each adapter, the libraries vary
depending on platform and the paths vary depending on where your third-party software
is installed. Below is an example for CICS: cicsadapterra.thirdpartyfiles=C:/Program Files/IBM/CICS Transaction Gateway/classes/ctgclient.jar;C:/Program Files/IBM/CICS Transaction Gateway/classes/ctgserver.jar To find out which third–party file
properties you need to use for an Adapter, see the instructions for that
Adapter. |
|