Hitachi

Hitachi Advanced Database Application Development Guide


3.3 Upgrading the JDBC driver (replacing the JAR file)

The following shows the procedure for upgrading the JDBC driver:

Procedure
  1. Copy a compressed file from the HADB client installation CD-ROM to a folder of your choice.

    The file to be copied is as follows:

    • In the 64-bit edition of Windows

      hitachi_advanced_data_binder_client.zip

    • In the 32-bit edition of Windows

      hitachi_advanced_data_binder_client32.zip

    • In Linux

      hitachi_advanced_data_binder_client-$VER.tar.gz

    The $VER portion is replaced by an HADB version and release number.

  2. Expand the compressed file that you copied.

    For details about the location of the JAR file after the compressed file is expanded, see Table 3‒2: Location of the JAR file after the compressed file is expanded.

  3. Replace the existing JAR file with the new one.

  4. Confirm that a connection to the HADB server is established.

  5. Delete the following folders and files:

    • The compressed file you copied in step 1.

    • The folders and files you expanded in step 2.

Important

Steps 1 to 3 in the preceding procedure must be performed by the same OS user. If the OS user changes, the upgrade might not be completed correctly.

■ Points to be checked after the upgrade

When the JDBC driver is upgraded, the default values of some properties# might be changed. Check whether the default values of those properties have been changed. If the default values have been changed, respecify the properties as needed. The default values of properties are the same as the values of the corresponding operands in the client environment definition. For details about the operands in the client definition, see 2.2 Contents of operands in the client definition.

#

The properties in Table 3‒3: System properties that can be specified apply.

■ To downgrade the JDBC driver

See the following procedure.

Procedure

  1. Replace the current JAR file with the previously used JAR file.

  2. Restore the previous values of system properties.

    If the current values of system properties are different from the values that were set before the JDBC driver was upgraded, you must change the values back to the previous ones when downgrading the version.

  3. Confirm that a connection to the HADB server is established.

Important

Steps 1 to 2 in the preceding procedure must be performed by the same OS user. If the OS user changes, the JDBC driver might not work correctly.