8.2.2 Installation procedure
This subsection explains how to install the HADB server. You install the HADB server as the OS user who was set up as the HADB administrator.
- Organization of this subsection
(1) Creating a directory for storing the installation data
Create a directory for storing the HADB server's installation data. To do this, enter the following OS command:
mkdir path-name-of-desired-directory
An example follows in which /home/adbmanager/install is selected as the path name for the desired directory.
- • Command execution example
-
mkdir /home/adbmanager/install
(2) Granting write privileges for the directory that stores the installation data
Grant write privileges for the directory that will store the installation data so that the HADB administrator can perform write operations. To do this, enter the following OS command:
chmod 755 path-name-of-desired-directory
An example follows in which /home/adbmanager/install is selected as the path name for the desired directory.
- • Command execution example
-
chmod 755 /home/adbmanager/install
(3) Mounting the file system CD-ROM
Allow the file system CD-ROM containing the installation command (adbinstall command) and the installation data (tar.gz file) for the HADB server to mount automatically.
If the file system CD-ROM does not mount automatically, you must mount it manually. To do so, enter the following command and press Enter:
mount /dev/cdrom /media
The underlined portion is the name of the mount directory for the file system CD-ROM. It will vary depending on the environment.
- Important
-
Depending on the machine being used, the directory names and file names used on the CD-ROM might be different from those shown above. Enter the directory name that is displayed exactly as shown when you execute the ls operating system command.
(4) Copying the installation command (adbinstall command)
Copy the HADB server installation command (adbinstall command) that is stored in the mounted file system CD-ROM to a directory of your choice.
Enter the following operating system command to copy the adbinstall command to the desired directory:
cp /media/adbinstall path-name-of-desired-directory
The underlined portion is the name of the mount directory for the file system CD-ROM. It varies depending on the environment.
An example follows in which /home/adbmanager/install is selected as the directory path name.
- • Command execution example
-
cp /media/adbinstall /home/adbmanager/install
(5) Copying the installation data (tar.gz file)
Copy to a directory of your choice the HADB server installation data (tar.gz file) that is stored on the mounted file system CD-ROM.
Enter the following operating system command to copy the tar.gz file to the directory of your choice:
cp /media/hitachi_advanced_data_binder_server-$VR.tar.gz path-name-of-desired-directory
The underlined portion is the name of the mount directory for the file system CD-ROM. It varies depending on the environment. $VR indicates the HADB version and release number.
- Important
-
Copy the tar.gz file to the directory to which the adbinstall command was copied in (4) Copying the installation command (adbinstall command). Unless you store the adbinstall command and the tar.gz file in the same directory, you cannot install the HADB server.
The following provides an example in which /home/adbmanager/install is selected as the directory path name.
- • Command execution example
-
cp /media/hitachi_advanced_data_binder_server-$VR.tar.gz /home/adbmanager/install
(6) Assigning execution privileges to the installation command (adbinstall command)
Assign execution privileges to the HADB server installation command (adbinstall command) that was copied to the directory of your choice, so that the HADB administrator has execution privileges.
An example follows in which the installation command (adbinstall command) is stored in /home/adbmanager/install.
- • Command execution example
-
Execute the following operating system command to assign execution privileges to the installation command (adbinstall command):
chmod 777 /home/adbmanager/install/adbinstall
Execution privileges have now been assigned to the installation command (adbinstall command).
(7) Installing the HADB server
Install the HADB server by executing the HADB server installation command (adbinstall command), to which execution privileges were assigned.
Enter the HADB command shown below to install the HADB server. The directory under which the HADB server is installed becomes the server directory. The server directory stores a group of files related to server processes.
/install/adbinstall -s server directory path name
- Note
-
The underlined portion is the path name of the directory that was selected to copy and store the adbinstall command.
The HADB server is installed under the directory specified in the -s option. This directory becomes the server directory. For the path name of the server directory, use a character string of no more than 118 bytes that begins with a forward slash (/).
For information about the characters that can be used in a server directory path, see <path name> under ■ Conventions: Syntax elements in the Preface.
In the -s option, you must specify a directory for which the HADB administrator has write privileges. If you specify a directory for which the HADB administrator does not have write privileges, an error occurs and the KFAA91553-E message is output.
The KFAA91553-E message is also output when the HADB administrator does not have write privileges for the installation command (adbinstall command) and the installation data (tar.gz file).
If the KFAA91553-E message is output, grant write privileges for the target directory.
If the directory specified in the -s option does not exist, execute the adbinstall command to automatically generate the directory.
- Note
-
The OS user who executes the adbinstall command to install the HADB server is recognized as the HADB administrator by the HADB server.
If you execute the adbinstall command as root, not as the OS user specified as the HADB administrator, a warning message (KFAA91558-W) is output. Normally, the OS user specified as the HADB administrator executes the adbinstall command. Therefore, if the KFAA91558-W message is output, make sure that executing the adbinstall command by root does not cause any problems.
If a program 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 as the OS user specified as the HADB administrator.
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 a value of 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.
- Note
-
For details about the adbinstall command, see adbinstall (Install HADB Server or Client) in the manual HADB Command Reference.
An execution example follows in which /home/adbmanager/install is selected as the directory path name and /HADB/server is selected as the server directory path name.
- • Command execution example
-
The HADB server is installed under the /HADB/server directory. The /HADB/server directory becomes the server directory.
/home/adbmanager/install/adbinstall -s /HADB/server
- Note
-
For details about the configuration of the server directory when the HADB server is installed using the adbinstall command, see A.1 Configuration of the server directory (for installation).