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 zip file from the installation media to a folder of your choice.
Expand the zip file to the client directory specified in the ADBCLTDIR environment variable.

If you expand the zip file to a path other than the client directory, perform the following additional step:
- Change the client directory path specified in the ADBCLTDIR environment variable.

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 a directory.
```
mkdir /home/osuser01/client
```
Create the directory /home/osuser01/client in which the installation data (tar.gz file) and the adbinstall command will be stored.
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.
Copy the installation data (tar.gz file) and installation command (adbinstall) from the installation media to the directory you created in step 2.
```
cp /media/hitachi_advanced_data_binder_client-$VER.tar.gz /home/osuser01/client
cp /media/adbinstall /home/osuser01/client
```
The underlined portion indicates the mount directory of the CD-ROM file system. The actual mount directory will depend on the environment.

$VER represents the HADB version and release number.

You must copy the tar.gz file and the adbinstall command to the same directory.
Assign execution permission for the installation command to the OS user who manages the HADB client.
```
chmod 777 /home/osuser01/client/adbinstall
```
Assign execution permission for the installation command (adbinstall) you copied in step 4 to the OS user who manages the HADB client.
Execute the installation command (adbinstall command).
```
/home/osuser01/client/adbinstall -c /home/osuser01/clientdir
```
As the client directory path in the -c option, specify a directory of your choice or the path specified in the ADBCLTDIR environment variable.

The directory you specify must be one for which the OS user who manages the HADB client has write permission.

If you specify a path in the -c option that differs from the path specified in the ADBCLTDIR environment variable, perform the following additional step:
- In the ADBCLTDIR environment variable, specify the path of the directory you specified in the -c option.
Note

For details about how to execute the adbinstall command and the rules, see adbinstall (Install HADB Server or Client) in the manual HADB Command Reference.

▪ Action to take when KFAA91553-E message is output

If the OS user who manages the HADB client does not have write permission for the directory specified in the -c option of the adbinstall command, the KFAA91553-E message is output.

The KFAA91553-E message is also output if the OS user who manages the HADB client does not have write permission for the directory that contains the installation command (adbinstall) and installation data (tar.gz file).

If the KFAA91553-E message is output, assign write permission for the directory concerned.

▪ Action to take when KFAA91558-W message is output

If the root user executes the adbinstall command instead of the OS user who manages the HADB client, the KFAA91558-W message is output.

Under normal circumstances, the OS user who manages the HADB client executes the adbinstall command. If the KFAA91558-W message is output, check whether executing the adbinstall command as root might cause any issues.

If doing so might cause an issue, press n or N when prompted for input by the KFAA91559-Q message output after the KFAA91558-W message. Then, execute the adbinstall command using the account of the OS user who manages the HADB client.

Note

The KFAA91558-W message is not output if a superuser other than root executes the adbinstall command.
root is the user whose value is 0 in the output of the id -u OS command. This includes situations in which you use the su command of the OS to elevate an OS user to root, giving that user a value of 0 in the output of the id -u OS command.

To Page Top