Installing Third-Party JAR Files

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:

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.

ProcedureTo 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

ProcedureTo 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:/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.