HiRDB Datareplicator Version 8 Description, User's Guide and Operator's Guide
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. |
| 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 |
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.
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}]
| Maximum size of unload log segment file (bytes) = pd_log_max_data_size operand value for HiRDB subject to recovery x number of blocks |
| 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. |
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.
setup_tool1 (set_tool1 in Windows Vista and Windows Server 2008) |
| 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). |
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.
setup_tool2 (set_tool2 in Windows Vista and Windows Server 2008) |
| 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). |
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.
unsetup_tool (unset_tool in Windows Vista and Windows Server 2008) |
| 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). |
All rights reserved. Copyright (C) 2007, 2013, Hitachi, Ltd.