+ CLI Guide Overview: Difference between revisions

From OSNEXUS Online Documentation Site
Jump to navigation Jump to search
Line 129: Line 129:
Note that we list the command names along with a short version in square brackets (ex: help [h]). If you find yourself using the CLI frequently learning the short command names can make the CLI easier to work with as it reduces the amount of typing required. For scripting, it's often better to use the long command names as it makes your script easier to read and maintain.  
Note that we list the command names along with a short version in square brackets (ex: help [h]). If you find yourself using the CLI frequently learning the short command names can make the CLI easier to work with as it reduces the amount of typing required. For scripting, it's often better to use the long command names as it makes your script easier to read and maintain.  


===Alert Management [ALERT]===
==Alert Management [ALERT]==
Alerts are generated by the system and routed to the administrators via the various call-home mechanisms which include email, SNMP, PagerDuty and custom alert handlers.  Alerts include a severity, a descriptive message, and in most cases an identifier referring to the element of the system or grid that is the subject of the alert.
Alerts are generated by the system and routed to the administrators via the various call-home mechanisms which include email, SNMP, PagerDuty and custom alert handlers.  Alerts include a severity, a descriptive message, and in most cases an identifier referring to the element of the system or grid that is the subject of the alert.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 146: Line 146:




; alert-clear-all : Clears all the alerts.
===alert-clear-all===
Clears all the alerts.


<pre> qs alert-clear-all|a-clear-all </pre>
<pre> qs alert-clear-all|a-clear-all </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; alert-config-get : Alert configuration settings indicate where alert notifications should be sent.
===alert-config-get===
Alert configuration settings indicate where alert notifications should be sent.


<pre> qs alert-config-get|ac-get </pre>
<pre> qs alert-config-get|ac-get </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; alert-config-set : Sets the alert configuration settings such as the administrator email address, SMTP server address, etc. Be sure to use the alert-raise command to generate a test alert after you modify the alert configuration settings to ensure that emails are being properly sent.
===alert-config-set===
Sets the alert configuration settings such as the administrator email address, SMTP server address, etc. Be sure to use the alert-raise command to generate a test alert after you modify the alert configuration settings to ensure that emails are being properly sent.


<pre> qs alert-config-set|ac-set [--sender-email=value ] [--smtp-server=value ] [--smtp-port=value ] [--smtp-user=value ] [--smtp-password=value ] [--smtp-auth=value ] [--support-email=value ] [--freespace-warning=value ] [--freespace-alert=value ] [--freespace-critical=value ] [--pagerduty-key=value ] </pre>
<pre> qs alert-config-set|ac-set [--sender-email=value ] [--smtp-server=value ] [--smtp-port=value ] [--smtp-user=value ] [--smtp-password=value ] [--smtp-auth=value ] [--support-email=value ] [--freespace-warning=value ] [--freespace-alert=value ] [--freespace-critical=value ] [--pagerduty-key=value ] </pre>
Line 185: Line 188:




; alert-get : Gets information about a specific alert.
===alert-get===
Gets information about a specific alert.


<pre> qs alert-get|a-get --id=value </pre>
<pre> qs alert-get|a-get --id=value </pre>
Line 194: Line 198:




; alert-list : Returns a list of all the alerts from all systems in the grid. Adjust the settings for the 'admin' or custom user account(s) to indicate alerts to be sent out via email call-home mechanism.
===alert-list===
Returns a list of all the alerts from all systems in the grid. Adjust the settings for the 'admin' or custom user account(s) to indicate alerts to be sent out via email call-home mechanism.


<pre> qs alert-list|a-list [--filtered=value ] </pre>
<pre> qs alert-list|a-list [--filtered=value ] </pre>
Line 203: Line 208:




; alert-raise : Allows one to raise a user generated alert for testing the SMTP server configuration settings.
===alert-raise===
Allows one to raise a user generated alert for testing the SMTP server configuration settings.


<pre> qs alert-raise|a-raise --title=value --message=value [--alert-severity=value ] </pre>
<pre> qs alert-raise|a-raise --title=value --message=value [--alert-severity=value ] </pre>
Line 216: Line 222:




; event-list : Returns a list of all the internal events in the event queue (used for service monitoring).
===event-list===
Returns a list of all the internal events in the event queue (used for service monitoring).


<pre> qs event-list|ev-list [--index=value ] [--max=value ] [--time-stamp=value ] </pre>
<pre> qs event-list|ev-list [--index=value ] [--max=value ] [--time-stamp=value ] </pre>
Line 231: Line 238:
</div>
</div>


===Backup Policy Management [BACKUP-POLICY]===
==Backup Policy Management [BACKUP-POLICY]==
Backup policies provide a mechanism for scheduling and executing automatic backups of 3rd party filers and other NFS/SMB shares in an environment directly to a Network Share.
Backup policies provide a mechanism for scheduling and executing automatic backups of 3rd party filers and other NFS/SMB shares in an environment directly to a Network Share.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 238: Line 245:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; backup-job-list : Returns a list of backup jobs in the system.
===backup-job-list===
Returns a list of backup jobs in the system.


<pre> qs backup-job-list|bj-list </pre>
<pre> qs backup-job-list|bj-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; backup-policy-create : Creates a ingest backup policy which pull data from NFS shares to the QuantaStor appliance.
===backup-policy-create===
Creates a ingest backup policy which pull data from NFS shares to the QuantaStor appliance.


<pre> qs backup-policy-create|bp-create --name=value --desc=value --network-share=value --remote-hostname=value --remote-export-path=value [--remote-export-type=value ] [--retain-rules=value ] [--policy-type=value ] [--scan-threads=value ] [--hours=value ] [--days=value ] [--retain-period=value ] [--purge-policy=value ] [--backup-to-root=value ] [--maintain-logs=value ] [--start-date=value ] [--enabled=value ] </pre>
<pre> qs backup-policy-create|bp-create --name=value --desc=value --network-share=value --remote-hostname=value --remote-export-path=value [--remote-export-type=value ] [--retain-rules=value ] [--policy-type=value ] [--scan-threads=value ] [--hours=value ] [--days=value ] [--retain-period=value ] [--purge-policy=value ] [--backup-to-root=value ] [--maintain-logs=value ] [--start-date=value ] [--enabled=value ] </pre>
Line 284: Line 293:




; backup-policy-delete : Deletes the specified backup policy.
===backup-policy-delete===
Deletes the specified backup policy.


<pre> qs backup-policy-delete|bp-delete --policy=value </pre>
<pre> qs backup-policy-delete|bp-delete --policy=value </pre>
Line 293: Line 303:




; backup-policy-disable : Disables the specified backup policy so job are not automatically run.
===backup-policy-disable===
Disables the specified backup policy so job are not automatically run.


<pre> qs backup-policy-disable|bp-disable --policy=value </pre>
<pre> qs backup-policy-disable|bp-disable --policy=value </pre>
Line 302: Line 313:




; backup-policy-enable : Enables a backup policy that was previously disabled.
===backup-policy-enable===
Enables a backup policy that was previously disabled.


<pre> qs backup-policy-enable|bp-enable --policy=value </pre>
<pre> qs backup-policy-enable|bp-enable --policy=value </pre>
Line 311: Line 323:




; backup-policy-get : Returns detailed information on a specific backup policy.
===backup-policy-get===
Returns detailed information on a specific backup policy.


<pre> qs backup-policy-get|bp-get --policy=value </pre>
<pre> qs backup-policy-get|bp-get --policy=value </pre>
Line 320: Line 333:




; backup-policy-list : Returns a list of backup policies in the system.
===backup-policy-list===
Returns a list of backup policies in the system.


<pre> qs backup-policy-list|bp-list </pre>
<pre> qs backup-policy-list|bp-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; backup-policy-modify : Modifies the specified backup policy settings.
===backup-policy-modify===
Modifies the specified backup policy settings.


<pre> qs backup-policy-modify|bp-modify --policy=value --name=value --desc=value --network-share=value --remote-hostname=value --remote-export-path=value [--remote-export-type=value ] [--retain-rules=value ] [--policy-type=value ] [--scan-threads=value ] [--hours=value ] [--days=value ] [--retain-period=value ] [--purge-policy=value ] [--maintain-logs=value ] [--start-date=value ] [--enabled=value ] </pre>
<pre> qs backup-policy-modify|bp-modify --policy=value --name=value --desc=value --network-share=value --remote-hostname=value --remote-export-path=value [--remote-export-type=value ] [--retain-rules=value ] [--policy-type=value ] [--scan-threads=value ] [--hours=value ] [--days=value ] [--retain-period=value ] [--purge-policy=value ] [--maintain-logs=value ] [--start-date=value ] [--enabled=value ] </pre>
Line 366: Line 381:




; backup-policy-trigger : Triggers the specified backup policy which in turn starts a backup job.
===backup-policy-trigger===
Triggers the specified backup policy which in turn starts a backup job.


<pre> qs backup-policy-trigger|bp-trigger --policy=value </pre>
<pre> qs backup-policy-trigger|bp-trigger --policy=value </pre>
Line 377: Line 393:
</div>
</div>


===Scale-out Object / Ceph Management [CEPH]===
==Scale-out Object / Ceph Management [CEPH]==
Commands for management, monitoring, and configuration of Ceph object clusters and associated storage.
Commands for management, monitoring, and configuration of Ceph object clusters and associated storage.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 384: Line 400:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; ceph-cluster-add-member : Add a new storage system to existing Ceph Cluster.
===ceph-cluster-add-member===
Add a new storage system to existing Ceph Cluster.


<pre> qs ceph-cluster-add-member|cc-amn --ceph-cluster=value --storage-system=value --port=value [--public-network=value ] [--cluster-network=value ] [--enable-object-store=value ] [--flags=value ] </pre>
<pre> qs ceph-cluster-add-member|cc-amn --ceph-cluster=value --storage-system=value --port=value [--public-network=value ] [--cluster-network=value ] [--enable-object-store=value ] [--flags=value ] </pre>
Line 405: Line 422:




; ceph-cluster-create : Create a new Ceph Cluster using the specified QuantaStor nodes(s)
===ceph-cluster-create===
Create a new Ceph Cluster using the specified QuantaStor nodes(s)


<pre> qs ceph-cluster-create|cc-create --name=value --client-interface=value --backend-interface=value [--desc=value ] [--public-network=value ] [--cluster-network=value ] [--osd-default-pool-size=value ] [--auth-cluster-required=value ] [--auth-service-required=value ] [--auth-client-required=value ] [--filestore-xattr-use-omap=value ] [--flags=value ] </pre>
<pre> qs ceph-cluster-create|cc-create --name=value --client-interface=value --backend-interface=value [--desc=value ] [--public-network=value ] [--cluster-network=value ] [--osd-default-pool-size=value ] [--auth-cluster-required=value ] [--auth-service-required=value ] [--auth-client-required=value ] [--filestore-xattr-use-omap=value ] [--flags=value ] </pre>
Line 436: Line 454:




; ceph-cluster-delete : Deletes the specified Ceph Cluster
===ceph-cluster-delete===
Deletes the specified Ceph Cluster


<pre> qs ceph-cluster-delete|cc-delete --ceph-cluster=value [--flags=value ] </pre>
<pre> qs ceph-cluster-delete|cc-delete --ceph-cluster=value [--flags=value ] </pre>
Line 447: Line 466:




; ceph-cluster-fix-clock-skew : Adjusts the clocks on all the member nodes in the specified Ceph Cluster in order to address any clock skew issues.
===ceph-cluster-fix-clock-skew===
Adjusts the clocks on all the member nodes in the specified Ceph Cluster in order to address any clock skew issues.


<pre> qs ceph-cluster-fix-clock-skew|cc-fcs --ceph-cluster=value [--flags=value ] </pre>
<pre> qs ceph-cluster-fix-clock-skew|cc-fcs --ceph-cluster=value [--flags=value ] </pre>
Line 458: Line 478:




; ceph-cluster-get : Gets information about a specific Ceph Cluster
===ceph-cluster-get===
Gets information about a specific Ceph Cluster


<pre> qs ceph-cluster-get|cc-get --ceph-cluster=value </pre>
<pre> qs ceph-cluster-get|cc-get --ceph-cluster=value </pre>
Line 467: Line 488:




; ceph-cluster-list : Returns a list of all the Ceph Clusters
===ceph-cluster-list===
Returns a list of all the Ceph Clusters


<pre> qs ceph-cluster-list|cc-list </pre>
<pre> qs ceph-cluster-list|cc-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-cluster-member-get : Gets information about a specific Ceph Cluster Member
===ceph-cluster-member-get===
Gets information about a specific Ceph Cluster Member


<pre> qs ceph-cluster-member-get|ccm-get --ceph-cluster-member=value </pre>
<pre> qs ceph-cluster-member-get|ccm-get --ceph-cluster-member=value </pre>
Line 481: Line 504:




; ceph-cluster-member-list : Returns a list of all the Ceph Clusters Members
===ceph-cluster-member-list===
Returns a list of all the Ceph Clusters Members


<pre> qs ceph-cluster-member-list|ccm-list </pre>
<pre> qs ceph-cluster-member-list|ccm-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-cluster-modify : Modify a Ceph Cluster using the specified QuantaStor nodes(s)
===ceph-cluster-modify===
Modify a Ceph Cluster using the specified QuantaStor nodes(s)


<pre> qs ceph-cluster-modify|cc-modify --ceph-cluster=value [--desc=value ] [--flags=value ] </pre>
<pre> qs ceph-cluster-modify|cc-modify --ceph-cluster=value [--desc=value ] [--flags=value ] </pre>
Line 499: Line 524:




; ceph-cluster-remove-member : Remove a storage system from an existing Ceph Cluster.
===ceph-cluster-remove-member===
Remove a storage system from an existing Ceph Cluster.


<pre> qs ceph-cluster-remove-member|cc-rmn --ceph-cluster=value --storage-system=value [--flags=value ] </pre>
<pre> qs ceph-cluster-remove-member|cc-rmn --ceph-cluster=value --storage-system=value [--flags=value ] </pre>
Line 512: Line 538:




; ceph-journal-create : Creates a group of Ceph Journal Devices on the specified Physical Disk.
===ceph-journal-create===
Creates a group of Ceph Journal Devices on the specified Physical Disk.


<pre> qs ceph-journal-create|cj-create --disk=value --storage-system=value [--device-count=value ] [--flags=value ] </pre>
<pre> qs ceph-journal-create|cj-create --disk=value --storage-system=value [--device-count=value ] [--flags=value ] </pre>
Line 527: Line 554:




; ceph-journal-delete : Deletes the specified Ceph Journal and all journal partitions on the given physical disk, if a physical disk is specified. Note: This call will fail if there are one or more Journals still being used by OSDs in the system.
===ceph-journal-delete===
Deletes the specified Ceph Journal and all journal partitions on the given physical disk, if a physical disk is specified. Note: This call will fail if there are one or more Journals still being used by OSDs in the system.


<pre> qs ceph-journal-delete|cj-delete --ceph-journal-device=value --storage-system=value [--flags=value ] </pre>
<pre> qs ceph-journal-delete|cj-delete --ceph-journal-device=value --storage-system=value [--flags=value ] </pre>
Line 540: Line 568:




; ceph-journal-get : Returns details of a specific Ceph Journal Device
===ceph-journal-get===
Returns details of a specific Ceph Journal Device


<pre> qs ceph-journal-get|cj-get --ceph-journal-device=value </pre>
<pre> qs ceph-journal-get|cj-get --ceph-journal-device=value </pre>
Line 549: Line 578:




; ceph-journal-list : Returns a list of all the Ceph Journal Devices
===ceph-journal-list===
Returns a list of all the Ceph Journal Devices


<pre> qs ceph-journal-list|cj-list </pre>
<pre> qs ceph-journal-list|cj-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-monitor-add : Configure a new monitor for the Ceph Cluster
===ceph-monitor-add===
Configure a new monitor for the Ceph Cluster


<pre> qs ceph-monitor-add|cmon-add --ceph-cluster=value --ceph-cluster-member=value --ceph-cluster-monitor-ipaddress=value [--ceph-cluster-monitor-port=value ] [--flags=value ] </pre>
<pre> qs ceph-monitor-add|cmon-add --ceph-cluster=value --ceph-cluster-member=value --ceph-cluster-monitor-ipaddress=value [--ceph-cluster-monitor-port=value ] [--flags=value ] </pre>
Line 571: Line 602:




; ceph-monitor-get : Gets information about a specific Ceph Monitor
===ceph-monitor-get===
Gets information about a specific Ceph Monitor


<pre> qs ceph-monitor-get|cmon-get --ceph-monitor=value </pre>
<pre> qs ceph-monitor-get|cmon-get --ceph-monitor=value </pre>
Line 580: Line 612:




; ceph-monitor-list : Returns a list of all the Ceph Monitors
===ceph-monitor-list===
Returns a list of all the Ceph Monitors


<pre> qs ceph-monitor-list|cmon-list </pre>
<pre> qs ceph-monitor-list|cmon-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-monitor-remove : Removes the specified Ceph Monitor
===ceph-monitor-remove===
Removes the specified Ceph Monitor


<pre> qs ceph-monitor-remove|cmon-remove --ceph-cluster=value --ceph-monitor=value [--flags=value ] </pre>
<pre> qs ceph-monitor-remove|cmon-remove --ceph-cluster=value --ceph-monitor=value [--flags=value ] </pre>
Line 598: Line 632:




; ceph-osd-create : Creates a new Ceph OSD on the specified storage pool
===ceph-osd-create===
Creates a new Ceph OSD on the specified storage pool


<pre> qs ceph-osd-create|osd-create --ceph-cluster=value --data-pool=value --journal-device=value [--desc=value ] [--weight=value ] [--flags=value ] </pre>
<pre> qs ceph-osd-create|osd-create --ceph-cluster=value --data-pool=value --journal-device=value [--desc=value ] [--weight=value ] [--flags=value ] </pre>
Line 617: Line 652:




; ceph-osd-delete : Deletes the specified Ceph Osd
===ceph-osd-delete===
Deletes the specified Ceph Osd


<pre> qs ceph-osd-delete|osd-delete --ceph-cluster=value --ceph-osd=value [--delete-data=value ] [--flags=value ] </pre>
<pre> qs ceph-osd-delete|osd-delete --ceph-cluster=value --ceph-osd=value [--delete-data=value ] [--flags=value ] </pre>
Line 632: Line 668:




; ceph-osd-get : Gets information about a specific Ceph Object Storage Daemon.
===ceph-osd-get===
Gets information about a specific Ceph Object Storage Daemon.


<pre> qs ceph-osd-get|osd-get --ceph-osd=value </pre>
<pre> qs ceph-osd-get|osd-get --ceph-osd=value </pre>
Line 641: Line 678:




; ceph-osd-list : Returns a list of all the Ceph Object Storage Daemons
===ceph-osd-list===
Returns a list of all the Ceph Object Storage Daemons


<pre> qs ceph-osd-list|osd-list </pre>
<pre> qs ceph-osd-list|osd-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-osd-modify : Modifies the specified ceph Osd
===ceph-osd-modify===
Modifies the specified ceph Osd


<pre> qs ceph-osd-modify|osd-modify --ceph-cluster=value --ceph-osd=value [--desc=value ] [--flags=value ] </pre>
<pre> qs ceph-osd-modify|osd-modify --ceph-cluster=value --ceph-osd=value [--desc=value ] [--flags=value ] </pre>
Line 661: Line 700:




; ceph-osd-multi-create : Creates multiple new ceph Osd on the specified ceph cluster
===ceph-osd-multi-create===
Creates multiple new ceph Osd on the specified ceph cluster


<pre> qs ceph-osd-multi-create|osd-multi-create --ceph-cluster=value --physical-disk-list=value [--journal-ssd-list=value ] [--use-unused-journal-partitions=value ] [--flags=value ] </pre>
<pre> qs ceph-osd-multi-create|osd-multi-create --ceph-cluster=value --physical-disk-list=value [--journal-ssd-list=value ] [--use-unused-journal-partitions=value ] [--flags=value ] </pre>
Line 678: Line 718:




; ceph-pool-create : Creates a new Ceph pool using the specified OSDs or Storage Pools
===ceph-pool-create===
Creates a new Ceph pool using the specified OSDs or Storage Pools


<pre> qs ceph-pool-create|cpool-create --name=value --ceph-cluster=value [--osd-list=value ] [--desc=value ] [--placement-groups=value ] [--max-replicas=value ] [--min-replicas=value ] [--pool-type=value ] [--crush-ruleset-name=value ] [--flags=value ] </pre>
<pre> qs ceph-pool-create|cpool-create --name=value --ceph-cluster=value [--osd-list=value ] [--desc=value ] [--placement-groups=value ] [--max-replicas=value ] [--min-replicas=value ] [--pool-type=value ] [--crush-ruleset-name=value ] [--flags=value ] </pre>
Line 705: Line 746:




; ceph-pool-delete : Deletes the specified Ceph pool
===ceph-pool-delete===
Deletes the specified Ceph pool


<pre> qs ceph-pool-delete|cpool-delete --ceph-cluster=value --ceph-pool=value [--flags=value ] </pre>
<pre> qs ceph-pool-delete|cpool-delete --ceph-cluster=value --ceph-pool=value [--flags=value ] </pre>
Line 718: Line 760:




; ceph-pool-get : Gets information about a specific Ceph storage pool.
===ceph-pool-get===
Gets information about a specific Ceph storage pool.


<pre> qs ceph-pool-get|cpool-get --ceph-pool=value </pre>
<pre> qs ceph-pool-get|cpool-get --ceph-pool=value </pre>
Line 727: Line 770:




; ceph-pool-list : Returns a list of all the Ceph storage pools.
===ceph-pool-list===
Returns a list of all the Ceph storage pools.


<pre> qs ceph-pool-list|cpool-list </pre>
<pre> qs ceph-pool-list|cpool-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-pool-modify : Sets the display name and/or description field for the Ceph pool.
===ceph-pool-modify===
Sets the display name and/or description field for the Ceph pool.


<pre> qs ceph-pool-modify|cpool-modify --ceph-cluster=value --ceph-pool=value [--name=value ] [--desc=value ] [--max-replicas=value ] [--flags=value ] </pre>
<pre> qs ceph-pool-modify|cpool-modify --ceph-cluster=value --ceph-pool=value [--name=value ] [--desc=value ] [--max-replicas=value ] [--flags=value ] </pre>
Line 751: Line 796:




; ceph-rbd-create : Creates a new Ceph block device (RBD) in the specified Ceph pool.
===ceph-rbd-create===
Creates a new Ceph block device (RBD) in the specified Ceph pool.


<pre> qs ceph-rbd-create|rbd-create --name=value --ceph-cluster=value --ceph-pool=value --size=value [--desc=value ] [--flags=value ] </pre>
<pre> qs ceph-rbd-create|rbd-create --name=value --ceph-cluster=value --ceph-pool=value --size=value [--desc=value ] [--flags=value ] </pre>
Line 770: Line 816:




; ceph-rbd-delete : Deletes the specified Ceph block device (RBD)
===ceph-rbd-delete===
Deletes the specified Ceph block device (RBD)


<pre> qs ceph-rbd-delete|rbd-delete --ceph-cluster=value --ceph-rbd=value [--flags=value ] </pre>
<pre> qs ceph-rbd-delete|rbd-delete --ceph-cluster=value --ceph-rbd=value [--flags=value ] </pre>
Line 783: Line 830:




; ceph-rbd-get : Gets information about a specific Ceph RDB / block device
===ceph-rbd-get===
Gets information about a specific Ceph RDB / block device


<pre> qs ceph-rbd-get|rbd-get --ceph-rbd=value </pre>
<pre> qs ceph-rbd-get|rbd-get --ceph-rbd=value </pre>
Line 792: Line 840:




; ceph-rbd-list : Returns a list of all the Ceph RDB / block devices.
===ceph-rbd-list===
Returns a list of all the Ceph RDB / block devices.


<pre> qs ceph-rbd-list|rbd-list </pre>
<pre> qs ceph-rbd-list|rbd-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ceph-rbd-modify : Sets the display name and/or description field for the Ceph block device (RBD).
===ceph-rbd-modify===
Sets the display name and/or description field for the Ceph block device (RBD).


<pre> qs ceph-rbd-modify|rbd-modify --ceph-cluster=value --ceph-rbd=value --name=value [--desc=value ] [--flags=value ] </pre>
<pre> qs ceph-rbd-modify|rbd-modify --ceph-cluster=value --ceph-rbd=value --name=value [--desc=value ] [--flags=value ] </pre>
Line 814: Line 864:




; ceph-rbd-resize : Resizes the specified Ceph block device (RBD) to a larger size.
===ceph-rbd-resize===
Resizes the specified Ceph block device (RBD) to a larger size.


<pre> qs ceph-rbd-resize|rbd-resize --ceph-cluster=value --ceph-rbd=value --size=value [--flags=value ] </pre>
<pre> qs ceph-rbd-resize|rbd-resize --ceph-cluster=value --ceph-rbd=value --size=value [--flags=value ] </pre>
Line 829: Line 880:




; ceph-rbd-snapshot : Creates an instant snapshot of the specified Ceph block device (RBD)
===ceph-rbd-snapshot===
Creates an instant snapshot of the specified Ceph block device (RBD)


<pre> qs ceph-rbd-snapshot|rbd-snap --ceph-cluster=value --ceph-rbd=value --name=value [--desc=value ] [--flags=value ] </pre>
<pre> qs ceph-rbd-snapshot|rbd-snap --ceph-cluster=value --ceph-rbd=value --name=value [--desc=value ] [--flags=value ] </pre>
Line 848: Line 900:
</div>
</div>


===Cloud Backup Schedule Management [CLOUD-BACKUP]===
==Cloud Backup Schedule Management [CLOUD-BACKUP]==
Cloud Backup schedules provide a mechanism for automatic backups of storage volumes into remote S3/SWIFT object storage.
Cloud Backup schedules provide a mechanism for automatic backups of storage volumes into remote S3/SWIFT object storage.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 855: Line 907:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; cloud-backup-schedule-create : Creates a new schedule to automate backups to a cloud backup container.
===cloud-backup-schedule-create===
Creates a new schedule to automate backups to a cloud backup container.


