QUERY REPLICATION (Query node replication processes)
Use this command to display information about running and ended node-replication processes.
Issue this command on the server that acts as a source for replicated data.
By default, records about completed node-replication processes are retained for 30 calendar days. A calendar day consists of 24-hours, from midnight to midnight.
To display the retention period, issue the QUERY STATUS command. Check the value in the Replication Record Retention Period field. To change the retention period, issue the SET REPLRETENTION command.
Privilege class
Any administrator can issue this command.
Syntax
>>-Query REPLIcation--node_name---------------------------------> .-*--------------------------. >--+----------------------------+-------------------------------> | (1) | '-----+-+-filespace_name-+-+-' | '-,--------------' | '-+-FSID--+----------' | (2) | '-,-----' .-NAMEType--=--SERVER-------. >--+---------------------------+--------------------------------> '-NAMEType--=--+-SERVER---+-' +-UNIcode--+ | (2) | '-FSID-----' .-CODEType--=--BOTH-----------. >--+-----------------------------+------------------------------> '-CODEType--=--+-BOTH-------+-' +-UNIcode----+ '-NONUNIcode-' .-DISplay--=--1--------------. >--+----------------------------+-------------------------------> '-DISplay--=--number_of_days-' >--+----------------------------------+-------------------------> '-PROCessid--=--process_identifier-' .-STatus--=--ALl---------. .-Format--=--Standard-----. >--+------------------------+--+-------------------------+----->< '-STatus--=--+-ALl-----+-' '-Format--=--+-Standard-+-' +-RUnning-+ '-Detailed-' +-ENded---+ '-FAiled--'
- Do not mix FSIDs (file space identifiers) and file space names in the same command.
- Do not specify FSID if you use wildcard characters for the client node name.
Parameters
- node_name (Required)
Specifies the name of the client node to be queried. You can use wildcard characters when you specify this name, with one exception. If the value of the NAMETYPE parameter is FSID, do not specify wildcard characters for the client node name. The FSID value indicates the file space identifier. File spaces with identical names can have different identifiers in different client nodes.
- filespace_name or FSID
Specifies the name of the file space or the file space identifier (FSID) to be queried. A name or FSID is optional. If you do not specify a name or an FSID, all file spaces are queried.
- filespace_name
- Specifies the name of the file space that has data to be queried.
File space names are case-sensitive. To determine the correct capitalization
for the file space, issue the QUERY FILESPACE command.
Separate multiple names with commas with no intervening spaces. When
you specify a name, you can use wildcard characters.
A server that has clients with Unicode-enabled file spaces might have to convert the file space name. For example, the server might have to convert a name from the server code page to Unicode. For details, see the NAMETYPE parameter. If you do not specify a file space name, or if you specify only a single wildcard character for the name, you can use the CODETYPE parameter to limit the operation to Unicode file spaces or to non-Unicode file spaces.
- FSID
- Specifies the file space identifier for the file space to be queried. The server uses FSIDs to find the file spaces to replicate. To determine the FSID for a file space, issue the QUERY FILESPACE command. Separate multiple FSIDs with commas with no intervening spaces. If you specify an FSID, the value of the NAMETYPE parameter must be FSID.
- NAMEType
Specifies how you want the server to interpret the file space names that you enter. You can use this parameter for IBM Spectrum Protect™ clients that are Unicode-enabled and that have Windows, Macintosh OS X, or NetWare operating systems.
Use this parameter only if you enter a partly qualified or fully qualified file space name. The default value is SERVER. You can specify one of the following values:- SERVER
- The server uses the server code page to interpret file space names.
- UNIcode
- The server converts file space names from the server code page to the UTF-8 code page. The success of the conversion depends on the characters in the name and the server code page. Conversion can fail if the string includes characters that are not available in the server code page. Conversion can also fail if the server cannot access system conversion routines.
- FSID
- The server interprets file space names by using their file space identifiers.
- CODEType
Specifies the type of file spaces to be included in the query. The default value is BOTH, which means that file spaces are included regardless of code page type. Use this parameter only if you enter a single wildcard character for the file space name. You can specify one of the following values:
- UNIcode
- Include file spaces that are in Unicode only.
- NONUNIcode
- Include file spaces that are not in Unicode only.
- BOTH
- Include all file spaces regardless of code page type.
- DISplay
Specifies the number of days of node replication history to display. The default value is 1, which displays information about running node replication processes and about processes that completed during the current calendar day. The maximum value is 9999.
You can specify a number that is the same as or less than the number of days that are specified as the retention period for the replication history records. If you specify a value that is more than the value of the replication retention period or more than the number of days that replication records are collected, the server displays only the number of replication history records that are available. For example, suppose that the replication retention period is 30 days and that the replication process is running for only 10 days. If you specify DISPLAY=20, only 10 days of replication history are displayed.
- PROCessid
- Specifies the node replication history that is associated with
a particular process identified by the process identifier. This parameter
is optional. If you do not specify this parameter, all processes are
displayed for the number of days that are specified by the DISPLAY parameter.
Restarting the server can cause the server to reuse process IDs. Reuse of process IDs can result in duplicate process IDs for separate processes.
- STatus
- Specifies the status of the file spaces to query. This parameter
is optional. The default value is ALL. You can specify one of the
following values:
- ALl
- Specifies all file spaces that are replicating, file spaces that replicated successfully, and file spaces that did not finish replicating or replicated with errors.
- RUnning
- Specifies all file spaces that are replicating to the target replication server.
- ENded
- Specifies all file spaces that replicated successfully and file spaces that did not finish replicating or replicated with errors.
- FAiled
- Specifies all file spaces that did not finish replicating or replicated with errors.
- Format
- Specifies how the information is displayed. This parameter is
optional. The default value is STANDARD. You can specify one of the
following values:
- Standard
- Specifies that partial information is displayed for node replication processes.
- Detailed
- Specifies that all available information for the node replication processes is displayed.
Example: Display information about replication processes for a file space
Display information about replication processes for a file space in client node PAYROLL. The file space identifier is 10.query replication ironman
NodeName Filespace FSID Start Time End Time Status Phase
Name
---------------------------------—---------------–----–----–-------
IRONMAN /space 2 02/08/11 02/08/11 Ended None
21:44:19 21:48:14
query replication ironman format=detailed
Node Name: IRONMAN
Filespace Name: /space
FSID: 2
Start Time: 02/08/11 21:44:19
End Time: 02/08/11 21:48:14
Status: Ended
Process Number: 4
Command: replicate node ironman
Phase: None
Process Running Time: 0 Day(s) 0 Hour(s)
4 Minute(s)
Completion State: Complete
Reason For Incompletion: None
Backup Last Update Date/Time:
Backup Target Server:
Backup Files Needing No Action: 0
Backup Files To Replicate: 0
Backup Files Replicated: 0
Backup Files Not Replicated Due to Errors: 0
Backup Files Not Yet Replicated: 0
Backup Files To Delete: 0
Backup Files Deleted: 0
Backup Files Not Deleted Due To Errors: 0
Backup Files To Update: 0
Backup Files Updated: 0
Backup Files Not Updated Due To Errors: 0
Backup Bytes To Replicate (MB): 0
Backup Bytes Replicated (MB): 0
Backup Bytes Transferred (MB): 0
Backup Bytes Not Replicated Due
To Errors (MB): 0
Backup Bytes Not Yet Replicated (MB): 0
Archive Last Update Date/Time: 02/08/11 21:48:14
Archive Target Server: NIGLINA
Archive Files Needing No Action: 0
Archive Files To Replicate: 39,416
Archive Files Replicated: 39,206
Archive Files Not Replicated Due to Errors: 210
Archive Files Not Yet Replicated: 0
Archive Files To Delete: 0
Archive Files Deleted: 0
Archive Files Not Deleted Due To Errors: 0
Archive Files To Update: 0
Archive Files Updated: 0
Archive Files Not Updated Due To Errors: 0
Archive Bytes To Replicate (MB): 4,335
Archive Bytes Replicated (MB): 4,335
Archive Bytes Transferred (MB): 0
Archive Bytes Not Replicated
Due To Errors (MB): 0
Archive Bytes Not Yet Replicated (MB): 0
Space Managed Last Update Date/Time:
Space Management Target Server:
Space Managed Files Needing No Action: 0
Space Managed Files To Replicate: 0
Space Managed Files Replicated: 0
Space Managed Files Not Replicated
Due to Errors: 0
Space Managed Files Not Yet Replicated: 0
Space Managed Files To Delete: 0
Space Managed Files Deleted: 0
Space Managed Files Not Deleted
Due To Errors: 0
Space Managed Files To Update: 0
Space Managed Files Updated: 0
Space Managed Files Not Updated
Due To Errors: 0
Space Managed Bytes To Replicate (MB): 0
Space Managed Bytes Replicated (MB): 0
Space Managed Bytes Transferred (MB): 0
Space Managed Bytes Not Replicated
Due To Errors (MB): 0
Space Managed Bytes Not Yet Replicated (MB): 0
Total Files Needing No Action: 0
Total Files To Replicate: 39,416
Total Files Replicated: 39,206
Total Files Not Replicated Due To Errors: 210
Total Files Not Yet Replicated: 0
Total Files To Delete: 0
Total Files Deleted: 0
Total Files Not Deleted Due To Errors: 0
Total Files To Update: 0
Total Files Updated: 0
Total Files Not Updated Due To Errors: 0
Total Bytes To Replicate (MB): 4,335
Total Bytes Replicated (MB): 4,335
Total Bytes Transferred (MB):
Total Bytes Not Replicated
Due to Errors (MB):
Total Bytes Not Yet Replicated (MB):
Estimated Percentage Complete: 100
Estimated Time Remaining:
Estimated Time of Completion:
Field descriptions
- Node Name
- The name of the client node whose data is displayed.
- Filespace Name
- The name of the client file space whose data is displayed.
- FSID
- The file space identifier.
- Start Time
- The date and time that the node replication process started.
- End Time
- The date and time that the node replication process ended.
- Status
- The status of the node replication process. The following values
are possible:
- Running
- The process is active and is either searching for eligible data or sending data to the target replication server.
- Ended
- The process ended or failed.
- Failed
- The process failed.
- Process Number
- The identifier for the node replication process.
The same process number can have different start times. If a replication process starts and the server is restarted, the server begins assigning process numbers that begin with the number 1. Replication processes that start after a server restart can obtain process numbers that are already assigned to other replication processes in the replication history. To identify unique replication processes, use the start time.
- Command
- The command that was issued to start the node replication process.
- Phase
- The phase of a running node-replication process. The following
phases are listed in the order in which they occur:
- Identifying
- The node replication process started to identify data to be replicated, but data is not yet being sent to the target replication server.
- Identifying and replicating
- The node replication process is identifying data to be replicated and transferring the data to the target replication server.
- Replicating
- The node replication process identified the data and is transferring files to the target replication server.
- None
- The node replication process is not running.
- Process Running Time
- The running time of the node replication process.
- Completion State
- The state of the node replication process. The following values
are possible:
- Complete
- The node replication process completed.
- Incomplete
- The node replication process ended without running to completion. To determine the reason, check the value in the Reason for Incompletion field.
- Reason for Incompletion
- The reason why the node replication process ended without completing. Possible values include canceled and other. The value other can indicate that the server was halted during replication or that the server failed.
- Backup Last Update Date/Time
- The date and time that statistics for backup were last updated. The specified time is the time that the files in the file space were identified for replication or when each batch of files was sent to the target replication server.
- Archive Last Update Date/Time
- The date and time that statistics for archive were last updated. The specified time is the time that the files in the file space were identified for replication or when each batch of files was sent to the target replication server.
- Space Managed Last Update Date/Time
- The date and time that statistics for space-managed files were last updated. The specified time is the time that the files in the file space were identified for replication or when each batch of files was sent to the target replication server.
- Backup Target Server
- The name of the target replication server for backup files.
- Archive Target Server
- The name of the target replication server for archive files.
- Space Management Target Server
- The name of the target replication server for space-managed files.
- Backup Files Needing No Action
- The number of backup files in the file space that did not need to be replicated, updated, or deleted.
- Archive Files Needing No Action
- The number of archive files in the file space that did not need to be replicated, updated, or deleted.
- Space Managed Files Needing No Action
- The number of space-managed files in the file space that did not need to be replicated, updated, or deleted.
- Backup Files To Replicate
- The number of backup files to replicate to the target replication server.
- Archive Files To Replicate
- The number of archive files to replicate to the target replication server.
- Space Managed Files To Replicate
- The number of space-managed files to replicate to the target replication server.
- Backup Files Replicated
- The number of backup files that are replicated to the target replication server.
- Archive Files Replicated
- The number of archive files that are replicated to the target replication server.
- Space Managed Files Replicated
- The number of space-managed files that are replicated to the target replication server.
- Backup Files Not Replicated Due To Errors
- The number of backup files that were not replicated to the target replication server because of errors.
- Archive Files Not Replicated Due To Errors
- The number of archive files that were not replicated to the target replication server because of errors.
- Space Managed Files Not Replicated Due To Errors
- The number of space-managed files that were not replicated to the target replication server because of errors.
- Backup Files Not Yet Replicated
- The number of backup files that are not yet replicated to the target replication server.
- Archive Files Not Yet Replicated
- The number of archive files that are not yet replicated to the target replication server.
- Space Managed Files Not Yet Replicated
- The number of space-managed files that are not yet replicated to the target replication server.
- Backup Files To Delete
- The number of backup files to be deleted on the target replication server.
- Archive Files To Delete
- The number of archive files to be deleted on the target replication server.
- Space Managed Files To Delete
- The number of space-managed files to be deleted on the target replication server.
- Backup Files Deleted
- The number of backup files that are deleted on the target replication server.
- Archive Files Deleted
- The number of archive files that are deleted on the target replication server.
- Space Managed Files Deleted
- The number of space-managed files that are deleted on the target replication server.
- Backup Files Not Deleted Due To Errors
- The number of backup files that were not deleted from the target replication server because of errors.
- Archive Files Not Deleted Due To Errors
- The number of archive files that were not deleted from the target replication server because of errors.
- Space Managed Files Not Deleted Due To Errors
- The number of space-managed files that were not deleted from the target replication server because of errors.
- Backup Files To Update
- The number of backup files to update on the target replication server. If the metadata of a file is changed, the changed fields are sent to the target replication server.
- Archive Files To Update
- The number of archive files to update on the target replication server. If the metadata of a file is changed, the changed fields are sent to the target replication server.
- Space Managed Files To Update
- The number of space-managed files to update on the target replication server. If the metadata of a file is changed, the changed fields are sent to the target replication server.
- Backup Files Updated
- The number of backup files that are updated on the target replication server.
- Archive Files Updated
- The number of archive files that are updated on the target replication server.
- Space Managed Files Updated
- The number of space-managed files that are updated on the target replication server.
- Backup Files Not Updated Due To Errors
- The number of backup files that were not updated on the target replication server because of errors.
- Archive Files Not Updated Due To Errors
- The number of archive files that were not updated on the target replication server because of errors.
- Space Managed Files Not Updated Due To Errors
- The number of space-managed files that were not updated on the target replication server because of errors.
- Backup Bytes To Replicate (MB)
- The number of backup bytes to replicate to the target replication server.
- Archive Bytes To Replicate (MB)
- The number of archive bytes to replicate to the target replication server.
- Space Managed Bytes To Replicate (MB)
- The number of space-managed bytes to replicate to the target replication server.
- Backup Bytes Replicated (MB)
- The number of backup bytes that are replicated to the target replication server.
If a file was stored in a deduplicated storage pool, the number of bytes in the stored file might be less than the number of bytes in the original file. This field represents the number of physical bytes in the original file.
- Archive Bytes Replicated (MB)
- The number of archive bytes that are replicated to the target replication server.
If a file was stored in a deduplicated storage pool, the number of bytes in the stored file might be less than the number of bytes in the original file. This field represents the number of physical bytes in the original file.
- Space Managed Bytes Replicated (MB)
- The number of space-managed bytes that are replicated to the target replication server.
If a file was stored in a deduplicated storage pool, the number of bytes in the stored file might be less than the number of bytes in the original file. This field represents the number of physical bytes in the original file.
- Backup Bytes Transferred (MB)
- The number of backup bytes that were sent to the target replication server.
The value in this field represents the actual number of file bytes sent to the target replication server. This value is calculated by subtracting the number of bytes not sent because of deduplication from the number of bytes to replicate.
- Archive Bytes Transferred (MB)
- The number of archive bytes that were sent to the target replication server.
The value in this field represents the actual number of file bytes sent to the target replication server. This value is calculated by subtracting the number of bytes not sent because of deduplication from the number of bytes to replicate.
- Space Managed Bytes Transferred (MB)
- The number of space-managed bytes that were sent to the target replication server.
The value in this field represents the actual number of file bytes sent to the target replication server. This value is calculated by subtracting the number of bytes not sent because of deduplication from the number of bytes to replicate.
- Backup Bytes Not Replicated Due to Errors (MB)
- The number of backup bytes that were not replicated to the target replication server because of errors.
- Archive Bytes Not Replicated Due to Errors (MB)
- The number of archive bytes that were not replicated to the target replication server because of errors.
- Space Managed Bytes Not Replicated Due to Errors (MB)
- The number of space-managed bytes that were not replicated to the target replication server because of errors.
- Backup Bytes Not Yet Replicated (MB)
- The number of backup bytes not yet replicated to the target replication server.
- Archive Bytes Not Yet Replicated (MB)
- The number of archive bytes not yet replicated to the target replication server.
- Space Managed Bytes Not Yet Replicated (MB)
- The number of space-managed bytes not yet replicated to the target replication server.
- Total Files Needing No Action
- The total number of files in the file space that did not need to be replicated, updated, or deleted.
- Total Files To Replicate
- The total number of files to replicate to the target replication server.
- Total Files Replicated
- The total number of files that are replicated to the target replication server.
- Total Files Not Replicated Due To Errors
- The total number of files that were not replicated because of errors.
- Total files Not Yet Replicated
- The total number of files that are not yet replicated to the target replication server.
- Total Files To Delete
- The total number of files that were deleted on the target replication server.
- Total Files Deleted
- The total number of files that are deleted on the target replication server.
- Total Files Not Deleted Due to Errors
- The total number of backup, archive, and space-managed files that were not deleted on the target replication server because of errors.
- Total Files To Update
- The total number of files to be updated on the target replication server. When the metadata of a file is changed, the changed fields are sent to the target replication server.
- Total Files Updated
- The total number of files that are updated on the target replication server.
- Total Files Not Updated Due to Errors
- The total number of backup, archive, and space-managed files that were not updated on the target replication server because of errors.
- Total Bytes To Replicate (MB)
- The total number of bytes to replicate to the target replication server.
- Total Bytes Replicated (MB)
- The total number of bytes that are replicated to the target server.
If a file was stored in a deduplicated storage pool, the number of bytes in the stored file might be less than the number of bytes in the original file. This field represents the number of physical bytes in the original file.
- Total Bytes Transferred (MB)
- The total number of bytes that were transferred to the target
replication server.
For files stored in a deduplicated storage pool, the value in this field includes the number of bytes in the original file before duplicate extents were removed. If duplicate extents were already on the target replication server, the number of bytes in the original file is more than the number of bytes transferred.
- Total Bytes Not Replicated Due to Errors (MB)
- The total number of bytes that were skipped because the source replication server was unable to transfer them to the target replication server.
- Total Bytes Not Yet Replicated (MB)
- The total number of bytes not yet transferred to the target replication server.
- Estimated Percentage Complete
- The estimated completion percentage that is based on the number of bytes.
- Estimated Time Remaining
- The estimated time that remains before the node replication process is complete.
- Estimated Time Of Completion
- The estimated time when the node replication process ends.
Command | Description |
---|---|
CANCEL REPLICATION | Cancels node replication processes. |
QUERY ACTLOG | Displays messages from the server activity log. |
QUERY FILESPACE | Displays information about data in file spaces that belong to a client. |
QUERY NODE | Displays partial or complete information about one or more clients. |
QUERY PROCESS | Displays information about background processes. |
QUERY REPLNODE | Displays information about the replication status of a client node. |
QUERY REPLRULE | Displays information about node replication rules. |
REPLICATE NODE | Replicates data in file spaces that belong to a client node. |
SET REPLRETENTION | Specifies the retention period for replication history records. |