Checks the contents of system definitions that are required in order to start HiRDB.
If there is an error in the system definitions, the command displays the erroneous definition along with the details.
(a) -d subdirectory-name ~<path name>
Specifies the subdirectory that contains the HiRDB system definition file to be checked, expressed as a path name relative to $PDDIR/conf or $PDCONFPATH. $PDDIR/conf is the directory that contains unit control information definition files. $PDCONFPATH is the directory that contains other HiRDB system definition files.
The following table shows the locations of the HiRDB system definition files that can be checked:
Type of HiRDB system definition file | -d option specified | -d option omitted |
---|
Unit control information definition file | $PDDIR/conf/subdirectory/ | $PDDIR/conf/ |
Other file | $PDCONFPATH/subdirectory/ | $PDCONFPATH/ |
- Criteria
- Before changing the HiRDB system definitions for the current environment, you should save the new HiRDB system definitions in a subdirectory and check them. This enables you to check the modified HiRDB system definitions before proceeding.
- Rules
- Create in advance the subdirectory that will be specified.
- Store in the subdirectory not only the modified HiRDB system definition file but all HiRDB system definition files.
- For a HiRDB single server configuration, the same path name is set in $PDDIR/conf and $PDCONFPATH.
- For a HiRDB parallel server configuration, the path name pointed to by $PDDIR/conf and $PDCONFPATH may be different (for example, when the HiRDB system definition file is shared). In this case, create a subdirectory with the same name on both paths.
If the $PDDIR/conf and $PDCONFPATH settings are different for each unit, create the subdirectory under $PDDIR/conf and $PDCONFPATH and then store the HiRDB system definition files in the subdirectories.
- The maximum lengths of $PDDIR/conf/subdirectory and $PDCONFPATH/subdirectory are 220 bytes. Make sure that the name does not exceed 220 bytes.
- To check the system definitions that are to be changed by the pdchgconf command, store the new system definition files in $PDDIR/conf/chgconf and then specify -d chgconf when you execute the pdconfchk command.
- Because definitions are checked in the primary system when the system switchover facility is used, subdirectories that you create must be in the primary system. Note also that you must switch all running units to the primary units before you execute the pdconfchk command. If the unit containing the system manager is offline, execute the pdconfchk -d command on the unit that contains the system manager for the primary system.
- For a HiRDB single server configuration, the following operand values in the HiRDB system definition file under subdirectories must match the operand values under $PDDIR/conf or $PDCONFPATH:
Host name specified in the -x option of the pdunit operand
Host name specified in the pd_hostname operand
- For a HiRDB parallel server configuration, the following operand values in the HiRDB system definition file under subdirectories must match the operand values under $PDDIR/conf or $PDCONFPATH:
Host name specified in the -x option of the pdunit operand on the unit that contains the system manager
Host name specified in the pd_hostname operand on the unit that contains the system manager
(b) -n
Specifies that checking of the system files and access permissions is to be skipped. Use this option when the system files have not been created by the pdfmkfs or pdloginit command.
(c) -l
When Real Time SAN Replication based on the log-only synchronous method is used, this option specifies that the status file for log application processing and the synchronization point dump file for log application processing, which are required for log application processing, are to be included as targets for system file checking as well as for access privilege checking.
The -l option can be specified only when all of the conditions listed below are satisfied; if any of these conditions is not satisfied, the pdconfchk command terminates with an error:
- Y is specified in the pd_rise_use operand in the system definition.
- syssync is specified in the pd_rise_pairvolume_combination operand in the system definition.
- data or never is specified in the pd_rise_fence_level operand in the system definition.
(d) -u unit-identifier ~<identifier> ((4 characters))
This option is applicable to a HiRDB parallel server configuration only.
Specifies a specific unit that is to be checked. When this option is specified, the command checks the definitions for the unit specified in this option and for the unit where the system manager is located.
- Rules
- This option can be executed at the server machine where the system manager is located.
- If the unit containing the system manager is specified in this option, checking between server machines is not performed.
- Syntax checking
The command outputs the result of syntax checking to the standard output and standard error output.
- Checking for system files
The command checks for any system log file, synchronization point dump file, or status file.
- Checking for access privilege
The command checks the following:
- Whether the HiRDB administrator can access HiRDB files
- Whether the HiRDB administrator can access the hosts file
- Whether there is a directory specified in the pd_tmp_directory operand in the system definition and whether the HiRDB administrator can access that directory
If the pd_tmp_directory operand is omitted, this checking is not performed.
- Checking for duplicated system files
The command checks the system log files, synchronization point dump files, and status files for any duplication.
The command checks to see if the host names are specified in the HOSTS file.
- Checking between server machines (applicable to a HiRDB parallel server configuration)
The command checks between server machines based on the system manager's server machine.
For details about the operands in the system definition that can be checked by the pdconfchk command, see Operands Checked by the pdconfchk Command in the manual HiRDB Version 9 System Definition.