Hitachi

Hitachi Advanced Database Application Development Guide


4.2.1 HADB client for Windows

This subsection explains how to install and uninstall an HADB client for Windows.

Administrator permissions are required to install and uninstall an HADB client.

Organization of this subsection

(1) Installing an HADB client

The following explains how to install an HADB client.

To install an HADB client:

  1. Copy the following compressed file from the CD-ROM to any folder on the client computer:

    • 64-bit edition of Windows: hitachi_advanced_data_binder_client.zip

    • 32-bit edition of Windows: hitachi_advanced_data_binder_client32.zip

    Make sure that the length of the path for the target folder does not exceed 200 bytes.

    For information on the characters that can be used in a copy-to folder path, see <path name> under ■ Conventions: Syntax elements in the Preface.

  2. Expand the compressed file.

Example:

Copy the hitachi_advanced_data_binder_client.zip file to D:\hadb_clt, and then expand the file.

The folders and files are expanded under D:\hadb_clt\hitachi_advanced_data_binder_client\HADBCL.

Note: This is the default target folder when the compressed file is expanded.

Important

To use an ODBC driver, the version information of the ODBC driver must be the same as the version information of the HADB client. Therefore, do not replace some of the DLL files in the client\bin folder under the client directory.

■ Tasks to be performed after installation

After you have finished the installation, perform the following tasks:

  • Specifying environment variables

    For details about the environment variables to be specified, see 4.3.1 HADB client for Windows.

    Specify in the ADBCLTDIR environment variable the absolute path of the client directory. In the installation procedure example provided above, the client directory is D:\hadb_clt\hitachi_advanced_data_binder_client\HADBCL.

    A client directory stores a group of files that are related to a single client process.

  • Registering the registry key

    After you have specified the environment variables, register the registry key by executing the following registry registration command:

    • 64-bit edition of Windows: %ADBCLTDIR%\adbreg.reg

    • 32-bit edition of Windows: %ADBCLTDIR%\adbreg32.reg

  • Granting write permission for the folder

    Grant write permission for the following folder to each OS user who might use the HADB client (including the ODBC driver):

    %ADBCLTDIR%\spool

    %ADBODBTRCPATH%

    This folder is common to 32 and 64-bit Windows.

  • Reviewing the targets of scans by antivirus software

    If antivirus software is installed on the client machine where HADB client is installed, review the scope of virus scans.

    If the files and directories used by the HADB client are included in the scope of scans by antivirus software, the HADB client might not work correctly. For this reason, you need to configure the antivirus software to not scan the client directory.

(2) Uninstalling an HADB client

You must perform the following before you uninstall an HADB client:

The following explains how to uninstall an HADB client.

To uninstall an HADB client:

  1. Delete the registry key.

    Delete the registry key that was registered during installation by executing the following registry deletion command:

    • 64-bit edition of Windows: %ADBCLTDIR%\adbunreg.reg

    • 32-bit edition of Windows: %ADBCLTDIR%\adbunreg32.reg

  2. Delete all folders and files that were copied when the HADB client was installed.

    Delete folders and files that were created after the HADB client was installed.