volume mirror status

Displays the status of the mirroring operation in progress. Use this command to examine the progress of mirroring.

  • License required: Enterprise Edition
  • Permissions required: fc or restore on the volume
The status command displays the statstics of the mirroring operation including the total number of container IDs to resync, the current status of the mirroring, the number of indoes in use for the mirror, the container ID information for the source and destination volumes, and the error code if any, to name a few.

Syntax

CLI
maprcli volume mirror status
    [ -cluster cluster_name ]
    -name name 
    [ -start start. default: 1 ]
    [ -limit limit. default: 2147483647 ]
    [ -verbose <true/false> if true, will displayed detailed container information. default: true ]
REST
Request Type POST
Request URL
http[s]://<host>:<port>/rest/volume/mirror/status?<parameters> 

Parameters

Parameter Description
cluster The cluster on which to run the command.
name The volume for which to determine the mirror status.
start The container to start with.
limit The number of containers for which to display status.
verbose Whether to display a terse output or display full statistics.

Examples

Check the status of the mirroring on mirror volume "testvol":

maprcli volume mirror status -name testvol -json

**** Displays mirroring statistics. ****
***  Here, it is resyncing destination containers ****
   {
        "timestamp":1622443868513,
        "timeofday":"2021-05-31 06:51:08.513 GMT+0000 AM",
        "status":"OK",
        "total":1,
        "data":[
                {
                        "SourceVolumeName":"test",
                        "SourceClusterName":"my.cluster.com",
                        "MirroringStarted":"2021-05-31 06:51:02.532 GMT+0000",
                        "MirrorState":"ResyncDestinationContainers",
                        "TotalResyncInProgressCids":6,
                        "ResyncInProgressCids":[
                                {
                                        "ErrorCode":0,
                                        "Progress":0,
                                        "ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
                                        "DestinationCid":{
                                                "ContainerId":2147,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NumInodesInUse":256,
                                                "Mtime":"May 31, 2021",
                                                "NameContainer":"false",
                                                "CreatorContainerId":2138,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        },
                                        "SourceSnapCid":{
                                                "ContainerId":256000069,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NameContainer":"false",
                                                "RW ContainerId":2138,
                                                "RW VolumeId":217081367,
                                                "CreatorContainerId":2138,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        }
                                },
                                {
                                        "ErrorCode":0,
                                        "Progress":0,
                                        "ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
                                        "DestinationCid":{
                                                "ContainerId":2144,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"32 MB",
                                                "LogicalSizeMB":"32 MB",
                                                "TotalSizeMB":"32 MB",
                                                "NumInodesInUse":33,
                                                "Mtime":"May 31, 2021",
                                                "NameContainer":"false",
                                                "CreatorContainerId":2142,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        },
                                        "SourceSnapCid":{
                                                "ContainerId":256000073,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NameContainer":"false",
                                                "RW ContainerId":2142,
                                                "RW VolumeId":217081367,
                                                "CreatorContainerId":2142,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        }
                                },
                                {
                                        "ErrorCode":0,
                                        "Progress":0,
                                        "ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
                                        "DestinationCid":{
                                                "ContainerId":2137,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NumInodesInUse":34,
                                                "Mtime":"May 31, 2021",
                                                "NameContainer":"true",
                                                "CreatorContainerId":2136,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        },
                                        "SourceSnapCid":{
                                                "ContainerId":256000068,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NameContainer":"true",
                                                "RW ContainerId":2136,
                                                "RW VolumeId":217081367,
                                                "CreatorContainerId":2136,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        }
                                },
                                {
                                        "ErrorCode":0,
                                        "Progress":0,
                                        "ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
                                        "DestinationCid":{
                                                "ContainerId":2145,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NumInodesInUse":256,
                                                "Mtime":"May 31, 2021",
                                                "NameContainer":"false",
                                                "CreatorContainerId":2140,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        },
                                        "SourceSnapCid":{
                                                "ContainerId":256000071,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NameContainer":"false",
                                                "RW ContainerId":2140,
                                                "RW VolumeId":217081367,
                                                "CreatorContainerId":2140,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        }
                                },
                                {
                                        "ErrorCode":0,
                                        "Progress":0,
                                        "ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
                                        "DestinationCid":{
                                                "ContainerId":2143,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"32 MB",
                                                "NumInodesInUse":32,
                                                "Mtime":"May 31, 2021",
                                                "NameContainer":"false",
                                                "CreatorContainerId":2141,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        },
                                        "SourceSnapCid":{
                                                "ContainerId":256000072,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NameContainer":"false",
                                                "RW ContainerId":2141,
                                                "RW VolumeId":217081367,
                                                "CreatorContainerId":2141,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        }
                                },
                                {
                                        "ErrorCode":0,
                                        "Progress":0,
                                        "ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
                                        "DestinationCid":{
                                                "ContainerId":2146,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NumInodesInUse":256,
                                                "Mtime":"May 31, 2021",
                                                "NameContainer":"false",
                                                "CreatorContainerId":2139,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        },
                                        "SourceSnapCid":{
                                                "ContainerId":256000070,
                                                "Epoch":3,
                                                "Master":"10.163.167.214:5660--3-VALID",
                                                "ActiveServers":{
                                                        "IP":"10.163.167.214:5660--3-VALID"
                                                },
                                                "InactiveServers":{

                                                },
                                                "UnusedServers":{

                                                },
                                                "OwnedSizeMB":"0 MB",
                                                "SharedSizeMB":"0 MB",
                                                "LogicalSizeMB":"0 MB",
                                                "TotalSizeMB":"0 MB",
                                                "NameContainer":"false",
                                                "RW ContainerId":2139,
                                                "RW VolumeId":217081367,
                                                "CreatorContainerId":2139,
                                                "CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
                                                "UseActualCreatorId":false
                                        }
                                }
                        ]
                }
        ]
   }


maprcli volume mirror status -name testvol -json

*** Now the resync is done and the source snapshot is deleted. ***
   {
        "timestamp":1622443878136,
        "timeofday":"2021-05-31 06:51:18.136 GMT+0000 AM",
        "status":"OK",
        "total":1,
        "data":[
                {
                        "SourceVolumeName":"test",
                        "SourceClusterName":"my.cluster.com",
                        "MirroringStarted":"2021-05-31 06:51:02.532 GMT+0000",
                        "MirrorState":"DeleteSourceSnapshot"
                }
        ]
}


maprcli volume mirror status -name testvol -json

*** Mirroring is now complete ***
   {
        "timestamp":1622443883402,
        "timeofday":"2021-05-31 06:51:23.402 GMT+0000 AM",
        "status":"ERROR",
        "errors":[
                {
                        "id":0,
                        "desc":"No mirror jobs are in progress for volume testvol"
                }
        ]
   }
https://abc.sj.us:8443/rest/volume/mirror/status?name=testvol