3.2.1 Preparations necessary for installation
Before installing the HADB server, you must set up on the OS the OS user who will manage HADB (HADB administrator) and the group to which the HADB administrator belongs (HADB administrators group).
This user must also create directories for storing the communication-information files necessary for operating the HADB server.
- Organization of this subsection
(1) Setting up the HADB administrator and HADB administrators group
(2) Verifying that the HADB administrator and HADB administrators group have been set up correctly
(3) Creating the directories for storing communication-information files
(4) Checking the created directories for storing communication-information files
(1) Setting up the HADB administrator and HADB administrators group
You can assign any names you wish to the HADB administrator and HADB administrators group. The following names are used in this manual:
-
HADB administrator: adbmanager
-
HADB administrators group: adbgroup
-
Log on to the OS as a superuser.
Once you have logged on, open a terminal window for entering commands.
-
Set up the HADB administrators group (adbgroup) on the OS.
Enter the following operating system command and press Enter:
groupadd adbgroup
-
Set up the HADB administrator (adbmanager) on the OS.
Enter the operating system command below and press Enter:
For the -g option, specify the HADB administrators group (adbgroup) set up in step 2.
useradd -g adbgroup adbmanager
-
Set up a password for the HADB administrator on the OS.
Enter the following operating system command and press Enter:
passwd adbmanager
When you execute the passwd command, the system asks you to enter the new password for adbmanager twice. Specify any password.
(2) Verifying that the HADB administrator and HADB administrators group have been set up correctly
Verify that the HADB administrator and HADB administrators group that have been set up on the OS are correct.
As a superuser, enter the following operating system command and press Enter:
id adbmanager
Executing the id command lets you check the information that has been specified for adbmanager. The following shows an example of the execution result.
- ■ Execution result example
-
uid=501(adbmanager) gid=501(adbgroup) group=501(adbgroup)
If adbmanager is shown for uid, and adbgroup is shown for gid and group, the settings are correct.
- Note
-
Setting up the HADB administrator as an OS user belonging to the HADB administrators group on the OS gives the HADB administrator access privileges as the owner of the HADB server's various files and directories. As a result, the HADB administrator can prevent other users from overwriting crucial data, and can enhance the level of security. The HADB administrator also has the privileges needed to execute all HADB commands.
(3) Creating the directories for storing communication-information files
The directories that will store communication-information files differ depending on the OS version of the server machine.
-
If the server machine's OS is Red Hat Enterprise Linux Server 6 (64-bit x86_64)
-
If the server machine's OS is Red Hat Enterprise Linux Server 7 (64-bit x86_64)
(a) Red Hat Enterprise Linux Server 6
To store communication-information files, create the following directories:
-
/dev/HADB/pth
-
/lib/udev/devices/HADB/pth
The permission to be assigned to these directories is 777.
-
Create the /dev/HADB/pth directory.
As a superuser, enter the following operating system command, and then press Enter:
mkdir -p -v -m 777 /dev/HADB/pth
-
Create the /lib/udev/devices/HADB/pth directory.
As a superuser, enter the following operating system command, and then press Enter:
mkdir -p -v -m 777 /lib/udev/devices/HADB/pth
(b) Red Hat Enterprise Linux Server 7
To store communication-information files, create the following directory and file:
-
/dev/HADB/pth
The permission to be assigned to the directory is 777.
-
/etc/tmpfiles.d/dev-HADB-pth.conf
The permission to be assigned to the configuration file is 644 (default). Because this is the default permission, you do not need to specify this permission.
-
Create the /dev/HADB/pth.
As a superuser, enter the following operating system command, and then press Enter:
mkdir -p -v -m 777 /dev/HADB/pth
-
Create the configuration file (dev-HADB-pth.conf).
As a superuser, enter the following operating system command, and then press Enter: The configuration file is created.
vi /etc/tmpfiles.d/dev-HADB-pth.conf
-
Edit the configuration file.
Press the I key to place the editor in edit mode. When the editor is placed in edit mode, enter the following settings:
# Type Path Mode UID GID Age Argument d /dev/HADB/pth 0777 root root - -
-
Terminate editing the configuration file.
When entry finishes, press the Esc key to place the editor in command mode. When the editor is placed in command mode, enter the following command, and then press the Enter key.
:wq
The settings specified in edit mode are saved. Creation of the configuration file is completed when this procedure finishes.
(4) Checking the created directories for storing communication-information files
Check that the directories for storing communication-information files have been created correctly.
-
If the server machine's OS is Red Hat Enterprise Linux Server 6 (64-bit x86_64)
-
If the server machine's OS is Red Hat Enterprise Linux Server 7 (64-bit x86_64)
(a) Red Hat Enterprise Linux Server 6
Use the following procedure to check whether the two directories for storing communication-information files have been created correctly.
-
Check whether the /dev/HADB/pth directory has been created.
As a superuser, enter the following operating system command, and then press Enter:
ls -d -l /dev/HADB/pth
From the execution result of the ls command, you can check whether the /dev/HADB/pth directory has been created and whether the proper permission has been assigned. The following shows an example of the execution result.
▪ Execution result example
drwxrwxrwx 2 root root 40 Aug 13 19:28 2013 /dev/HADB/pth
Verify that the result begins with drwxrwxrwx and ends with /dev/HADB/pth.
-
Check whether the /lib/udev/devices/HADB/pth directory has been created.
As a superuser, enter the following operating system command, and then press Enter:
ls -d -l /lib/udev/devices/HADB/pth
From the execution result of the ls command, you can check whether the /lib/udev/devices/HADB/pth directory has been created and whether the proper permission has been assigned. The following shows an example of the execution result.
▪ Execution result example
drwxrwxrwx 2 root root 4096 Aug 13 19:29 2013 /lib/udev/devices/HADB/pth
Verify that the result begins with drwxrwxrwx and ends with /lib/udev/devices/HADB/pth.
(b) Red Hat Enterprise Linux Server 7
Use the following procedure to check whether the directory for storing communication-information files has been created correctly and whether the configuration file has been created correctly.
-
Check whether the /dev/HADB/pth directory has been created.
As a superuser, enter the following operating system command, and then press Enter:
ls -d -l /dev/HADB/pth
From the execution result of the ls command, you can check whether the /dev/HADB/pth directory has been created and whether the proper permission has been assigned. The following shows an example of the execution result.
▪ Execution result example
drwxrwxrwx 2 root root 40 Aug 13 19:28 2013 /dev/HADB/pth
Verify that the result begins with drwxrwxrwx and ends with /dev/HADB/pth.
-
Check whether the configuration file (dev-HADB-pth.conf) has been created.
As a superuser, enter the following operating system command, and then press Enter:
ls -l /etc/tmpfiles.d/dev-HADB-pth.conf
From the execution result of the ls command, you can check whether the /etc/tmpfiles.d/dev-HADB-pth.conf file has been created correctly and whether the default permission has been assigned. The following shows an example of the execution result.
▪ Execution result example
-rw-r--r-- 2 root root 40 Aug 13 19:29 2013 /etc/tmpfiles.d/dev-HADB-pth.conf
Verify that the result begins with -rw-r--r-- and ends with /etc/tmpfiles.d/dev-HADB-pth.conf.