CHANGEMIRRORENDPOINTS

• Display job information for the volume
• Pause the Mirror using the EMCMD command line via the command line If the mirror is currently in a mirroring or resync state. If the mirror is already in a paused, resync pending or broken state, proceed with the next step.
  emcmd . pausemirror <drive>
• Change the IP address on the system(s) (if necessary)
  

!IMPORTANT: If you haven’t already done so, prior to performing the CHANGEMIRRORENDPOINTS command, update the IP addresses for the Source and Target. This will automatically place the mirror into the Paused state.

Note: Confirm that the required DataKeeper Ports are available via Windows Firewall, AWS Security Groups or other Stateful Packet Inspections devices. Click here to view the required ports for Datakeeper.

• Run EMCMD . CHANGEMIRRORENDPOINTS to change to the new IP address(es).
  IP addresses can be changed in any of the following ways:
  
  

  Changing only the Source IP address
  

  Changing only the Target IP address
  

  Changing the Source and Target IP addresses

*More information on the ways to change IP addresses can be located under the CHANGEMIRRORENDPOINTS COMMAND dropdown below.

• Run EMCMD . CONTINUEMIRROR <drive> to resume mirroring

!If the Source system is rebooted before the mirrors are continued a full resync will occur on the mirrored volumes.

• This command is used to change the replication IP addresses within systems that are already part of a DataKeeper job for the given volume.
  
  emcmd <NEW source IP> CHANGEMIRRORENDPOINTS <volume letter> <ORIGINAL target IP> <NEW source IP> <NEW target IP>
  
  
• If changing the IP address of the Source ONLY, the syntax is as follows:
  
  emcmd <NEW source IP> CHANGEMIRRORENDPOINTS <volume letter> <ORIGINAL target IP> <NEW source IP> <ORIGINAL target IP>
  
  
• If changing the IP address of the Target ONLY, the syntax is as follows:
  
  emcmd <ORIGINAL source IP> CHANGEMIRRORENDPOINTS <volume letter> <ORIGINAL target IP> <ORIGINAL source IP> <NEW target IP>
  

*This command supports changing the endpoints of a mirrored volume that is configured on 3 nodes or fewer. If your configuration consists of more than three nodes, the mirrors must be deleted and recreated.

Refer to the examples below:

See WAN Considerations and Initial Synchronization of Data Across the LAN/WAN in the Configuration section.

<system name> This is the system that has the new source IP address available for the mirror.
<volume letter> The drive letter of the mirror to be changed.
<original target IP> The previous IP address of the target system.
<new source IP> The new IP address of the source system.
<new target IP> The new IP address of the target system.

Notes:

• A job may contain multiple volumes and multiple mirrors. The CHANGEMIRRORENDPOINTS command will modify endpoints on one mirror each time it is used. For a 1×1 mirror (1 source, 1 target), only one command is required. For a 2×1 mirror (2 nodes with a shared volume with one target node) or a 1×1×1 (1 source, two target nodes), two commands are required to change the necessary mirror endpoints.

• If an existing mirror whose endpoints are being changed is currently an active mirror, it must be put into the Paused, Broken or Resync Pending state before the endpoints can be changed.

!Using the Break command will cause a full resync. It is recommended that the mirror be Paused instead.

Before making changes, it will be helpful to display Job Information for the volume. For example, emcmd . getJobInfoForVol D.
While making endpoint changes, the Job icon in the DataKeeper GUI may turn red. However, it will return to green after the ContinueMirror command is performed.
In the following examples, we move mirrors from the 172.17.103 subnet to the 192.168.1 subnet. The basic steps are as follows:

• Display job information for the volume
• Pause the Mirror using the EMCMD command line via the command line If the mirror is currently in a mirroring or resync state. If the mirror is already in a paused, resync pending or broken state, proceed with the next step.
  emcmd . pausemirror <drive>
• Change the IP address on the system(s) (if necessary)
  

!IMPORTANT: If you haven’t already done so, prior to performing the CHANGEMIRRORENDPOINTS command, update the IP addresses for the source and target. This will automatically place the mirror into the Paused state.

• Run EMCMD CHANGEMIRRORENDPOINTS to change to the new IP address
  
  
• Run EMCMD CONTINUEMIRROR to resume mirror If the source system is rebooted before the mirrors are continued a full resync will occur on the mirrored volumes.
  

