replication --add --name <name> --role <source | target> --peer <ip address | hostname> [--peer_name <name>] [--peer_group_name <name>] [--replication_traffic <ip address | hostname>] [--encryption <none | aes128 | aes256>][--username <user name>]
Description
Adds a new replication link to a container on the QoreStor, for which you need to define its name, role, peer IP address/hostname , peer name, peer group name, user name on the peer system, and encryption level to apply. The peer group name is the name of the remote container’s group to replicate to/from, and this parameter is applicable only if a remote container is not present.
There are three options for encryption:
- none,
- aes128 (Advanced Encryption Standard) which uses128-bit cryptographic keys
- aes256 (using 256-bit AES cryptographic keys).
If the username is a domain login (for example, domain\username), ensure that '\' characters and spaces are either escaped or in quotes.
|
|
NOTE: Make sure that the data container you intend to replicate already exists. If it does not, the following error message displays: Error: Container <container_name> does not exist. |
Syntax
replication --add --name backup --role source --peer 10.250.240.192 --encryption aes128
Result
Enter password foradministrator@10.250.240.192: Replication entry created successfully. Replication Container : backup Replication Role : Source Replication Target : 10.250.240.192 Replication Target IP : 10.250.240.192 Replication Target Mgmt Name : 10.250.240.192 Replication Target Mgmt IP : 10.250.240.192 Replication Local Data Name : QS2K-01 Replication Local Data IP : 10.250.208.232 Replication Target Container : backup Replication Enabled : Yes Replication Compression Enabled: Yes Replication Encryption : AES 128-bit
|
|
NOTE: To verify that you have successful added a replication link to the QoreStor (or to view the current status of existing containers), see replication --show. |
replication --update --name <name> --role <source | target> [--peer <ip address | hostname>] [--encryption <none | aes128 | aes256>] [--username <user name>]
Description
Updates an existing replication link to a container in a QoreStor and allows you to change the corresponding role, peer IP address or host name, the encryption being used, and user name based on the QoreStor CLI command options you specify.
Syntax
replication --update --name backup --role source --peer 10.25.19.5
Result
|
|
NOTE: If you attempt to update a container that already has replication enabled, this displays the following message: Replication on backup is enabled and cannot be updated, please stop it first. |
When replication is enabled on the container, you must first disable it before you can update it. To disable replication on a container, enter the QoreStor CLI replication --stop command and define the container name and role:
replication --stop --name <name> --role <source | target>
|
|
NOTE: For more information about disabling replication, see replication --stop --name <name> --role <source | target>. |
Disables replication on a container:
replication --stop --name backup --role source Replication configuration updated successfully. Replication Container : backup Replication Role : Source Replication Target System : acme-85 Replication Target System IP : 10.25.192.5 Replication Target Container : acme85-S2 Replication Enabled : No Replication Compression Enabled : Yes Replication Encryption : AES 128-bit
replication --delete --name <name> --role <source | target> [--force]
Description
Deletes an existing replication link to a container in a QoreStor.
|
|
NOTE: It is recommended that the replication be in an INSYNC state for this operation. If replication is not in an INSYNC state, this operation can potentially take a much longer time to execute. |
Syntax
replication --delete --name acme-59-replica --role target
If you attempt to delete a container that already has replication enabled, this displays the following message:
Replication on acme-59-replica is enabled and cannot be deleted, please stop it first.
|
|
NOTE: If the replication state of the link is enabled, you must use the replication --stop command to disable replication before you can delete the replication link. For more information, see replication --stop --name <name> --role <source | target>. |
Deletes the existing replication link to a container.
replication --delete --name acme-59-replica --role source
Result
Successfully deleted replication entry.
|
|
NOTE: The QoreStor CLI --force command is optional, and this command allows you to force the deletion of an existing replication link (such as when communications between the source and target are not working). Before using the --force option, replication must be stopped with the replication --stop command. For more information, see replication --stop --name <name> --role <source | target> |
replication --start --name <name> --role <source | target>
Description
Starts the replication process on an existing replication link to a container in a QoreStor.
Syntax
replication --start --name container2_replica --role target
Result
Replication configuration updated successfully. Replication Container : container2_replica Replication Role : Source Replication Target System : acme-85 Replication Target System IP : 10.20.22.20 Replication Target Container : acme85-S2 Replication Enabled : Yes Replication Compression Enabled : Yes Replication Encryption : AES 128-bit