Informix JDBC Driver Programmer's Guide Getting Started

Informix JDBC Driver is released as a Java class file called setup.class.

There are two ways to install the driver: using a Setup program or using the command line. The following sections describe the two ways for both UNIX and Windows.

This section describes how to interactively install Informix JDBC Driver with the Setup program.

1. If you are installing Informix JDBC Driver from a CD-ROM, load the disc into the CD-ROM drive.

On Hewlett-Packard platforms, you must use the -o cdcase option of the mount command to read the CD in case-sensitive mode.

2. Copy the ifxjdbc.tar file from the Web or the CD into a temporary directory (not the directory into which you are installing Informix JDBC Driver).

Warning: If you copy the tar file to the same directory into which you attempt to install the driver, the installation fails.

3. Execute the following command:
tar xvf ifxjdbc.tar

The setup.class and install.txt files appear in the temporary directory.

4. Be sure your CLASSPATH environment variable points to Version 1.2 or later of the Java Development Kit (JDK).
5. At the UNIX shell prompt, create a directory to hold the contents of the driver.

For example, to create the directory /work/jdbcdriver_home, execute the following command:

mkdir /work/jdbcdriver_home

6. Change directory to the temporary directory that contains the setup.class file.
7. Launch the Setup program with the java command at the UNIX shell prompt:
java setup
8. The Setup program guides you through the installation of Informix JDBC Driver.

The following warning message might appear:

Font specified in font.properties not found [-b&h-lucida sans

typewriter-bold-r-normal-sans-*-%d-*-*-m-*-iso8859-1]

This condition does not affect the installation.

After the Welcome window, the program asks you for your serial number and key. It then asks you to accept a licensing agreement. The program then asks you for the name of the directory that will hold the contents of the driver. In this example, this directory is called /work/jdbcdriver_home and was created in Step 5 of these instructions.

The installation is complete when you get to the Installation Complete window.

1. If you are installing Informix JDBC Driver from a CD-ROM, load the disc into the CD-ROM drive.
2. Copy the ifxjdbc.tar file from the Web or the CD into a temporary directory (not the directory into which you are installing Informix JDBC Driver).

Warning: If you copy the tar file to the same directory into which you attempt to install the driver, the installation fails.

3. Use WinZip or a similar utility to unpack the tar file. The setup.class and install.txt files appear in the temporary directory.
4. Be sure your CLASSPATH environment variable points to Version 1.2 or later of the Java Development Kit (JDK).
5. Using Windows Explorer, create a directory to hold the contents of the driver.

Assume, for this example, that the new directory is called c:\work\jdbcdriver_home.

6. Change directory to the temporary directory that contains the setup.class file.
7. Launch the Setup program with the java command at the Windows command prompt:
java setup
8. The Setup program guides you through the installation of Informix JDBC Driver.

The following warning message might appear:

Font specified in font.properties not found [-b&h-lucida sans

typewriter-bold-r-normal-sans-*-%d-*-*-m-*-iso8859-1]

This condition does not affect the installation.

After the Welcome window, the program asks you for your serial number and key. It then asks you to accept a licensing agreement. The program then asks you for the name of the directory that will hold the contents of the driver. In this example, this directory is called c:\work\dbcdriver_home and was created in Step 5 of these instructions.

The installation is complete when you get to the Installation Complete window.

This section describes how to silently install Informix JDBC Driver from the UNIX shell prompt or Windows command line.

1. If you are installing Informix JDBC Driver from a CD-ROM, load the disc into the CD-ROM drive.

On Hewlett-Packard platforms, you must use the -o cdcase option of the mount command to read the CD in case-sensitive mode.

2. Copy the ifxjdbc.tar file from the Web or the CD into a temporary directory (not the directory into which you are installing Informix JDBC Driver).

Warning: If you copy the tar file to the same directory into which you attempt to install the driver, the installation fails.

3. Execute the following command:
tar xvf ifxjdbc.tar

The setup.class and install.txt files appear in the temporary directory.

4. Be sure your CLASSPATH environment variable points to Version 1.2 or later of the Java Development Kit (JDK).
5. At the UNIX shell prompt, create a directory to hold the contents of the driver.

For example, to create the directory /work/jdbcdriver_home, execute the following command:

mkdir /work/jdbcdriver_home

6. Change directory to the temporary directory that contains the setup.class file.
7. Execute the following command at the UNIX shell prompt:
java setup -o <directory> serialNo=<serial_no> key=<key>

In this command, directory refers to the directory that will hold the contents of the driver (created in Step 5 of these instructions), and serial_no and key refer to the installation serial number and key.

The keywords serialNo and key are case sensitive. You can also use the keywords SERIALNO, serialno, and KEY.

For example, to install Informix JDBC Driver in the directory /work/jdbcdriver_home using a serial number of INF#J123456 and a key of ABCDEF, execute the following command:

java setup -o /work/jdbcdriver_home serialNo=INF#J123456 key=ABCDEF

If the specified directory already contains Informix JDBC Driver files, the command asks you if you want to overwrite them.

The installation is complete after the command has finished executing.

1. If you are installing Informix JDBC Driver from a CD-ROM, load the disc into the CD-ROM drive.
2. Copy the ifxjdbc.tar file from the Web or the CD into a temporary directory (not the directory into which you are installing Informix JDBC Driver).

Warning: If you copy the tar file to the same directory into which you attempt to install the driver, the installation fails.

3. Use WinZip or a similar utility to unpack the tar file. The setup.class and install.txt files appear in the temporary directory.
4. Be sure your CLASSPATH environment variable points to Version 1.2 or later of the Java Development Kit (JDK).
5. Using Windows Explorer, create a directory to hold the contents of the driver.

Assume, for this example, that the new directory is called c:\work\jdbcdriver_home.

6. Change directory to the temporary directory that contains the setup.class file.
7. Execute the following command at the Windows command prompt:
java setup -o <directory> serialNo=<serial_no> key=<key>

In this command, directory refers to the directory that will hold the contents of the driver (created in Step 5 of these instructions), and serial_no and key refer to the installation serial number and key.

The keywords serialNo and key are case sensitive. You can also use the keywords SERIALNO, serialno, and KEY.

For example, to install Informix JDBC Driver in the directory c:\work\jdbcdriver_home using a serial number of INF#J123456 and a key of ABCDEF, execute the following command:

java setup -o c:\work\jdbcdriver_home serialNo=INF#J123456 key=ABCDEF

If the directory already contains Informix JDBC Driver files, the command asks you if you want to overwrite them.

The installation is complete once the command has finished executing.