This topic introduces the replication command usage:
- replication --show [options]
- replication --add --name --role --peer [options]
- replication --update --name --role --peer [options]
- replication --delete --name --role [options]
- replication --start --name --role [options]
- replication --stop --name --role [options]
- replication --limit --speed --target [options]
- replication --resync --name --role [options]
- replication --troubleshoot --peer
- replication --help
|
|
NOTE: If you specify a command without supplying the expected value or option, you will be prompted to provide the correct value or option. |
Description
Displays the current status of all existing replication containers (and respective roles) in the QoreStor.
Syntax
replication --show [--air]
[--name <name>]
[--role <source | target>]
[--verbose]
[--limits]
Where
--air Auto Image replication enabled.
--name Name of container.
--role Role of container.
--verbose Display more details.
--limits Replication speed limits.
Result
Container Name Replication Role Status
backup Source, Target Enabled
acme-59 Source Enabled
acmeStorage1 Source Enabled
acmeStorage2 Source Enabled
acmeStorage3 Target Enabled
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 <name>
--role <source | target>
--peer <ip address | hostname>
[--peer_name <name>]
[--peer_group_name <name>]
[--replication_traffic <ip address | hostname>]
[--encryption <none || aes256>]
[--username <user name>]
[--air]
Where
--name Name of container to replicate.
--role Role of container.
--peer Peer appliance IP address/name of replication network interface(s).
--peer_name Name of remote container to/from replicate.
--peer_group_name Name of remote container's group to/from replicate. Only applicable if remote container is not present
--replication_traffic IP address/name of local dedicated replication network interface(s).
--encryption Type of encryption to use on the wire.
--username Username on peer system.
--air Auto Image replication enabled.
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. |
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 <name>
--role <source | target>
[--peer <ip address | hostname>]
[--replication_traffic <ip address | hostname>]
[--encryption <none || aes256>]
[--username <user name>]
Where
--name Name of the replication container to update.
--role Current replication role of container.
--peer Peer appliance IP address/name of replication network interface.
--replication_traffic IP address/name of dedicated replication network interface.
--encryption Type of encryption to use on the wire.
--username Username on peer system.
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>
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
