5.2.4 Modifying HiRDB system definitions (excluding UAP environment definitions)

This section describes how to modify HiRDB system definitions.

Note
  • After modifying the HiRDB system definitions, be sure to back up the files under $PDDIR/conf. To protect against possible errors on the disk that contains the HiRDB directory, you need to back up the files in the HiRDB directory (files under $PDDIR/conf). To restore the HiRDB directory, you need a backup copy of the files under $PDDIR/conf. If $PDCONFPATH is under the HiRDB directory, back it up in the same manner.
  • For a HiRDB/Parallel Server, create subdirectories for each unit under $PDDIR/conf and $PDCONFPATH, and check the contents of the HiRDB system definition.
Organization of this subsection
(1) How to modify HiRDB system definitions
(2) How to modify HiRDB system definitions with the system reconfiguration command
(3) Notes

(1) How to modify HiRDB system definitions

This section describes how to modify HiRDB system definitions. In this explanation, the directory that stores the unit control information definition file is referred to as $PDDIR/conf, and the directory that stores any other HiRDB system definition files is referred to as $PDCONFPATH.

Procedure

  1. Create subdirectories under $PDDIR/conf and $PDCONFPATH. In this example, the subdirectories will be named work.
  2. Copy the unit control information definition file under $PDDIR/conf/work. Copy the other HiRDB system definition files under $PDCONFPATH/work.
  3. Modify the HiRDB system definitions copied into $PDDIR/conf/work and $PDCONFPATH/work.
  4. Use the pdconfchk -d work command to check the contents of the HiRDB system definitions in $PDDIR/conf/work and $PDCONFPATH/work. If an error is detected, correct the HiRDB system definition and re-execute the pdconfchk command.
  5. Use the pdstop command to terminate HiRDB normally.
  6. Use the pdlogunld command to unload system log files in unload wait status.
  7. Replace the HiRDB system definition files by copying the HiRDB system definition files modified in step 3 under $PDDIR/conf and $PDCONFPATH.
  8. If the values specified for the following operands have been modified, use the pdloginit command to initialize the system log files:
    [Figure]pd_log_dual
    [Figure] pdstart
  9. Use the pdstart command to perform a HiRDB normal startup.

(2) How to modify HiRDB system definitions with the system reconfiguration command

When the system reconfiguration command (pdchgconf command) is used, the HiRDB system definitions can be modified while HiRDB is operating, which means that HiRDB need not be terminated. However, in order to use this command, HiRDB Advanced High Availability must be installed. The following section shows how to modify a HiRDB system definition with the system reconfiguration command.

Procedure
  1. Create the $PDDIR/conf/chgconf directory.
  2. Copy the HiRDB system definition files currently being used to the directory created in step 1.
  3. Modify the HiRDB system definitions in $PDDIR/conf/chgconf.
  4. Use the pdconfchk command to perform a check of the HiRDB system definitions in $PDDIR/conf/chgconf. If an error is detected, correct the HiRDB system definition and re-execute the pdconfchk command.
  5. Use the pdchgconf command to replace the HiRDB system definitions with the modified HiRDB system definitions.
    When the pdchgconf command is executed, the HiRDB system definition files currently being used (before modification) will be saved in $PDDIR/conf/chgconf. Therefore, the modified HiRDB system definition files in $PDDIR/conf/chgconf will be copied to $PDDIR/conf.
Notes
  • If a transaction or utility is still operating 15 minutes after the pdchgconf command was entered, the pdchgconf command terminates abnormally.
  • There are restrictions on the use of the system reconfiguration command to modify HiRDB system definitions; for details about the restrictions, see the manual HiRDB Version 8 System Operation Guide.

(3) Notes