Chat now with support
Chat with Support

QoreStor 7.3.0 - Command Line Interface Reference Guide

Introduction to the QoreStor Command Line Reference Guide Introducing QoreStor Managing QoreStor
Alerts Commands Authenticate Commands Email_alerts Commands OST RDA SAML sc_manager command Stats Storage Group commands System User
Managing QoreStor Storage Operations
Cloud_tier Connection Container iSCSI NDMP Object_container Object_direct Performance_tier Replication Seed Schedule VTL
Maintaining QoreStor About us

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 <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>

NOTE: For more information about disabling replication, see replication --stop .

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 run.

Syntax

replication --delete --name <name> --role <source | target> [--force]

Where

--name    Name of container.
--role    Role of container.
--force   Delete configuration even if peer container is unreachable. Replication must be stopped first even with force option.

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 .

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

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 <name> --role <source | target>

Where

--name   Name of container.
--role   Role of container.

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

replication --stop --name <name> --role <source | target>

Description

Stops the replication process on an existing replication link to a container in a QoreStor.

Syntax

replication --stop --name <name> --role <source | target>

Where

--name   Name of container.
--role   Role of container.

Result

Replication configuration updated successfully.
Replication Container           : acme59
Replication Role                : Source
Replication Target System       : acme-85
Replication Target System IP    : 10.20.22.20
Replication Target Container    : acme85-S2
Replication Enabled             : No
Replication Compression Enabled : Yes
Replication Encryption          : AES 128-bit
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating