Modifying a file replication job

Some configuration parameters including the source mount point, the target mount point, the host, and the job direction can not be changed if a replication job is currently scheduled. All other configuration changes including the source and the target IP address, replication frequency, the target port, the debugging level, and the checksum type can be changed when a replication job is scheduled. Unless otherwise specified, all replication job modification commands must be run on both the source and the target systems to maintain replication job configuration consistency, otherwise the replication job will fail with a job configuration mismatch error.

To update the frequency at which file system data is replicated, type the following command:

# vfradmin setjobfreq name mntpt freq

where name is the name of the replication job you want to modify, mntpt is the mount point of the source or target system, and freq is the updated frequency in which the replication job runs.

To update the source address of the replication job, type the following command:

# vfradmin setjobsrcaddr name mntpt  src_addr

where name is the name of the replication job you want to modify, mntpt is the mount point of the source or target file system, and src_addr is the new source address for the replication job.

To update the target address of the replication job, type the following command:

# vfradmin setjobtgtaddr name mntpt  tgt_addr

where name is the name of the replication job you want to modify, mntpt is the mount point of the source or target file system, and tgt_addr is the new target address for the replication job.

To update the host name where the replication job can come online, type the following command:

# vfradmin setjobhost name mntpt host

where name is the name of the replication job you want to modify, mntpt is the mount point of the source or target system, and host is the updated host name.

The host must be the same host name as returned by the uname -n command. You must update the host name to manually failover the replication job from one cluster system to another. This command is only required on the source system if a new system will become the source for the replication job. Similarly, this command is only required on the target system if a new system will become the target for the replication job.

To update the target port of the replication job, type the following command:

# vfradmin setjobport -p tgt_port name mntpt

where tgt_port is the target port you want to use, name is the name of the replication job you want to modify, and mntpt is the mount point of the source or target system.

If you run this command, the vxfsrepld daemon on the target system must be started with the updated port.

To update the replication job source mount point, type the following command:

# vfradmin setjobsrcmntpt [-n] name mntpt newsrc_mntpt

where name is the name of the replication job you want to modify. On the source system, mntpt is the currently configured mount point and newsrc_mntpt is the new mount point. You must use the -n option if the file system is currently mounted at newsrc_mntpt instead of mntpt. On the target system, mntpt is the target mount point. The replication job must not be running for this command to succeed.

To update the replication job target mount point, type the following command:

# vfradmin setjobtgtmntpt [-n] name mntpt newtgt_mntpt

where name is the name of the replication job you want to modify. On the target system, mntpt is the currently configured mount point and newtgt_mntpt is the new mount point. You must use the -n option if the file system is currently mounted at newtgt_mntpt instead of mntpt. On the source system, mntpt is the source mount point. The replication job must not be running for this command to succeed.

To update the replication job direction on the source or target, type the following command:

# vfradmin setjobmode [-s|-t] name mntpt

where name is the name of the replication job you want to modify and mntpt is the mount point on the source or the target system. You must specify the -s option when updating the replication job mode on the target system. This specifies that the current machine should now behave as the source system for the replication job. You must specify the -t option when updating the replication job mode on the old source system. This specifies that the current machine should behave as the target system for the replication job. This command swaps the source and target mount points and IP addresses in the replication job configuration.

Changing the replication job mode can be used with other commands in disaster recovery scenarios.

Note:

For a given replication job, when a previous source machine becomes the target machine, any statistics and shared extent efficiency information is deleted from the source machine. New source will build the statistics and shared efficiency information form the next replication iteration.

To set the debug level of the replication job, type the following command:

# vfradmin setjobdbg -d [0|1] name mntpt

where name is the name of the replication job you want to modify and mntpt is the mount point on the source or the target system. By default, the debug level is set to 0. Setting the debug level to 1 displays diagnostic information in the job log file. The diagnostic information can provide useful information for debugging any errors.

To disable the check sum check for the shared extent, type the following command:

# vfradmin setjobcksum -c none name mntpt

where name is the name of the replication job you want to modify and mntpt is the mount point on the source or target system. Once disabled, the option cannot be enabled again.