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:
Sun Adapter for CICS
Sun Adapter for WebSphere MQ
Sun Adapters for SAP BAPI and SAP ALE
Sun Adapter for Siebel EAI
Sun Adapter for DB2 Connect
Sun 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:
You can also use the ant version distributed with Java CAPS.
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
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.
Name |
Description |
Value |
---|---|---|
netbeans.home |
The location of the NetBeans installation in Java CAPS. |
For a default installation of Java CAPS, the location is C:/JavaCAPS6/netbeans/ for Windows, or ~/JavaCAPS6/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:/JavaCAPS6/glassfish for Windows, or ~/JavaCAPS6/glassfish 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. |