<pre> qs cloud-backup-schedule-create|cbs-create --name=value --container=value [--volume-list=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--max-backups=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
<pre> qs cloud-backup-schedule-create|cbs-create --name=value --container=value [--volume-list=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--max-backups=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
Line 882: Line 935:




; cloud-backup-schedule-delete : Deletes the specified cloud backup schedule.
===cloud-backup-schedule-delete===
Deletes the specified cloud backup schedule.


<pre> qs cloud-backup-schedule-delete|cbs-delete --backup-sched=value [--flags=value ] </pre>
<pre> qs cloud-backup-schedule-delete|cbs-delete --backup-sched=value [--flags=value ] </pre>
Line 893: Line 947:




; cloud-backup-schedule-disable : Disables a cloud backup schedule so that it does not trigger backups.
===cloud-backup-schedule-disable===
Disables a cloud backup schedule so that it does not trigger backups.


<pre> qs cloud-backup-schedule-disable|cbs-disable --backup-sched=value [--flags=value ] </pre>
<pre> qs cloud-backup-schedule-disable|cbs-disable --backup-sched=value [--flags=value ] </pre>
Line 904: Line 959:




; cloud-backup-schedule-enable : Enables a cloud backup schedule that was previously disabled.
===cloud-backup-schedule-enable===
Enables a cloud backup schedule that was previously disabled.


<pre> qs cloud-backup-schedule-enable|cbs-enable --backup-sched=value [--flags=value ] </pre>
<pre> qs cloud-backup-schedule-enable|cbs-enable --backup-sched=value [--flags=value ] </pre>
Line 915: Line 971:




; cloud-backup-schedule-get : Gets detailed information about a specific cloud backup schedule.
===cloud-backup-schedule-get===
Gets detailed information about a specific cloud backup schedule.


<pre> qs cloud-backup-schedule-get|cbs-get --backup-sched=value </pre>
<pre> qs cloud-backup-schedule-get|cbs-get --backup-sched=value </pre>
Line 924: Line 981:




; cloud-backup-schedule-list : Lists all the cloud backup schedules in the system.
===cloud-backup-schedule-list===
Lists all the cloud backup schedules in the system.


<pre> qs cloud-backup-schedule-list|cbs-list </pre>
<pre> qs cloud-backup-schedule-list|cbs-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; cloud-backup-schedule-modify : Modifies the settings for the specified cloud backup schedule.
===cloud-backup-schedule-modify===
Modifies the settings for the specified cloud backup schedule.


<pre> qs cloud-backup-schedule-modify|cbs-modify --backup-sched=value [--name=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--container=value ] [--max-backups=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
<pre> qs cloud-backup-schedule-modify|cbs-modify --backup-sched=value [--name=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--container=value ] [--max-backups=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
Line 956: Line 1,015:




; cloud-backup-schedule-trigger : Immediately triggers the specified cloud backup schedule to start a backup.
===cloud-backup-schedule-trigger===
Immediately triggers the specified cloud backup schedule to start a backup.


<pre> qs cloud-backup-schedule-trigger|cbs-trigger --backup-sched=value [--flags=value ] </pre>
<pre> qs cloud-backup-schedule-trigger|cbs-trigger --backup-sched=value [--flags=value ] </pre>
Line 967: Line 1,027:




; cloud-backup-schedule-volume-add : Adds storage volumes to an existing cloud backup schedule.
===cloud-backup-schedule-volume-add===
Adds storage volumes to an existing cloud backup schedule.


<pre> qs cloud-backup-schedule-volume-add|cbs-v-add --backup-sched=value [--volume-list=value ] </pre>
<pre> qs cloud-backup-schedule-volume-add|cbs-v-add --backup-sched=value [--volume-list=value ] </pre>
Line 978: Line 1,039:




; cloud-backup-schedule-volume-remove : Removes storage volumes from an existing cloud backup schedule.
===cloud-backup-schedule-volume-remove===
Removes storage volumes from an existing cloud backup schedule.


<pre> qs cloud-backup-schedule-volume-remove|cbs-v-remove --backup-sched=value [--volume-list=value ] </pre>
<pre> qs cloud-backup-schedule-volume-remove|cbs-v-remove --backup-sched=value [--volume-list=value ] </pre>
Line 991: Line 1,053:
</div>
</div>


===Cloud Container Management [CLOUD-CONTAINER]===
==Cloud Container Management [CLOUD-CONTAINER]==
Cloud containers provide a NAS gateway mechanism to bridging S3/SWIFT cloud storage to a local Network Share within an appliance.
Cloud containers provide a NAS gateway mechanism to bridging S3/SWIFT cloud storage to a local Network Share within an appliance.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 998: Line 1,060:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; cloud-backup-container-add : Recovers a cloud backup container that was previously removed or used with a prior installation.
===cloud-backup-container-add===
Recovers a cloud backup container that was previously removed or used with a prior installation.


<pre> qs cloud-backup-container-add|cbc-add --provider-creds=value --encryption-key=value --storage-url=value --enable-nfs=value </pre>
<pre> qs cloud-backup-container-add|cbc-add --provider-creds=value --encryption-key=value --storage-url=value --enable-nfs=value </pre>
Line 1,013: Line 1,076:




; cloud-backup-container-create : Creates a cloud backup container into which cloud backups of storage volumes can be made.
===cloud-backup-container-create===
Creates a cloud backup container into which cloud backups of storage volumes can be made.


<pre> qs cloud-backup-container-create|cbc-create --name=value --provider-creds=value --location=value --encryption-key=value --enable-nfs=value [--desc=value ] </pre>
<pre> qs cloud-backup-container-create|cbc-create --name=value --provider-creds=value --location=value --encryption-key=value --enable-nfs=value [--desc=value ] </pre>
Line 1,032: Line 1,096:




; cloud-backup-container-delete : Deletes the specified cloud backup container. WARNING, all data in the container will be destroyed.
===cloud-backup-container-delete===
Deletes the specified cloud backup container. WARNING, all data in the container will be destroyed.


<pre> qs cloud-backup-container-delete|cbc-delete --container=value </pre>
<pre> qs cloud-backup-container-delete|cbc-delete --container=value </pre>
Line 1,041: Line 1,106:




; cloud-backup-container-disable : Disables access to the specified cloud container without having to remove it.
===cloud-backup-container-disable===
Disables access to the specified cloud container without having to remove it.


<pre> qs cloud-backup-container-disable|cbc-disable --container=value </pre>
<pre> qs cloud-backup-container-disable|cbc-disable --container=value </pre>
Line 1,050: Line 1,116:




; cloud-backup-container-enable : Enables a cloud container that was previously disabled or was inaccessible due to network connection issues.
===cloud-backup-container-enable===
Enables a cloud container that was previously disabled or was inaccessible due to network connection issues.


<pre> qs cloud-backup-container-enable|cbc-enable --container=value </pre>
<pre> qs cloud-backup-container-enable|cbc-enable --container=value </pre>
Line 1,059: Line 1,126:




; cloud-backup-container-get : Returns detailed information on a specific cloud backup container.
===cloud-backup-container-get===
Returns detailed information on a specific cloud backup container.


<pre> qs cloud-backup-container-get|cbc-get --container=value </pre>
<pre> qs cloud-backup-container-get|cbc-get --container=value </pre>
Line 1,068: Line 1,136:




; cloud-backup-container-list : Returns a list of cloud backup containers in the system.
===cloud-backup-container-list===
Returns a list of cloud backup containers in the system.


<pre> qs cloud-backup-container-list|cbc-list </pre>
<pre> qs cloud-backup-container-list|cbc-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; cloud-backup-container-modify : Modifies the specified cloud backup container settings.
===cloud-backup-container-modify===
Modifies the specified cloud backup container settings.


<pre> qs cloud-backup-container-modify|cbc-modify --name=value --desc=value --container=value --encryption-key=value --enable-nfs=value </pre>
<pre> qs cloud-backup-container-modify|cbc-modify --name=value --desc=value --container=value --encryption-key=value --enable-nfs=value </pre>
Line 1,090: Line 1,160:




; cloud-backup-container-remove : Removes the specified cloud backup container from the system but does not delete any backup data in the cloud.
===cloud-backup-container-remove===
Removes the specified cloud backup container from the system but does not delete any backup data in the cloud.


<pre> qs cloud-backup-container-remove|cbc-remove --container=value </pre>
<pre> qs cloud-backup-container-remove|cbc-remove --container=value </pre>
Line 1,099: Line 1,170:




; cloud-backup-container-repair : Repairs the specified cloud backup container.
===cloud-backup-container-repair===
Repairs the specified cloud backup container.


<pre> qs cloud-backup-container-repair|cbc-repair --container=value </pre>
<pre> qs cloud-backup-container-repair|cbc-repair --container=value </pre>
Line 1,108: Line 1,180:




; cloud-backup-credentials-add : Adds cloud provider credentials to enable cloud backup to cloud backup containers.
===cloud-backup-credentials-add===
Adds cloud provider credentials to enable cloud backup to cloud backup containers.


<pre> qs cloud-backup-credentials-add|cbcred-add --provider=value --access-key=value --secret-key=value [--project-id=value ] </pre>
<pre> qs cloud-backup-credentials-add|cbcred-add --provider=value --access-key=value --secret-key=value [--project-id=value ] </pre>
Line 1,123: Line 1,196:




; cloud-backup-credentials-get : Returns information about the specified cloud provider credential.
===cloud-backup-credentials-get===
Returns information about the specified cloud provider credential.


<pre> qs cloud-backup-credentials-get|cbcred-get --provider-creds=value </pre>
<pre> qs cloud-backup-credentials-get|cbcred-get --provider-creds=value </pre>
Line 1,132: Line 1,206:




; cloud-backup-credentials-list : Returns a list of all the cloud provider credentials in the system. Passwords are masked.
===cloud-backup-credentials-list===
Returns a list of all the cloud provider credentials in the system. Passwords are masked.


<pre> qs cloud-backup-credentials-list|cbcred-list </pre>
<pre> qs cloud-backup-credentials-list|cbcred-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; cloud-backup-credentials-remove : Removes the specified cloud provider credentials
===cloud-backup-credentials-remove===
Removes the specified cloud provider credentials


<pre> qs cloud-backup-credentials-remove|cbcred-remove --provider-creds=value </pre>
<pre> qs cloud-backup-credentials-remove|cbcred-remove --provider-creds=value </pre>
Line 1,146: Line 1,222:




; cloud-backup-provider-get : Returns detailed information about the specified cloud provider.
===cloud-backup-provider-get===
Returns detailed information about the specified cloud provider.


<pre> qs cloud-backup-provider-get|cbp-get --provider=value </pre>
<pre> qs cloud-backup-provider-get|cbp-get --provider=value </pre>
Line 1,155: Line 1,232:




; cloud-backup-provider-list : Returns the list of supported cloud providers.
===cloud-backup-provider-list===
Returns the list of supported cloud providers.


<pre> qs cloud-backup-provider-list|cbp-list </pre>
<pre> qs cloud-backup-provider-list|cbp-list </pre>
Line 1,162: Line 1,240:
</div>
</div>


===Physical Disk Management [DISK]===
==Physical Disk Management [DISK]==
Physical disks are storage devices (SATA, SAS, nVME, SSD, HW RAID LVs, etc) that appear to the underlying QuantaStor operating system which can then be used to form storage pools.
Physical disks are storage devices (SATA, SAS, nVME, SSD, HW RAID LVs, etc) that appear to the underlying QuantaStor operating system which can then be used to form storage pools.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,169: Line 1,247:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; disk-get : Gets information about a specific physical disk.
===disk-get===
Gets information about a specific physical disk.


<pre> qs disk-get|pd-get --disk=value </pre>
<pre> qs disk-get|pd-get --disk=value </pre>
Line 1,178: Line 1,257:




; disk-global-spare-add : Adds one or more dedicated hotspares to the global hotspare pool.
===disk-global-spare-add===
Adds one or more dedicated hotspares to the global hotspare pool.


<pre> qs disk-global-spare-add|hsm-add --disk-list=value [--flags=value ] </pre>
<pre> qs disk-global-spare-add|hsm-add --disk-list=value [--flags=value ] </pre>
Line 1,189: Line 1,269:




; disk-global-spare-marker-cleanup : Cleans up invalid marker records for the dedicated hotspare physical disks in the global hotspare pool.
===disk-global-spare-marker-cleanup===
Cleans up invalid marker records for the dedicated hotspare physical disks in the global hotspare pool.


<pre> qs disk-global-spare-marker-cleanup|hsm-cleanup [--flags=value ] </pre>
<pre> qs disk-global-spare-marker-cleanup|hsm-cleanup [--flags=value ] </pre>
Line 1,198: Line 1,279:




; disk-global-spare-marker-delete : Deletes the specified global hotspare marker object.
===disk-global-spare-marker-delete===
Deletes the specified global hotspare marker object.


<pre> qs disk-global-spare-marker-delete|hsm-del --name=value [--flags=value ] </pre>
<pre> qs disk-global-spare-marker-delete|hsm-del --name=value [--flags=value ] </pre>
Line 1,209: Line 1,291:




; disk-global-spare-marker-get : Returns information about the specified global hotspare marker object.
===disk-global-spare-marker-get===
Returns information about the specified global hotspare marker object.


<pre> qs disk-global-spare-marker-get|hsm-get --name=value [--flags=value ] </pre>
<pre> qs disk-global-spare-marker-get|hsm-get --name=value [--flags=value ] </pre>
Line 1,220: Line 1,303:




; disk-global-spare-marker-list : Enumerates marker records for the dedicated hotspare physical disks in the global hotspare pool.
===disk-global-spare-marker-list===
Enumerates marker records for the dedicated hotspare physical disks in the global hotspare pool.


<pre> qs disk-global-spare-marker-list|hsm-list [--flags=value ] </pre>
<pre> qs disk-global-spare-marker-list|hsm-list [--flags=value ] </pre>
Line 1,229: Line 1,313:




; disk-global-spare-remove : Removes one or more dedicated hotspares from the global hotspare pool.
===disk-global-spare-remove===
Removes one or more dedicated hotspares from the global hotspare pool.


<pre> qs disk-global-spare-remove|hsm-remove --disk-list=value [--flags=value ] </pre>
<pre> qs disk-global-spare-remove|hsm-remove --disk-list=value [--flags=value ] </pre>
Line 1,240: Line 1,325:




; disk-identify : Pulses the disk activity light so that the specified disk can be identified in the chassis.
===disk-identify===
Pulses the disk activity light so that the specified disk can be identified in the chassis.


<pre> qs disk-identify|pd-id --disk=value [--pattern=value ] [--duration=value ] </pre>
<pre> qs disk-identify|pd-id --disk=value [--pattern=value ] [--duration=value ] </pre>
Line 1,253: Line 1,339:




; disk-list : Enumerates all physical disks.
===disk-list===
Enumerates all physical disks.


<pre> qs disk-list|pd-list </pre>
<pre> qs disk-list|pd-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; disk-scan : Scans for any new physical disks that may have been hot-plugged into the storage system.
===disk-scan===
Scans for any new physical disks that may have been hot-plugged into the storage system.


<pre> qs disk-scan|pd-scan [--storage-system=value ] </pre>
<pre> qs disk-scan|pd-scan [--storage-system=value ] </pre>
Line 1,267: Line 1,355:




; disk-spare-list : Enumerates dedicated hotspare physical disks in the global hotspare pool.
===disk-spare-list===
Enumerates dedicated hotspare physical disks in the global hotspare pool.


<pre> qs disk-spare-list|pd-spare-list [--flags=value ] </pre>
<pre> qs disk-spare-list|pd-spare-list [--flags=value ] </pre>
Line 1,276: Line 1,365:




; path-list : Enumerates all physical disk paths for multi-path devices.
===path-list===
Enumerates all physical disk paths for multi-path devices.


<pre> qs path-list|pdp-list </pre>
<pre> qs path-list|pdp-list </pre>
Line 1,283: Line 1,373:
</div>
</div>


===Scale-out NAS / Gluster Management [GLUSTER]===
==Scale-out NAS / Gluster Management [GLUSTER]==
Commands for the management and creation of scale-out Network Shares which uses integrated GlusterFS technology.
Commands for the management and creation of scale-out Network Shares which uses integrated GlusterFS technology.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,290: Line 1,380:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; gluster-brick-get : Gets information about a specific Gluster brick.
===gluster-brick-get===
Gets information about a specific Gluster brick.


<pre> qs gluster-brick-get|gb-get --gluster-brick=value </pre>
<pre> qs gluster-brick-get|gb-get --gluster-brick=value </pre>
Line 1,299: Line 1,390:




; gluster-brick-list : Returns a list of all the Gluster bricks
===gluster-brick-list===
Returns a list of all the Gluster bricks


<pre> qs gluster-brick-list|gb-list </pre>
<pre> qs gluster-brick-list|gb-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; gluster-ha-intf-get : Returns a list of all the Gluster HA failover interface definitions.
===gluster-ha-intf-get===
Returns a list of all the Gluster HA failover interface definitions.


<pre> qs gluster-ha-intf-get|gi-get --ha-interface=value </pre>
<pre> qs gluster-ha-intf-get|gi-get --ha-interface=value </pre>
Line 1,313: Line 1,406:




; gluster-ha-intf-list : Gets information about a specific Gluster HA failover interface definition.
===gluster-ha-intf-list===
Gets information about a specific Gluster HA failover interface definition.


<pre> qs gluster-ha-intf-list|gi-list </pre>
<pre> qs gluster-ha-intf-list|gi-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; gluster-peer-get : Gets information about a specific Gluster peer system
===gluster-peer-get===
Gets information about a specific Gluster peer system


<pre> qs gluster-peer-get|gp-get --gluster-peer=value </pre>
<pre> qs gluster-peer-get|gp-get --gluster-peer=value </pre>
Line 1,327: Line 1,422:




; gluster-peer-list : Returns a list of all the Gluster peer systems.
===gluster-peer-list===
Returns a list of all the Gluster peer systems.


<pre> qs gluster-peer-list|gp-list </pre>
<pre> qs gluster-peer-list|gp-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; gluster-volume-add-bricks : Adds one or more bricks on the specified volume.
===gluster-volume-add-bricks===
Adds one or more bricks on the specified volume.


<pre> qs gluster-volume-add-bricks|gv-add-bricks --gluster-volume=value --pool-list=value --restripe-volume=value [--flags=value ] </pre>
<pre> qs gluster-volume-add-bricks|gv-add-bricks --gluster-volume=value --pool-list=value --restripe-volume=value [--flags=value ] </pre>
Line 1,347: Line 1,444:




; gluster-volume-create : Create a new Gluster volume with new Bricks on the specified Storage Pools.
===gluster-volume-create===
Create a new Gluster volume with new Bricks on the specified Storage Pools.


<pre> qs gluster-volume-create|gv-create --name=value --pool-list=value --replica-count=value --disperse-count=value --stripe-volume=value [--desc=value ] [--flags=value ] </pre>
<pre> qs gluster-volume-create|gv-create --name=value --pool-list=value --replica-count=value --disperse-count=value --stripe-volume=value [--desc=value ] [--flags=value ] </pre>
Line 1,368: Line 1,466:




; gluster-volume-delete : Deletes the specified Gluster volume.
===gluster-volume-delete===
Deletes the specified Gluster volume.


<pre> qs gluster-volume-delete|gv-delete --gluster-volume=value </pre>
<pre> qs gluster-volume-delete|gv-delete --gluster-volume=value </pre>
Line 1,377: Line 1,476:




; gluster-volume-get : Gets information about the specified Gluster volume
===gluster-volume-get===
Gets information about the specified Gluster volume


<pre> qs gluster-volume-get|gv-get --gluster-volume=value </pre>
<pre> qs gluster-volume-get|gv-get --gluster-volume=value </pre>
Line 1,386: Line 1,486:




; gluster-volume-list : Returns a list of all the Gluster volumes in the grid
===gluster-volume-list===
Returns a list of all the Gluster volumes in the grid


<pre> qs gluster-volume-list|gv-list </pre>
<pre> qs gluster-volume-list|gv-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; gluster-volume-modify : Modifies the name and/or description of the specified Gluster volume.
===gluster-volume-modify===
Modifies the name and/or description of the specified Gluster volume.


<pre> qs gluster-volume-modify|gv-modify --gluster-volume=value --name=value [--desc=value ] [--flags=value ] </pre>
<pre> qs gluster-volume-modify|gv-modify --gluster-volume=value --name=value [--desc=value ] [--flags=value ] </pre>
Line 1,406: Line 1,508:




; gluster-volume-rebalance : Rebalances files across the bricks in the specified Gluster volume
===gluster-volume-rebalance===
Rebalances files across the bricks in the specified Gluster volume


<pre> qs gluster-volume-rebalance|gv-rebalance --gluster-volume=value [--flags=value ] </pre>
<pre> qs gluster-volume-rebalance|gv-rebalance --gluster-volume=value [--flags=value ] </pre>
Line 1,417: Line 1,520:




; gluster-volume-start : Starts the specified Gluster volume
===gluster-volume-start===
Starts the specified Gluster volume


<pre> qs gluster-volume-start|gv-start --gluster-volume=value [--flags=value ] </pre>
<pre> qs gluster-volume-start|gv-start --gluster-volume=value [--flags=value ] </pre>
Line 1,428: Line 1,532:




; gluster-volume-stop : Stops the specified Gluster volume.
===gluster-volume-stop===
Stops the specified Gluster volume.


<pre> qs gluster-volume-stop|gv-stop --gluster-volume=value [--flags=value ] </pre>
<pre> qs gluster-volume-stop|gv-stop --gluster-volume=value [--flags=value ] </pre>
Line 1,441: Line 1,546:
</div>
</div>


===Storage System Grid Management [GRID]===
==Storage System Grid Management [GRID]==
Commands for management and formation of grids of QuantaStor appliances which simplifies management and enables advanced features including HA, DR, and scale-out configurations.
Commands for management and formation of grids of QuantaStor appliances which simplifies management and enables advanced features including HA, DR, and scale-out configurations.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,448: Line 1,553:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; grid-add : Adds the specified storage system to the management grid.
===grid-add===
Adds the specified storage system to the management grid.


<pre> qs grid-add|mg-add --node-ipaddress=value [--node-username=value ] [--node-password=value ] </pre>
<pre> qs grid-add|mg-add --node-ipaddress=value [--node-username=value ] [--node-password=value ] </pre>
Line 1,461: Line 1,567:




; grid-assoc-get : Get general information about the associated storage system management grid.
===grid-assoc-get===
Get general information about the associated storage system management grid.


<pre> qs grid-assoc-get|mg-aget --name=value --storage-system=value [--flags=value ] </pre>
<pre> qs grid-assoc-get|mg-aget --name=value --storage-system=value [--flags=value ] </pre>
Line 1,474: Line 1,581:




; grid-assoc-list : Returns a list of the associated storage system nodes in the grid.
===grid-assoc-list===
Returns a list of the associated storage system nodes in the grid.


<pre> qs grid-assoc-list|mg-alist </pre>
<pre> qs grid-assoc-list|mg-alist </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; grid-create : Creates a new management grid.  A given storage system can only be a member of one grid at a time.
===grid-create===
Creates a new management grid.  A given storage system can only be a member of one grid at a time.


<pre> qs grid-create|mg-create --name=value [--desc=value ] </pre>
<pre> qs grid-create|mg-create --name=value [--desc=value ] </pre>
Line 1,490: Line 1,599:




; grid-delete : Deletes the management grid.  After the grid is deleted each node in the grid operates independently again.
===grid-delete===
Deletes the management grid.  After the grid is deleted each node in the grid operates independently again.


<pre> qs grid-delete|mg-delete </pre>
<pre> qs grid-delete|mg-delete </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; grid-get : Get general information about the storage system management grid.
===grid-get===
Get general information about the storage system management grid.


<pre> qs grid-get|mg-get </pre>
<pre> qs grid-get|mg-get </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; grid-get-hosts : Returns the /etc/hosts configuration file configuration for grid nodes.
===grid-get-hosts===
Returns the /etc/hosts configuration file configuration for grid nodes.


<pre> qs grid-get-hosts|mg-get-hosts </pre>
<pre> qs grid-get-hosts|mg-get-hosts </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; grid-modify : Modify the management grid properties.
===grid-modify===
Modify the management grid properties.


<pre> qs grid-modify|mg-modify --name=value [--desc=value ] </pre>
<pre> qs grid-modify|mg-modify --name=value [--desc=value ] </pre>
Line 1,516: Line 1,629:




; grid-remove : Removes the specified storage system from the management grid.
===grid-remove===
Removes the specified storage system from the management grid.


<pre> qs grid-remove|mg-remove --storage-system=value </pre>
<pre> qs grid-remove|mg-remove --storage-system=value </pre>
Line 1,525: Line 1,639:




; grid-set-hosts : Configures the /etc/hosts configuration file on all systems to facilitate host name based gluster volume configurations.
===grid-set-hosts===
Configures the /etc/hosts configuration file on all systems to facilitate host name based gluster volume configurations.


<pre> qs grid-set-hosts|mg-set-hosts --portid-list=value </pre>
<pre> qs grid-set-hosts|mg-set-hosts --portid-list=value </pre>
Line 1,534: Line 1,649:




; grid-set-master : Sets the master node for a storage system.
===grid-set-master===
Sets the master node for a storage system.


<pre> qs grid-set-master|mg-set --storage-system=value </pre>
<pre> qs grid-set-master|mg-set --storage-system=value </pre>
Line 1,545: Line 1,661:
</div>
</div>


===Storage Pool HA Failover Management [HA-FAILOVER]===
==Storage Pool HA Failover Management [HA-FAILOVER]==
Storage Pools based on ZFS can be made Highly-Available when formed using SAS/FC/iSCSI disks connected to two or more appliances. HA storage pools can be moved dynamically between a pair of appliances and activated HA groups will do automatic failover to ensure availability to the underlying pool and it's associated volume and shares.
Storage Pools based on ZFS can be made Highly-Available when formed using SAS/FC/iSCSI disks connected to two or more appliances. HA storage pools can be moved dynamically between a pair of appliances and activated HA groups will do automatic failover to ensure availability to the underlying pool and it's associated volume and shares.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,552: Line 1,668:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; ha-group-activate : Activates/enables the specified high-availability group to failover can occur on a system outage.
===ha-group-activate===
Activates/enables the specified high-availability group to failover can occur on a system outage.


<pre> qs ha-group-activate|hag-activate --ha-group=value </pre>
<pre> qs ha-group-activate|hag-activate --ha-group=value </pre>
Line 1,561: Line 1,678:




; ha-group-create : Creates a new storage pool high-availability group.
===ha-group-create===
Creates a new storage pool high-availability group.


<pre> qs ha-group-create|hag-create --name=value --pool=value --sys-secondary=value --sys-primary=value [--desc=value ] [--ha-module=value ] </pre>
<pre> qs ha-group-create|hag-create --name=value --pool=value --sys-secondary=value --sys-primary=value [--desc=value ] [--ha-module=value ] </pre>
Line 1,580: Line 1,698:




; ha-group-deactivate : Deactivates the specified high-availability group so that failover policies are disabled.
===ha-group-deactivate===
Deactivates the specified high-availability group so that failover policies are disabled.


<pre> qs ha-group-deactivate|hag-deactivate --ha-group=value </pre>
<pre> qs ha-group-deactivate|hag-deactivate --ha-group=value </pre>
Line 1,589: Line 1,708:




; ha-group-delete : Deletes the specified high-availability group
===ha-group-delete===
Deletes the specified high-availability group


<pre> qs ha-group-delete|hag-delete --ha-group=value </pre>
<pre> qs ha-group-delete|hag-delete --ha-group=value </pre>
Line 1,598: Line 1,718:




; ha-group-failover : Manually triggers a failover of the specified storage pool using the associated storage pool HA group policy.
===ha-group-failover===
Manually triggers a failover of the specified storage pool using the associated storage pool HA group policy.


<pre> qs ha-group-failover|hag-failover --ha-group=value --storage-system=value [--flags=value ] </pre>
<pre> qs ha-group-failover|hag-failover --ha-group=value --storage-system=value [--flags=value ] </pre>
Line 1,611: Line 1,732:




; ha-group-get : Gets information about the specified storage pool HA group
===ha-group-get===
Gets information about the specified storage pool HA group


<pre> qs ha-group-get|hag-get --ha-group=value </pre>
<pre> qs ha-group-get|hag-get --ha-group=value </pre>
Line 1,620: Line 1,742:




; ha-group-list : Returns a list of all the HA groups
===ha-group-list===
Returns a list of all the HA groups


<pre> qs ha-group-list|hag-list </pre>
<pre> qs ha-group-list|hag-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ha-group-modify : Modifies the settings for the specified high-availability group
===ha-group-modify===
Modifies the settings for the specified high-availability group


<pre> qs ha-group-modify|hag-modify --ha-group=value [--name=value ] [--desc=value ] [--sys-secondary=value ] [--ha-module=value ] [--verify-client-ips=value ] [--client-connectivity-check-policy=value ] </pre>
<pre> qs ha-group-modify|hag-modify --ha-group=value [--name=value ] [--desc=value ] [--sys-secondary=value ] [--ha-module=value ] [--verify-client-ips=value ] [--client-connectivity-check-policy=value ] </pre>
Line 1,646: Line 1,770:




; ha-interface-create : Creates a new virtual network interface for the specified HA failover group.
===ha-interface-create===
Creates a new virtual network interface for the specified HA failover group.


<pre> qs ha-interface-create|hai-create --ha-group=value --parent-port=value --ip-address=value [--netmask=value ] [--interface-tag=value ] [--desc=value ] [--gateway=value ] [--mac-address=value ] [--iscsi-enable=value ] </pre>
<pre> qs ha-interface-create|hai-create --ha-group=value --parent-port=value --ip-address=value [--netmask=value ] [--interface-tag=value ] [--desc=value ] [--gateway=value ] [--mac-address=value ] [--iscsi-enable=value ] </pre>
Line 1,671: Line 1,796:




; ha-interface-delete : Deletes the specified virtual network interface resource from the HA group
===ha-interface-delete===
Deletes the specified virtual network interface resource from the HA group


<pre> qs ha-interface-delete|hai-delete --ha-interface=value </pre>
<pre> qs ha-interface-delete|hai-delete --ha-interface=value </pre>
Line 1,680: Line 1,806:




; ha-interface-get : Gets information about the specified storage pool HA virtual network interface
===ha-interface-get===
Gets information about the specified storage pool HA virtual network interface


<pre> qs ha-interface-get|hai-get --ha-interface=value </pre>
<pre> qs ha-interface-get|hai-get --ha-interface=value </pre>
Line 1,689: Line 1,816:




; ha-interface-list : Returns a list of all the HA interfaces on the specified group
===ha-interface-list===
Returns a list of all the HA interfaces on the specified group


<pre> qs ha-interface-list|hai-list </pre>
<pre> qs ha-interface-list|hai-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ha-module-get : Gets information about the specified storage pool HA module
===ha-module-get===
Gets information about the specified storage pool HA module


<pre> qs ha-module-get|ham-get --ha-module=value </pre>
<pre> qs ha-module-get|ham-get --ha-module=value </pre>
Line 1,703: Line 1,832:




; ha-module-list : Returns a list of all the HA failover modules
===ha-module-list===
Returns a list of all the HA failover modules


<pre> qs ha-module-list|ham-list </pre>
<pre> qs ha-module-list|ham-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; ping-check : Pings the specified list of IP addresses and returns the list of IPs that responded to the ping check.
===ping-check===
Pings the specified list of IP addresses and returns the list of IPs that responded to the ping check.


<pre> qs ping-check|ping --verify-client-ips=value [--storage-system=value ] </pre>
<pre> qs ping-check|ping --verify-client-ips=value [--storage-system=value ] </pre>
Line 1,721: Line 1,852:
</div>
</div>


===Host Management [HOST]===
==Host Management [HOST]==
Storage Volumes must be assigned to Host(s) before the block storage (LUNs) can be accessed.  Each Host entry is identified by one or more iSCSI IQNs and/or FibreChannel WWPNs.
Storage Volumes must be assigned to Host(s) before the block storage (LUNs) can be accessed.  Each Host entry is identified by one or more iSCSI IQNs and/or FibreChannel WWPNs.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,728: Line 1,859:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; host-add : Modifies a host entry. The username/password fields are optional and are not yet leveraged by the QuantaStor system. Later this may be used to provide additional levels of integration such as automatic host side configuration of your iSCSI initiator.
===host-add===
Modifies a host entry. The username/password fields are optional and are not yet leveraged by the QuantaStor system. Later this may be used to provide additional levels of integration such as automatic host side configuration of your iSCSI initiator.


<pre> qs host-add|h-add --hostname=value [--iqn=value ] [--ip-address=value ] [--desc=value ] [--username=value ] [--password=value ] [--host-type=value ] [--flags=value ] </pre>
<pre> qs host-add|h-add --hostname=value [--iqn=value ] [--ip-address=value ] [--desc=value ] [--username=value ] [--password=value ] [--host-type=value ] [--flags=value ] </pre>
Line 1,751: Line 1,883:




; host-get : Gets information about a specific host.
===host-get===
Gets information about a specific host.


<pre> qs host-get|h-get --host=value </pre>
<pre> qs host-get|h-get --host=value </pre>
Line 1,760: Line 1,893:




; host-initiator-add : Adds an additional iSCSI host initiator IQN to the specified host.
===host-initiator-add===
Adds an additional iSCSI host initiator IQN to the specified host.


<pre> qs host-initiator-add|hi-add --host=value --iqn=value </pre>
<pre> qs host-initiator-add|hi-add --host=value --iqn=value </pre>
Line 1,771: Line 1,905:




; host-initiator-get : Gets information about a specific host identified by its initiator IQN.
===host-initiator-get===
Gets information about a specific host identified by its initiator IQN.


<pre> qs host-initiator-get|hi-get --iqn=value </pre>
<pre> qs host-initiator-get|hi-get --iqn=value </pre>
Line 1,780: Line 1,915:




; host-initiator-list : Returns a list of all the initiators (IQN) of the specified host
===host-initiator-list===
Returns a list of all the initiators (IQN) of the specified host


<pre> qs host-initiator-list|hi-list --host=value </pre>
<pre> qs host-initiator-list|hi-list --host=value </pre>
Line 1,789: Line 1,925:




; host-initiator-remove : Removes a iSCSI host initiator (IQN) from the specified host.
===host-initiator-remove===
Removes a iSCSI host initiator (IQN) from the specified host.


<pre> qs host-initiator-remove|hi-remove --host=value --iqn=value </pre>
<pre> qs host-initiator-remove|hi-remove --host=value --iqn=value </pre>
Line 1,800: Line 1,937:




; host-list : Returns a list of all the hosts that you have added to the QuantaStor system. Host groups allow you to assign storage to multiple host all at once. This is especially useful when you have a VMware or Windows cluster as you can assign and unassign storage to all nodes in the cluster in one operation.
===host-list===
Returns a list of all the hosts that you have added to the QuantaStor system. Host groups allow you to assign storage to multiple host all at once. This is especially useful when you have a VMware or Windows cluster as you can assign and unassign storage to all nodes in the cluster in one operation.


<pre> qs host-list|h-list </pre>
<pre> qs host-list|h-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; host-modify : Modifies a host entry which contains a list of WWN/IQN or IB GIDs for a given host.
===host-modify===
Modifies a host entry which contains a list of WWN/IQN or IB GIDs for a given host.


<pre> qs host-modify|h-modify --host=value [--desc=value ] [--ip-address=value ] [--username=value ] [--password=value ] [--host-type=value ] [--hostname=value ] [--flags=value ] </pre>
<pre> qs host-modify|h-modify --host=value [--desc=value ] [--ip-address=value ] [--username=value ] [--password=value ] [--host-type=value ] [--hostname=value ] [--flags=value ] </pre>
Line 1,828: Line 1,967:




; host-remove : Removes the specified host, *WARNING* host's active iSCSI sessions will be dropped.
===host-remove===
Removes the specified host, *WARNING* host's active iSCSI sessions will be dropped.


<pre> qs host-remove|h-remove --host=value [--flags=value ] </pre>
<pre> qs host-remove|h-remove --host=value [--flags=value ] </pre>
Line 1,841: Line 1,981:
</div>
</div>


===Host Group Management [HOST-GROUP]===
==Host Group Management [HOST-GROUP]==
Hosts can be grouped together into Host Group(s) to simplify assignment and management of Storage Volumes assigned to a cluster of hosts (eg. VMware).
Hosts can be grouped together into Host Group(s) to simplify assignment and management of Storage Volumes assigned to a cluster of hosts (eg. VMware).
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,848: Line 1,988:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; host-group-create : Creates a new host group with the specified name.
===host-group-create===
Creates a new host group with the specified name.


<pre> qs host-group-create|hg-create --name=value --host-list=value [--desc=value ] [--flags=value ] </pre>
<pre> qs host-group-create|hg-create --name=value --host-list=value [--desc=value ] [--flags=value ] </pre>
Line 1,863: Line 2,004:




; host-group-delete : Removes the specified host group.
===host-group-delete===
Removes the specified host group.


<pre> qs host-group-delete|hg-delete --host-group=value [--flags=value ] </pre>
<pre> qs host-group-delete|hg-delete --host-group=value [--flags=value ] </pre>
Line 1,874: Line 2,016:




; host-group-get : Gets information about a specific host group.
===host-group-get===
Gets information about a specific host group.


<pre> qs host-group-get|hg-get --host-group=value </pre>
<pre> qs host-group-get|hg-get --host-group=value </pre>
Line 1,883: Line 2,026:




; host-group-host-add : Adds a host to the specified host group.
===host-group-host-add===
Adds a host to the specified host group.


<pre> qs host-group-host-add|hg-host-add --host-group=value --host-list=value </pre>
<pre> qs host-group-host-add|hg-host-add --host-group=value --host-list=value </pre>
Line 1,894: Line 2,038:




; host-group-host-remove : Removes a host from the specified host group.
===host-group-host-remove===
Removes a host from the specified host group.


<pre> qs host-group-host-remove|hg-host-remove --host-group=value --host-list=value </pre>
<pre> qs host-group-host-remove|hg-host-remove --host-group=value --host-list=value </pre>
Line 1,905: Line 2,050:




; host-group-list : Returns a list of all the host groups.
===host-group-list===
Returns a list of all the host groups.


<pre> qs host-group-list|hg-list </pre>
<pre> qs host-group-list|hg-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; host-group-modify : Modifies the properties of a host group such as its name and/or description.
===host-group-modify===
Modifies the properties of a host group such as its name and/or description.


<pre> qs host-group-modify|hg-modify --host-group=value [--name=value ] [--desc=value ] </pre>
<pre> qs host-group-modify|hg-modify --host-group=value [--name=value ] [--desc=value ] </pre>
Line 1,925: Line 2,072:
</div>
</div>


===Hardware RAID Management [HWRAID]===
==Hardware RAID Management [HWRAID]==
Integrated hardware management modules monitor, discover, correlate and manage all the key aspects of internal SAS HBAs and RAID Controllers.
Integrated hardware management modules monitor, discover, correlate and manage all the key aspects of internal SAS HBAs and RAID Controllers.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 1,932: Line 2,079:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; hw-alarm-clear-all : Clears all the hardware alarms that have been recorded for the specified hardware RAID controller.
===hw-alarm-clear-all===
Clears all the hardware alarms that have been recorded for the specified hardware RAID controller.


<pre> qs hw-alarm-clear-all|hwa-clear-all --controller=value </pre>
<pre> qs hw-alarm-clear-all|hwa-clear-all --controller=value </pre>
Line 1,941: Line 2,089:




; hw-alarm-get : Returns information about a specific hardware alarm.
===hw-alarm-get===
Returns information about a specific hardware alarm.


<pre> qs hw-alarm-get|hwa-get --id=value </pre>
<pre> qs hw-alarm-get|hwa-get --id=value </pre>
Line 1,950: Line 2,099:




; hw-alarm-list : Returns a list of all the current hardware alarms/alert messages generated from the controller.
===hw-alarm-list===
Returns a list of all the current hardware alarms/alert messages generated from the controller.


<pre> qs hw-alarm-list|hwa-list [--controller=value ] </pre>
<pre> qs hw-alarm-list|hwa-list [--controller=value ] </pre>
Line 1,959: Line 2,109:




; hw-controller-change-security-key : Change the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.
===hw-controller-change-security-key===
Change the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.


<pre> qs hw-controller-change-security-key|hwc-change-security-key --controller=value --old-security-key=value --security-key=value </pre>
<pre> qs hw-controller-change-security-key|hwc-change-security-key --controller=value --old-security-key=value --security-key=value </pre>
Line 1,972: Line 2,123:




; hw-controller-create-security-key : Create the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.
===hw-controller-create-security-key===
Create the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.


<pre> qs hw-controller-create-security-key|hwc-create-security-key --controller=value --security-key=value </pre>
<pre> qs hw-controller-create-security-key|hwc-create-security-key --controller=value --security-key=value </pre>
Line 1,983: Line 2,135:




; hw-controller-get : Returns information about a specific hardware RAID controller.
===hw-controller-get===
Returns information about a specific hardware RAID controller.


<pre> qs hw-controller-get|hwc-get --controller=value </pre>
<pre> qs hw-controller-get|hwc-get --controller=value </pre>
Line 1,992: Line 2,145:




; hw-controller-group-get : Returns information about all the support hardware RAID controller group types.
===hw-controller-group-get===
Returns information about all the support hardware RAID controller group types.


<pre> qs hw-controller-group-get|hwcg-get --controller-group=value </pre>
<pre> qs hw-controller-group-get|hwcg-get --controller-group=value </pre>
Line 2,001: Line 2,155:




; hw-controller-group-list : Returns a list of all the hardware controller groups.
===hw-controller-group-list===
Returns a list of all the hardware controller groups.


<pre> qs hw-controller-group-list|hwcg-list </pre>
<pre> qs hw-controller-group-list|hwcg-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; hw-controller-import-units : Scan and import foreign disks associated with RAID groups that were attached to another RAID controller or that require re-importing to the local appliance.
===hw-controller-import-units===
Scan and import foreign disks associated with RAID groups that were attached to another RAID controller or that require re-importing to the local appliance.


<pre> qs hw-controller-import-units|hwc-import-units --controller=value </pre>
<pre> qs hw-controller-import-units|hwc-import-units --controller=value </pre>
Line 2,015: Line 2,171:




; hw-controller-list : Returns a list of all the hardware controllers.
===hw-controller-list===
Returns a list of all the hardware controllers.


<pre> qs hw-controller-list|hwc-list [--controller-group=value ] </pre>
<pre> qs hw-controller-list|hwc-list [--controller-group=value ] </pre>
Line 2,024: Line 2,181:




; hw-controller-rescan : Rescans the hardware controller to look for new disks and RAID units.
===hw-controller-rescan===
Rescans the hardware controller to look for new disks and RAID units.


<pre> qs hw-controller-rescan|hwc-rescan --controller=value </pre>
<pre> qs hw-controller-rescan|hwc-rescan --controller=value </pre>
Line 2,033: Line 2,191:




; hw-disk-delete : Marks the specified disk so that it can be removed from the enclosure.  Disks marked as hot-spares will return to normal status after being deleted.
===hw-disk-delete===
Marks the specified disk so that it can be removed from the enclosure.  Disks marked as hot-spares will return to normal status after being deleted.


<pre> qs hw-disk-delete|hwd-delete --disk=value [--duration=value ] </pre>
<pre> qs hw-disk-delete|hwd-delete --disk=value [--duration=value ] </pre>
Line 2,044: Line 2,203:




; hw-disk-get : Returns information about a specific disk managed by a hardware RAID controller.
===hw-disk-get===
Returns information about a specific disk managed by a hardware RAID controller.


<pre> qs hw-disk-get|hwd-get --disk=value </pre>
<pre> qs hw-disk-get|hwd-get --disk=value </pre>
Line 2,053: Line 2,213:




; hw-disk-identify : Flashes the LED indicator light on the specified disk so that it can be identified in the enclosure chassis.
===hw-disk-identify===
Flashes the LED indicator light on the specified disk so that it can be identified in the enclosure chassis.


<pre> qs hw-disk-identify|hwd-identify --unit=value [--duration=value ] </pre>
<pre> qs hw-disk-identify|hwd-identify --unit=value [--duration=value ] </pre>
Line 2,064: Line 2,225:




; hw-disk-list : Returns a list of all the disks managed by the specified hardware controller.
===hw-disk-list===
Returns a list of all the disks managed by the specified hardware controller.


<pre> qs hw-disk-list|hwd-list [--controller=value ] </pre>
<pre> qs hw-disk-list|hwd-list [--controller=value ] </pre>
Line 2,073: Line 2,235:




; hw-disk-mark-good : Marks the specified disk as 'good' or 'ready'.  You can use this to correct the disk status for good disks that the controller has in 'bad' or 'failed' state.
===hw-disk-mark-good===
Marks the specified disk as 'good' or 'ready'.  You can use this to correct the disk status for good disks that the controller has in 'bad' or 'failed' state.


<pre> qs hw-disk-mark-good|hwd-mark-good --disk=value </pre>
<pre> qs hw-disk-mark-good|hwd-mark-good --disk=value </pre>
Line 2,082: Line 2,245:




; hw-disk-mark-spare : Marks the specified disk as a universal hot spare within the group of RAID units managed by the controller in which the disk is attached.
===hw-disk-mark-spare===
Marks the specified disk as a universal hot spare within the group of RAID units managed by the controller in which the disk is attached.


<pre> qs hw-disk-mark-spare|hwd-mark-spare --disk=value </pre>
<pre> qs hw-disk-mark-spare|hwd-mark-spare --disk=value </pre>
Line 2,091: Line 2,255:




; hw-enclosure-get : Returns information about a specific enclosure managed by the specified hardware RAID controller.
===hw-enclosure-get===
Returns information about a specific enclosure managed by the specified hardware RAID controller.


<pre> qs hw-enclosure-get|hwe-get --enclosure=value </pre>
<pre> qs hw-enclosure-get|hwe-get --enclosure=value </pre>
Line 2,100: Line 2,265:




; hw-enclosure-list : Returns a list of all the enclosures managed by the specified hardware RAID controller.
===hw-enclosure-list===
Returns a list of all the enclosures managed by the specified hardware RAID controller.


<pre> qs hw-enclosure-list|hwe-list [--controller=value ] </pre>
<pre> qs hw-enclosure-list|hwe-list [--controller=value ] </pre>
Line 2,109: Line 2,275:




; hw-unit-auto-create : Creates new hardware RAID units automatically using available disk resources according to the selection criteria.
===hw-unit-auto-create===
Creates new hardware RAID units automatically using available disk resources according to the selection criteria.


<pre> qs hw-unit-auto-create|hwu-auto-create --raid=value --disks-per-unit=value [--disk-category=value ] [--min-size=value ] [--max-size=value ] [--unit-count=value ] [--options=value ] [--storage-system=value ] [--flags=value ] </pre>
<pre> qs hw-unit-auto-create|hwu-auto-create --raid=value --disks-per-unit=value [--disk-category=value ] [--min-size=value ] [--max-size=value ] [--unit-count=value ] [--options=value ] [--storage-system=value ] [--flags=value ] </pre>
Line 2,134: Line 2,301:




; hw-unit-create : Creates a new hardware RAID unit using the specified controller.
===hw-unit-create===
Creates a new hardware RAID unit using the specified controller.


<pre> qs hw-unit-create|hwu-create --raid=value --disk-list=value [--controller=value ] [--flags=value ] </pre>
<pre> qs hw-unit-create|hwu-create --raid=value --disk-list=value [--controller=value ] [--flags=value ] </pre>
Line 2,149: Line 2,317:




; hw-unit-delete : Deletes the specified RAID unit.  Note that you must first delete the Storage Pool before you delete the RAID unit.
===hw-unit-delete===
Deletes the specified RAID unit.  Note that you must first delete the Storage Pool before you delete the RAID unit.


<pre> qs hw-unit-delete|hwu-delete --unit=value [--duration=value ] </pre>
<pre> qs hw-unit-delete|hwu-delete --unit=value [--duration=value ] </pre>
Line 2,160: Line 2,329:




; hw-unit-encrypt : Enable hardware SED/FDE encryption for the specified hardware RAID unit.
===hw-unit-encrypt===
Enable hardware SED/FDE encryption for the specified hardware RAID unit.


<pre> qs hw-unit-encrypt|hwu-encrypt --unit=value [--options=value ] </pre>
<pre> qs hw-unit-encrypt|hwu-encrypt --unit=value [--options=value ] </pre>
Line 2,171: Line 2,341:




; hw-unit-get : Returns information about a specific RAID unit managed by the specified hardware RAID controller.
===hw-unit-get===
Returns information about a specific RAID unit managed by the specified hardware RAID controller.


<pre> qs hw-unit-get|hwu-get --unit=value </pre>
<pre> qs hw-unit-get|hwu-get --unit=value </pre>
Line 2,180: Line 2,351:




; hw-unit-identify : Flashes the LED indicator light on all the disks in the RAID unit so that it can be identified in the enclosure.
===hw-unit-identify===
Flashes the LED indicator light on all the disks in the RAID unit so that it can be identified in the enclosure.


<pre> qs hw-unit-identify|hwu-identify --unit=value [--duration=value ] </pre>
<pre> qs hw-unit-identify|hwu-identify --unit=value [--duration=value ] </pre>
Line 2,191: Line 2,363:




; hw-unit-list : Returns a list of all the RAID units managed by the specified hardware controller.
===hw-unit-list===
Returns a list of all the RAID units managed by the specified hardware controller.


<pre> qs hw-unit-list|hwu-list [--controller=value ] </pre>
<pre> qs hw-unit-list|hwu-list [--controller=value ] </pre>
Line 2,202: Line 2,375:
</div>
</div>


===SAS Switch Management [HWSWITCH]===
==SAS Switch Management [HWSWITCH]==
DEPRECATED
DEPRECATED
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 2,209: Line 2,382:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; hw-switch-adapter-get : Returns information about the specified HW switch management module.
===hw-switch-adapter-get===
Returns information about the specified HW switch management module.


<pre> qs hw-switch-adapter-get|hwsa-get --switch-adapter=value </pre>
<pre> qs hw-switch-adapter-get|hwsa-get --switch-adapter=value </pre>
Line 2,218: Line 2,392:




; hw-switch-adapter-list : Returns a list of all the storage switch management adapters
===hw-switch-adapter-list===
Returns a list of all the storage switch management adapters


<pre> qs hw-switch-adapter-list|hwsa-list </pre>
<pre> qs hw-switch-adapter-list|hwsa-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; hw-switch-cred-add : Adds storage switch login credentials for a specific switch management adapter
===hw-switch-cred-add===
Adds storage switch login credentials for a specific switch management adapter


<pre> qs hw-switch-cred-add|hwsc-add --username=value --password=value --domain-password=value --ip-address=value [--switch-adapter=value ] [--primary=value ] [--secondary=value ] </pre>
<pre> qs hw-switch-cred-add|hwsc-add --username=value --password=value --domain-password=value --ip-address=value [--switch-adapter=value ] [--primary=value ] [--secondary=value ] </pre>
Line 2,244: Line 2,420:




; hw-switch-cred-get : Returns information about specific storage switch login credentials
===hw-switch-cred-get===
Returns information about specific storage switch login credentials


<pre> qs hw-switch-cred-get|hwsc-get --creds=value </pre>
<pre> qs hw-switch-cred-get|hwsc-get --creds=value </pre>
Line 2,253: Line 2,430:




; hw-switch-cred-list : Returns a list of all the storage switch login credentials
===hw-switch-cred-list===
Returns a list of all the storage switch login credentials


<pre> qs hw-switch-cred-list|hwsc-list [--switch-adapter=value ] </pre>
<pre> qs hw-switch-cred-list|hwsc-list [--switch-adapter=value ] </pre>
Line 2,262: Line 2,440:




; hw-switch-cred-remove : Removes storage switch login credentials
===hw-switch-cred-remove===
Removes storage switch login credentials


<pre> qs hw-switch-cred-remove|hwsc-remove --creds=value </pre>
<pre> qs hw-switch-cred-remove|hwsc-remove --creds=value </pre>
Line 2,271: Line 2,450:




; hw-switch-failover-group-activate : Activates the pools in a switch failover group on the specified storage system
===hw-switch-failover-group-activate===
Activates the pools in a switch failover group on the specified storage system


<pre> qs hw-switch-failover-group-activate|hwsfg-activate --failover-group=value --storage-system=value </pre>
<pre> qs hw-switch-failover-group-activate|hwsfg-activate --failover-group=value --storage-system=value </pre>
Line 2,282: Line 2,462:




; hw-switch-failover-group-create : Creates a new switch failover group
===hw-switch-failover-group-create===
Creates a new switch failover group


<pre> qs hw-switch-failover-group-create|hwsfg-create --name=value --pool-list=value --sys-primary=value --zoneset-primary=value --sys-secondary=value --zoneset-secondary=value [--ip-address=value ] [--netmask=value ] [--gateway=value ] [--desc=value ] </pre>
<pre> qs hw-switch-failover-group-create|hwsfg-create --name=value --pool-list=value --sys-primary=value --zoneset-primary=value --sys-secondary=value --zoneset-secondary=value [--ip-address=value ] [--netmask=value ] [--gateway=value ] [--desc=value ] </pre>
Line 2,309: Line 2,490:




; hw-switch-failover-group-delete : Deletes a failover group
===hw-switch-failover-group-delete===
Deletes a failover group


<pre> qs hw-switch-failover-group-delete|hwsfg-delete --failover-group=value </pre>
<pre> qs hw-switch-failover-group-delete|hwsfg-delete --failover-group=value </pre>
Line 2,318: Line 2,500:




; hw-switch-failover-group-get : Returns information about a specific switch failover group
===hw-switch-failover-group-get===
Returns information about a specific switch failover group


<pre> qs hw-switch-failover-group-get|hwsfg-get --failover-group=value </pre>
<pre> qs hw-switch-failover-group-get|hwsfg-get --failover-group=value </pre>
Line 2,327: Line 2,510:




; hw-switch-failover-group-list : Returns a list of all the switch failover groups
===hw-switch-failover-group-list===
Returns a list of all the switch failover groups


<pre> qs hw-switch-failover-group-list|hwsfg-list [--switch=value ] </pre>
<pre> qs hw-switch-failover-group-list|hwsfg-list [--switch=value ] </pre>
Line 2,336: Line 2,520:




; hw-switch-failover-group-modify : Modifies the properties of a failover group
===hw-switch-failover-group-modify===
Modifies the properties of a failover group


<pre> qs hw-switch-failover-group-modify|hwsfg-modify --failover-group=value [--name=value ] [--ip-address=value ] [--netmask=value ] [--gateway=value ] [--pool-list=value ] [--sys-primary=value ] [--zoneset-primary=value ] [--sys-secondary=value ] [--zoneset-secondary=value ] [--desc=value ] </pre>
<pre> qs hw-switch-failover-group-modify|hwsfg-modify --failover-group=value [--name=value ] [--ip-address=value ] [--netmask=value ] [--gateway=value ] [--pool-list=value ] [--sys-primary=value ] [--zoneset-primary=value ] [--sys-secondary=value ] [--zoneset-secondary=value ] [--desc=value ] </pre>
Line 2,365: Line 2,550:




; hw-switch-get : Returns detailed information about a storage switch
===hw-switch-get===
Returns detailed information about a storage switch


<pre> qs hw-switch-get|hws-get --switch=value </pre>
<pre> qs hw-switch-get|hws-get --switch=value </pre>
Line 2,374: Line 2,560:




; hw-switch-list : Returns a list of all the discovered storage switches
===hw-switch-list===
Returns a list of all the discovered storage switches


<pre> qs hw-switch-list|hws-list [--switch-adapter=value ] </pre>
<pre> qs hw-switch-list|hws-list [--switch-adapter=value ] </pre>
Line 2,383: Line 2,570:




; hw-switch-zoneset-activate : Activates a specific storage switch zonset
===hw-switch-zoneset-activate===
Activates a specific storage switch zonset


<pre> qs hw-switch-zoneset-activate|hwsz-activate --zoneset=value [--switch=value ] </pre>
<pre> qs hw-switch-zoneset-activate|hwsz-activate --zoneset=value [--switch=value ] </pre>
Line 2,394: Line 2,582:




; hw-switch-zoneset-get : Returns information about a specific switch zoneset
===hw-switch-zoneset-get===
Returns information about a specific switch zoneset


<pre> qs hw-switch-zoneset-get|hwsz-get --zoneset=value </pre>
<pre> qs hw-switch-zoneset-get|hwsz-get --zoneset=value </pre>
Line 2,403: Line 2,592:




; hw-switch-zoneset-list : Returns a list of all the discovered zonesets
===hw-switch-zoneset-list===
Returns a list of all the discovered zonesets


<pre> qs hw-switch-zoneset-list|hwsz-list [--switch=value ] </pre>
<pre> qs hw-switch-zoneset-list|hwsz-list [--switch=value ] </pre>
Line 2,414: Line 2,604:
</div>
</div>


===License Management [LICENSE]===
==License Management [LICENSE]==
Commands for management of QuantaStor license keys including adding, removing and listing keys within a grid of one or more appliances.
Commands for management of QuantaStor license keys including adding, removing and listing keys within a grid of one or more appliances.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 2,421: Line 2,611:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; license-activate : Activates the system using a activation key received from customer support.
===license-activate===
Activates the system using a activation key received from customer support.


<pre> qs license-activate|lic-act --activation-key=value </pre>
<pre> qs license-activate|lic-act --activation-key=value </pre>
Line 2,430: Line 2,621:




; license-activate-online : Requests automatic activation via the online activation service.
===license-activate-online===
Requests automatic activation via the online activation service.


<pre> qs license-activate-online|lic-aon [--key=value ] </pre>
<pre> qs license-activate-online|lic-aon [--key=value ] </pre>
Line 2,439: Line 2,631:




; license-add : Adds a license key using a license key block specified in a key file. In general, you have 7 days to activate your license using online activation of activation via email. If you do not activate after the 7 days the system will continue to run but you will not be able to make configuration changes.
===license-add===
Adds a license key using a license key block specified in a key file. In general, you have 7 days to activate your license using online activation of activation via email. If you do not activate after the 7 days the system will continue to run but you will not be able to make configuration changes.


<pre> qs license-add|lic-add --key-file=value [--storage-system=value ] </pre>
<pre> qs license-add|lic-add --key-file=value [--storage-system=value ] </pre>
Line 2,450: Line 2,643:




; license-get : Shows the current license key info, and any activation request code.
===license-get===
Shows the current license key info, and any activation request code.


<pre> qs license-get|lic-get [--key=value ] </pre>
<pre> qs license-get|lic-get [--key=value ] </pre>
Line 2,459: Line 2,653:




; license-list : Returns a list of all the registered license keys.
===license-list===
Returns a list of all the registered license keys.


<pre> qs license-list|lic-list </pre>
<pre> qs license-list|lic-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; license-remove : Removes the specified license key.
===license-remove===
Removes the specified license key.


<pre> qs license-remove|lic-remove --key=value </pre>
<pre> qs license-remove|lic-remove --key=value </pre>
Line 2,475: Line 2,671:
</div>
</div>


===Cloud I/O Stats Management [METRICS]===
==Cloud I/O Stats Management [METRICS]==
Commands for the configuration and management of Librato Metrics cloud stats collection system.
Commands for the configuration and management of Librato Metrics cloud stats collection system.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 2,482: Line 2,678:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; metrics-get : Get the current username, token, and interval settings for Librato Metrics.
===metrics-get===
Get the current username, token, and interval settings for Librato Metrics.


<pre> qs metrics-get|lm-get --storage-system=value </pre>
<pre> qs metrics-get|lm-get --storage-system=value </pre>
Line 2,491: Line 2,688:




; metrics-set : Set the username, token, and interval for Librato Metrics posting.
===metrics-set===
Set the username, token, and interval for Librato Metrics posting.


<pre> qs metrics-set|lm-set --username=value --token=value [--storage-system=value ] [--interval=value ] [--dashboards=value ] [--alert-anno=value ] [--config-anno=value ] </pre>
<pre> qs metrics-set|lm-set --username=value --token=value [--storage-system=value ] [--interval=value ] [--dashboards=value ] [--alert-anno=value ] [--config-anno=value ] </pre>
Line 2,514: Line 2,712:
</div>
</div>


===Storage Pool Management [POOL]===
==Storage Pool Management [POOL]==
Storage Pools combined Physical Disks together to form fault-tolerant pools of storage that can be provisioned from.  Both Storage Volumes and Network Shares are provisioned from Storage Pools where ZFS based pools are the default ans XFS based pools are used for scale-out configurations using Ceph or Gluster technology.
Storage Pools combined Physical Disks together to form fault-tolerant pools of storage that can be provisioned from.  Both Storage Volumes and Network Shares are provisioned from Storage Pools where ZFS based pools are the default ans XFS based pools are used for scale-out configurations using Ceph or Gluster technology.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 2,521: Line 2,719:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; pool-add-spare : Adds a dedicated hotspare to the specified storage pool.
===pool-add-spare===
Adds a dedicated hotspare to the specified storage pool.


<pre> qs pool-add-spare|p-add --pool=value --disk-list=value [--flags=value ] </pre>
<pre> qs pool-add-spare|p-add --pool=value --disk-list=value [--flags=value ] </pre>
Line 2,534: Line 2,733:




; pool-create : Creates a new storage pool from which storage volumes can be created.
===pool-create===
Creates a new storage pool from which storage volumes can be created.


<pre> qs pool-create|p-create --name=value --disk-list=value [--raid-type=value ] [--pool-type=value ] [--desc=value ] [--is-default=value ] [--ssd=value ] [--compress=value ] [--nobarriers=value ] [--profile=value ] [--raid-set-size=value ] [--encrypt=value ] [--encryption-type=value ] [--passphrase=value ] [--flags=value ] </pre>
<pre> qs pool-create|p-create --name=value --disk-list=value [--raid-type=value ] [--pool-type=value ] [--desc=value ] [--is-default=value ] [--ssd=value ] [--compress=value ] [--nobarriers=value ] [--profile=value ] [--raid-set-size=value ] [--encrypt=value ] [--encryption-type=value ] [--passphrase=value ] [--flags=value ] </pre>
Line 2,571: Line 2,771:




; pool-destroy : Deletes a storage pool, *WARNING* any data in the pool will be lost.
===pool-destroy===
Deletes a storage pool, *WARNING* any data in the pool will be lost.


<pre> qs pool-destroy|p-destroy --pool=value [--flags=value ] </pre>
<pre> qs pool-destroy|p-destroy --pool=value [--flags=value ] </pre>
Line 2,582: Line 2,783:




; pool-device-get : Gets information about a specific storage pool device.
===pool-device-get===
Gets information about a specific storage pool device.


<pre> qs pool-device-get|spd-get --name=value </pre>
<pre> qs pool-device-get|spd-get --name=value </pre>
Line 2,591: Line 2,793:




; pool-device-list : Returns a list of all the storage pool devices.
===pool-device-list===
Returns a list of all the storage pool devices.


<pre> qs pool-device-list|spd-list </pre>
<pre> qs pool-device-list|spd-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; pool-expand : Expands a storage pool after the underlying hardware RAID unit has been grown underneath.
===pool-expand===
Expands a storage pool after the underlying hardware RAID unit has been grown underneath.


<pre> qs pool-expand|p-expand --pool=value [--flags=value ] </pre>
<pre> qs pool-expand|p-expand --pool=value [--flags=value ] </pre>
Line 2,607: Line 2,811:




; pool-export : Deactivate and removes the storage pool from the storage system database so that it can be exported and used on another system.
===pool-export===
Deactivate and removes the storage pool from the storage system database so that it can be exported and used on another system.


<pre> qs pool-export|p-export --pool=value [--flags=value ] </pre>
<pre> qs pool-export|p-export --pool=value [--flags=value ] </pre>
Line 2,618: Line 2,823:




; pool-get : Gets information about a specific storage pool.
===pool-get===
Gets information about a specific storage pool.


<pre> qs pool-get|p-get --pool=value </pre>
<pre> qs pool-get|p-get --pool=value </pre>
Line 2,627: Line 2,833:




; pool-grow : Grows the specified storage pool by adding an additional disk.  You can only grow storage pools that are using the RAID5 or RAID6 layout.
===pool-grow===
Grows the specified storage pool by adding an additional disk.  You can only grow storage pools that are using the RAID5 or RAID6 layout.


<pre> qs pool-grow|p-grow --pool=value --disk-list=value [--raid-type=value ] [--flags=value ] </pre>
<pre> qs pool-grow|p-grow --pool=value --disk-list=value [--raid-type=value ] [--flags=value ] </pre>
Line 2,642: Line 2,849:




; pool-identify : Pulses the disk activity lights for all disks in the pool so they can be identified in the chassis.
===pool-identify===
Pulses the disk activity lights for all disks in the pool so they can be identified in the chassis.


<pre> qs pool-identify|p-id --pool=value [--pattern=value ] [--duration=value ] [--flags=value ] </pre>
<pre> qs pool-identify|p-id --pool=value [--pattern=value ] [--duration=value ] [--flags=value ] </pre>
Line 2,657: Line 2,865:




; pool-import : Imports the named storage pool(s) which have been previously exported.
===pool-import===
Imports the named storage pool(s) which have been previously exported.


<pre> qs pool-import|p-import --storage-system=value --pool-list=value [--flags=value ] </pre>
<pre> qs pool-import|p-import --storage-system=value --pool-list=value [--flags=value ] </pre>
Line 2,670: Line 2,879:




; pool-list : Returns a list of all the storage pools.
===pool-list===
Returns a list of all the storage pools.


<pre> qs pool-list|p-list </pre>
<pre> qs pool-list|p-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; pool-modify : Modifies the properties of the storage pool such as its name and description.
===pool-modify===
Modifies the properties of the storage pool such as its name and description.


<pre> qs pool-modify|p-modify --pool=value [--name=value ] [--is-default=value ] [--ssd=value ] [--compress=value ] [--nobarriers=value ] [--profile=value ] [--desc=value ] [--sync=value ] [--compression-type=value ] [--repair-policy=value ] [--approve-repair=value ] [--copies=value ] [--flags=value ] </pre>
<pre> qs pool-modify|p-modify --pool=value [--name=value ] [--is-default=value ] [--ssd=value ] [--compress=value ] [--nobarriers=value ] [--profile=value ] [--desc=value ] [--sync=value ] [--compression-type=value ] [--repair-policy=value ] [--approve-repair=value ] [--copies=value ] [--flags=value ] </pre>
Line 2,710: Line 2,921:




; pool-preimport-scan : Returns a list of pools that are available to import but that are not yet discovered.
===pool-preimport-scan===
Returns a list of pools that are available to import but that are not yet discovered.


<pre> qs pool-preimport-scan|ppi-scan --storage-system=value [--flags=value ] </pre>
<pre> qs pool-preimport-scan|ppi-scan --storage-system=value [--flags=value ] </pre>
Line 2,721: Line 2,933:




; pool-profile-get : Gets information about a specific storage pool profile.
===pool-profile-get===
Gets information about a specific storage pool profile.


<pre> qs pool-profile-get|pp-get --profile=value </pre>
<pre> qs pool-profile-get|pp-get --profile=value </pre>
Line 2,730: Line 2,943:




; pool-profile-list : Returns a list of all the storage pool profiles.
===pool-profile-list===
Returns a list of all the storage pool profiles.


<pre> qs pool-profile-list|pp-list </pre>
<pre> qs pool-profile-list|pp-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; pool-remove-spare : Removes the specified hotspare from the specified pool.
===pool-remove-spare===
Removes the specified hotspare from the specified pool.


<pre> qs pool-remove-spare|p-remove --pool=value --disk-list=value [--flags=value ] </pre>
<pre> qs pool-remove-spare|p-remove --pool=value --disk-list=value [--flags=value ] </pre>
Line 2,748: Line 2,963:




; pool-scan : Rescans the specified storage system for storage pools.
===pool-scan===
Rescans the specified storage system for storage pools.


<pre> qs pool-scan|p-scan [--storage-system=value ] [--flags=value ] </pre>
<pre> qs pool-scan|p-scan [--storage-system=value ] [--flags=value ] </pre>
Line 2,759: Line 2,975:




; pool-scrub-start : Starts a scrub/verify operation on a ZFS-based storage pool (verifies data integrity and prevents bit-rot).See 'zpoolscrub' command for additional control. For example, 'zpoolscrub --cron' will setup an automatic monthly scrub.
===pool-scrub-start===
Starts a scrub/verify operation on a ZFS-based storage pool (verifies data integrity and prevents bit-rot).See 'zpoolscrub' command for additional control. For example, 'zpoolscrub --cron' will setup an automatic monthly scrub.


<pre> qs pool-scrub-start|p-scrub-start --pool=value [--flags=value ] </pre>
<pre> qs pool-scrub-start|p-scrub-start --pool=value [--flags=value ] </pre>
Line 2,770: Line 2,987:




; pool-scrub-stop : Stops the an active scrub/verify operation on a ZFS-based storage pool.
===pool-scrub-stop===
Stops the an active scrub/verify operation on a ZFS-based storage pool.


<pre> qs pool-scrub-stop|p-scrub-stop --pool=value [--flags=value ] </pre>
<pre> qs pool-scrub-stop|p-scrub-stop --pool=value [--flags=value ] </pre>
Line 2,781: Line 2,999:




; pool-start : Starts up a previously stopped storage pool.
===pool-start===
Starts up a previously stopped storage pool.


<pre> qs pool-start|p-start --pool=value [--passphrase=value ] [--flags=value ] </pre>
<pre> qs pool-start|p-start --pool=value [--passphrase=value ] [--flags=value ] </pre>
Line 2,794: Line 3,013:




; pool-stop : Stops all volume activity to the pool and disables it for maintenance.
===pool-stop===
Stops all volume activity to the pool and disables it for maintenance.


<pre> qs pool-stop|p-stop --pool=value [--flags=value ] </pre>
<pre> qs pool-stop|p-stop --pool=value [--flags=value ] </pre>
Line 2,807: Line 3,027:
</div>
</div>


===QoS Policy Management [QOSPOLICY]===
==QoS Policy Management [QOSPOLICY]==
Storage Volume access can be throttled to limit throughput independently for read and write IO in terms of MB/sec via Quality of Serivce (QoS) policies.
Storage Volume access can be throttled to limit throughput independently for read and write IO in terms of MB/sec via Quality of Serivce (QoS) policies.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 2,814: Line 3,034:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; qos-policy-create : Creates a new Quality-of-Service (QoS) policy template, which can apply performance limits to storage volumes.
===qos-policy-create===
Creates a new Quality-of-Service (QoS) policy template, which can apply performance limits to storage volumes.


<pre> qs qos-policy-create|qos-create --name=value --bw-read=value --bw-write=value [--desc=value ] [--flags=value ] </pre>
<pre> qs qos-policy-create|qos-create --name=value --bw-read=value --bw-write=value [--desc=value ] [--flags=value ] </pre>
Line 2,831: Line 3,052:




; qos-policy-delete : Deletes a given QoS Policy and clears the QoS performance limits on all Storage Volumes associated with the policy.
===qos-policy-delete===
Deletes a given QoS Policy and clears the QoS performance limits on all Storage Volumes associated with the policy.


<pre> qs qos-policy-delete|qos-delete --qos-policy=value [--flags=value ] </pre>
<pre> qs qos-policy-delete|qos-delete --qos-policy=value [--flags=value ] </pre>
Line 2,842: Line 3,064:




; qos-policy-get : Returns detailed information about a specific QoS policy.
===qos-policy-get===
Returns detailed information about a specific QoS policy.


<pre> qs qos-policy-get|qos-get --qos-policy=value </pre>
<pre> qs qos-policy-get|qos-get --qos-policy=value </pre>
Line 2,851: Line 3,074:




; qos-policy-list : Returns details on the list of all QoS policy objects in the storage system grid.
===qos-policy-list===
Returns details on the list of all QoS policy objects in the storage system grid.


<pre> qs qos-policy-list|qos-list </pre>
<pre> qs qos-policy-list|qos-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; qos-policy-modify : Modifies an existing QoS policy with a new name, description, or performance limits. Changes are applied immediately to all volumes.
===qos-policy-modify===
Modifies an existing QoS policy with a new name, description, or performance limits. Changes are applied immediately to all volumes.


<pre> qs qos-policy-modify|qos-modify --qos-policy=value [--name=value ] [--desc=value ] [--bw-read=value ] [--bw-write=value ] [--flags=value ] </pre>
<pre> qs qos-policy-modify|qos-modify --qos-policy=value [--name=value ] [--desc=value ] [--bw-read=value ] [--bw-write=value ] [--flags=value ] </pre>
Line 2,877: Line 3,102:
</div>
</div>


===Resource Group Quota Management [QUOTA]===
==Resource Group Quota Management [QUOTA]==
Resource Groups can have quotas associated with them to limit which pools and how much storage can be provisioned from those pools by a given group of users which are members of a Resource Group
Resource Groups can have quotas associated with them to limit which pools and how much storage can be provisioned from those pools by a given group of users which are members of a Resource Group
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 2,884: Line 3,109:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; provisioning-quota-create : Creates a new storage provisioning quota on a pool for the specified tenant resource cloud.
===provisioning-quota-create===
Creates a new storage provisioning quota on a pool for the specified tenant resource cloud.


<pre> qs provisioning-quota-create|pq-create --name=value --pool=value --cloud=value [--policy=value ] [--desc=value ] [--psize=value ] [--usize=value ] [--max-volumes=value ] [--max-shares=value ] [--flags=value ] </pre>
<pre> qs provisioning-quota-create|pq-create --name=value --pool=value --cloud=value [--policy=value ] [--desc=value ] [--psize=value ] [--usize=value ] [--max-volumes=value ] [--max-shares=value ] [--flags=value ] </pre>
Line 2,911: Line 3,137:




; provisioning-quota-delete : Deletes a storage provisioning quota, the associated volumes are not deleted.
===provisioning-quota-delete===
Deletes a storage provisioning quota, the associated volumes are not deleted.


<pre> qs provisioning-quota-delete|pq-delete --quota=value [--flags=value ] </pre>
<pre> qs provisioning-quota-delete|pq-delete --quota=value [--flags=value ] </pre>
Line 2,922: Line 3,149:




; provisioning-quota-get : Returns information about a specific storage provisioning quota.
===provisioning-quota-get===
Returns information about a specific storage provisioning quota.


<pre> qs provisioning-quota-get|pq-get --quota=value </pre>
<pre> qs provisioning-quota-get|pq-get --quota=value </pre>
Line 2,931: Line 3,159:




; provisioning-quota-list : Returns a list of all the storage provisioning quotas.
===provisioning-quota-list===
Returns a list of all the storage provisioning quotas.


<pre> qs provisioning-quota-list|pq-list </pre>
<pre> qs provisioning-quota-list|pq-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; provisioning-quota-modify : Modifies one to change the name and/or description of a storage provisioning quota.
===provisioning-quota-modify===
Modifies one to change the name and/or description of a storage provisioning quota.


<pre> qs provisioning-quota-modify|pq-modify --quota=value --cloud=value [--name=value ] [--desc=value ] [--psize=value ] [--usize=value ] [--max-volumes=value ] [--max-shares=value ] [--policy=value ] [--flags=value ] </pre>
<pre> qs provisioning-quota-modify|pq-modify --quota=value --cloud=value [--name=value ] [--desc=value ] [--psize=value ] [--usize=value ] [--max-volumes=value ] [--max-shares=value ] [--policy=value ] [--flags=value ] </pre>
Line 2,963: Line 3,193:




; provisioning-quota-share-add : Adds one or more shares to the specified provisioning quota.
===provisioning-quota-share-add===
Adds one or more shares to the specified provisioning quota.


<pre> qs provisioning-quota-share-add|pqs-add --quota=value --share-list=value </pre>
<pre> qs provisioning-quota-share-add|pqs-add --quota=value --share-list=value </pre>
Line 2,974: Line 3,205:




; provisioning-quota-share-assoc-list : Returns a list of all the associated provisioning quotas of a specified share.
===provisioning-quota-share-assoc-list===
Returns a list of all the associated provisioning quotas of a specified share.


<pre> qs provisioning-quota-share-assoc-list|pqs-alist --share=value </pre>
<pre> qs provisioning-quota-share-assoc-list|pqs-alist --share=value </pre>
Line 2,983: Line 3,215:




; provisioning-quota-share-remove : Removes one or more shares from the specified provisioning quota.
===provisioning-quota-share-remove===
Removes one or more shares from the specified provisioning quota.


<pre> qs provisioning-quota-share-remove|pqs-remove --quota=value --share-list=value </pre>
<pre> qs provisioning-quota-share-remove|pqs-remove --quota=value --share-list=value </pre>
Line 2,994: Line 3,227:




; provisioning-quota-volume-add : Adds one or more volumes to the specified provisioning quota.
===provisioning-quota-volume-add===
Adds one or more volumes to the specified provisioning quota.


<pre> qs provisioning-quota-volume-add|pqv-add --quota=value --volume-list=value </pre>
<pre> qs provisioning-quota-volume-add|pqv-add --quota=value --volume-list=value </pre>
Line 3,005: Line 3,239:




; provisioning-quota-volume-assoc-list : Returns a list of all the associated provisioning quotas of a specified volume.
===provisioning-quota-volume-assoc-list===
Returns a list of all the associated provisioning quotas of a specified volume.


<pre> qs provisioning-quota-volume-assoc-list|pqv-alist --volume=value </pre>
<pre> qs provisioning-quota-volume-assoc-list|pqv-alist --volume=value </pre>
Line 3,014: Line 3,249:




; provisioning-quota-volume-remove : Removes one or more volumes from the specified provisioning quota
===provisioning-quota-volume-remove===
Removes one or more volumes from the specified provisioning quota


<pre> qs provisioning-quota-volume-remove|pqv-remove --quota=value --volume-list=value </pre>
<pre> qs provisioning-quota-volume-remove|pqv-remove --quota=value --volume-list=value </pre>
Line 3,027: Line 3,263:
</div>
</div>


===Remote Replication Management [REPLICATION]===
==Remote Replication Management [REPLICATION]==
Remote-replication and associated replication schedules enable automatic replication to a pool of storage in a remote appliance for disaster-recovery (DR) purposes.
Remote-replication and associated replication schedules enable automatic replication to a pool of storage in a remote appliance for disaster-recovery (DR) purposes.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,034: Line 3,270:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; replica-assoc-delete : Deletes the specified replication association between a source/target pair of volumes or shares.
===replica-assoc-delete===
Deletes the specified replication association between a source/target pair of volumes or shares.


<pre> qs replica-assoc-delete|rep-assoc-delete --replica-assoc=value </pre>
<pre> qs replica-assoc-delete|rep-assoc-delete --replica-assoc=value </pre>
Line 3,043: Line 3,280:




; replica-assoc-get : Returns details of the specified replication association.
===replica-assoc-get===
Returns details of the specified replication association.


<pre> qs replica-assoc-get|rep-assoc-get --replica-assoc=value </pre>
<pre> qs replica-assoc-get|rep-assoc-get --replica-assoc=value </pre>
Line 3,052: Line 3,290:




; replica-assoc-list : Returns a list of all the replication associations.
===replica-assoc-list===
Returns a list of all the replication associations.


<pre> qs replica-assoc-list|rep-assoc-list </pre>
<pre> qs replica-assoc-list|rep-assoc-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; replica-assoc-rollback : Reverses the replication to send the changes on the target back to the source volume/share.  Requires the --force flag.
===replica-assoc-rollback===
Reverses the replication to send the changes on the target back to the source volume/share.  Requires the --force flag.


<pre> qs replica-assoc-rollback|rep-assoc-rollback --replica-assoc=value </pre>
<pre> qs replica-assoc-rollback|rep-assoc-rollback --replica-assoc=value </pre>
Line 3,066: Line 3,306:




; replica-assoc-stop : Attempts to stop the replication process between a source/target pair of volumes or shares.
===replica-assoc-stop===
Attempts to stop the replication process between a source/target pair of volumes or shares.


<pre> qs replica-assoc-stop|rep-assoc-stop --replica-assoc=value </pre>
<pre> qs replica-assoc-stop|rep-assoc-stop --replica-assoc=value </pre>
Line 3,075: Line 3,316:




; replica-assoc-sync : Restarts the replication process between a source/target pair of volumes or shares.
===replica-assoc-sync===
Restarts the replication process between a source/target pair of volumes or shares.


<pre> qs replica-assoc-sync|rep-assoc-sync --replica-assoc=value </pre>
<pre> qs replica-assoc-sync|rep-assoc-sync --replica-assoc=value </pre>
Line 3,084: Line 3,326:




; replication-schedule-add : Adds one or more volumes/shares to the specified schedule.
===replication-schedule-add===
Adds one or more volumes/shares to the specified schedule.


<pre> qs replication-schedule-add|rsch-add --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
<pre> qs replication-schedule-add|rsch-add --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
Line 3,097: Line 3,340:




; replication-schedule-create : Creates a new replication schedule to replicate the specified storage volumes and shares to the specified target pool on a schedule.
===replication-schedule-create===
Creates a new replication schedule to replicate the specified storage volumes and shares to the specified target pool on a schedule.


<pre> qs replication-schedule-create|rsch-create --name=value --target-pool=value [--volume-list=value ] [--share-list=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-replicas=value ] [--days=value ] [--hours=value ] [--interval=value ] [--offset-minutes=value ] [--flags=value ] </pre>
<pre> qs replication-schedule-create|rsch-create --name=value --target-pool=value [--volume-list=value ] [--share-list=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-replicas=value ] [--days=value ] [--hours=value ] [--interval=value ] [--offset-minutes=value ] [--flags=value ] </pre>
Line 3,132: Line 3,376:




; replication-schedule-delete : Deletes a replication schedule, snapshots associated with the schedule are not removed.
===replication-schedule-delete===
Deletes a replication schedule, snapshots associated with the schedule are not removed.


<pre> qs replication-schedule-delete|rsch-delete --schedule=value [--flags=value ] </pre>
<pre> qs replication-schedule-delete|rsch-delete --schedule=value [--flags=value ] </pre>
Line 3,143: Line 3,388:




; replication-schedule-disable : Disables the specified replication schedule.
===replication-schedule-disable===
Disables the specified replication schedule.


<pre> qs replication-schedule-disable|rsch-disable --schedule=value [--flags=value ] </pre>
<pre> qs replication-schedule-disable|rsch-disable --schedule=value [--flags=value ] </pre>
Line 3,154: Line 3,400:




; replication-schedule-enable : Enables the specified replication schedule.
===replication-schedule-enable===
Enables the specified replication schedule.


<pre> qs replication-schedule-enable|rsch-enable --schedule=value [--flags=value ] </pre>
<pre> qs replication-schedule-enable|rsch-enable --schedule=value [--flags=value ] </pre>
Line 3,165: Line 3,412:




; replication-schedule-get : Returns information about a specific replication schedule.
===replication-schedule-get===
Returns information about a specific replication schedule.


<pre> qs replication-schedule-get|rsch-get --schedule=value </pre>
<pre> qs replication-schedule-get|rsch-get --schedule=value </pre>
Line 3,174: Line 3,422:




; replication-schedule-list : Returns a list of all the replication schedules.
===replication-schedule-list===
Returns a list of all the replication schedules.


<pre> qs replication-schedule-list|rsch-list </pre>
<pre> qs replication-schedule-list|rsch-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; replication-schedule-modify : Modifies the name, description or other properties of a replication schedule.
===replication-schedule-modify===
Modifies the name, description or other properties of a replication schedule.


<pre> qs replication-schedule-modify|rsch-modify --schedule=value [--name=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-replicas=value ] [--days=value ] [--hours=value ] [--interval=value ] [--offset-minutes=value ] [--flags=value ] </pre>
<pre> qs replication-schedule-modify|rsch-modify --schedule=value [--name=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-replicas=value ] [--days=value ] [--hours=value ] [--interval=value ] [--offset-minutes=value ] [--flags=value ] </pre>
Line 3,210: Line 3,460:




; replication-schedule-remove : Removes one or more volumes/shares from the specified schedule.
===replication-schedule-remove===
Removes one or more volumes/shares from the specified schedule.


<pre> qs replication-schedule-remove|rsch-remove --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
<pre> qs replication-schedule-remove|rsch-remove --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
Line 3,223: Line 3,474:




; replication-schedule-trigger : Triggers the specified schedule to run immediately.
===replication-schedule-trigger===
Triggers the specified schedule to run immediately.


<pre> qs replication-schedule-trigger|rsch-trigger --schedule=value [--flags=value ] </pre>
<pre> qs replication-schedule-trigger|rsch-trigger --schedule=value [--flags=value ] </pre>
Line 3,236: Line 3,488:
</div>
</div>


===Resource Domain Management [RESOURCE-DOMAIN]===
==Resource Domain Management [RESOURCE-DOMAIN]==
Resource Domains group appliances by site, building, and rack so that scale-out data distribution technologies (Ceph CRUSH, GlusterFS) can be automatically configured.
Resource Domains group appliances by site, building, and rack so that scale-out data distribution technologies (Ceph CRUSH, GlusterFS) can be automatically configured.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,243: Line 3,495:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; resource-domain-add-system : Adds one or more systems to a resource domain (site, rack, etc).
===resource-domain-add-system===
Adds one or more systems to a resource domain (site, rack, etc).


<pre> qs resource-domain-add-system|rd-add-sys --domain-resource=value --system-list=value </pre>
<pre> qs resource-domain-add-system|rd-add-sys --domain-resource=value --system-list=value </pre>
Line 3,254: Line 3,507:




; resource-domain-assoc-get : Returns information about a system/appliance association with a specific domain (rack, building, site).
===resource-domain-assoc-get===
Returns information about a system/appliance association with a specific domain (rack, building, site).


<pre> qs resource-domain-assoc-get|rda-get [--system-resource=value ] [--resource-domain-assoc=value ] </pre>
<pre> qs resource-domain-assoc-get|rda-get [--system-resource=value ] [--resource-domain-assoc=value ] </pre>
Line 3,265: Line 3,519:




; resource-domain-assoc-list : Returns a list of all the defined resource domain association objects which represent links between appliances to sites, buildings, and racks.
===resource-domain-assoc-list===
Returns a list of all the defined resource domain association objects which represent links between appliances to sites, buildings, and racks.


<pre> qs resource-domain-assoc-list|rda-list </pre>
<pre> qs resource-domain-assoc-list|rda-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; resource-domain-create : Creates a new resource domain which identifies a site, building or rack of equipment.
===resource-domain-create===
Creates a new resource domain which identifies a site, building or rack of equipment.


<pre> qs resource-domain-create|rd-create --name=value [--desc=value ] [--resource-type=value ] [--resource-parent=value ] [--flags=value ] </pre>
<pre> qs resource-domain-create|rd-create --name=value [--desc=value ] [--resource-type=value ] [--resource-parent=value ] [--flags=value ] </pre>
Line 3,287: Line 3,543:




; resource-domain-delete : Deletes the specified resource domain.
===resource-domain-delete===
Deletes the specified resource domain.


<pre> qs resource-domain-delete|rd-delete --domain-resource=value [--flags=value ] </pre>
<pre> qs resource-domain-delete|rd-delete --domain-resource=value [--flags=value ] </pre>
Line 3,298: Line 3,555:




; resource-domain-get : Resource failure domains identify physical equipment, sites, racks so that data can be dispersed in such a way as to ensure fault-tolerance and high availability across sites and racks.
===resource-domain-get===
Resource failure domains identify physical equipment, sites, racks so that data can be dispersed in such a way as to ensure fault-tolerance and high availability across sites and racks.


<pre> qs resource-domain-get|rd-get --domain-resource=value </pre>
<pre> qs resource-domain-get|rd-get --domain-resource=value </pre>
Line 3,307: Line 3,565:




; resource-domain-list : Returns a list of all the defined resource domain objects which can include sites, buildings, racks, and servers.
===resource-domain-list===
Returns a list of all the defined resource domain objects which can include sites, buildings, racks, and servers.


<pre> qs resource-domain-list|rd-list </pre>
<pre> qs resource-domain-list|rd-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; resource-domain-modify : Modifies an existing resource domain to change properties like name and description.
===resource-domain-modify===
Modifies an existing resource domain to change properties like name and description.


<pre> qs resource-domain-modify|rd-modify --domain-resource=value [--name=value ] [--desc=value ] [--resource-type=value ] [--resource-parent=value ] [--flags=value ] </pre>
<pre> qs resource-domain-modify|rd-modify --domain-resource=value [--name=value ] [--desc=value ] [--resource-type=value ] [--resource-parent=value ] [--flags=value ] </pre>
Line 3,331: Line 3,591:




; resource-domain-rm-system : Removes one or more systems from a resource domain (site, rack, etc)
===resource-domain-rm-system===
Removes one or more systems from a resource domain (site, rack, etc)


<pre> qs resource-domain-rm-system|rd-rm-sys --domain-resource=value --system-list=value </pre>
<pre> qs resource-domain-rm-system|rd-rm-sys --domain-resource=value --system-list=value </pre>
Line 3,344: Line 3,605:
</div>
</div>


===Multitenant Resource Group Management [RESOURCE-GROUP]===
==Multitenant Resource Group Management [RESOURCE-GROUP]==
Resource Groups combine volumes, shares, and pools of storage together and so that they can be assigned to one more users (tenants).  This facilitates multi-tenancy and delegation of common tasks like storage provisioning to end-users.
Resource Groups combine volumes, shares, and pools of storage together and so that they can be assigned to one more users (tenants).  This facilitates multi-tenancy and delegation of common tasks like storage provisioning to end-users.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,351: Line 3,612:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; resource-group-create : Creates a new tenant resource group comprised of the specified users, resources and chap information.
===resource-group-create===
Creates a new tenant resource group comprised of the specified users, resources and chap information.


<pre> qs resource-group-create|rg-create --name=value [--desc=value ] [--subject-list=value ] [--resource-list=value ] [--parent-cloud=value ] [--tier=value ] [--organization=value ] [--chap-user=value ] [--chap-pass=value ] [--flags=value ] </pre>
<pre> qs resource-group-create|rg-create --name=value [--desc=value ] [--subject-list=value ] [--resource-list=value ] [--parent-cloud=value ] [--tier=value ] [--organization=value ] [--chap-user=value ] [--chap-pass=value ] [--flags=value ] </pre>
Line 3,378: Line 3,640:




; resource-group-delete : Deletes a tenant's resource group, the resources and users will not be deleted.
===resource-group-delete===
Deletes a tenant's resource group, the resources and users will not be deleted.


<pre> qs resource-group-delete|rg-delete --cloud=value [--flags=value ] </pre>
<pre> qs resource-group-delete|rg-delete --cloud=value [--flags=value ] </pre>
Line 3,389: Line 3,652:




; resource-group-get : Returns information of the specified tenant resource groups.
===resource-group-get===
Returns information of the specified tenant resource groups.


<pre> qs resource-group-get|rg-get --cloud=value [--flags=value ] </pre>
<pre> qs resource-group-get|rg-get --cloud=value [--flags=value ] </pre>
Line 3,400: Line 3,664:




; resource-group-list : Returns a list of all the tenant resource groups.
===resource-group-list===
Returns a list of all the tenant resource groups.


<pre> qs resource-group-list|rg-list [--flags=value ] </pre>
<pre> qs resource-group-list|rg-list [--flags=value ] </pre>
Line 3,409: Line 3,674:




; resource-group-modify : Modifies the name, description, parent resource group, tier, organization, and chap information of a resource group.
===resource-group-modify===
Modifies the name, description, parent resource group, tier, organization, and chap information of a resource group.


<pre> qs resource-group-modify|rg-modify --cloud=value [--name=value ] [--desc=value ] [--parent-cloud=value ] [--tier=value ] [--organization=value ] [--chap-user=value ] [--chap-pass=value ] [--flags=value ] </pre>
<pre> qs resource-group-modify|rg-modify --cloud=value [--name=value ] [--desc=value ] [--parent-cloud=value ] [--tier=value ] [--organization=value ] [--chap-user=value ] [--chap-pass=value ] [--flags=value ] </pre>
Line 3,434: Line 3,700:




; resource-group-resource-add : Add one or more resources to the specified tenant resource group.
===resource-group-resource-add===
Add one or more resources to the specified tenant resource group.


<pre> qs resource-group-resource-add|rgr-add --cloud=value --resource-list=value </pre>
<pre> qs resource-group-resource-add|rgr-add --cloud=value --resource-list=value </pre>
Line 3,445: Line 3,712:




; resource-group-resource-mode : Set the mode of a specified resource in the tenant resource group.
===resource-group-resource-mode===
Set the mode of a specified resource in the tenant resource group.


<pre> qs resource-group-resource-mode|rgr-mode --cloud=value --resource=value --access-mode=value [--flags=value ] </pre>
<pre> qs resource-group-resource-mode|rgr-mode --cloud=value --resource=value --access-mode=value [--flags=value ] </pre>
Line 3,460: Line 3,728:




; resource-group-resource-remove : Remove one or more resource from the specified tenant resource group.
===resource-group-resource-remove===
Remove one or more resource from the specified tenant resource group.


<pre> qs resource-group-resource-remove|rgr-remove --cloud=value --resource-list=value </pre>
<pre> qs resource-group-resource-remove|rgr-remove --cloud=value --resource-list=value </pre>
Line 3,471: Line 3,740:




; resource-group-subject-assoc-list : Returns a list of associated tenant resource groups to the specified subject (user or user group).
===resource-group-subject-assoc-list===
Returns a list of associated tenant resource groups to the specified subject (user or user group).


<pre> qs resource-group-subject-assoc-list|rgsub-alist --subject=value [--flags=value ] </pre>
<pre> qs resource-group-subject-assoc-list|rgsub-alist --subject=value [--flags=value ] </pre>
Line 3,482: Line 3,752:




; resource-group-user-add : Add one or more users to the specified tenant resource group.
===resource-group-user-add===
Add one or more users to the specified tenant resource group.


<pre> qs resource-group-user-add|rgu-add --cloud=value --subject-list=value </pre>
<pre> qs resource-group-user-add|rgu-add --cloud=value --subject-list=value </pre>
Line 3,493: Line 3,764:




; resource-group-user-remove : Remove one or more users from specified tenant resource group.
===resource-group-user-remove===
Remove one or more users from specified tenant resource group.


<pre> qs resource-group-user-remove|rgu-remove --cloud=value --subject-list=value </pre>
<pre> qs resource-group-user-remove|rgu-remove --cloud=value --subject-list=value </pre>
Line 3,506: Line 3,778:
</div>
</div>


===RBAC Role Management [ROLE]===
==RBAC Role Management [ROLE]==
Advanced Role Based Access Controls (RBAC) allow for the creation of custom roles that limit users to specific tasks and operations within a grid or Resource Group (collection of volumes, shares, and pools).
Advanced Role Based Access Controls (RBAC) allow for the creation of custom roles that limit users to specific tasks and operations within a grid or Resource Group (collection of volumes, shares, and pools).
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,513: Line 3,785:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; role-add : Adds a new role to the role based access control (RBAC) system.
===role-add===
Adds a new role to the role based access control (RBAC) system.


<pre> qs role-add|r-add --name=value [--desc=value ] [--permissions=value ] </pre>
<pre> qs role-add|r-add --name=value [--desc=value ] [--permissions=value ] </pre>
Line 3,526: Line 3,799:




; role-get : Gets information about the specified role.
===role-get===
Gets information about the specified role.


<pre> qs role-get|r-get --role=value </pre>
<pre> qs role-get|r-get --role=value </pre>
Line 3,535: Line 3,809:




; role-list : Returns a list of all the defined roles the RBAC system.
===role-list===
Returns a list of all the defined roles the RBAC system.


<pre> qs role-list|r-list </pre>
<pre> qs role-list|r-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; role-modify : Modifies the name and/or description of a role
===role-modify===
Modifies the name and/or description of a role


<pre> qs role-modify|r-modify --role=value [--name=value ] [--desc=value ] </pre>
<pre> qs role-modify|r-modify --role=value [--name=value ] [--desc=value ] </pre>
Line 3,553: Line 3,829:




; role-permission-add : Adds additional permissions and/or permission groups to the specified role.
===role-permission-add===
Adds additional permissions and/or permission groups to the specified role.


<pre> qs role-permission-add|rp-add --role=value --permissions=value </pre>
<pre> qs role-permission-add|rp-add --role=value --permissions=value </pre>
Line 3,564: Line 3,841:




; role-permission-def-list : Returns a list of all the defined permissions available to be assigned to roles in the RBAC system.
===role-permission-def-list===
Returns a list of all the defined permissions available to be assigned to roles in the RBAC system.


<pre> qs role-permission-def-list|rpd-list </pre>
<pre> qs role-permission-def-list|rpd-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; role-permission-remove : Removes one or more permissions and/or permission groups from the specified role.
===role-permission-remove===
Removes one or more permissions and/or permission groups from the specified role.


<pre> qs role-permission-remove|rp-remove --role=value --permissions=value </pre>
<pre> qs role-permission-remove|rp-remove --role=value --permissions=value </pre>
Line 3,580: Line 3,859:




; role-remove : Removes the specified role identified by name or ID
===role-remove===
Removes the specified role identified by name or ID


<pre> qs role-remove|r-remove --role=value </pre>
<pre> qs role-remove|r-remove --role=value </pre>
Line 3,591: Line 3,871:
</div>
</div>


===Snapshot Schedule Management [SCHEDULE]===
==Snapshot Schedule Management [SCHEDULE]==
Snapshot schedules make automatic instant point-in-time snapshots of Storage Volumes and/or Network Shares on a schedule.  It is highly recommended that snapshot schedule(s) be created for all mission critical volumes and shares so that data and files can be easily recovered from a previous point in time.
Snapshot schedules make automatic instant point-in-time snapshots of Storage Volumes and/or Network Shares on a schedule.  It is highly recommended that snapshot schedule(s) be created for all mission critical volumes and shares so that data and files can be easily recovered from a previous point in time.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,598: Line 3,878:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; snap-schedule-add : Adds one or more volumes/shares to the specified schedule.
===snap-schedule-add===
Adds one or more volumes/shares to the specified schedule.


<pre> qs snap-schedule-add|sch-add --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
<pre> qs snap-schedule-add|sch-add --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
Line 3,611: Line 3,892:




; snap-schedule-assoc-list : Returns a list of all the volume/share associations for a given snapshot schedule.
===snap-schedule-assoc-list===
Returns a list of all the volume/share associations for a given snapshot schedule.


<pre> qs snap-schedule-assoc-list|scha-list --schedule=value </pre>
<pre> qs snap-schedule-assoc-list|scha-list --schedule=value </pre>
Line 3,620: Line 3,902:




; snap-schedule-create : Creates a new snapshot schedule comprised of the specified storage volumes.
===snap-schedule-create===
Creates a new snapshot schedule comprised of the specified storage volumes.


<pre> qs snap-schedule-create|sch-create --name=value [--volume-list=value ] [--share-list=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-snaps=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
<pre> qs snap-schedule-create|sch-create --name=value [--volume-list=value ] [--share-list=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-snaps=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
Line 3,649: Line 3,932:




; snap-schedule-delete : Deletes a snapshot schedule, snapshots associated with the schedule are not removed.
===snap-schedule-delete===
Deletes a snapshot schedule, snapshots associated with the schedule are not removed.


<pre> qs snap-schedule-delete|sch-delete --schedule=value [--flags=value ] </pre>
<pre> qs snap-schedule-delete|sch-delete --schedule=value [--flags=value ] </pre>
Line 3,660: Line 3,944:




; snap-schedule-disable : Disables the specified snapshot schedule.
===snap-schedule-disable===
Disables the specified snapshot schedule.


<pre> qs snap-schedule-disable|sch-disable --schedule=value [--flags=value ] </pre>
<pre> qs snap-schedule-disable|sch-disable --schedule=value [--flags=value ] </pre>
Line 3,671: Line 3,956:




; snap-schedule-enable : Enables the specified snapshot schedule.
===snap-schedule-enable===
Enables the specified snapshot schedule.


<pre> qs snap-schedule-enable|sch-enable --schedule=value [--flags=value ] </pre>
<pre> qs snap-schedule-enable|sch-enable --schedule=value [--flags=value ] </pre>
Line 3,682: Line 3,968:




; snap-schedule-get : Returns information about a specific snapshot schedule.
===snap-schedule-get===
Returns information about a specific snapshot schedule.


<pre> qs snap-schedule-get|sch-get --schedule=value </pre>
<pre> qs snap-schedule-get|sch-get --schedule=value </pre>
Line 3,691: Line 3,978:




; snap-schedule-list : Returns a list of all the snapshot schedules.
===snap-schedule-list===
Returns a list of all the snapshot schedules.


<pre> qs snap-schedule-list|sch-list </pre>
<pre> qs snap-schedule-list|sch-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; snap-schedule-modify : Modifies the name, description or other properties of a snapshot schedule.
===snap-schedule-modify===
Modifies the name, description or other properties of a snapshot schedule.


<pre> qs snap-schedule-modify|sch-modify --schedule=value [--name=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-snaps=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
<pre> qs snap-schedule-modify|sch-modify --schedule=value [--name=value ] [--start-date=value ] [--enabled=value ] [--desc=value ] [--cloud=value ] [--max-snaps=value ] [--days=value ] [--hours=value ] [--flags=value ] </pre>
Line 3,723: Line 4,012:




; snap-schedule-remove : Removes one or more volumes/shares from the specified schedule.
===snap-schedule-remove===
Removes one or more volumes/shares from the specified schedule.


<pre> qs snap-schedule-remove|sch-remove --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
<pre> qs snap-schedule-remove|sch-remove --schedule=value [--volume-list=value ] [--share-list=value ] </pre>
Line 3,736: Line 4,026:




; snap-schedule-trigger : Triggers the specified schedule to run immediately.
===snap-schedule-trigger===
Triggers the specified schedule to run immediately.


<pre> qs snap-schedule-trigger|sch-trigger --schedule=value </pre>
<pre> qs snap-schedule-trigger|sch-trigger --schedule=value </pre>
Line 3,747: Line 4,038:
</div>
</div>


===iSCSI/FC Session Management [SESSION]===
==iSCSI/FC Session Management [SESSION]==
Commands for iSCSI/FC storage session management.
Commands for iSCSI/FC storage session management.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,754: Line 4,045:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; session-close : Forcibly closes the specified iSCSI session; generally not recommended, use acl-remove instead.
===session-close===
Forcibly closes the specified iSCSI session; generally not recommended, use acl-remove instead.


<pre> qs session-close|sn-close --session=value </pre>
<pre> qs session-close|sn-close --session=value </pre>
Line 3,763: Line 4,055:




; session-get : Returns detailed information on a specific iSCSI session.
===session-get===
Returns detailed information on a specific iSCSI session.


<pre> qs session-get|sn-get --session=value </pre>
<pre> qs session-get|sn-get --session=value </pre>
Line 3,772: Line 4,065:




; session-list : Returns a list of all the active iSCSI sessions.
===session-list===
Returns a list of all the active iSCSI sessions.


<pre> qs session-list|sn-list [--volume=value ] [--host=value ] </pre>
<pre> qs session-list|sn-list [--volume=value ] [--host=value ] </pre>
Line 3,785: Line 4,079:
</div>
</div>


===Network Share Management [SHARE]===
==Network Share Management [SHARE]==
Commands for managing Network Shares which are accessible via NFS and/or the SMB protocol.
Commands for managing Network Shares which are accessible via NFS and/or the SMB protocol.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 3,792: Line 4,086:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; share-ad-user-group-list : Returns a list of all the users and groups in the Active Directory domain that the appliance is a member of.
===share-ad-user-group-list===
Returns a list of all the users and groups in the Active Directory domain that the appliance is a member of.


<pre> qs share-ad-user-group-list|shr-ad-ug-list --storage-system=value [--share=value ] [--flags=value ] </pre>
<pre> qs share-ad-user-group-list|shr-ad-ug-list --storage-system=value [--share=value ] [--flags=value ] </pre>
Line 3,805: Line 4,100:




; share-client-add : Adds a NFS client access rule for the specified network share.
===share-client-add===
Adds a NFS client access rule for the specified network share.


<pre> qs share-client-add|shr-cadd --share=value --filter=value [--async=value ] [--secure=value ] [--subtree=value ] [--rdonly=value ] [--options=value ] [--flags=value ] </pre>
<pre> qs share-client-add|shr-cadd --share=value --filter=value [--async=value ] [--secure=value ] [--subtree=value ] [--rdonly=value ] [--options=value ] [--flags=value ] </pre>
Line 3,828: Line 4,124:




; share-client-get : Returns information about the specific network share NFS client access rule.
===share-client-get===
Returns information about the specific network share NFS client access rule.


<pre> qs share-client-get|shr-cget --share=value [--filter=value ] [--flags=value ] </pre>
<pre> qs share-client-get|shr-cget --share=value [--filter=value ] [--flags=value ] </pre>
Line 3,841: Line 4,138:




; share-client-list : Returns a list of NFS clients access rules for the specified network share.
===share-client-list===
Returns a list of NFS clients access rules for the specified network share.


<pre> qs share-client-list|shr-clist --share=value [--flags=value ] </pre>
<pre> qs share-client-list|shr-clist --share=value [--flags=value ] </pre>
Line 3,852: Line 4,150:




; share-client-modify : Modifies a NFS client access rule for the specified network share.
===share-client-modify===
Modifies a NFS client access rule for the specified network share.


<pre> qs share-client-modify|shr-cmodify --share=value --filter=value [--rdonly=value ] [--secure=value ] [--async=value ] [--subtree=value ] [--options=value ] [--flags=value ] </pre>
<pre> qs share-client-modify|shr-cmodify --share=value --filter=value [--rdonly=value ] [--secure=value ] [--async=value ] [--subtree=value ] [--options=value ] [--flags=value ] </pre>
Line 3,875: Line 4,174:




; share-client-remove : Removes NFS client access rule for the specified network share.
===share-client-remove===
Removes NFS client access rule for the specified network share.


<pre> qs share-client-remove|shr-cremove --share=value --filter=value [--flags=value ] </pre>
<pre> qs share-client-remove|shr-cremove --share=value --filter=value [--flags=value ] </pre>
Line 3,888: Line 4,188:




; share-clone : Creates a full copy of the specified network share to another storage pool.
===share-clone===
Creates a full copy of the specified network share to another storage pool.


<pre> qs share-clone|shr-clone --share=value --pool=value [--name=value ] [--desc=value ] [--active=value ] [--flags=value ] </pre>
<pre> qs share-clone|shr-clone --share=value --pool=value [--name=value ] [--desc=value ] [--active=value ] [--flags=value ] </pre>
Line 3,907: Line 4,208:




; share-create : Creates a new NFS v3 network share.
===share-create===
Creates a new NFS v3 network share.


<pre> qs share-create|shr-create --name=value --pool=value [--desc=value ] [--public=value ] [--active=value ] [--cifs-enable=value ] [--user-access-list=value ] [--cifs-options=value ] [--space-quota=value ] [--space-quota-exclude-snapshots=value ] [--sync=value ] [--compression-type=value ] [--copies=value ] [--disable-snap-browsing=value ] [--share-owner=value ] [--share-owner-group=value ] [--permissions=value ] [--flags=value ] </pre>
<pre> qs share-create|shr-create --name=value --pool=value [--desc=value ] [--public=value ] [--active=value ] [--cifs-enable=value ] [--user-access-list=value ] [--cifs-options=value ] [--space-quota=value ] [--space-quota-exclude-snapshots=value ] [--sync=value ] [--compression-type=value ] [--copies=value ] [--disable-snap-browsing=value ] [--share-owner=value ] [--share-owner-group=value ] [--permissions=value ] [--flags=value ] </pre>
Line 3,950: Line 4,252:




; share-delete : Deletes the specified network share
===share-delete===
Deletes the specified network share


<pre> qs share-delete|shr-delete --share=value [--flags=value ] </pre>
<pre> qs share-delete|shr-delete --share=value [--flags=value ] </pre>
Line 3,961: Line 4,264:




; share-disable : Disables/deactivates the specified network share
===share-disable===
Disables/deactivates the specified network share


<pre> qs share-disable|shr-disable --share=value [--flags=value ] </pre>
<pre> qs share-disable|shr-disable --share=value [--flags=value ] </pre>
Line 3,972: Line 4,276:




; share-enable : Enables/activates the specified network share
===share-enable===
Enables/activates the specified network share


<pre> qs share-enable|shr-enable --share=value [--flags=value ] </pre>
<pre> qs share-enable|shr-enable --share=value [--flags=value ] </pre>
Line 3,983: Line 4,288:




; share-enum-quota : Returns the user quotas for the network share.
===share-enum-quota===
Returns the user quotas for the network share.


<pre> qs share-enum-quota --share=value [--flags=value ] </pre>
<pre> qs share-enum-quota --share=value [--flags=value ] </pre>
Line 3,994: Line 4,300:




; share-get : Returns information about the specified network share.
===share-get===
Returns information about the specified network share.


<pre> qs share-get|shr-get --share=value </pre>
<pre> qs share-get|shr-get --share=value </pre>
Line 4,003: Line 4,310:




; share-join-domain : Joins the specified Active Directory domain/realm.
===share-join-domain===
Joins the specified Active Directory domain/realm.


<pre> qs share-join-domain|shr-jdomain --storage-system=value --domain=value --realm=value --kdc=value --ad-admin=value --ad-password=value [--idmap-mode=value ] [--flags=value ] </pre>
<pre> qs share-join-domain|shr-jdomain --storage-system=value --domain=value --realm=value --kdc=value --ad-admin=value --ad-password=value [--idmap-mode=value ] [--flags=value ] </pre>
Line 4,026: Line 4,334:




; share-leave-domain : Leaves the current Active Directory domain.
===share-leave-domain===
Leaves the current Active Directory domain.


<pre> qs share-leave-domain|shr-ldomain --storage-system=value [--ad-admin=value ] [--ad-password=value ] [--flags=value ] </pre>
<pre> qs share-leave-domain|shr-ldomain --storage-system=value [--ad-admin=value ] [--ad-password=value ] [--flags=value ] </pre>
Line 4,041: Line 4,350:




; share-list : Returns a list of all the network shares in the system.
===share-list===
Returns a list of all the network shares in the system.


<pre> qs share-list|shr-list </pre>
<pre> qs share-list|shr-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; share-modify : Modifies the properties of the specified network share.
===share-modify===
Modifies the properties of the specified network share.


<pre> qs share-modify|shr-modify --share=value [--name=value ] [--desc=value ] [--active=value ] [--space-quota=value ] [--space-quota-exclude-snapshots=value ] [--sync=value ] [--compression-type=value ] [--copies=value ] [--cifs-enable=value ] [--user-access-list=value ] [--group-access-list=value ] [--cifs-options=value ] [--disable-snap-browsing=value ] [--share-owner=value ] [--share-owner-group=value ] [--permissions=value ] [--flags=value ] </pre>
<pre> qs share-modify|shr-modify --share=value [--name=value ] [--desc=value ] [--active=value ] [--space-quota=value ] [--space-quota-exclude-snapshots=value ] [--sync=value ] [--compression-type=value ] [--copies=value ] [--cifs-enable=value ] [--user-access-list=value ] [--group-access-list=value ] [--cifs-options=value ] [--disable-snap-browsing=value ] [--share-owner=value ] [--share-owner-group=value ] [--permissions=value ] [--flags=value ] </pre>
Line 4,089: Line 4,400:




; share-restore : Restores the specified network share with the contents of the specified snapshot.
===share-restore===
Restores the specified network share with the contents of the specified snapshot.


<pre> qs share-restore|shr-restore --share=value [--flags=value ] </pre>
<pre> qs share-restore|shr-restore --share=value [--flags=value ] </pre>
Line 4,100: Line 4,412:




; share-rollback : Instant rollback of the specified network share to the specified point-in-time snapshot. Rollback is faster than the Restore operation but only works with the most recent snapshot.  It use rollback with an earlier snapshot you must first remove those snapshots which were created after the desired rollback point.
===share-rollback===
Instant rollback of the specified network share to the specified point-in-time snapshot. Rollback is faster than the Restore operation but only works with the most recent snapshot.  It use rollback with an earlier snapshot you must first remove those snapshots which were created after the desired rollback point.


<pre> qs share-rollback|shr-rollback --share=value --share-snapshot=value [--flags=value ] </pre>
<pre> qs share-rollback|shr-rollback --share=value --share-snapshot=value [--flags=value ] </pre>
Line 4,113: Line 4,426:




; share-snapshot : Creates and instant space efficient snapshot of the specified network share (requires Advanced Storage Pool)
===share-snapshot===
Creates and instant space efficient snapshot of the specified network share (requires Advanced Storage Pool)


<pre> qs share-snapshot|shr-snap --share=value [--name=value ] [--desc=value ] [--active=value ] [--flags=value ] </pre>
<pre> qs share-snapshot|shr-snap --share=value [--name=value ] [--desc=value ] [--active=value ] [--flags=value ] </pre>
Line 4,132: Line 4,446:
</div>
</div>


===Site Cluster Resource Management [SITE]===
==Site Cluster Resource Management [SITE]==
Configurations with floating IPs such as High-Availability pools and Gluster VIFs first require that a Site Cluster is formed.  Site Clusters maintain a heart-beat and control quorum for a subset of nodes so that Virtual Interfaces can be automatically moved between nodes as necessary.
Configurations with floating IPs such as High-Availability pools and Gluster VIFs first require that a Site Cluster is formed.  Site Clusters maintain a heart-beat and control quorum for a subset of nodes so that Virtual Interfaces can be automatically moved between nodes as necessary.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,139: Line 4,453:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; cluster-ring-create : Creates a new cluster ring configuration for the specified site. Sites can have multiple rings to improve resiliency of the cluster in the event of a network loss on a specific port or network interface.
===cluster-ring-create===
Creates a new cluster ring configuration for the specified site. Sites can have multiple rings to improve resiliency of the cluster in the event of a network loss on a specific port or network interface.


<pre> qs cluster-ring-create|cr-create --site=value --member-addresses=value [--ring=value ] [--bind-address=value ] </pre>
<pre> qs cluster-ring-create|cr-create --site=value --member-addresses=value [--ring=value ] [--bind-address=value ] </pre>
Line 4,154: Line 4,469:




; cluster-ring-delete : Deletes the specified cluster ring configuration.
===cluster-ring-delete===
Deletes the specified cluster ring configuration.


<pre> qs cluster-ring-delete|cr-delete --cluster-ring=value </pre>
<pre> qs cluster-ring-delete|cr-delete --cluster-ring=value </pre>
Line 4,163: Line 4,479:




; cluster-ring-get : Returns the details about a specific cluster ring.  A ring represents a communication channel for cluster heartbeat communication.  Ideal cluster configurations have two rings.
===cluster-ring-get===
Returns the details about a specific cluster ring.  A ring represents a communication channel for cluster heartbeat communication.  Ideal cluster configurations have two rings.


<pre> qs cluster-ring-get|cr-get --cluster-ring=value </pre>
<pre> qs cluster-ring-get|cr-get --cluster-ring=value </pre>
Line 4,172: Line 4,489:




; cluster-ring-list : Returns a list of the cluster ring configurations.
===cluster-ring-list===
Returns a list of the cluster ring configurations.


<pre> qs cluster-ring-list|cr-list </pre>
<pre> qs cluster-ring-list|cr-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; cluster-ring-member-get : Returns information about the specified cluster ring member.
===cluster-ring-member-get===
Returns information about the specified cluster ring member.


<pre> qs cluster-ring-member-get|crm-get --cluster-ring=value </pre>
<pre> qs cluster-ring-member-get|crm-get --cluster-ring=value </pre>
Line 4,186: Line 4,505:




; cluster-ring-member-list : Returns a list of all the cluster ring members of the site.
===cluster-ring-member-list===
Returns a list of all the cluster ring members of the site.


<pre> qs cluster-ring-member-list|crm-list </pre>
<pre> qs cluster-ring-member-list|crm-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; site-cluster-assoc-get : Returns detailed information about the specified site association.
===site-cluster-assoc-get===
Returns detailed information about the specified site association.


<pre> qs site-cluster-assoc-get|sca-get [--system=value ] [--site-assoc=value ] </pre>
<pre> qs site-cluster-assoc-get|sca-get [--system=value ] [--site-assoc=value ] </pre>
Line 4,202: Line 4,523:




; site-cluster-assoc-list : Returns a list of all the configured site association.
===site-cluster-assoc-list===
Returns a list of all the configured site association.


<pre> qs site-cluster-assoc-list|sca-list </pre>
<pre> qs site-cluster-assoc-list|sca-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; site-cluster-create : A site represents a group of appliances at a particular location.  That location can span buildings but typically represents systems in close proximity to each other.
===site-cluster-create===
A site represents a group of appliances at a particular location.  That location can span buildings but typically represents systems in close proximity to each other.


<pre> qs site-cluster-create|sc-create --name=value --sys-list=value [--desc=value ] [--location=value ] [--flags=value ] </pre>
<pre> qs site-cluster-create|sc-create --name=value --sys-list=value [--desc=value ] [--location=value ] [--flags=value ] </pre>
Line 4,224: Line 4,547:




; site-cluster-delete : Deletes the specified site configuration.
===site-cluster-delete===
Deletes the specified site configuration.


<pre> qs site-cluster-delete|sc-delete --site=value [--flags=value ] </pre>
<pre> qs site-cluster-delete|sc-delete --site=value [--flags=value ] </pre>
Line 4,235: Line 4,559:




; site-cluster-get : Returns detailed information about the specified site.
===site-cluster-get===
Returns detailed information about the specified site.


<pre> qs site-cluster-get|sc-get --site=value </pre>
<pre> qs site-cluster-get|sc-get --site=value </pre>
Line 4,244: Line 4,569:




; site-cluster-list : Returns a list of all the configured sites.
===site-cluster-list===
Returns a list of all the configured sites.


<pre> qs site-cluster-list|sc-list </pre>
<pre> qs site-cluster-list|sc-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; site-cluster-modify : Modifies the configuration settings of a site like it's name, location or description.
===site-cluster-modify===
Modifies the configuration settings of a site like it's name, location or description.


<pre> qs site-cluster-modify|sc-modify --site=value [--name=value ] [--desc=value ] [--location=value ] </pre>
<pre> qs site-cluster-modify|sc-modify --site=value [--name=value ] [--desc=value ] [--location=value ] </pre>
Line 4,264: Line 4,591:




; site-vif-create : Creates a new virtual interface for the site. Site virtual interfaces automatically float between appliances/systems to ensure availability of a management IP for a given site.
===site-vif-create===
Creates a new virtual interface for the site. Site virtual interfaces automatically float between appliances/systems to ensure availability of a management IP for a given site.


<pre> qs site-vif-create|svr-create --site=value --parent-port=value --ip-address=value [--netmask=value ] [--mtu=value ] [--grid-vif=value ] </pre>
<pre> qs site-vif-create|svr-create --site=value --parent-port=value --ip-address=value [--netmask=value ] [--mtu=value ] [--grid-vif=value ] </pre>
Line 4,283: Line 4,611:




; site-vif-delete : Deletes the virtual interface site resource and it's associated configuration information from the cluster configuration.
===site-vif-delete===
Deletes the virtual interface site resource and it's associated configuration information from the cluster configuration.


<pre> qs site-vif-delete|svr-delete --vif-resource=value </pre>
<pre> qs site-vif-delete|svr-delete --vif-resource=value </pre>
Line 4,292: Line 4,621:




; site-vif-get : Returns the details about the specified virtual interface cluster resource in a site.
===site-vif-get===
Returns the details about the specified virtual interface cluster resource in a site.


<pre> qs site-vif-get|svr-get --vif-resource=value </pre>
<pre> qs site-vif-get|svr-get --vif-resource=value </pre>
Line 4,301: Line 4,631:




; site-vif-list : Returns a list of all the virtual interface site resources.
===site-vif-list===
Returns a list of all the virtual interface site resources.


<pre> qs site-vif-list|svr-list </pre>
<pre> qs site-vif-list|svr-list </pre>
Line 4,308: Line 4,639:
</div>
</div>


===Storage Provisioning Tier Management [STORAGE-TIER]===
==Storage Provisioning Tier Management [STORAGE-TIER]==
Storage Pools can be grouped into a Storage Provisioning Teir to simplify common provisioning tasks by pushing onto the system the task of selecting the optimial storage pool to provision a volume or share from based on the amount of free-space available and allocated.
Storage Pools can be grouped into a Storage Provisioning Teir to simplify common provisioning tasks by pushing onto the system the task of selecting the optimial storage pool to provision a volume or share from based on the amount of free-space available and allocated.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,315: Line 4,646:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; storage-tier-create : Creates a new storage storage tier comprised of the specified storage pools
===storage-tier-create===
Creates a new storage storage tier comprised of the specified storage pools


<pre> qs storage-tier-create|st-create --name=value --pool-list=value [--desc=value ] [--storage-class=value ] [--storage-type=value ] [--perf-level=value ] [--flags=value ] </pre>
<pre> qs storage-tier-create|st-create --name=value --pool-list=value [--desc=value ] [--storage-class=value ] [--storage-type=value ] [--perf-level=value ] [--flags=value ] </pre>
Line 4,336: Line 4,668:




; storage-tier-delete : Deletes the specified storage storage tier (pools are not deleted).
===storage-tier-delete===
Deletes the specified storage storage tier (pools are not deleted).


<pre> qs storage-tier-delete|st-delete --tier=value [--flags=value ] </pre>
<pre> qs storage-tier-delete|st-delete --tier=value [--flags=value ] </pre>
Line 4,347: Line 4,680:




; storage-tier-get : Returns information about a specific storage storage tier.
===storage-tier-get===
Returns information about a specific storage storage tier.


<pre> qs storage-tier-get|st-get --tier=value </pre>
<pre> qs storage-tier-get|st-get --tier=value </pre>
Line 4,356: Line 4,690:




; storage-tier-list : Returns a list of all the storage storage tiers.
===storage-tier-list===
Returns a list of all the storage storage tiers.


<pre> qs storage-tier-list|st-list </pre>
<pre> qs storage-tier-list|st-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; storage-tier-modify : Modifies the name, description or other property of the specified storage tier.
===storage-tier-modify===
Modifies the name, description or other property of the specified storage tier.


<pre> qs storage-tier-modify|st-modify --tier=value [--name=value ] [--desc=value ] [--storage-class=value ] [--storage-type=value ] [--perf-level=value ] </pre>
<pre> qs storage-tier-modify|st-modify --tier=value [--name=value ] [--desc=value ] [--storage-class=value ] [--storage-type=value ] [--perf-level=value ] </pre>
Line 4,380: Line 4,716:




; storage-tier-pool-add : Adds one or more pools to the specified storage tier.
===storage-tier-pool-add===
Adds one or more pools to the specified storage tier.


<pre> qs storage-tier-pool-add|stp-add --tier=value --pool-list=value </pre>
<pre> qs storage-tier-pool-add|stp-add --tier=value --pool-list=value </pre>
Line 4,391: Line 4,728:




; storage-tier-pool-remove : Removes one or more pools from the specified storage tier.
===storage-tier-pool-remove===
Removes one or more pools from the specified storage tier.


<pre> qs storage-tier-pool-remove|stp-remove --tier=value --pool-list=value </pre>
<pre> qs storage-tier-pool-remove|stp-remove --tier=value --pool-list=value </pre>
Line 4,404: Line 4,742:
</div>
</div>


===Software Controller / iSCSI SAN Adapter [SWC]===
==Software Controller / iSCSI SAN Adapter [SWC]==
QuantaStor appliances can use iSCSI storage to form Storage Pools.  To configure an appliance to automatically connect to and login to one or more storage appliances to access iSCSI block storage first add and then configure a iSCSI Software Adapter.
QuantaStor appliances can use iSCSI storage to form Storage Pools.  To configure an appliance to automatically connect to and login to one or more storage appliances to access iSCSI block storage first add and then configure a iSCSI Software Adapter.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,411: Line 4,749:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; sw-controller-add : Adds an iSCSI SAN adapter for connecting to the specified iSCSI SAN.
===sw-controller-add===
Adds an iSCSI SAN adapter for connecting to the specified iSCSI SAN.


<pre> qs sw-controller-add|swc-add --ip-address=value --name=value --storage-system=value [--desc=value ] [--chap-user=value ] [--chap-pass=value ] </pre>
<pre> qs sw-controller-add|swc-add --ip-address=value --name=value --storage-system=value [--desc=value ] [--chap-user=value ] [--chap-pass=value ] </pre>
Line 4,430: Line 4,769:




; sw-controller-get : Gets detailed information about a specific software SAN controller.
===sw-controller-get===
Gets detailed information about a specific software SAN controller.


<pre> qs sw-controller-get|swc-get --sw-controller=value </pre>
<pre> qs sw-controller-get|swc-get --sw-controller=value </pre>
Line 4,439: Line 4,779:




; sw-controller-list : Returns a list of all the configured software SAN adapter/controllers (iSCSI, etc).
===sw-controller-list===
Returns a list of all the configured software SAN adapter/controllers (iSCSI, etc).


<pre> qs sw-controller-list|swc-list </pre>
<pre> qs sw-controller-list|swc-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; sw-controller-remove : Removed the specified iSCSI SAN adapter
===sw-controller-remove===
Removed the specified iSCSI SAN adapter


<pre> qs sw-controller-remove|swc-remove --sw-controller=value </pre>
<pre> qs sw-controller-remove|swc-remove --sw-controller=value </pre>
Line 4,453: Line 4,795:




; sw-controller-scan : Scans the specified iSCSI SAN adapter for iSCSI targets.
===sw-controller-scan===
Scans the specified iSCSI SAN adapter for iSCSI targets.


<pre> qs sw-controller-scan|swc-scan --sw-controller=value </pre>
<pre> qs sw-controller-scan|swc-scan --sw-controller=value </pre>
Line 4,462: Line 4,805:




; sw-controller-target : Returns the specified software controller target.
===sw-controller-target===
Returns the specified software controller target.


<pre> qs sw-controller-target|swc-target --target=value </pre>
<pre> qs sw-controller-target|swc-target --target=value </pre>
Line 4,471: Line 4,815:




; sw-controller-target-list : Returns a list of all the discovered software controller targets.
===sw-controller-target-list===
Returns a list of all the discovered software controller targets.


<pre> qs sw-controller-target-list|swc-target-list </pre>
<pre> qs sw-controller-target-list|swc-target-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; sw-controller-target-login : Logs into the specified targets on the specified iSCSI SAN adapter.
===sw-controller-target-login===
Logs into the specified targets on the specified iSCSI SAN adapter.


<pre> qs sw-controller-target-login|swc-target-login --sw-controller=value --target-list=value </pre>
<pre> qs sw-controller-target-login|swc-target-login --sw-controller=value --target-list=value </pre>
Line 4,487: Line 4,833:




; sw-controller-target-logout : Logs out of the specified targets on the specified iSCSI SAN adapter.
===sw-controller-target-logout===
Logs out of the specified targets on the specified iSCSI SAN adapter.


<pre> qs sw-controller-target-logout|swc-target-logout --sw-controller=value --target-list=value </pre>
<pre> qs sw-controller-target-logout|swc-target-logout --sw-controller=value --target-list=value </pre>
Line 4,498: Line 4,845:




; sw-disk-session : Returns the specified software disk session.
===sw-disk-session===
Returns the specified software disk session.


<pre> qs sw-disk-session|swc-session --session=value </pre>
<pre> qs sw-disk-session|swc-session --session=value </pre>
Line 4,507: Line 4,855:




; sw-disk-session-list : Returns a list of all software disk sessions.
===sw-disk-session-list===
Returns a list of all software disk sessions.


<pre> qs sw-disk-session-list|swc-session-list </pre>
<pre> qs sw-disk-session-list|swc-session-list </pre>
Line 4,514: Line 4,863:
</div>
</div>


===Object Storage Management [SWIFT]===
==Object Storage Management [SWIFT]==
Commands for object storage setup and user management within a QuantaStor managed Ceph cluster.
Commands for object storage setup and user management within a QuantaStor managed Ceph cluster.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,521: Line 4,870:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; ceph-object-pool-group-create : Creates a new Object Pool Group for the Ceph Cluster to enable S3/SWIFT object storage gateway access.
===ceph-object-pool-group-create===
Creates a new Object Pool Group for the Ceph Cluster to enable S3/SWIFT object storage gateway access.


<pre> qs ceph-object-pool-group-create|cog-create --ceph-cluster=value --name=value [--desc=value ] [--object-store-zone=value ] [--object-store-region=value ] [--sys-list=value ] [--flags=value ] </pre>
<pre> qs ceph-object-pool-group-create|cog-create --ceph-cluster=value --name=value [--desc=value ] [--object-store-zone=value ] [--object-store-region=value ] [--sys-list=value ] [--flags=value ] </pre>
Line 4,542: Line 4,892:




; ceph-object-pool-group-delete : Deletes the specified object pool group, WARNING all associated objects in the pool group will be destroyed.
===ceph-object-pool-group-delete===
Deletes the specified object pool group, WARNING all associated objects in the pool group will be destroyed.


<pre> qs ceph-object-pool-group-delete|cog-delete --ceph-object-pool-group=value [--flags=value ] </pre>
<pre> qs ceph-object-pool-group-delete|cog-delete --ceph-object-pool-group=value [--flags=value ] </pre>
Line 4,553: Line 4,904:




; ceph-object-pool-group-get : Returns information about a specific object storage pool group used to store S3/SWIFT object data.
===ceph-object-pool-group-get===
Returns information about a specific object storage pool group used to store S3/SWIFT object data.


<pre> qs ceph-object-pool-group-get|cog-get --ceph-object-pool-group=value [--flags=value ] </pre>
<pre> qs ceph-object-pool-group-get|cog-get --ceph-object-pool-group=value [--flags=value ] </pre>
Line 4,564: Line 4,916:




; ceph-object-pool-group-list : Returns a list of all the object storage pool groups.
===ceph-object-pool-group-list===
Returns a list of all the object storage pool groups.


<pre> qs ceph-object-pool-group-list|cog-list [--ceph-cluster=value ] [--flags=value ] </pre>
<pre> qs ceph-object-pool-group-list|cog-list [--ceph-cluster=value ] [--flags=value ] </pre>
Line 4,575: Line 4,928:




; ceph-user-access-entry-create : Creates a new user access key entry to allow S3/SWIFT access to the object storage group.
===ceph-user-access-entry-create===
Creates a new user access key entry to allow S3/SWIFT access to the object storage group.


<pre> qs ceph-user-access-entry-create|cu-create --ceph-cluster=value --name=value --display-name=value [--email=value ] [--s3-access-key=value ] [--s3-secret-key=value ] [--access-permission=value ] [--user=value ] [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-create|cu-create --ceph-cluster=value --name=value --display-name=value [--email=value ] [--s3-access-key=value ] [--s3-secret-key=value ] [--access-permission=value ] [--user=value ] [--flags=value ] </pre>
Line 4,600: Line 4,954:




; ceph-user-access-entry-delete : Deletes the specified SWIFT/S3 user access entry.
===ceph-user-access-entry-delete===
Deletes the specified SWIFT/S3 user access entry.


<pre> qs ceph-user-access-entry-delete|cu-delete --ceph-cluster=value --acl-entry=value [--delete-data=value ] [--key-delete=value ] [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-delete|cu-delete --ceph-cluster=value --acl-entry=value [--delete-data=value ] [--key-delete=value ] [--flags=value ] </pre>
Line 4,617: Line 4,972:




; ceph-user-access-entry-disable : Disable a previously active/enabled SWIFT/S3 user access entry.
===ceph-user-access-entry-disable===
Disable a previously active/enabled SWIFT/S3 user access entry.


<pre> qs ceph-user-access-entry-disable|cu-disable --acl-entry=value [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-disable|cu-disable --acl-entry=value [--flags=value ] </pre>
Line 4,628: Line 4,984:




; ceph-user-access-entry-enable : Enable a previously suspended SWIFT/S3 user access entry.
===ceph-user-access-entry-enable===
Enable a previously suspended SWIFT/S3 user access entry.


<pre> qs ceph-user-access-entry-enable|cu-enable --acl-entry=value [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-enable|cu-enable --acl-entry=value [--flags=value ] </pre>
Line 4,639: Line 4,996:




; ceph-user-access-entry-get : Returns information about a specific object storage S3/SWIFT user access entry.
===ceph-user-access-entry-get===
Returns information about a specific object storage S3/SWIFT user access entry.


<pre> qs ceph-user-access-entry-get|cu-get --acl-entry=value [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-get|cu-get --acl-entry=value [--flags=value ] </pre>
Line 4,650: Line 5,008:




; ceph-user-access-entry-list : Returns a list of all the Ceph Object storage user access entries / keys
===ceph-user-access-entry-list===
Returns a list of all the Ceph Object storage user access entries / keys


<pre> qs ceph-user-access-entry-list|cu-list --ceph-cluster=value [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-list|cu-list --ceph-cluster=value [--flags=value ] </pre>
Line 4,661: Line 5,020:




; ceph-user-access-entry-modify : Modifies the name and permissions for a object user access S3/SWIFT entry.
===ceph-user-access-entry-modify===
Modifies the name and permissions for a object user access S3/SWIFT entry.


<pre> qs ceph-user-access-entry-modify|cu-modify --ceph-cluster=value --acl-entry=value [--display-name=value ] [--email=value ] [--s3-access-key=value ] [--s3-secret-key=value ] [--swift-secret-key=value ] [--user=value ] [--flags=value ] </pre>
<pre> qs ceph-user-access-entry-modify|cu-modify --ceph-cluster=value --acl-entry=value [--display-name=value ] [--email=value ] [--s3-access-key=value ] [--s3-secret-key=value ] [--swift-secret-key=value ] [--user=value ] [--flags=value ] </pre>
Line 4,688: Line 5,048:
</div>
</div>


===Storage System Management [SYSTEM]===
==Storage System Management [SYSTEM]==
Commands for managing all the appliance centric settings including NTP, DNS servers, hostname, ARP policies, system restart, shutdown and more.
Commands for managing all the appliance centric settings including NTP, DNS servers, hostname, ARP policies, system restart, shutdown and more.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,695: Line 5,055:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; system-get : Get general information about the storage system.
===system-get===
Get general information about the storage system.


<pre> qs system-get|sys-get [--storage-system=value ] </pre>
<pre> qs system-get|sys-get [--storage-system=value ] </pre>
Line 4,704: Line 5,065:




; system-list : Returns a list of all the managed storage systems. This is always a single system unless the system is a member of a management grid.
===system-list===
Returns a list of all the managed storage systems. This is always a single system unless the system is a member of a management grid.


<pre> qs system-list|sys-list </pre>
<pre> qs system-list|sys-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; system-metadata-recovery-point-list : Returns a list of all the available system metadata recovery points.  Recovery points allow you to restore system information such as network, host, users, and other system information from a prior automatic backup.
===system-metadata-recovery-point-list===
Returns a list of all the available system metadata recovery points.  Recovery points allow you to restore system information such as network, host, users, and other system information from a prior automatic backup.


<pre> qs system-metadata-recovery-point-list|smrp-list [--storage-system=value ] </pre>
<pre> qs system-metadata-recovery-point-list|smrp-list [--storage-system=value ] </pre>
Line 4,718: Line 5,081:




; system-modify : Modifies the name and/or description of the storage system.
===system-modify===
Modifies the name and/or description of the storage system.


<pre> qs system-modify|sys-modify [--storage-system=value ] [--name=value ] [--desc=value ] [--location=value ] [--domain=value ] [--search=value ] [--arp-filter-mode=value ] [--bond-mode=value ] [--ext-hostname=value ] [--grid-port=value ] [--ntp-servers=value ] [--dns-servers=value ] [--flags=value ] </pre>
<pre> qs system-modify|sys-modify [--storage-system=value ] [--name=value ] [--desc=value ] [--location=value ] [--domain=value ] [--search=value ] [--arp-filter-mode=value ] [--bond-mode=value ] [--ext-hostname=value ] [--grid-port=value ] [--ntp-servers=value ] [--dns-servers=value ] [--flags=value ] </pre>
Line 4,751: Line 5,115:




; system-platform-event : Signal the service with an event.
===system-platform-event===
Signal the service with an event.


<pre> qs system-platform-event|sys-pe --event-type=value --event-message=value </pre>
<pre> qs system-platform-event|sys-pe --event-type=value --event-message=value </pre>
Line 4,762: Line 5,127:




; system-restart : Restarts the entire storage system.
===system-restart===
Restarts the entire storage system.


<pre> qs system-restart|restart [--storage-system=value ] [--flags=value ] </pre>
<pre> qs system-restart|restart [--storage-system=value ] [--flags=value ] </pre>
Line 4,773: Line 5,139:




; system-shutdown : Shutdown the storage system.
===system-shutdown===
Shutdown the storage system.


<pre> qs system-shutdown|shutdown [--storage-system=value ] [--service-only=value ] [--flags=value ] </pre>
<pre> qs system-shutdown|shutdown [--storage-system=value ] [--service-only=value ] [--flags=value ] </pre>
Line 4,786: Line 5,153:




; system-upgrade : Upgrade to the latest version of the core packages.
===system-upgrade===
Upgrade to the latest version of the core packages.


<pre> qs system-upgrade|upgrade [--storage-system=value ] [--flags=value ] </pre>
<pre> qs system-upgrade|upgrade [--storage-system=value ] [--flags=value ] </pre>
Line 4,797: Line 5,165:




; timezone-list : Lists all the available time zones from the system time zone table.
===timezone-list===
Lists all the available time zones from the system time zone table.


<pre> qs timezone-list|tz-list [--storage-system=value ] [--search-filter=value ] </pre>
<pre> qs timezone-list|tz-list [--storage-system=value ] [--search-filter=value ] </pre>
Line 4,808: Line 5,177:




; timezone-set : Sets the time zone for the specified storage appliance.
===timezone-set===
Sets the time zone for the specified storage appliance.


<pre> qs timezone-set|tz-set --timezone=value [--storage-system=value ] </pre>
<pre> qs timezone-set|tz-set --timezone=value [--storage-system=value ] </pre>
Line 4,821: Line 5,191:
</div>
</div>


===Storage System Replication Link Management [SYSTEM-LINK]===
==Storage System Replication Link Management [SYSTEM-LINK]==
Storage System Links are a required prerequisite before remote-replication and replication schedules can be formed to move data between any given pair of appliances in a grid.
Storage System Links are a required prerequisite before remote-replication and replication schedules can be formed to move data between any given pair of appliances in a grid.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,828: Line 5,198:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; link-create : Create a new storage system link so that storage volumes may be replicated between storage systems.
===link-create===
Create a new storage system link so that storage volumes may be replicated between storage systems.


<pre> qs link-create|sl-create --storage-system=value --remote-system=value --local-ip=value --remote-ip=value [--bw-limit=value ] [--link-type=value ] [--desc=value ] </pre>
<pre> qs link-create|sl-create --storage-system=value --remote-system=value --local-ip=value --remote-ip=value [--bw-limit=value ] [--link-type=value ] [--desc=value ] </pre>
Line 4,849: Line 5,220:




; link-delete : Delete an existing storage system link.
===link-delete===
Delete an existing storage system link.


<pre> qs link-delete|sl-delete --link=value </pre>
<pre> qs link-delete|sl-delete --link=value </pre>
Line 4,858: Line 5,230:




; link-get : Get information about the storage system link.
===link-get===
Get information about the storage system link.


<pre> qs link-get|sl-get --link=value </pre>
<pre> qs link-get|sl-get --link=value </pre>
Line 4,867: Line 5,240:




; link-list : List the existing storage system remote replication links.
===link-list===
List the existing storage system remote replication links.


<pre> qs link-list|sl-list </pre>
<pre> qs link-list|sl-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; link-modify : Modify the properties of the storage system link.
===link-modify===
Modify the properties of the storage system link.


<pre> qs link-modify|sl-modify --link=value --remote-ip=value [--local-ip=value ] [--desc=value ] [--bw-limit=value ] [--link-type=value ] </pre>
<pre> qs link-modify|sl-modify --link=value --remote-ip=value [--local-ip=value ] [--desc=value ] [--bw-limit=value ] [--link-type=value ] </pre>
Line 4,893: Line 5,268:
</div>
</div>


===Tag/Object Property Management [TAG]===
==Tag/Object Property Management [TAG]==
Feature which allows any object within the QuantaStor system to be tagged with user custom properties (key/value pairs).  Tagging is often used to facilitate multi-tenancy deployments by applying tags containing unique IDs which identify users, customers, account, tenants and more.
Feature which allows any object within the QuantaStor system to be tagged with user custom properties (key/value pairs).  Tagging is often used to facilitate multi-tenancy deployments by applying tags containing unique IDs which identify users, customers, account, tenants and more.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,900: Line 5,275:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; tag-get : Returns information on a specific tag on a specific object.
===tag-get===
Returns information on a specific tag on a specific object.


<pre> qs tag-get|prop-get --object-id=value --tag=value </pre>
<pre> qs tag-get|prop-get --object-id=value --tag=value </pre>
Line 4,911: Line 5,287:




; tag-list : Lists all the tags for the object with the specified object UUID.
===tag-list===
Lists all the tags for the object with the specified object UUID.


<pre> qs tag-list|prop-list --object-id=value </pre>
<pre> qs tag-list|prop-list --object-id=value </pre>
Line 4,920: Line 5,297:




; tag-set : Adds a new tag/property to the specified object, use a value of hyphen '-' to clear a previously set value.
===tag-set===
Adds a new tag/property to the specified object, use a value of hyphen '-' to clear a previously set value.


<pre> qs tag-set|prop-set --object-id=value --tag=value --value=value [--value-type=value ] [--object-type=value ] </pre>
<pre> qs tag-set|prop-set --object-id=value --tag=value --value=value [--value-type=value ] [--object-type=value ] </pre>
Line 4,939: Line 5,317:
</div>
</div>


===Network Interface Management [TARGET-PORT]===
==Network Interface Management [TARGET-PORT]==
Commands for configuration, management and monitoring of network ports, teaming/bonding, VLAN configuration and more.
Commands for configuration, management and monitoring of network ports, teaming/bonding, VLAN configuration and more.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 4,946: Line 5,324:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; bonded-interface-create : Creates a bonded network interface by bonding/teaming together a group of one or more physical network ports.
===bonded-interface-create===
Creates a bonded network interface by bonding/teaming together a group of one or more physical network ports.


<pre> qs bonded-interface-create|bond-create --ip-address=value --port-list=value [--storage-system=value ] [--netmask=value ] [--gateway=value ] [--mtu=value ] [--desc=value ] [--bond-mode=value ] [--flags=value ] </pre>
<pre> qs bonded-interface-create|bond-create --ip-address=value --port-list=value [--storage-system=value ] [--netmask=value ] [--gateway=value ] [--mtu=value ] [--desc=value ] [--bond-mode=value ] [--flags=value ] </pre>
Line 4,971: Line 5,350:




; bonded-interface-delete : Deletes the specified bonded network interface.
===bonded-interface-delete===
Deletes the specified bonded network interface.


<pre> qs bonded-interface-delete|bond-delete --port=value </pre>
<pre> qs bonded-interface-delete|bond-delete --port=value </pre>
Line 4,980: Line 5,360:




; fiber-channel-port-disable : Disables the specified fiber channel port.
===fiber-channel-port-disable===
Disables the specified fiber channel port.


<pre> qs fiber-channel-port-disable|fcp-disable --port=value [--flags=value ] </pre>
<pre> qs fiber-channel-port-disable|fcp-disable --port=value [--flags=value ] </pre>
Line 4,991: Line 5,372:




; fiber-channel-port-enable : Enables the specified fiber channel port.
===fiber-channel-port-enable===
Enables the specified fiber channel port.


<pre> qs fiber-channel-port-enable|fcp-enable --port=value [--flags=value ] </pre>
<pre> qs fiber-channel-port-enable|fcp-enable --port=value [--flags=value ] </pre>
Line 5,002: Line 5,384:




; fiber-channel-port-get : Returns information about the specified fiber channel target port.
===fiber-channel-port-get===
Returns information about the specified fiber channel target port.


<pre> qs fiber-channel-port-get|fcp-get --port=value [--flags=value ] </pre>
<pre> qs fiber-channel-port-get|fcp-get --port=value [--flags=value ] </pre>
Line 5,013: Line 5,396:




; fiber-channel-port-list : Returns a list of all the fiber channel target ports in the system.
===fiber-channel-port-list===
Returns a list of all the fiber channel target ports in the system.


<pre> qs fiber-channel-port-list|fcp-list </pre>
<pre> qs fiber-channel-port-list|fcp-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; infiniband-port-get : Returns information about the specified infiniband port.
===infiniband-port-get===
Returns information about the specified infiniband port.


<pre> qs infiniband-port-get|ibp-get --port=value [--flags=value ] </pre>
<pre> qs infiniband-port-get|ibp-get --port=value [--flags=value ] </pre>
Line 5,029: Line 5,414:




; infiniband-port-list : Returns a list of all the infiniband ports in the system.
===infiniband-port-list===
Returns a list of all the infiniband ports in the system.


<pre> qs infiniband-port-list|ibp-list </pre>
<pre> qs infiniband-port-list|ibp-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; target-port-disable : Disables the specified target port.
===target-port-disable===
Disables the specified target port.


<pre> qs target-port-disable|tp-disable --port=value [--flags=value ] </pre>
<pre> qs target-port-disable|tp-disable --port=value [--flags=value ] </pre>
Line 5,045: Line 5,432:




; target-port-enable : Enables the specified target port.
===target-port-enable===
Enables the specified target port.


<pre> qs target-port-enable|tp-enable --port=value [--flags=value ] </pre>
<pre> qs target-port-enable|tp-enable --port=value [--flags=value ] </pre>
Line 5,056: Line 5,444:




; target-port-get : Returns information about the specified target port.
===target-port-get===
Returns information about the specified target port.


<pre> qs target-port-get|tp-get --port=value [--flags=value ] </pre>
<pre> qs target-port-get|tp-get --port=value [--flags=value ] </pre>
Line 5,067: Line 5,456:




; target-port-list : Returns a list of all the target ports in the system.
===target-port-list===
Returns a list of all the target ports in the system.


<pre> qs target-port-list|tp-list </pre>
<pre> qs target-port-list|tp-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; target-port-modify : Modifies target port settings including IP address, gateway, mtu, etc.
===target-port-modify===
Modifies target port settings including IP address, gateway, mtu, etc.


<pre> qs target-port-modify|tp-modify --port=value [--port-type=value ] [--ip-address=value ] [--netmask=value ] [--gateway=value ] [--mtu=value ] [--iscsi-enable=value ] [--object-gateway-enable=value ] [--desc=value ] [--float-list=value ] [--bond-mode=value ] [--flags=value ] </pre>
<pre> qs target-port-modify|tp-modify --port=value [--port-type=value ] [--ip-address=value ] [--netmask=value ] [--gateway=value ] [--mtu=value ] [--iscsi-enable=value ] [--object-gateway-enable=value ] [--desc=value ] [--float-list=value ] [--bond-mode=value ] [--flags=value ] </pre>
Line 5,103: Line 5,494:




; target-port-rescan : Discovers new target ports and/or any manual modifications made to the configuration of the target ports.
===target-port-rescan===
Discovers new target ports and/or any manual modifications made to the configuration of the target ports.


<pre> qs target-port-rescan|tp-rescan [--storage-system=value ] [--flags=value ] </pre>
<pre> qs target-port-rescan|tp-rescan [--storage-system=value ] [--flags=value ] </pre>
Line 5,114: Line 5,506:




; target-port-restart : Restarts the specified target port.
===target-port-restart===
Restarts the specified target port.


<pre> qs target-port-restart|tp-restart --port=value [--flags=value ] </pre>
<pre> qs target-port-restart|tp-restart --port=value [--flags=value ] </pre>
Line 5,125: Line 5,518:




; virtual-interface-create : Creates a new virtual network interface which is linked to a physical network port.
===virtual-interface-create===
Creates a new virtual network interface which is linked to a physical network port.


<pre> qs virtual-interface-create|vif-create --parent-port=value --ip-address=value [--storage-system=value ] [--netmask=value ] [--gateway=value ] [--float-list=value ] [--mtu=value ] [--desc=value ] [--flags=value ] </pre>
<pre> qs virtual-interface-create|vif-create --parent-port=value --ip-address=value [--storage-system=value ] [--netmask=value ] [--gateway=value ] [--float-list=value ] [--mtu=value ] [--desc=value ] [--flags=value ] </pre>
Line 5,150: Line 5,544:




; virtual-interface-delete : Deletes the specified virtual network interface.
===virtual-interface-delete===
Deletes the specified virtual network interface.


<pre> qs virtual-interface-delete|vif-delete --port=value </pre>
<pre> qs virtual-interface-delete|vif-delete --port=value </pre>
Line 5,159: Line 5,554:




; virtual-interface-move : Moves the specified virtual network interface to a different physical network port.
===virtual-interface-move===
Moves the specified virtual network interface to a different physical network port.


<pre> qs virtual-interface-move|vif-move --vif=value --port=value </pre>
<pre> qs virtual-interface-move|vif-move --vif=value --port=value </pre>
Line 5,170: Line 5,566:




; vlan-interface-create : Creates a new VLAN interface on the specified physical port.
===vlan-interface-create===
Creates a new VLAN interface on the specified physical port.


<pre> qs vlan-interface-create|vlan-create --parent-port=value --ip-address=value --vlan-id=value [--storage-system=value ] [--netmask=value ] [--gateway=value ] [--vlan-qos=value ] [--mtu=value ] [--desc=value ] [--flags=value ] </pre>
<pre> qs vlan-interface-create|vlan-create --parent-port=value --ip-address=value --vlan-id=value [--storage-system=value ] [--netmask=value ] [--gateway=value ] [--vlan-qos=value ] [--mtu=value ] [--desc=value ] [--flags=value ] </pre>
Line 5,197: Line 5,594:




; vlan-interface-delete : Deletes the specified VLAN interface.
===vlan-interface-delete===
Deletes the specified VLAN interface.


<pre> qs vlan-interface-delete|vlan-delete --port=value </pre>
<pre> qs vlan-interface-delete|vlan-delete --port=value </pre>
Line 5,208: Line 5,606:
</div>
</div>


===Task Management [TASK]===
==Task Management [TASK]==
Every configuration operation done within an appliance or across a group of appliances is represented in the system as a Task. Some long running tasks can be canceled while running and all tasks from all systems in a grid are visible and monitorable from all appliances.
Every configuration operation done within an appliance or across a group of appliances is represented in the system as a Task. Some long running tasks can be canceled while running and all tasks from all systems in a grid are visible and monitorable from all appliances.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,215: Line 5,613:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; task-cancel : Cancels the specified task that is in the queue or is running.
===task-cancel===
Cancels the specified task that is in the queue or is running.


<pre> qs task-cancel|t-cancel --task=value </pre>
<pre> qs task-cancel|t-cancel --task=value </pre>
Line 5,224: Line 5,623:




; task-clear-all : Clears all the completed and/or failed tasks from the task log so that only the running and queued tasks (if any) remain.
===task-clear-all===
Clears all the completed and/or failed tasks from the task log so that only the running and queued tasks (if any) remain.


<pre> qs task-clear-all|t-clear-all </pre>
<pre> qs task-clear-all|t-clear-all </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; task-get : Returns information about the specified task.
===task-get===
Returns information about the specified task.


<pre> qs task-get|t-get --task=value </pre>
<pre> qs task-get|t-get --task=value </pre>
Line 5,238: Line 5,639:




; task-list : Returns a list of all the tasks including active, completed, and failed tasks. Whenever you run a command in QuantaStor it is queued in the task manager and then executed automatically once the necessary resource locks are acquired. This means that you can run commands synchronously and/or asynchronously to run multiple operations concurrently. By default the CLI waits for the task to complete so it blocks by default. You can have the CLI not wait by specifying the 'async' flag to any operation. In such cases the CLI will return immediately.
===task-list===
Returns a list of all the tasks including active, completed, and failed tasks. Whenever you run a command in QuantaStor it is queued in the task manager and then executed automatically once the necessary resource locks are acquired. This means that you can run commands synchronously and/or asynchronously to run multiple operations concurrently. By default the CLI waits for the task to complete so it blocks by default. You can have the CLI not wait by specifying the 'async' flag to any operation. In such cases the CLI will return immediately.


<pre> qs task-list|t-list [--filtered=value ] </pre>
<pre> qs task-list|t-list [--filtered=value ] </pre>
Line 5,247: Line 5,649:




; task-proceed : Some tasks (e.g., volume-snapshot) can wait for a signal part-way through the task before proceeding.  In the case of volume snapshot tasks this can be used to shorten the snapshot quiesce window.
===task-proceed===
Some tasks (e.g., volume-snapshot) can wait for a signal part-way through the task before proceeding.  In the case of volume snapshot tasks this can be used to shorten the snapshot quiesce window.


<pre> qs task-proceed|t-proceed --task=value [--wait-for-signal=value ] </pre>
<pre> qs task-proceed|t-proceed --task=value [--wait-for-signal=value ] </pre>
Line 5,260: Line 5,663:
</div>
</div>


===Trace Level Management [TRACE-LEVEL]===
==Trace Level Management [TRACE-LEVEL]==
Debugging facility used to increase the amount of information sent to the /var/log/qs_service.log
Debugging facility used to increase the amount of information sent to the /var/log/qs_service.log
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,267: Line 5,670:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; trace-level-get : Get the current trace level that is being used for logging.
===trace-level-get===
Get the current trace level that is being used for logging.


<pre> qs trace-level-get|tl-get </pre>
<pre> qs trace-level-get|tl-get </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; trace-level-modify : Modify the current parameters used for logging.
===trace-level-modify===
Modify the current parameters used for logging.


<pre> qs trace-level-modify|tl-modify [--trace-level=value ] [--stdout=value ] [--trace-filter=value ] [--trace-options=value ] </pre>
<pre> qs trace-level-modify|tl-modify [--trace-level=value ] [--stdout=value ] [--trace-filter=value ] [--trace-options=value ] </pre>
Line 5,289: Line 5,694:
</div>
</div>


===User Management [USER]===
==User Management [USER]==
User management within an appliance is used both to facilitate access to appliance management operations as well as to create local user accounts to provide SMB access to Network Shares. Use the System Monitor role to limit users so that they cannot change the configuration of any aspect of the system except their own password.
User management within an appliance is used both to facilitate access to appliance management operations as well as to create local user accounts to provide SMB access to Network Shares. Use the System Monitor role to limit users so that they cannot change the configuration of any aspect of the system except their own password.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,296: Line 5,701:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; user-add : Adds a new user account to the system.  A matching console level account is created on all grid nodes but by default SSH access is not allowed. Rather, management accounts do allow the use of qs CLI commands and QuantaStor web management interface access as per the limits of the assigned user role.
===user-add===
Adds a new user account to the system.  A matching console level account is created on all grid nodes but by default SSH access is not allowed. Rather, management accounts do allow the use of qs CLI commands and QuantaStor web management interface access as per the limits of the assigned user role.


<pre> qs user-add|u-add --name=value --password=value --role=value [--first-name=value ] [--last-name=value ] [--email=value ] [--desc=value ] [--default-chap-user=value ] [--default-chap-pass=value ] [--alerts=value ] </pre>
<pre> qs user-add|u-add --name=value --password=value --role=value [--first-name=value ] [--last-name=value ] [--email=value ] [--desc=value ] [--default-chap-user=value ] [--default-chap-pass=value ] [--alerts=value ] </pre>
Line 5,323: Line 5,729:




; user-get : Gets information about the specified user.
===user-get===
Gets information about the specified user.


<pre> qs user-get|u-get --user=value </pre>
<pre> qs user-get|u-get --user=value </pre>
Line 5,332: Line 5,739:




; user-list : Returns a list of all the users.
===user-list===
Returns a list of all the users.


<pre> qs user-list|u-list </pre>
<pre> qs user-list|u-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; user-modify : Modifies the specified user name, role, and/or description.
===user-modify===
Modifies the specified user name, role, and/or description.


<pre> qs user-modify|u-modify --user=value [--role=value ] [--desc=value ] [--default-chap-user=value ] [--default-chap-pass=value ] [--lock-account=value ] [--alerts=value ] </pre>
<pre> qs user-modify|u-modify --user=value [--role=value ] [--desc=value ] [--default-chap-user=value ] [--default-chap-pass=value ] [--lock-account=value ] [--alerts=value ] </pre>
Line 5,358: Line 5,767:




; user-password-set : Changes the password for the specified user
===user-password-set===
Changes the password for the specified user


<pre> qs user-password-set|passwd --user=value --new-password=value [--old-password=value ] </pre>
<pre> qs user-password-set|passwd --user=value --new-password=value [--old-password=value ] </pre>
Line 5,371: Line 5,781:




; user-remove : Removes the specified user identified by name or ID.
===user-remove===
Removes the specified user identified by name or ID.


<pre> qs user-remove|u-remove --user=value </pre>
<pre> qs user-remove|u-remove --user=value </pre>
Line 5,382: Line 5,793:
</div>
</div>


===User Group Management [USER-GROUP]===
==User Group Management [USER-GROUP]==
Users can be grouped together to simplify management of Resource Groups.
Users can be grouped together to simplify management of Resource Groups.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,389: Line 5,800:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; user-group-create : Creates a new storage user group comprised of the specified users.
===user-group-create===
Creates a new storage user group comprised of the specified users.


<pre> qs user-group-create|ug-create --name=value --user-list=value [--desc=value ] [--flags=value ] </pre>
<pre> qs user-group-create|ug-create --name=value --user-list=value [--desc=value ] [--flags=value ] </pre>
Line 5,404: Line 5,816:




; user-group-delete : Deletes a storage user group, the users are not deleted unless the delete-users flag is set.
===user-group-delete===
Deletes a storage user group, the users are not deleted unless the delete-users flag is set.


<pre> qs user-group-delete|ug-delete --user-group=value [--flags=value ] </pre>
<pre> qs user-group-delete|ug-delete --user-group=value [--flags=value ] </pre>
Line 5,415: Line 5,828:




; user-group-get : Returns information about a specific storage user group.
===user-group-get===
Returns information about a specific storage user group.


<pre> qs user-group-get|ug-get --user-group=value </pre>
<pre> qs user-group-get|ug-get --user-group=value </pre>
Line 5,424: Line 5,838:




; user-group-list : Returns a list of all the storage user groups.
===user-group-list===
Returns a list of all the storage user groups.


<pre> qs user-group-list|ug-list </pre>
<pre> qs user-group-list|ug-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; user-group-modify : Modifies the name and/or description of a storage user group.
===user-group-modify===
Modifies the name and/or description of a storage user group.


<pre> qs user-group-modify|ug-modify --user-group=value [--name=value ] [--desc=value ] </pre>
<pre> qs user-group-modify|ug-modify --user-group=value [--name=value ] [--desc=value ] </pre>
Line 5,442: Line 5,858:




; user-group-user-add : Adds one or more users to the specified user group.
===user-group-user-add===
Adds one or more users to the specified user group.


<pre> qs user-group-user-add|ugu-add --user-group=value --user-list=value </pre>
<pre> qs user-group-user-add|ugu-add --user-group=value --user-list=value </pre>
Line 5,453: Line 5,870:




; user-group-user-remove : Removes one or more users from the specified user group
===user-group-user-remove===
Removes one or more users from the specified user group


<pre> qs user-group-user-remove|ugu-remove --user-group=value --user-list=value </pre>
<pre> qs user-group-user-remove|ugu-remove --user-group=value --user-list=value </pre>
Line 5,466: Line 5,884:
</div>
</div>


===Storage Volume Management [VOLUME]===
==Storage Volume Management [VOLUME]==
Commands for the management of Storage Volumes which are block devices which can be presented to Hosts via the iSCSI and/or FC protocols.
Commands for the management of Storage Volumes which are block devices which can be presented to Hosts via the iSCSI and/or FC protocols.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,473: Line 5,891:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; volume-clone : Creates a complete block copy of the source volume.
===volume-clone===
Creates a complete block copy of the source volume.


<pre> qs volume-clone|v-clone --volume=value [--pool=value ] [--name=value ] [--desc=value ] [--access-mode=value ] [--flags=value ] </pre>
<pre> qs volume-clone|v-clone --volume=value [--pool=value ] [--name=value ] [--desc=value ] [--access-mode=value ] [--flags=value ] </pre>
Line 5,492: Line 5,911:




; volume-create : Creates a new storage volume in the specified storage pool.
===volume-create===
Creates a new storage volume in the specified storage pool.


<pre> qs volume-create|v-create --name=value --size=value --pool=value [--desc=value ] [--percent-reserved=value ] [--access-mode=value ] [--chap-policy=value ] [--chap-user=value ] [--chap-pass=value ] [--count=value ] [--blocksize=value ] [--qos-policy=value ] [--thin=value ] [--flags=value ] </pre>
<pre> qs volume-create|v-create --name=value --size=value --pool=value [--desc=value ] [--percent-reserved=value ] [--access-mode=value ] [--chap-policy=value ] [--chap-user=value ] [--chap-pass=value ] [--count=value ] [--blocksize=value ] [--qos-policy=value ] [--thin=value ] [--flags=value ] </pre>
Line 5,527: Line 5,947:




; volume-delete : Deletes a storage volume, *WARNING* any data in the volume will be lost.
===volume-delete===
Deletes a storage volume, *WARNING* any data in the volume will be lost.


<pre> qs volume-delete|v-delete --volume=value [--flags=value ] </pre>
<pre> qs volume-delete|v-delete --volume=value [--flags=value ] </pre>
Line 5,538: Line 5,959:




; volume-get : Returns information about a specific storage volume.
===volume-get===
Returns information about a specific storage volume.


<pre> qs volume-get|v-get --volume=value </pre>
<pre> qs volume-get|v-get --volume=value </pre>
Line 5,547: Line 5,969:




; volume-list : Returns a list of all the storage volumes.
===volume-list===
Returns a list of all the storage volumes.


<pre> qs volume-list|v-list </pre>
<pre> qs volume-list|v-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; volume-modify : Modifies a the name, description or other properties of the storage volume.
===volume-modify===
Modifies a the name, description or other properties of the storage volume.


<pre> qs volume-modify|v-modify --volume=value [--name=value ] [--desc=value ] [--access-mode=value ] [--flags=value ] [--chap-policy=value ] [--chap-user=value ] [--chap-pass=value ] [--clear-snap-flag=value ] [--enable-wb-cache=value ] [--is-active-checkpoint=value ] [--sync=value ] [--compression-type=value ] [--copies=value ] [--qos-policy=value ] [--reserved=value ] </pre>
<pre> qs volume-modify|v-modify --volume=value [--name=value ] [--desc=value ] [--access-mode=value ] [--flags=value ] [--chap-policy=value ] [--chap-user=value ] [--chap-pass=value ] [--clear-snap-flag=value ] [--enable-wb-cache=value ] [--is-active-checkpoint=value ] [--sync=value ] [--compression-type=value ] [--copies=value ] [--qos-policy=value ] [--reserved=value ] </pre>
Line 5,591: Line 6,015:




; volume-reassign-schedule : Reassigns the created by ownership for a volume and optionally it's GMT snapshots to a new replication schedule so that they can be automatically cleaned up by the new schedule.
===volume-reassign-schedule===
Reassigns the created by ownership for a volume and optionally it's GMT snapshots to a new replication schedule so that they can be automatically cleaned up by the new schedule.


<pre> qs volume-reassign-schedule|v-reassign-schedule --volume=value --schedule=value [--recursive=value ] [--flags=value ] </pre>
<pre> qs volume-reassign-schedule|v-reassign-schedule --volume=value --schedule=value [--recursive=value ] [--flags=value ] </pre>
Line 5,606: Line 6,031:




; volume-resize : Re-sizes a storage volume to make it larger, volumes cannot be reduced in size.
===volume-resize===
Re-sizes a storage volume to make it larger, volumes cannot be reduced in size.


<pre> qs volume-resize|v-resize --volume=value --new-size=value [--flags=value ] </pre>
<pre> qs volume-resize|v-resize --volume=value --new-size=value [--flags=value ] </pre>
Line 5,619: Line 6,045:




; volume-restore : Restores a storage volume to a previous point in time using a previously created snapshot. The volume restore process uses a full copy technique which is much slower than the Volume Rollback operation but works with any point-in-time snapshot.
===volume-restore===
Restores a storage volume to a previous point in time using a previously created snapshot. The volume restore process uses a full copy technique which is much slower than the Volume Rollback operation but works with any point-in-time snapshot.


<pre> qs volume-restore|v-restore --volume=value --snapshot=value [--flags=value ] </pre>
<pre> qs volume-restore|v-restore --volume=value --snapshot=value [--flags=value ] </pre>
Line 5,632: Line 6,059:




; volume-rollback : Does an instant rollback of a storage volume to a previous point-in-time using the most recently created snapshot volume. Rollback only works with the most recently created snapshot. To rollback using an earlier snapshot, all snapshots that were created after the snapshot to be used for rollback must be deleted.  For example, volume V1 with snapshots Vt1, Vt2, Vt3 only Vt3 can be used for rollback. To use Vt1 for rollback Vt2 and Vt3 must be deleted first.
===volume-rollback===
Does an instant rollback of a storage volume to a previous point-in-time using the most recently created snapshot volume. Rollback only works with the most recently created snapshot. To rollback using an earlier snapshot, all snapshots that were created after the snapshot to be used for rollback must be deleted.  For example, volume V1 with snapshots Vt1, Vt2, Vt3 only Vt3 can be used for rollback. To use Vt1 for rollback Vt2 and Vt3 must be deleted first.


<pre> qs volume-rollback|v-rollback --volume=value --snapshot=value [--flags=value ] </pre>
<pre> qs volume-rollback|v-rollback --volume=value --snapshot=value [--flags=value ] </pre>
Line 5,645: Line 6,073:




; volume-set-qos : Sets quality of service (QoS) performance maximums for IOPS and bandwidth for the specified storage volume.
===volume-set-qos===
Sets quality of service (QoS) performance maximums for IOPS and bandwidth for the specified storage volume.


<pre> qs volume-set-qos|v-qos --volume=value [--iops-read=value ] [--iops-write=value ] [--bw-read=value ] [--bw-write=value ] [--qos-policy=value ] [--flags=value ] </pre>
<pre> qs volume-set-qos|v-qos --volume=value [--iops-read=value ] [--iops-write=value ] [--bw-read=value ] [--bw-write=value ] [--qos-policy=value ] [--flags=value ] </pre>
Line 5,666: Line 6,095:




; volume-snapshot : Creates a space efficient copy of the source volume.
===volume-snapshot===
Creates a space efficient copy of the source volume.


<pre> qs volume-snapshot|v-snap --volume=value [--name=value ] [--desc=value ] [--access-mode=value ] [--count=value ] [--lazy-clone=value ] [--wait-for-signal=value ] [--flags=value ] </pre>
<pre> qs volume-snapshot|v-snap --volume=value [--name=value ] [--desc=value ] [--access-mode=value ] [--count=value ] [--lazy-clone=value ] [--wait-for-signal=value ] [--flags=value ] </pre>
Line 5,689: Line 6,119:




; volume-utilization-get : Returns a specific volume utilization metrics for a single volume and specific date.
===volume-utilization-get===
Returns a specific volume utilization metrics for a single volume and specific date.


<pre> qs volume-utilization-get|vu-get --entry=value </pre>
<pre> qs volume-utilization-get|vu-get --entry=value </pre>
Line 5,698: Line 6,129:




; volume-utilization-list : Returns volume utilization information for a specific storage volume or all storage volumes if no volume is specified.
===volume-utilization-list===
Returns volume utilization information for a specific storage volume or all storage volumes if no volume is specified.


<pre> qs volume-utilization-list|vu-list [--volume=value ] [--offset-days=value ] [--num-days=value ] </pre>
<pre> qs volume-utilization-list|vu-list [--volume=value ] [--offset-days=value ] [--num-days=value ] </pre>
Line 5,713: Line 6,145:
</div>
</div>


===Storage Volume Access Control (LUN Masking) [VOLUME-ACLS]===
==Storage Volume Access Control (LUN Masking) [VOLUME-ACLS]==
Volume ACLs control which Hosts have access to which Storage Volumes via block protocols like FibreChannel and iSCSI.  All Storage Volumes must be assigned before they can be accessed; volumes are never made publically accessible.
Volume ACLs control which Hosts have access to which Storage Volumes via block protocols like FibreChannel and iSCSI.  All Storage Volumes must be assigned before they can be accessed; volumes are never made publically accessible.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,720: Line 6,152:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; volume-assign : Enables access to the specific volume from the specified host.
===volume-assign===
Enables access to the specific volume from the specified host.


<pre> qs volume-assign|va-add --volume=value --host-list=value </pre>
<pre> qs volume-assign|va-add --volume=value --host-list=value </pre>
Line 5,731: Line 6,164:




; volume-assign-list : Returns a list of all the volume to host assignments, optionally filtered by host or storage volume.
===volume-assign-list===
Returns a list of all the volume to host assignments, optionally filtered by host or storage volume.


<pre> qs volume-assign-list|va-list [--volume=value ] [--host=value ] </pre>
<pre> qs volume-assign-list|va-list [--volume=value ] [--host=value ] </pre>
Line 5,742: Line 6,176:




; volume-unassign : Disables access to the specific volume from the specified host.
===volume-unassign===
Disables access to the specific volume from the specified host.


<pre> qs volume-unassign|va-remove --volume=value --host-list=value </pre>
<pre> qs volume-unassign|va-remove --volume=value --host-list=value </pre>
Line 5,753: Line 6,188:




; volume-unassign-all : Disables all access to the specified volume, host, or host group.
===volume-unassign-all===
Disables all access to the specified volume, host, or host group.


<pre> qs volume-unassign-all|va-remove-all --volume=value </pre>
<pre> qs volume-unassign-all|va-remove-all --volume=value </pre>
Line 5,762: Line 6,198:




; widget-create : Create a new widget object
===widget-create===
Create a new widget object


<pre> qs widget-create|wid-create --name=value [--flags=value ] </pre>
<pre> qs widget-create|wid-create --name=value [--flags=value ] </pre>
Line 5,775: Line 6,212:
</div>
</div>


===Storage Volume Group Management [VOLUME-GROUP]===
==Storage Volume Group Management [VOLUME-GROUP]==
Storage Volume Groups are a convience feature to grouping together Storage Volumes so that they can be snapshot as a set.
Storage Volume Groups are a convience feature to grouping together Storage Volumes so that they can be snapshot as a set.
<div class='mw-collapsible mw-collapsed'>
<div class='mw-collapsible mw-collapsed'>
Line 5,782: Line 6,219:
<div class='mw-collapsible-content'>
<div class='mw-collapsible-content'>


; volume-group-clone : Creates a complete block by block copy of all volumes in the group.
===volume-group-clone===
Creates a complete block by block copy of all volumes in the group.


<pre> qs volume-group-clone|vg-clone --volume-group=value [--pool=value ] [--name-suffix=value ] [--desc=value ] [--access-mode=value ] [--flags=value ] </pre>
<pre> qs volume-group-clone|vg-clone --volume-group=value [--pool=value ] [--name-suffix=value ] [--desc=value ] [--access-mode=value ] [--flags=value ] </pre>
Line 5,801: Line 6,239:




; volume-group-create : Creates a new storage volume group comprised of the specified storage volumes
===volume-group-create===
Creates a new storage volume group comprised of the specified storage volumes


<pre> qs volume-group-create|vg-create --name=value --volume-list=value [--desc=value ] [--flags=value ] </pre>
<pre> qs volume-group-create|vg-create --name=value --volume-list=value [--desc=value ] [--flags=value ] </pre>
Line 5,816: Line 6,255:




; volume-group-delete : Deletes a storage volume group, the volumes are not deleted unless the delete-volumes flag is set.
===volume-group-delete===
Deletes a storage volume group, the volumes are not deleted unless the delete-volumes flag is set.


<pre> qs volume-group-delete|vg-delete --volume-group=value [--destroy-volumes=value ] [--flags=value ] </pre>
<pre> qs volume-group-delete|vg-delete --volume-group=value [--destroy-volumes=value ] [--flags=value ] </pre>
Line 5,829: Line 6,269:




; volume-group-get : Returns information about a specific storage volume group.
===volume-group-get===
Returns information about a specific storage volume group.


<pre> qs volume-group-get|vg-get --volume-group=value </pre>
<pre> qs volume-group-get|vg-get --volume-group=value </pre>
Line 5,838: Line 6,279:




; volume-group-list : Returns a list of all the storage volume groups.
===volume-group-list===
Returns a list of all the storage volume groups.


<pre> qs volume-group-list|vg-list </pre>
<pre> qs volume-group-list|vg-list </pre>
{| cellspacing='0' cellpadding='5'
{| cellspacing='0' cellpadding='5'


; volume-group-modify : Modifies the name and/or description of a storage volume group.
===volume-group-modify===
Modifies the name and/or description of a storage volume group.


<pre> qs volume-group-modify|vg-modify --volume-group=value [--name=value ] [--desc=value ] </pre>
<pre> qs volume-group-modify|vg-modify --volume-group=value [--name=value ] [--desc=value ] </pre>
Line 5,856: Line 6,299:




; volume-group-snapshot : Creates a space efficient copy of all volumes in the group.
===volume-group-snapshot===
Creates a space efficient copy of all volumes in the group.


<pre> qs volume-group-snapshot|vg-snap --volume-group=value [--name-suffix=value ] [--desc=value ] [--access-mode=value ] [--count=value ] [--wait-for-signal=value ] [--flags=value ] </pre>
<pre> qs volume-group-snapshot|vg-snap --volume-group=value [--name-suffix=value ] [--desc=value ] [--access-mode=value ] [--count=value ] [--wait-for-signal=value ] [--flags=value ] </pre>
Line 5,877: Line 6,321:




; volume-group-volume-add : Adds one or more volumes to the specified volume group.
===volume-group-volume-add===
Adds one or more volumes to the specified volume group.


<pre> qs volume-group-volume-add|vgv-add --volume-group=value --volume-list=value </pre>
<pre> qs volume-group-volume-add|vgv-add --volume-group=value --volume-list=value </pre>
Line 5,888: Line 6,333:




; volume-group-volume-remove : Removes one or more volumes from the specified volume group
===volume-group-volume-remove===
Removes one or more volumes from the specified volume group


<pre> qs volume-group-volume-remove|vgv-remove --volume-group=value --volume-list=value </pre>
<pre> qs volume-group-volume-remove|vgv-remove --volume-group=value --volume-list=value </pre>

Revision as of 03:35, 19 July 2016

The QuantaStor command line interface (CLI) can be used to remotely manage your QuantaStor based systems via a Windows or Linux system, and it is also a powerful tool for scripting the configuration and provisioning of storage volumes, network shares, and other resources. The command line utility for managing your QuantaStor system is called simply 'qs'. You can run 'qs' after logging into your QuantaStor system via an SSH connection, or you can download the QuantaStor Remote CLI client installer for Windows which is available for download from the OSNEXUS web site.

How to use the CLI

QuantaStor CLI is a full featured interface into all of the QuantaStor management features and can communicates with the local core management service as well as remote storage appliances.

Authentication

It is important to note that running the qs CLI locally as root affords no additional access privileges. Each command run via the CLI must include the --server specification which includes which server and what credentials should be used to access the appliance with.

Authentication via --server Argument

All CLI commands accept the server specification argument which is of this form:

[--server=ipaddress[,username,password]]

If you do not specify a username or password it will try to use the defaults which are 'admin' and 'password'.

Authentication via QS_SERVER Environment Variable

Rather than having to specify the --server argument over and over again you can set an environment variable once then it will use this as the default appliance IP address and credentials. The form of the variable is like so:

export QS_SERVER=ipaddress[,username,password]]

Examples:

export QS_SERVER=localhost,admin,password
export QS_SERVER=10.0.5.10,admin,mypass123
export QS_SERVER=myhostname.domain.net,mike,mypass123

Authentication via .qs.cnf Configuration File

Finally, rather than using an environment variable you can also create a file in your home directory called .qs.cnf with your credentials in it. Here's an example of how to create the file:

echo "192.168.0.10,admin,password" > ~/.qs.cnf
chmod 600 ~/.qs.cnf

Usage

The general usage format for all CLI commands is as follows:

    
qs command <-mandatory-arg=val> [-optional-arg=val] [-flags=force,async,...] [-server=ipaddress[,username,password]] [-xml] [-min] 

As you read through the CLI documentation note that all arguments that are specified in angle backets <> are mandatory required arguments. Arguments in square brackets [] are optional and you'll generally see the default argument specified in the documentation. Note that the qs CLI is installed on your QuantaStor system so you can run it from there, or from a Windows system using our Remote Management CLI Installer found on the downloads page. All commands can be run against a remote QuantaStor storage system using the --server= argument as outlined above.

Note also that anytime you must specify an object argument like host= volume= share= or others you can refer to the object by name or by its unique ID (UUID). For scripting it is always best to be more exact and use the UUID but it can be a big time-saver to be able to refer to objects by name as well, hence this capability.

Output Modes

XML Output Mode

Use --xml with any command to get the results in XML. Example:

qs disk-list --server=localhost,admin,password --xml
qs volume-list --server=localhost,admin,password

Minimal Output Mode

Use --min with any list or enumeration command where you want the results in a more compact format.

Interactive Mode

You can use the qs command line utility in an interactive mode where you will not have to run it from the shell each time. To enter the interactive mode just run the CLI like so:

qs i

To exit the interactive command line mode simply press CTRL-C to exit.

Built-in CLI Help

All of the commands covered in the documentation are also documented within the command line utility itself. Simply run the CLI with the 'help' argument to get the full list of all the different CLI commands. This list is pretty long so it's often best to pipe it to more

qs help | more

.

You can also use the help system to get information on a specific command:

    qs help command=CMD-NAME

As an example you can get help on how to use the pool-create command like so:

    qs help command=pool-create

Another way to get information on a group of commands is to specify a category. Help will then be printed for all commands that have a partial name match to the category specified. For example, to see all the commands that have 'pool' in their name:

    qs help category=pool

Or to see all list or get commands:

    qs help category=list
    qs help category=get

In this way you can reduce down help results to just what you need.

Remote System Specification

You can use the CLI to manage remote QuantaStor systems, but in such cases you'll need to specify the IP address and username/password of the remote storage system using the 'server' argument.

qs command [--server=ipaddress[,username,password]] [command-args]
example: qs disk-list --server=192.168.0.88,admin,password --xml

Note that the The service specification must be comma delimited with no spaces. If no username and password are supplied the default Administrator username 'admin' and the default password 'password' will be tried.

Command Error Code Definitions

For all commands a 0 is returned for SUCCESS and a non-zero error code is returned if there is a command failure. Use the --xml mode to get verbose detail on the error. Full list of error codes are available here.

Usage Examples

It's always nice to see some common examples of how the CLI can be used so here's a number of commands so you can see the general syntax of how the CLI is used. You'll notice that sometimes we specify arguments with a single hyphen (-), other times with the double hyphen (--) and sometimes it is omitted. All three are supported. The only hard rule is that the command name must be the first argument after the 'qs' command-line utility name. After that the arguments can be specified in any order with or without hyphens.

    qs help -min
    qs pool-list
    qs volume-list -xml
    qs volume-create name=vol1 size=100G pool=pool0
    qs volume-create vol1 100G pool0 -xml --server=192.168.0.88,admin,password 

Help Commands

help
Display help for all commands. 'qs help' provides a verbose listing of all commands with their input parameters. Use 'qs help --min' for a compacted list of commands, or use 'qs help --category=<some category>' for help on aspecific category or command (for example, 'qs help --category=volume').
 qs help|h [--command=value ] [--category=value ] [--wiki=value ] [--api=value ] 
  command A specific CLI command to get detailed help with.
  category Category of commands to get help with (acl, alert, host, host-group, license, role, session, schedule, pool, quota, system, volume, volume-group, task, user, user-group).
  wiki Generates help output in a format that's importable into MediaWiki.
  api Generates help output in a parsable format for automating API.


tc-commands
List of commands for tab completion
 qs tc-commands [--command=value ] 
  command Command to show method args for.

CLI Command Reference

The following list of commands is the complete list of everything you can do from the CLI. In fact, the list of CLI commands is a pretty close 1-to-1 match with our SOAP based management interface API set. As such, anything you can do via the web management interface, you can do through the CLI, and with the XML output mode you can easily integrate your QuantaStor system with any automated provisioning system in any language. Note that we list the command names along with a short version in square brackets (ex: help [h]). If you find yourself using the CLI frequently learning the short command names can make the CLI easier to work with as it reduces the amount of typing required. For scripting, it's often better to use the long command names as it makes your script easier to read and maintain.

Alert Management [ALERT]

Alerts are generated by the system and routed to the administrators via the various call-home mechanisms which include email, SNMP, PagerDuty and custom alert handlers. Alerts include a severity, a descriptive message, and in most cases an identifier referring to the element of the system or grid that is the subject of the alert.



Backup Policy Management [BACKUP-POLICY]

Backup policies provide a mechanism for scheduling and executing automatic backups of 3rd party filers and other NFS/SMB shares in an environment directly to a Network Share.



Scale-out Object / Ceph Management [CEPH]

Commands for management, monitoring, and configuration of Ceph object clusters and associated storage.



Cloud Backup Schedule Management [CLOUD-BACKUP]

Cloud Backup schedules provide a mechanism for automatic backups of storage volumes into remote S3/SWIFT object storage.



Cloud Container Management [CLOUD-CONTAINER]

Cloud containers provide a NAS gateway mechanism to bridging S3/SWIFT cloud storage to a local Network Share within an appliance.



Storage System Grid Management [GRID]

Commands for management and formation of grids of QuantaStor appliances which simplifies management and enables advanced features including HA, DR, and scale-out configurations.



Storage Pool HA Failover Management [HA-FAILOVER]

Storage Pools based on ZFS can be made Highly-Available when formed using SAS/FC/iSCSI disks connected to two or more appliances. HA storage pools can be moved dynamically between a pair of appliances and activated HA groups will do automatic failover to ensure availability to the underlying pool and it's associated volume and shares.



Host Management [HOST]

Storage Volumes must be assigned to Host(s) before the block storage (LUNs) can be accessed. Each Host entry is identified by one or more iSCSI IQNs and/or FibreChannel WWPNs.



Host Group Management [HOST-GROUP]

Hosts can be grouped together into Host Group(s) to simplify assignment and management of Storage Volumes assigned to a cluster of hosts (eg. VMware).



Hardware RAID Management [HWRAID]

Integrated hardware management modules monitor, discover, correlate and manage all the key aspects of internal SAS HBAs and RAID Controllers.



SAS Switch Management [HWSWITCH]

DEPRECATED



License Management [LICENSE]

Commands for management of QuantaStor license keys including adding, removing and listing keys within a grid of one or more appliances.



Cloud I/O Stats Management [METRICS]

Commands for the configuration and management of Librato Metrics cloud stats collection system.



Storage Pool Management [POOL]

Storage Pools combined Physical Disks together to form fault-tolerant pools of storage that can be provisioned from. Both Storage Volumes and Network Shares are provisioned from Storage Pools where ZFS based pools are the default ans XFS based pools are used for scale-out configurations using Ceph or Gluster technology.



QoS Policy Management [QOSPOLICY]

Storage Volume access can be throttled to limit throughput independently for read and write IO in terms of MB/sec via Quality of Serivce (QoS) policies.



Resource Group Quota Management [QUOTA]

Resource Groups can have quotas associated with them to limit which pools and how much storage can be provisioned from those pools by a given group of users which are members of a Resource Group



Remote Replication Management [REPLICATION]

Remote-replication and associated replication schedules enable automatic replication to a pool of storage in a remote appliance for disaster-recovery (DR) purposes.



Resource Domain Management [RESOURCE-DOMAIN]

Resource Domains group appliances by site, building, and rack so that scale-out data distribution technologies (Ceph CRUSH, GlusterFS) can be automatically configured.



Multitenant Resource Group Management [RESOURCE-GROUP]

Resource Groups combine volumes, shares, and pools of storage together and so that they can be assigned to one more users (tenants). This facilitates multi-tenancy and delegation of common tasks like storage provisioning to end-users.



RBAC Role Management [ROLE]

Advanced Role Based Access Controls (RBAC) allow for the creation of custom roles that limit users to specific tasks and operations within a grid or Resource Group (collection of volumes, shares, and pools).



Snapshot Schedule Management [SCHEDULE]

Snapshot schedules make automatic instant point-in-time snapshots of Storage Volumes and/or Network Shares on a schedule. It is highly recommended that snapshot schedule(s) be created for all mission critical volumes and shares so that data and files can be easily recovered from a previous point in time.



iSCSI/FC Session Management [SESSION]

Commands for iSCSI/FC storage session management.



Network Share Management [SHARE]

Commands for managing Network Shares which are accessible via NFS and/or the SMB protocol.



Site Cluster Resource Management [SITE]

Configurations with floating IPs such as High-Availability pools and Gluster VIFs first require that a Site Cluster is formed. Site Clusters maintain a heart-beat and control quorum for a subset of nodes so that Virtual Interfaces can be automatically moved between nodes as necessary.



Software Controller / iSCSI SAN Adapter [SWC]

QuantaStor appliances can use iSCSI storage to form Storage Pools. To configure an appliance to automatically connect to and login to one or more storage appliances to access iSCSI block storage first add and then configure a iSCSI Software Adapter.



Storage System Management [SYSTEM]

Commands for managing all the appliance centric settings including NTP, DNS servers, hostname, ARP policies, system restart, shutdown and more.



Storage System Replication Link Management [SYSTEM-LINK]

Storage System Links are a required prerequisite before remote-replication and replication schedules can be formed to move data between any given pair of appliances in a grid.



Tag/Object Property Management [TAG]

Feature which allows any object within the QuantaStor system to be tagged with user custom properties (key/value pairs). Tagging is often used to facilitate multi-tenancy deployments by applying tags containing unique IDs which identify users, customers, account, tenants and more.



Network Interface Management [TARGET-PORT]

Commands for configuration, management and monitoring of network ports, teaming/bonding, VLAN configuration and more.



Task Management [TASK]

Every configuration operation done within an appliance or across a group of appliances is represented in the system as a Task. Some long running tasks can be canceled while running and all tasks from all systems in a grid are visible and monitorable from all appliances.



Trace Level Management [TRACE-LEVEL]

Debugging facility used to increase the amount of information sent to the /var/log/qs_service.log



User Management [USER]

User management within an appliance is used both to facilitate access to appliance management operations as well as to create local user accounts to provide SMB access to Network Shares. Use the System Monitor role to limit users so that they cannot change the configuration of any aspect of the system except their own password.



User Group Management [USER-GROUP]

Users can be grouped together to simplify management of Resource Groups.



Storage Volume Management [VOLUME]

Commands for the management of Storage Volumes which are block devices which can be presented to Hosts via the iSCSI and/or FC protocols.



Storage Volume Access Control (LUN Masking) [VOLUME-ACLS]

Volume ACLs control which Hosts have access to which Storage Volumes via block protocols like FibreChannel and iSCSI. All Storage Volumes must be assigned before they can be accessed; volumes are never made publically accessible.



Storage Volume Group Management [VOLUME-GROUP]

Storage Volume Groups are a convience feature to grouping together Storage Volumes so that they can be snapshot as a set.