2.3.1 Creating the HiRDB directory
(1) Information to be specified in the HiRDB directory
You can assign any name to the HiRDB directory, but be sure to specify all the following information. The pathname of the HiRDB directory must be no longer than 128 characters (bytes). For Linux, specify 1-27 characters (bytes) as the pathname.
- Directory name: Any name
- Owner: HiRDB administrator
- Group: HiRDB group
- Mode: 0755
Also note the following:
- Specify a character string that begins with / (forward slash) and that consists of only the following characters:
- Alphanumeric characters
- _ (underscore)
- . (period)
- / (forward slash separating paths)
- The forward slash (/) alone cannot be specified.
- A path name must not exceed 128 characters (bytes). For the Linux version, a path name must not exceed 27 characters (bytes).
(2) Points to be noted when creating the HiRDB directory
- To create the HiRDB directory, you need at least 500 MB of disk space. The recommended disk space is 1 GB. This is just a guideline; the actual size that is required depends on the size of the system.
- You should not create the HiRDB directory in the root directory. Files containing troubleshooting information are created in the HiRDB directory (files under $PDDIR/spool). If you do not delete these files periodically using the pdcspool command, a space shortage may occur on the disk, resulting in adverse effects on operating system operation.
If you do create the HiRDB directory in the root directory, you should use a different partition than that of the root directory.
- Create the HiRDB directory on a local disk. Do not specify nosuid as the mount type of the file system in /etc/checklist or etc/fstab.
- For multi-HiRDB, create a HiRDB directory with a different name for each HiRDB.
- To employ a 2-to-1 or mutual system switchover organization for a HiRDB/Parallel Server, you cannot share the same HiRDB directory among all server machines. For details about how to define the HiRDB directory, see the manual HiRDB Version 8 System Operation Guide.
(3) Deleting files from the HiRDB directory
When a server process or client has been terminated forcibly, HiRDB outputs troubleshooting information under $PDDIR/spool. If a command or utility is terminated by pressing Ctrl + C, temporary work files output by the command or utility remain in $PDDIR/tmp and are not deleted. These remaining troubleshooting information items and temporary work files are often the cause of a shortage of disk space available to the HiRDB directory. Because insufficient disk space for the HiRDB directory can cause abnormal termination, HiRDB deletes the following files periodically:
- Troubleshooting information files (files in $PDDIR/spool)
- Temporary work files (files in $PDDIR/tmp)
Normally, these files are deleted every 24 hours. The interval between deletions can be changed with the pd_spool_cleanup_interval operand. The pd_spool_cleanup_interval_level operand can be used to specify that only files that were output earlier than a specified number of days previous to the current date are to be deleted.
It is also possible to delete all at once all troubleshooting information (all files in $PDDIR/spool).
- Use the pdcspool command to delete the troubleshooting information files. Temporary work files (in $PDDIR/tmp) can also be deleted.
- Automatically delete the troubleshooting information files during the HiRDB startup. In this case, use the pd_spool_cleanup operand to specify whether or not to delete the troubleshooting information files. If you omit this operand, the troubleshooting information files are deleted automatically.
You can also use the pd_spool_cleanup_level operand to delete only those troubleshooting information files that have been output a specified number of days ago.
- Note
- You can select the troubleshooting information to be deleted using the pdcspool command's option, pd_spool_cleanup_level operand or pd_spool_cleanup_interval operand.
(4) Making a backup copy of the HiRDB directory
To prepare for possible errors on the disk that contains the HiRDB directory, make a backup copy of the files in the HiRDB directory (files under $PDDIR/conf). You need the backup copy of the files under $PDDIR/conf to restore the HiRDB directory. There are HiRDB system definition files under $PDDIR/conf. If you have modified the HiRDB system definition, back up the files contained under $PDDIR/conf.
If you have created user files under the HiRDB directory, also back up those files. You need this backup copy to restore the HiRDB directory.
For details about how to recover the HiRDB directory, see the manual HiRDB Version 8 System Operation Guide.
- Backing up the disk that contains the HiRDB directory
If you need to back up the disk that contains the HiRDB directory, use the following procedure:
- Terminate HiRDB with the pdstop command.
- Execute the pdsetup -d command. Enter n as a response.*
- Use the OS function (command) to back up the disk that contains the HiRDB directory.
- Execute the pdsetup command.
- Enter the pdstart command to start HiRDB.
- * You need to execute the pdsetup -d command to remove all the files that may cause problems after recovery. Additionally, you need to enter n as a response to retain all the files that are required after recovery.