- Required actions to be taken before executing the changemirrorendpoints command
- Display job information for the volume
- Pause the Mirror using the following EMCMD command via the command line.
emcmd . pausemirror <volume letter> - Change the IP address on the system(s) (if necessary)
Note: 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)
- Run EMCMD . CONTINUEMIRROR <volume letter> to resume mirroring
- CHANGEMIRRORENDPOINTS COMMAND SYNTAX
-
The CHANGEMIRRORENDPOINTS command is used to change the replication IP addresses within systems that are already part of a DataKeeper job for the given volume.
Parameters:
<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. If changing the IP address of the Source and Target, the syntax is as follows:*
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>
Refer to the examples below:
See WAN Considerations and Initial Synchronization of Data Across the LAN/WAN in the Configuration section.
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.
- 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.
- 1×1 Mirror CHANGEMIRRORENDPOINTS Command Example
- 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 172.17.103.221 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 1×1 mirror (source and target only), one command is required.
- 2×1 Mirror CHANGEMIRRORENDPOINTS Command Example
- 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 172.17.103.221 ChangeMirrorEndPoints E 172.17.103.223 192.168.1.221 192.168.1.223
emcmd 172.17.103.222 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 2×1 mirror that includes a shared source volume and a target volume, two commands are required.
- 1×1×1 Mirror CHANGEMIRRORENDPOINTS Command Example
- 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 172.17.103.221 ChangeMirrorEndPoints J 172.17.103.223 192.168.1.221 192.168.1.223
emcmd 172.17.103.222 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
- For a 1×1×1 mirror that includes 2 Target volumes, 2 commands are required.
Post your comment on this topic.