Scalable Database Server, HiRDB Version 8 System Operation Guide
When HiRDB runs out of current system log files due to a shortage of space, it issues the KFPS01220-E message and terminates itself (unit) abnormally. When this happens, abort code Psjnf07 or Psjn381 is output. The HiRDB administrator must restart the job using the procedure shown below:
The numbers to the left of the process boxes correspond to the paragraph numbers of the explanations on the following pages. For example, step 5 is explained in paragraph (5) below.
1 This step is explained in Section 18.17.2 Determining the minimum number of system log files to be added.
2 This step is explained in Section 18.17.3 Creating a file in swappable target status.
Messages can be checked during the procedure explained below. Because messages in the HiRDB message log files ($PDDIR/spool/pdlog1 and pdlog2) may have been overwritten, check the messages in syslogfile.
The server that caused the abnormal termination can be determined from the KFPS01220-E message:
Contents of the syslogfile
KFPS01220-E PRDT untF Request to swap sys(bes1) log file unable to be executed because there is no standby log file group available.(13830) |
In this example, bes1 is the cause of abnormal termination. Assume for this example that this server's system log files are organized as follows:
The number of system log files to be used as the input information during restart can be determined from the KFPS01229-I message and the pdlogls command.
Contents of the syslogfile
KFPS01220-E PRDT untF Request to swap sys(bes1) log file unable to be executed because there is no standby log file group available.(13830) KFPO00105-E PRDT untF Server _log1s(process ID=13830) killed by code=Psjnf07(13830) KFPS01821-E PRDT untF Unable to continue HiRDB unit processing because serious error occurred; stops HiRDB unit untF (13776) KFPS01229-I PRDT untF Next bes1 log file restart point,generation number=4, block number=d. restart end point, generation number=6, blocknumber=11. last acquired syncpoint dump 1998/11/15 15:54:41 (13776) |
Execution results of the pdlogls command:
pdlogls -d sys -s bes1 HOSTNAME : dcm3500(163541) ***** Off-line Information ***** Group Type Server Gen No. Status Run ID Block No. logfg01 sys bes1 1 cna---u 364a4ac2 1 6 logfg02 sys bes1 2 cna---u 364a4ac2 7 9 logfg03 sys bes1 3 cna---u 364a4ac2 a c logfg04 sys bes1 4 cna---u 364a4ac2 d e logfg05 sys bes1 5 cna---u 364a4ac2 f 10 logfg06 sys bes1 6 cn---cu 364a4ac2 11 0 logfg07 sys bes1 0 cn----- 00000000 0 0 logfg08 sys bes1 0 cn----- 00000000 0 0 |
Use the pdfstatfs command to determine if there is enough space in the HiRDB file system area to add the four system log files determined in step (2).
pdfstatfs /bes1/sysfile_a pdfstatfs /bes1/sysfile_b |
The following procedure is used to determine the size of one system log file:
pdlogadfg -d sys -g logfg09 ONL
pdlogadpf -d sys -g logfg09 -a /bes1/sysfile_a/log09a\
-b /bes1/sysfile_b/log09b
pdlogadfg -d sys -g logfg10 ONL
pdlogadpf -d sys -g logfg10 -a /bes1/sysfile_a/log10a\
-b /bes1/sysfile_b/log10b
pdlogadfg -d sys -g logfg11 ONL
pdlogadpf -d sys -g logfg11 -a /bes1/sysfile_a/log11a\
-b /bes1/sysfile_b/log11b
pdlogadfg -d sys -g logfg12 ONL
pdlogadpf -d sys -g logfg12 -a /bes1/sysfile_a/log12a\
-b /bes1/sysfile_b/log12b
|
Specify the pdlogadfg and pdlogadpf operands for the system log files to be added. In this example, four files are added to each of versions A and B.
pdloginit -d sys -s bes1 -f /bes1/sysfile_a/log09a -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_b/log09b -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_a/log10a -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_b/log10b -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_a/log11a -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_b/log11b -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_a/log12a -n 5000 pdloginit -d sys -s bes1 -f /bes1/sysfile_b/log12b -n 5000 |
In this example, four files are added to each of versions A and B.
HiRDB/Single Server
pdstart |
HiRDB/Parallel Server
In the case of a HiRDB/Parallel Server, restart the applicable unit.
pdstart -u untF |
Although jobs can be accepted immediately after HiRDB (the unit) has been restarted, do not resume jobs yet. Immediately after HiRDB (the unit) is restarted, HiRDB is still recovering the database. If many database-updating jobs are entered at this point, a system log file space shortage may occur again. If that happens, HiRDB (the unit) will terminate abnormally again. Therefore, refrain from resuming jobs until all the steps through (9) have been completed.
When HiRDB is restarted, a synchronization point dump is validated, in which case the KFPS02183-I message is output. A check should be made that the synchronization point dump has been validated before the next step is executed.
Note that the KFPS02183-I message is output only if Y was specified in the pd_spd_assurance_msg operand or if this operand was omitted. If this condition is not satisfied, check that the synchronization point dump is validated using the procedure explained in Section 18.17.6 Checking for synchronization point dump validation.
pdcopy -m dcm3500:/dbarea/area1/rdmt1 -M x -p /usr/ofile -f /usr/seifile/cfl -z /usr/bes1/logpoint02 |
If operation without unloading of the system log was in effect, use the database copy utility (pdcopy command) to back up all RDAREAs in the server before restarting an application. In such a case, specify the -z option to determine the log point information file.
After backing up the RDAREAs, use the pdlogchg -z command to release the system log file and place it in unload completed status:
pdlogchg -z /usr/bes1/logpoint02 [-x host_name] |
pdlogls -d sys -s bes1 |
If there is no file in swappable target status, HiRDB may terminate abnormally again. Immediately create a file in swappable target status. For example, if a file can be placed in swappable target status by releasing it from unload wait status, use the pdlogunld command to unload the system log.
Restart the application.
Reevaluate the size of the system log files. For details on how to obtain the size of system log files, see the manual HiRDB Version 8 Installation and Design Guide. If any added system log file is not needed, delete it. The procedure for deleting a system log file is shown below.
If operation without unloading of the system log is being used, a system log file cannot be deleted while it is in use as the current system log file. Check that the system log file to be deleted is not the current file, execute step (8) again, then delete the system log file.
All Rights Reserved. Copyright (C) 2007, Hitachi, Ltd.