Create a UR pair

Deploy Universal Replicator using REST API with 25G iSCSI

Version
Audience
anonymous
Part Number
MK-24VSP1BQ011-00
ft:lastEdition
2026-07-01
  1. Get the Storage Device ID.
    Request line:
    GET base-URL/v1/objects/storages/instance
    Example:
    curl -k -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session <32-character HEX string>"  -X GET  
    https:// <Service_IP_Address_of_VSP_One_Block_20_series>/v1/objects/storages/instance
    Output:
    {
      "storageDeviceId" : " <storageDeviceId>",
      "model" : "VSP One B26",
      "serialNumber" : <primarySerialNumber>,
      "ip" : " <Service_IP_Address_of_VSP_One_Block_20_series>",
      "dkcMicroVersion" : "A3-04-22/00",
      "communicationModes" : [ {
        "communicationMode" : "lanConnectionMode"
      } ],
      "isSecure" : true,
      "ctlLocation" : "CTL01"
    }
    
  2. 2. Get the Remote Storage Device ID.
    Request line:
    GET base-URL/v1/objects/storages/instance
    Example:
    curl -k -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session <32-character HEX string>"  -X GET  
    https:// <Service_IP_Address_of_VSP_One_Block_20_series>/v1/objects/storages/instance
    Output:
    {
      "storageDeviceId" : " <storageDeviceId>",
      "model" : "VSP One B26",
      "serialNumber" : <remoteSerialNumber>,
      "ip" : " <Service_IP_Address_of_VSP_One_Block_20_series>",
      "dkcMicroVersion" : "A3-04-22/00",
      "communicationModes" : [ {
        "communicationMode" : "lanConnectionMode"
      } ],
      "isSecure" : true,
      "ctlLocation" : "CTL01"
    }
    
  3. Create a new copy group and add a pair to the copy group:
    Request line:
    POST base-URL/v1/objects/remote-mirror-copypairs
    Example:
    curl -v -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization:Session <32-character HEX string>" -H "Remote-Authorization:Session <32-character HEX string>" --data- binary @./hur.json 
    http://<Service_IP_Address_of_VSP_One_Block_20_series>/ConfigurationManager/v1/objects/remote-mirror-copypairs
    hur.json example:
    {
     "copyGroupName": "hur0",
     "copyPairName": "pair1",
     "replicationType": "UR",
     "remoteStorageDeviceId": <remotestorageDeviceId>,
     "pvolLdevId": 1000,
     "svolLdevId": 1000,
     "pvolJournalId": 0,
     "svolJournalId": 0,
     "pathGroupId": 0,
     "localDeviceGroupName": "hur0",
     "remoteDeviceGroupName": "hur0",
     "isNewGroupCreation": true,
     "fenceLevel": "ASYNC",
     "muNumber": 0,
     "consistencyGroupId": 0,
     "doInitialCopy": true,
     "doDeltaResyncSuspend": false,
     "isDataReductionForceCopy": true
    }
    
  4. (Optional) To add more volumes to the replication group, add the pair to an existing copy group:
    Request line:
    POST base-URL/v1/objects/remote-mirror-copypairs
    Example:
    curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session <32-character HEX string>" -H "Remote-Authorization:Session <32-character HEX string>" -X POST --data-binary @./hur3.json 
    http://<Service_IP_Address_of_VSP_One_Block_20_series>//ConfigurationManager/v1/objects/remote-mirror-copypairs
    hur3.json example:
    {
     "copyGroupName": "hur0",
     "copyPairName": "pair2",
     "replicationType": "UR",
     "remoteStorageDeviceId": <remotestorageDeviceId>,
     "pvolLdevId": 1001,
     "svolLdevId": 1001,
     "localDeviceGroupName": "hur0",
     "remoteDeviceGroupName": "hur0",
     "isNewGroupCreation": false,
     "fenceLevel": "ASYNC",
     "consistencyGroupId": 0,
     "doInitialCopy": true,
     "doDeltaResyncSuspend": false,
     "isDataReductionForceCopy": true
    }
    
  5. Verify the pair status of the remote copy group:
    Request line:
    GET base-URL/v1/objects/remote-mirror-copygroups/object-ID

    where Object-ID is remoteStorageDeviceId,copyGroupName,localDeviceGroupName,remoteDeviceGroupName

    Example:
    curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session <32-character HEX string>" -H "Remote-Authorization:Session <32-character HEX string>" -X GET 
    http://<Service_IP_Address_of_VSP_One_Block_20_series>/ConfigurationManager/v1/objects//remote-mirror-copygroups//<remotestorageDeviceId>,hur0,hur0,hur0
    Output example:
    {
      "remoteMirrorCopyGroupId" : " <remotestorageDeviceId>,hur100,hur100,hur100",
      "copyGroupName" : "hur100",
      "copyPairs" : [ {
        "copyGroupName" : "hur100",
        "copyPairName" : "pair1",
        "replicationType" : "UR",
        "remoteMirrorCopyPairId" : " <remotestorageDeviceId> ,hur100,hur100,hur100,pair1",
        "consistencyGroupId" : 0,
        "pvolLdevId" : 1100,
        "pvolJournalId" : 0,
        "svolLdevId" : 1100,
        "svolJournalId" : 0,
        "fenceLevel" : "ASYNC",
        "pvolStatus" : "PAIR",
        "svolStatus" : "PAIR",
        "pvolDifferenceDataManagement" : "S",
        "svolDifferenceDataManagement" : "D",
        "pvolProcessingStatus" : "N",
        "svolProcessingStatus" : "N",
        "pvolStorageDeviceId" : " <storageDeviceId>,
        "svolStorageDeviceId" : " <remotestorageDeviceId> "
      } ],
      "remoteStorageDeviceId" : " <remotestorageDeviceId> ",
      "localDeviceGroupName" : "hur100",
      "remoteDeviceGroupName" : "hur100"
    * Connection #0 to host 172.23.x.x left intact
    }