HiRDB Datareplicator Version 8 Description, User's Guide and Operator's Guide

[Contents][Glossary][Index][Back][Next]

9.6.6 Commands provided by the data linkage recovery facility

You use the following commands for data linkage recovery via unload log files:

Command name Description
logmrg Divides unload log files subject to recovery, or linkage recovery backup files into smaller files in such a format that the error recovery tools can read them.
setup_tool1# Sets up the data linkage recovery facility1.
setup_tool2# Sets up the data linkage recovery facility 2.
unsetup_tool# Disables the data linkage recovery facility that has been set up and enables Datareplicator's extraction facility.

#
The command names differ in Windows Vista and Windows Server 2008, as shown in the following table:
OS other than Windows Vista or Windows Server 2008 Windows Vista and Windows Server 2008
setup_tool1 set_tool1
setup_tool2 set_tool2
unsetup_tool unset_tool
Organization of this subsection
(1) logmrg command
(2) setup_tool1 command
(3) setup_tool2 command
(4) unsetup_tool command

(1) logmrg command

Execute the logmrg command in a directory for which the logon user has access privilege. An access privilege error occurs if the command is executed in a directory for which the logon user does not have access privilege.

Format
logmrg HiRDB-server-name
       divided-blocks-count
       output-target-directory
       input-source-directory
      {HiRDB-unload-log-file-name|linkage-recovery-backup-file-name}
     [{HiRDB-unload-log-file-name|linkage-recovery-backup-file-name}]

Options

HiRDB-server-name
Specify the HiRDB server name.

divided-blocks-count
Specify the number of blocks for dividing a HiRDB unload log file. The relationship between this value and the maximum size of an unload log segment file is as follows:
Maximum size of unload log segment file (bytes)
= pd_log_max_data_size operand value for HiRDB subject to recovery x number of blocks
We recommend that you specify in this operand a value in the range 100 to 1000.
Make sure that the size of an unload log segment file does not exceed 2 GB - 1 byte.

output-target-directory
Specify the absolute path of the storage directory for the logmrg command's output files (such as the unload log segment files). The permitted maximum length of the path name is 128 bytes. Do not specify the directory path of a name that contains a space.

input-source-directory
Specify the name of the storage directory for the input HiRDB unload log files. The permitted maximum length of the name is 128 bytes. Do not specify the directory path of a name that contains a space.
If you use Datareplicator version 07-02 or later, you can specify a large file as the input load log file or linkage recovery backup file. Note that an unload log segment file to be output cannot be a large file.

HiRDB-unload-log-file-name|linkage-recovery-backup-file-name

~ <symbolic name of 1-32 characters>
Specify an input HiRDB unload log file name or linkage recovery backup file name. Specify file names in the order of generations. Note that an unload log segment file must be a regular file or a non-large file.
To check the date of an unload log file, execute the following command:
pdlogcat_s -i unload-log-file-name|grep "First use"
To check the date of a linkage recovery backup file, execute the command:
pdlogcat_s -i backup-source-HiRDB-file-name|grep "First use"
The backup source HiRDB file is the HiRDB file from which the linkage recovery backup file was created. Specify it in the format HiRDB-file-system-area-name/HiRDB-file-name.

Messages
Message Action
[aa...aa] File(file-name) open error, errno=xx...xx Identify the cause of the error on the basis of the displayed errno, eliminate it, then re-execute the command.
[aa...aa] File size after dividing exceeds 2 GB, filesize = bb...b Size of the unload log segment file exceeds 2 GB. Specify a smaller number of partitioned blocks in the logmrg command argument, and then re-execute the command.
[aa...aa] Interface error occurred Contact the customer support center.
[aa...aa] Invalid file format Re-execute the command specifying unload log files or linkage recovery backup files as the input files.
[aa...aa] Lseek error, errno= xx...xx Identify the cause of the error on the basis of the displayed errno, eliminate it, then re-execute the command.
[aa...aa] Malloc error, size= xx...xx Add more memory, and then re-execute the command.
[aa...aa] Number of HiRDB files in backup file exceeds x A specified linkage recovery backup file contains information about more than x HiRDB files.
Specify a linkage recovery backup file that was created for a HiRDB file.
[aa...aa] Read error, errno= xx...xx Identify the cause of the error on the basis of the displayed errno, eliminate it, then re-execute the command.
[aa...aa] Stat error, errno= xx...xx Identify the cause of the error on the basis of the displayed errno, eliminate it, then re-execute the command.
[aa...aa] system call error. errno=xx...xx Identify the cause of the error on the basis of the system call name and the displayed errno, eliminate it, then re-execute the command.
[aa...aa] Write error, errno= xx...xx Identify the cause of the error on the basis of the displayed errno, eliminate it, then re-execute the command.
File open error. errno=xx...xx file=yy...yy Identify the cause of the error on the basis of the displayed errno, eliminate it, then re-execute the command.
HDEPATH env not set. Set the HDEPATH environment variable, and then re-execute the command.
HDEPATH env length invalid Correct the settings of the HDEPATH environment variable, and then re-execute the command.
Invalid command argument.
Usage:logmrg <server name> <block numbers> <output directory> <input directory> <unload log file name>...
Correct the operand specification, and then re-execute the command.
Invalid logcut output file. Identify the cause of the error on the basis of the message that was issued before this message, eliminate it, then re-execute the command.
Specified output directory is not full path name. Correct the operand specification, and then re-execute the command.

(2) setup_tool1 command

The setup_tool1 command sets up an environment for the data linkage recovery facility 1. At the time of setup, the command renames the program to be used for normal operation, and then copies the data linkage recovery facility 1.

Format

setup_tool1 (set_tool1 in Windows Vista and Windows Server 2008)

Messages
Message Action
Setup for <hdecapture_tool1> complete. Setup of the data linkage recovery facility 1 has been completed. Continue with the recovery procedure.
Setup for <hdecapture_tool1> failed. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
<hdecapture> backup failed. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
Setup for <hdecapture_tool1> already execute. The data linkage recovery facility 1 has already been set up.
HiRDB Datareplicator is not installed. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
Please execute by root user. Re-execute the command by the administrator privilege (superuser).

(3) setup_tool2 command

The setup_tool2 command sets up an environment for the data linkage recovery facility 2. At the time of setup, the command renames the program to be used for normal operation, and then copies the data linkage recovery facility 2.

Format

setup_tool2 (set_tool2 in Windows Vista and Windows Server 2008)

Messages
Message Action
Setup for <hdecapture_tool2> complete. Setup of the data linkage recovery facility 2 has been completed. Continue with the recovery procedure.
Setup for <hdecapture_tool2> failed. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
<hdecapture> backup failed. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
Not setup for <hdecapture_tool1>. Execute the command after setting up the data linkage recovery facility 1.
HiRDB Datareplicator is not installed. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
Please execute by root user. Re-execute the command by the administrator privilege (superuser).

(4) unsetup_tool command

The unsetup_tool command cancels the environment setup for the data linkage recovery facility 1 or 2. At the time of unsetup, the command renames the facility that has been set up and copies the programs that are used for normal operation.

Format

unsetup_tool (unset_tool in Windows Vista and Windows Server 2008)

Messages
Message Action
Unsetup for <hdecapture_tool> complete. Setup of the data linkage recovery facility has been cancelled.
Unsetup for <hdecapture_tool> failed.Please re-install HiRDB Datareplicator. Datareplicator's load module might be invalid. Re-install Datareplicator, and then re-execute the command.
Not setup for <hdecapture_tool>. The data linkage recovery facility has not been set up.
Please execute by root user. Re-execute the command by the administrator privilege (superuser).