4.6.3 How to upgrade an HADB client

This subsection provides the steps to upgrade an HADB client.

Organization of this subsection

(1) Upgrading an HADB client (Windows edition)
(2) Upgrading an HADB client (Linux edition)

(1) Upgrading an HADB client (Windows edition)

The OS user who manages the HADB client upgrades the HADB client.

To upgrade an HADB client:

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, we will assume copying to the D:\hadbclt_install 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:\hadbclt_install
certutil -hashfile hitachi_advanced_database_client.zip SHA256
```
- When using the 32-bit version of the HADB client
```
cd /D D:\hadbclt_install
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:\hadbclt_install\hitachi_advanced_database_client\HADBCL.

The D:\hadbclt_install\hitachi_advanced_database_client\HADBCL folder is the default extraction destination when decompressing the compressed file.
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.
Overwrite the client directory.

Example:

Please overwrite and copy the D:\hadbclt_install\hitachi_advanced_database_client\HADBCL folder to the client directory specified in the environment variable ADBCLTDIR.

If you want to change the client directory to the D:\hadbclt_install\hitachi_advanced_database_client\HADBCL folder, please change the path of the client directory specified in the environment variable ADBCLTDIR.

To Page Top

(2) Upgrading an HADB client (Linux edition)

To upgrade an HADB client:

Procedure

Log in as the OS user who manages the HADB client.
Create the directory for storing the installation data.
```
mkdir /home/osuser01/client
```
In the above example, /home/osuser01/client is created as the directory to store the HADB client installation data.
Assign write permission to the directory you created.
```
chmod 755 /home/osuser01/client
```
Assign write permission to the directory you created so that the OS user who manages the HADB client can write to the directory (in this example, /home/osuser01/client).
Mount the CD-ROM file system.

Automatically mount the CD-ROM file system that contains the HADB client installation data.

If the CD-ROM file system is not automatically mounted, execute the following command to mount the CD-ROM file system.
```
mount /dev/cdrom /media
```
The underlined portion is the mount directory name of the CD-ROM file system. It might differ in your environment.

Important

The directory names and file names on the CD-ROM may appear differently from what is described here, depending on the machine you are using. Execute the ls command of the OS and enter the displayed directory name as is.
Copy the installation data.

Copy the following files stored in the mounted CD-ROM file system to the directory created in step 2 to store the installation data.
- File in tar.gz format
- Executable file of the adbinstall command
```
cp /media/hitachi_advanced_database_client-$VER.tar.gz /home/osuser01/client ...a
cp /media/adbinstall /home/osuser01/client                                   ...b
```
Explanation:
1. Copy the tar.gz file (the compressed file containing the HADB client program).
2. Copy the executable file for the adbinstall command (the installation command for the HADB client).
The underlined portion is the mount directory name of the CD-ROM file system. It might differ in your environment.

$VER represents the HADB client version and release number.

Important

Be sure to copy the aforementioned two files into the same directory. If you copy them to different directories, the HADB client cannot be installed.
Check that the copied files are not corrupted.

Check that the files copied in Step 5 are not corrupted. Run the following commands.
```
cd /home/osuser01/client
sha256sum -c /media/adbhashfile_client_sha256.txt
```
The underlined portion is the mount directory name of the CD-ROM file system. It might differ in your environment.

If there is a possibility that the file is corrupted (the hash value of the file is different), an error message will be displayed. In this case, redo the process from Step 5.

For details on the output messages, refer to the OS manual.
Grant permissions.

Assign execution permission for the adbinstall command (the installation command for the HADB client) to the OS user who manages the HADB client.

Also, grant read permissions for the tar.gz file.
```
chmod 555 /home/osuser01/client/adbinstall
chmod 444 /home/osuser01/client/hitachi_advanced_database_client-$VER.tar.gz
```
$VER represents the client version and release number of the HADB client.
Install the HADB client.

Execute the installation command (adbinstall command).
```
/home/osuser01/client/adbinstall -c /home/osuser01/clientdir
```
For the underlined part, specify the directory where you stored the installation data created in Step 2.

Specify the path to the client directory for the -c option. Specify either of the following paths.
- Path specified in the environment variable ADBCLTDIR
- Path to another directory
  
  If you specified a path to another directory, set that path to the environment variable ADBCLTDIR.
When you specify a directory for the -c option, make sure that the OS user who will manage the HADB client can write to the directory.

Note

For details about how to run the adbinstall command and the rules that apply when doing so, see adbinstall (Install HADB Server or Client) in the manual HADB Command Reference.
Verify that the HADB client has been installed correctly

Open the adbinstcl.log file in the client directory and check its contents. If the HADB client is installed correctly, the following information is listed.
```
Hitachi Advanced Database Client 06-00-/B (20250725131854)
```
The first underlined part shows the output version information of the installed HADB client.

The second underlined part shows the output date and time when the HADB client was installed (in the example above, July 25, 2025, at 13:18:54).
Note
- If the adbinstcl.log file already exists when the adbinstall command is run, the contents of the adbinstcl.log file is updated. Additionally, if the adbinstall command is executed multiple times, the date and time of the last execution are recorded.
- If the return code of the adbinstall command (the return code output in the KFAA91552-I message) is not 0 or 4, the contents of the adbinstcl.log file will not be updated.
- If the KFAA91555-I message is output when executing the adbinstall command, the contents of the adbinstcl.log file will not be updated.

■ Action to take when KFAA91553-E message is output: For the solution, refer to ■ Action to take when KFAA91553-E message is output in (2) Installing an HADB client in 4.2.2 HADB client for Linux.
■ Action to take when KFAA91558-W message is output: For the solution, refer to ■ Action to take when KFAA91558-W message is output in (2) Installing an HADB client in 4.2.2 HADB client for Linux.

To Page Top