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

1. On the Java CAPS Uploader, click the Download tab.
2. Click Adapter's Third Party Library Installer and extract it into a working directory.
3. 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

4. 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

5. 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.

1. Make a backup copy of the build.properties file.
2. 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.
3. 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:/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.