4.2.2 HADB client for Linux

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

Important

An HADB client is installed by the OS user who will be managing the HADB client.
This OS user's user name must not exceed 32 bytes.

Note that the client directory, as described later in this document, stores the files that relate to a single client process.

Organization of this subsection

(1) Matters to check before installing an HADB client
(2) Installing an HADB client
(3) Uninstalling an HADB client

(1) Matters to check before installing an HADB client

Before installing an HADB client, you need to make sure that the libraries required for the HADB client to operate correctly have been installed in the operating system.

▪ How to checks

You can check which packages are installed in the OS by running the yum command. Execute the command as follows:

yum list installed

Review the output of the command. If all of the packages listed in the following table have been installed, the required libraries are in place in your operating system.

Table 4‒1: List of packages to check
No.	Name and version of package to check	Prerequisite library for HADB client contained in package
1	`glibc` (2.12 or later)	`libc.so.6`
2		`librt.so.1`
3		`libm.so.6`
4		`libpthread.so.0`
5		`ld-linux-x86-64.so.2` (runtime loader)
6		`libdl.so.2`
7	`libaio` (0.3.107 or later)	`libaio.so.1`
8	`openssl` (1.0.0 or later)	`libcrypto.so.10`
9	`zlib` (1.2.3 or later)	`libz.so.1`
10	`libuuid` (2.17.2 or later)	`libuuid.so.1`
11	None	`linux-vdso.so.1`^#

#: Because this library is a virtual shared library provided by the kernel, you do not need to check for a corresponding package.

If any of the packages listed in the table are not installed, install them in the operating system. For details about how to install packages, see the documentation for your operating system. Install the packages as a superuser.

Note

The following shows an example of how to execute the command to check whether a specific package is installed.

Example:

To check whether the package libaio is installed, you execute the command as follows:

yum list installed | grep libaio

If the package libaio appears in the command output, this means that the package is installed. If the package libaio does not appear in the command output, this means that the package is not installed.

To Page Top

(2) Installing an HADB client

The following explains how to install an HADB client.

To install an HADB client:

Create a directory.
```
mkdir /home/osuser01/client
```
Create a directory for storing the installation data (tar.gz file) and the adbinstall command. In the following example, /home/osuser01/client is specified as the storage directory path:
Assign write permission to the directory you created.
```
chmod 755 /home/osuser01/client
```
Assign write permission so that the OS user who manages the HADB client can write to the directory you created.
Mount the file system CD-ROM.

Automatically mount the file system CD-ROM that contains the installation data (tar.gz file) and the installation command (adbinstall command) for the HADB client.

If the file system CD-ROM cannot be mounted automatically, you must mount it manually. To mount the file system CD-ROM manually, enter the following OS command:
```
mount /dev/cdrom  /media
```
The underlined part is the mount directory of the CD-ROM file system. It might differ in your environment.

Important

The directory names and file names on the CD-ROM might differ depending on the computer. Execute the ls OS command and enter the displayed directory names as they are shown.
Copy the installation data (tar.gz file) and the installation command (adbinstall command) to the directory created in step 1.
```
cp /media/hitachi_advanced_data_binder_client-$VER.tar.gz /home/osuser01/client
cp /media/adbinstall /home/osuser01/client
```
The underlined part is the mount directory of the CD-ROM file system. It might differ in your environment.

$VER indicates the HADB version and release number.

You must copy the tar.gz file and the adbinstall command to the same directory.
Assign execution privileges for the install command to the OS user who manages the HADB client.
```
chmod 777 /home/osuser01/client/adbinstall
```
This command assigns execution privileges for the install command you copied in step 4 (adbinstall command) to the OS user who manages the HADB client.
Execute the installation command (adbinstall command).
```
/home/osuser01/client/adbinstall -c /home/osuser01/clientdir
```
The HADB client is installed under the directory specified for the -c option. This directory becomes the client directory.

Note

If the directory specified for the -c option does not exist, the directory is automatically created when the adbinstall command is executed.

The following rules apply to the client directory:
- The client directory path must not exceed 118 bytes.
- For information on the characters that can be used in a client directory path, see <path name> under ■ Conventions: Syntax elements in the Preface.
- When you specify a directory for the -c option of the adbinstall command, make sure that the OS user who will manage the HADB client can write to the directory.

■ Action to take when KFAA91553-E message is output

In the -c option of the adbinstall command, if you specify a directory for which the OS user who manages the HADB client does not have write permissions, the KFAA91553-E message is output.

This message is also output if the OS user who manages the HADB client lacks write permissions for the directory that stores the install command (adbinstall) and the installation data (tar.gz file).

If the KFAA91553-E message is output, assign write permission to the OS user 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 a root user 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 command.

■ Tasks to be performed after installation

Setting environment variables

After you have finished the installation, specify environment variables. For details about the environment variables to be specified, see 4.3.2 HADB client for Linux.

Specify in the ADBCLTDIR environment variable the absolute path of the client directory. In the installation procedure example provided above, the client directory is /home/osuser01/clientdir.
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.

Note: For details about the structure of the client directory that is created when an HADB client is installed by using the adbinstall command, see (1) Structure of the client directory (at installation) in B.2 HADB clients for Linux.

To Page Top

(3) Uninstalling an HADB client

An HADB client is uninstalled by the OS user who installed the HADB client.

Before uninstalling an HADB client, perform the following:

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.

This subsection explains how to uninstall an HADB client.

To uninstall an HADB client:

Delete the client directory.

The client directory must be deleted by the OS user who installed the HADB client.
```
rm -rf /home/osuser01/clientdir
```
Delete the installation data (tar.gz file and adbinstall command).

The installation data (tar.gz file and adbinstall command) that was used to install the HADB client must be deleted by the OS user who installed the HADB client.
```
rm -rf /home/osuser01/client
```
Delete the specifications for the environment variables that were set during installation.

To Page Top