• For a 1×1 mirror (source and target only), one command is required.
  
  emcmd SYS1.MYDOM.LOCAL getJobInfoForVol D
  
  

  ID = caa97f9f-ac6a-4b56-8f25-20db9e2808a8
  
  

  Name = Mirr Vol D
  
  

  Description = Mirror Volume D
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;D;172.17.103.223;SYS1.MYDOM.LOCAL;E;172.17.103.221;A
  
  emcmd SYS1.MYDOM.LOCAL PauseMirror D
  
  emcmd SYS1.MYDOM.LOCAL ChangeMirrorEndPoints D 172.17.103.223 192.168.1.221 192.168.1.223
  
  emcmd SYS1.MYDOM.LOCAL getJobInfoForVol D
  
  . . .
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;D;192.168.1.223;SYS1.MYDOM.LOCAL;D;192.168.1.221;A
  
  emcmd SYS1.MYDOM.LOCAL ContinueMirror D
  

• For a 2×1 mirror that includes a shared source volume and a target volume, two commands are required.
  
  emcmd SYS1.MYDOM.LOCAL getJobInfoForVol E
  
  

  ID = caa97f93e-ac6a-4b56-8f25-20db9e2808a8
  
  

  Name = Mirr Vol E
  
  

  Description = Mirror Volume E
  
  

  MirrorEndPoints = SYS1.MYDOM.LOCAL;E;0.0.0.0;SYS2.MYDOM.LOCAL;E ;0.0.0.0;D
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;E;172.17.103.223;SYS2.MYDOM.LOCAL;E;172.17.103.222;A
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;E;172.17.103.223;SYS1.MYDOM.LOCAL;E;172.17.103.221;A
  
  emcmd SYS1.MYDOM.LOCAL PauseMirror E
  
  emcmd SYS1.MYDOM.LOCAL ChangeMirrorEndPoints E 172.17.103.223 192.168.1.221 192.168.1.223
  
  emcmd SYS2.MYDOM.LOCAL ChangeMirrorEndPoints E 172.17.103.223 192.168.1.222 192.168.1.223
  
  emcmd SYS1.MYDOM.LOCAL getJobInfoForVol E
  
  . . .
  
  

  MirrorEndPoints = SYS1.MYDOM.LOCAL;E;0.0.0.0;SYS2.MYDOM.LOCAL;E;0.0.0.0;D
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;E;192.168.1.223;SYS2.MYDOM.LOCAL;E;192.168.1.222;A
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;E;192.168.1.223;SYS1.MYDOM.LOCAL;E;192.168.1.221;A
  
  emcmd SYS1.MYDOM.LOCAL ContinueMirror E
  

• For a 1×1×1 mirror that includes 2 Target volumes, 2 commands are required.
  
  emcmd SYS1.MYDOM.LOCAL getJobInfoForVol J
  
  

  ID = caa97f93j-ac6a-4b56-8f25-20db9j2808a8
  
  

  Name = Mirr Vol J
  
  

  Description = Mirror Volume J
  
  

  MirrorEndPoints = SYS1.MYDOM.LOCAL;J;172.17.103.221;SYS3.MYDOM.LOCAL;J;172.17.103.223;A
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;J;172.17.103.223;SYS2.MYDOM.LOCAL;J;172.17.103.222;A
  
  

  MirrorEndPoints = SYS1.MYDOM.LOCAL;J;172.17.103.221;SYS2.MYDOM.LOCAL;J;172.17.103.222;A
  
  In this example the system “SYS3.MYDOM.LOCAL” will be moved to another site.
  
  SYS1 and SYS2 will now use a new subnet (192.168.1.*) to communicate with SYS3.
  
  However, SYS1 and SYS2 will continue using 172.17.103.* to communicate with each other.
  
  

  emcmd SYS1.MYDOM.LOCAL PauseMirror J
  
  

  emcmd SYS1.MYDOM.LOCAL ChangeMirrorEndPoints J 172.17.103.223 192.168.1.221 192.168.1.223
  
  

  emcmd SYS2.MYDOM.LOCAL ChangeMirrorEndPoints J 172.17.103.223 192.168.1.222 192.168.1.223
  
  

  emcmd SYS1.MYDOM.LOCAL getJobInfoForVol J
  
  

  . . .
  
  

  MirrorEndPoints = SYS1.MYDOM.LOCAL;J;192.168.1.221;SYS3.MYDOM.LOCAL;J;192.168.1.223;A
  
  

  MirrorEndPoints = SYS3.MYDOM.LOCAL;J;192.168.1.223;SYS2.MYDOM.LOCAL;J;192.168.1.222;A
  
  

  MirrorEndPoints = SYS1.MYDOM.LOCAL;J;172.17.103.221;SYS2.MYDOM.LOCAL;J;172.17.103.222;A
  
  emcmd SYS1.MYDOM.LOCAL ContinueMirror J