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 --limit --speed <<num><KBps | MBps | GBps> | default> --target <ip address | hostname>

Description

Limits the bandwidth used during replication by defining a bandwidth limit using any of the following settings:

  • Kilobytes/second (KBps)
  • Megabytes/second (MBps)
  • Gigabytes/second (GBps)
  • Unlimited bandwidth (this is the default setting); minimum allowed bandwidth setting is 192 KBps

IMPORTANT: Bandwidth rules for all ports will be deleted. New rules will be applied by QoreStor with this command.

Syntax

replication --limit --speed <<num><KBps|MBps|GBps> | default> --target <ip address | hostname> [--air]

Where

--speed		Replication speed limit (eg. 10MBps).
--target	Replication peer IP address.
--air		Auto Image replication enabled.

Result

Successfully updated replication limit for acme-60 to 10 GBps.
Changing traffic control policies ... done.

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

Description

Resynchronizes the replication process between a source and target container in a replication relationship on a QoreStor.

IMPORTANT: This command should only be used in an emergency situation with the help of Quest Support. Do not mistake this command as an ability to start a replication sync outside of the schedule window.

If your intention is to start a replication outside of the window, you can either delete the schedule, or add a temporary replication window to the current schedule and delete it when the systems are in sync.

Syntax

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

Where

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

Result

Successfully initiated replication resync on container dataStorage3.

replication --troubleshoot --peer <ip address | hostname>

Description

Troubleshoots the replication connections between a source and target container on a QoreStor.

NOTE: This command only reports 9915 and 9916 as succeeding against a replication peer that has Qorestor or DR Series replication configured to another system. If the peer is not currently using any replication ports, 9915 and 9916 will report as connection refused.

Syntax

replication --troubleshoot --peer <ip address | hostname>

Where

--peer   IP address or name of remote machine to troubleshoot.

Result

The following examples shows both successful and unsuccessful replication connection attempts:

Testing connection to port 9904... Connected!
Testing connection to port 9911... Connected!
Testing connection to port 9915... Connected!
Testing connection to port 9916... Connected!
Replication troubleshooting completed successfully - Connection to all ports is OK!
replication --troubleshoot --peer acme-205
Testing connection to port 9904... Connected!
Testing connection to port 9911... Connected!
Testing connection to port 9915...
Unable to connect to socket - Connection refused
Could not connect to acme-205 on port 9915 - (Connection refused)
Testing connection to port 9916...
Unable to connect to socket - Connection refused
Could not connect to acme-205 on port 9916 - (Connection refused)

replication --help

Description

Displays the list of all replication-related options that can be used as a reference when using the QoreStor CLI.

Syntax

replication --help

Result

Usage:
				
	replication --show [-air] [--name <name>]
		[--role <source | target>]
		[--verbose]
		[--limits]
				
	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>]
		[-air]
				
			
	replication --update --name <name>
		--role <source | target>
		[--peer <ip address | hostname>]
		[--replication_traffic <ip address | hostname>]
		[--encryption <none | aes128 | aes256>]
		[--username <user name>]
			
	replication --delete --name <name>
		--role <source | target>
		[--force]
			
	replication --start --name <name>
		--role <source | target>
		
	replication --stop --name <name>
		--role <source | target>
			
	replication --limit --speed <<num><KBps|MBps|GBps> | default>
		--target <ip address | hostname>
		[-air]
				
	replication --resync --name <name>
		--role <source | target>
			
	replication --troubleshoot --peer <ip address | hostname>
			
	replication --help
			
replication <command> <command-arguments>
<command> can be one of:
	--show           Displays command specific information.
	--add            Adds a replication link to a container.
	--update         Updates a replication link to a container.
	--delete         Deletes a replication link from a container.
	--start          Starts replication.
	--stop           Stops replication.
	--limit          Delete existing bandwidth rules for all ports and set new throttling limits.
	--resync         Initiates a replication re-sync.
	--troubleshoot   Troubleshoots replication connection.
			
For command-specific help, please type replication --help <command>
	eg:
	replication --help show
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating