8.8.2 Procedure for swapping the HADB server with its revised version

After you have taken the steps described in 8.8.1 Steps to take before swapping the HADB server with its revised version, swap the HADB server with its revised version by using the following procedure.

Procedure:

Log on to the OS from the HADB administrator's OS account.

Log on to the server machine's OS from the HADB administrator's OS account that you have been using.

Important

Do not modify the HADB administrator's OS account. If you modify the HADB administrator's OS account, you might not be able to correctly swap the HADB server with its revised version.
Create the directory for storing the installation command and installation data.

Execute the OS's mkdir command to create the directory for storing the installation command (adbinstall command) and installation data (tar.gz file).
```
mkdir /home/adbmanager/vup
```
In this example, /home/adbmanager/vup is created as the directory for storing the installation command and installation data.
To the directory created in step 2, assign permissions that allow writing by the HADB administrator.

Execute the OS's chmod command to assign the directory created in step 2 the permissions that allow writing by the HADB administrator.
```
chmod 755 /home/adbmanager/vup
```
Mount the CD-ROM file system.

Execute the OS's mount command to automatically mount the CD-ROM file system containing the installation command and installation data. If the CD-ROM file system is not mounted automatically, you must mount it manually.
```
mount /dev/cdrom /media
```
The underlined portion shows the name of the mount directory for the CD-ROM file system. It will vary depending on the environment.

Important

Depending on the server machine you are using, the directory and file names used on the CD-ROM might be different from those shown in the preceding command. Enter the directory name that is displayed exactly as it is shown when you execute the ls operating system command.
Copy the installation command.

Execute the OS's cp command to copy the HADB server installation command (adbinstall command) to the directory created in step 2. The installation command is stored on the mounted CD-ROM file system.
```
cp /media/adbinstall /home/adbmanager/vup
```
The underlined portion shows the name of the mount directory for the CD-ROM file system. It will vary depending on the environment.
Copy the installation data.

Execute the OS's cp command to copy the HADB server installation data (tar.gz file) to the directory created in step 2. The installation data is stored on the mounted CD-ROM file system.
```
cp /media/hitachi_advanced_data_binder_server-$VR.tar.gz
   /home/adbmanager/vup
```
The underlined portion shows the name of the mount directory for the CD-ROM file system. It will vary depending on the environment.

$VR indicates the HADB version and release number.

Example: For 03-02-/A, 0302a-0 is displayed in place of $VR.

Important

Copy the installation command and installation data to the same directory. If they are copied to different directories, you cannot swap the HADB server with its revised version.
Assign the installation command the permissions that allow execution by the HADB administrator.

Assign the installation command the permissions that allow execution by the HADB administrator.
```
chmod 777 /home/adbmanager/vup/adbinstall
```
Execute the installation command.

The HADB administrator must execute the installation command to install the revised version of the HADB server.
```
/home/adbmanager/vup/adbinstall -s /HADB/server
```
The underlined portion is the path name of the directory to which the installation command has been copied.

For the -s option, specify the absolute path for the server directory being used (in this example, /HADB/server).
Important
- If the installation command causes an error and the KFAA91553-E message is output, see ■ If the installation command causes an error (the KFAA91553-E message is output).
- If the KFAA91558-W message (warning message) is output when you execute the installation command, see ■ If the message KFAA91558-W (warning message) is output.
Respond to the KFAA91554-Q message.

When you execute the installation command, the KFAA91554-Q message is output, asking whether you want to overwrite the directory. Enter y or Y to overwrite the directory.
Confirm that the revised version of the HADB server has been installed.

Execute the adbls -d ver command to check the HADB server version information.
```
adbls -d ver
```
Multi-node function

If you are using the multi-node function, check the HADB server version information for all nodes by executing the preceding command on all HADB servers on all nodes.

If no version information is displayed even when you execute the adbls -d ver command, there might be a specification error in one of the following environment variables:
- The server directory has not been set in the ADBDIR environment variable.
- The bin directory under the server directory has not been correctly set in the PATH environment variable.
For details about environment variables, see 8.4 Setting environment variables.
Start the HADB server normally.

Execute the adbstart command to start the HADB server normally.
```
adbstart
```
If the HADB server starts successfully, swapping of the HADB server with its revised version is complete.

■ If the installation command causes an error (the KFAA91553-E message is output)

In the following cases, the installation command causes an error and the KFAA91553-E message is output. In such cases, assign the target directory the permissions that allow writing by the HADB administrator.

The HADB administrator does not have write privileges for the directory specified in the -s option.
The HADB administrator does not have write privileges for the directory containing the installation command and installation data.

■ If the message KFAA91558-W (warning message) is output

If you execute the adbinstall command as root rather than using the HADB administrator's OS account, the KFAA91558-W message (warning message) is output. Normally, the HADB administrator's OS account is used to execute the adbinstall command. Therefore, if the KFAA91558-W message is output, make sure that executing the adbinstall command as the root user (root) does not cause any problems.

If a problem exists, enter n or N in response to the input request in the KFAA91559-Q message that is output after the KFAA91558-W message. Then, execute the adbinstall command by using the HADB administrator's OS account.

If you execute the adbinstall command as a superuser other than root, the KFAA91558-W message is not output.

Note: root indicates a user for which 0 is displayed by executing the OS's id -u command. This includes a case where 0 is displayed by executing the OS's id -u command after another OS user was changed to root by using the OS's su command.

To Page Top