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
(2) Uninstalling an HADB client

(1) Installing an HADB client

The following explains how to install an HADB client.

Note

Install an HADB client that corresponds to the version of the HADB server.
Use the installation data stored on the HADB client installation CD-ROM. Do not perform the installation using ZIP format files or other files stored on a different CD-ROM.

Procedure

Log in as the OS user who manages the HADB client.
Copy the installation data for the HADB client.

Copy the zip file from the installation media to a folder of your choice. In this procedure explanation, it is assumed that you will copy files to the D:\hadb_clt folder.
- When using the 64-bit version of the HADB client: hitachi_advanced_database_client.zip
- When using the 32-bit version of the HADB client: hitachi_advanced_database_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.
Obtain the hash value of the copied file.

Start the command prompt and execute the following command:
- When using the 64-bit version of the HADB client
```
cd /D D:\hadb_clt
certutil -hashfile hitachi_advanced_database_client.zip SHA256
```
- When using the 32-bit version of the HADB client
```
cd /D D:\hadb_clt
certutil -hashfile hitachi_advanced_database_client32.zip SHA256
```
The underlined part is the folder where the installation data was copied in step 2.
Compare the hash values.

Compare the hash value obtained in step 3 with the hash value listed in the following file stored on the installation CD-ROM:
- For 64-bit versions of the HADB client: adbhashfile_winclt64_sha256.txt
- For 32-bit versions of the HADB client: adbhashfile_winclt32_sha256.txt
If the hash values are the same, there is no problem. Please proceed to the next step.

If the hash values are different, the file copy may have failed. Please redo the process from step 2.
Expand the compressed file.

(Example) When hitachi_advanced_database_client.zip is extracted

The folders and files of the HADB client will be extracted under the HADBCL folder in D:\hadb_clt\hitachi_advanced_database_client\HADBCL.

The D:\hadb_clt\hitachi_advanced_database_client\HADBCL folder is the default extraction destination when the compressed file is extracted.
Check the version information of the HADB client.

Open the readme.txt file stored in the destination folder after extraction.

Check the version information of the HADB client written on the first row.
```
P-aaaa-bbbb 06-00-/B
```
P-aaaa-bbbb displays the PP model name information of the HADB client.

The underlined part will display the version of the HADB client.

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 example explained in the installation procedure above, D:\hadb_clt\hitachi_advanced_database_client\HADBCL becomes the client directory.

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:

• When using the 64-bit version of the HADB client: %ADBCLTDIR%\adbreg.reg

• When using the 32-bit version of the HADB client: %ADBCLTDIR%\adbreg32.reg
Installing the runtime components of the Microsoft Visual C++ library

If an OS user might use the HADB client (including the ODBC driver), they must run the following Microsoft Visual C++ Redistributable Package for Microsoft Visual Studio 2019 to install the runtime components of the Microsoft Visual C++ libraries.

• When using the 64-bit version of the HADB client: %ADBCLTDIR%\vclib\VC_redist.x64.exe

• When using the 32-bit version of the HADB client: %ADBCLTDIR%\vclib32\VC_redist.x86.exe
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 both the 64-bit and the 32-bit version of the HADB client.
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.
- If you are using PAM authentication, exclude the directory where public key files are stored from your antivirus software's scan targets.

To Page Top

(2) Uninstalling an HADB client

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

Check that no command or application program is being executed from the HADB client. Uninstallation might fail if an attempt is made to uninstall an HADB client while a command or application program is executing.
Back up all the files that you might need from the client directory.

The following explains how to uninstall an HADB client.

Procedure

Delete the registry key.

Delete the registry key that was registered during installation by executing the following registry deletion command:
- 64-bit version of the HADB client: %ADBCLTDIR%\adbunreg.reg
- 32-bit version of the HADB client: %ADBCLTDIR%\adbunreg32.reg
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.

To Page Top