2
Installation on Windows and UNIX

Before you start installation, verify that your system meets the specified requirements. Refer to Chapter 1, "Before You Install" for a list of these requirements.

This chapter covers the following topics:

• Installation

• Uninstalling

• For More Information

Installation

To install Connect JDBC on your local drive:

1. Decide on an installation directory for Connect JDBC. Choose an existing directory on your machine or create a new one.

2. Locate the Connect JDBC jar file in the appropriate platform-specific directory on the DataDirect CD. Copy or download the jar file to the installation directory on your machine.

3. Change to the Connect JDBC installation directory and unjar the contents of the file. Enter:

   jar -xvf jar_filename
   
   

   where jar_filename is the name of the Connect JDBC jar file.

   The Connect JDBC files are unjarred in the correct structure inside the installation directory. Included in these files is the License Tool.

4. You must run the License Tool to complete the installation. Do one of the following:
   • If you prefer to use a Graphical User Interface (GUI), go to "The GUI License Tool" for instructions.

   • If you prefer to use the command line, go to "The Command-Line License Tool" for instructions.

The GUI License Tool

1. At a command prompt, change to the Connect JDBC installation directory.

2. Start the License Tool by entering the following command:

   java -cp LicenseTool.jar com.merant.datadirect.jdbc.licensetool.LicenseTool
   

   The JDBC License Tool dialog box appears.

   You can exit at any time by clicking Close.

   • If this is a licensed installation, proceed to Step 3

   • If this is an evaluation installation, skip to Step 4

3. For a licensed installation, complete all of the fields as follows:

   Key: Type the key for a licensed installation, which is provided to you by DataDirect.

   Driver: Type one of the following:

   pack
   db2
   db2OS390
   informix
   sybase
   sqlserver

   Pack includes all the drivers; the other options are single-driver installations.

   Installation Directory: Type the full path, including the drive letter on Windows machines, of the Connect JDBC installation directory that you have chosen. Or, you can browse to the directory by clicking the Browse (...) button.

   Skip to Step 5

4. For an evaluation installation, complete all of the fields as follows:

   Key: Type EVAL.

   Driver: Type EVAL.

   Installation Directory: Type the full path, including the drive letter on Windows machines, of the Connect JDBC installation directory that you have chosen. Or, you can browse to the directory by clicking the Browse (...) button.

   Note: An evaluation installation automatically installs all of the drivers. If you later want to perform a licensed installation, simply run the License Tool again.

5. Click Finish to complete the installation.

6. When installation is complete, click Close to close the License Tool.

The Command-Line License Tool

1. At a command prompt, change to the Connect JDBC installation directory.
   • If this is a licensed installation, proceed to Step 2

   • If this is an evaluation installation, skip to Step 3

2. Run the License Tool for a licensed installation by specifying switches on the command line. You must specify values for all of the switches. Use the following syntax:

   java -cp LicenseTool.jar com.merant.datadirect.jdbc.licensetool.LicenseTool 
   -k key -d driver_package -i installation_directory
   
   

   where:

   key is the key for a licensed installation, which is provided to you by DataDirect.

   driver_package is one of the following:

   pack
   db2
   db2OS390
   informix
   sybase
   sqlserver

   Pack includes all the drivers; the other options are single-driver installations.

   installation_directory is the full path, including the drive letter on Windows machines, to the Connect JDBC installation directory.

   Note: If the directory path contains spaces, you must use double quotation marks around the path name, for example: -i "/home/users/jdbc drivers/install"

   To license the Sybase driver, for example, located in /home/users/jdbc/install on a UNIX machine, you would enter the following command:

   java -cp LicenseTool.jar com.merant.datadirect.jdbc.licensetool.LicenseTool -k xxxxxxxx -d sybase -i 
   /home/users/jdbc/install
   
   

3. Run the License Tool for an evaluation installation by specifying switches on the command line. You must specify values for all the switches. Use the following syntax:

   java -cp LicenseTool.jar com.merant.datadirect.jdbc.licensetool.LicenseTool -k EVAL -d EVAL -i installation_
   directory
   

   where installation_directory is the full path, including the drive letter on Windows machines, to the Connect JDBC installation directory.

   Note: If the directory path contains spaces, you must use double quotation marks around the path name, for example: -i "c:\jdbc drivers\install"

   For example, to complete an evaluation installation located in c:\jdbc drivers\install, you would enter the following command:

   java -cp LicenseTool.jar com.merant.datadirect.jdbc.licensetool.LicenseTool -k EVAL -d EVAL -i "c:\jdbc 
   drivers\install"
   

   Note: An evaluation installation automatically installs all of the drivers. If you later want to perform a licensed installation, simply run the License Tool again.

4. The installation is complete after running the License Tool.

Uninstalling

To uninstall, delete the entire installation directory.

For More Information

We recommend that you read the README text file that accompanies the product for current information regarding the release.