pdfrstr (Restore HiRDB file system)
Function
The pdfrstr command restores a HiRDB file system backed up by the pdfbkup command. Restoration can also be performed in units of HiRDB files.
The number of added areas and the number of noncontiguous free areas can be determined by displaying the status of a HiRDB file system area (by entering the pdfstatfs command). The added areas and noncontiguous free areas can then be merged and the HiRDB file system area used more effectively by taking the following measures:
- Back up the HiRDB file system (pdfbkup command)
- Initialize the HiRDB file system area (pdfmkfs command)
- Restore the backed up HiRDB file system to the initialized HiRDB file system (pdfrstr command)
Executor
Format
pdfrstr [-y] [-q] [-{t|o|r}]
backup-filename[/HiRDB-filename]
HiRDB-file-system-area-name
Options
Specifies that the HiRDB file system is to be restored without obtaining user confirmation. When this option is omitted, the system is restored only after the user confirms the processing.
Specifies that high-speed restoration, which writes the backup file information in the batch mode, is to be used.
Specifies the processing to be performed if a file with the same name as a HiRDB file in the backup file to be restored already exists in the restoration destination HiRDB file system area:
- -t
- Do not restore if the existing HiRDB file in the restoration destination HiRDB file system area has a more recent time stamp
- -o
- Do not use the HiRDB file in the backup file for restoration
- -r
- Restore from the HiRDB file in the backup file regardless of the time stamp
- When this option is omitted, -t is assumed.
Command arguments
- backup-filename[/HiRDB-filename]
Specifies the backup file backed up by the pdfbkup command. If a particular HiRDB file is to be restored, also specifies that file.
- backup-filename
- Specifies the name of the backup file.
- HiRDB-filename
<HiRDB filename> - Specifies the name of the backed up HiRDB file that is to be restored.
- HiRDB-file-system-area-name
<pathname> ((up to 165 characters))
Specifies the name of the restoration destination HiRDB file system area.
Rules
- The pdfrstr command can be executed only while HiRDB is inactive.
- The pdfrstr command must be executed at each server machine where the HiRDB file system area is stored.
- Any HiRDB files in the restoration destination HiRDB file system area that are not in the backup file will remain in the HiRDB file system area after execution of the pdfrstr command.
- A confirmation message is displayed when the -y option is omitted. The HiRDB file system is not restored if any character other than G is entered in response to the confirmation message.
- If there are no HiRDB files in the restoration destination HiRDB file system area, the -q option is assumed when the pdfrstr command executes.
- If the pdfrstr command with the -q option specified terminates abnormally during execution, the HiRDB file system area at the storage destination may become corrupted. Thus, if there are any HiRDB files in the storage destination HiRDB file system area, you should back them up in advance with the pdfbkup command.
- You cannot restore a HiRDB file if the record length of the backup HiRDB file is not a multiple of the sector length of the target HiRDB file system area. Before backing up a HiRDB file, use the pdfls command to check its record length. To check the sector length of the target HiRDB file system area, use the pdfstatfs command.
Notes
- The execution results of the pdfrstr command can be confirmed by the return code after the command has executed and by whether or not there are any error messages. Return code 0 for this command indicates normal termination, 1 indicates warning termination, and -1 indicates abnormal termination.
- Restoration to a utility HiRDB file system area cannot be made while the utility is executing; in such a case, restoration should be performed after termination of the utility.