+ CLI Guide Overview: Difference between revisions

From OSNEXUS Online Documentation Site
Jump to navigation Jump to search
Line 90: Line 90:
</pre>
</pre>


== Storage Volume Access Control (LUN Masking) ==
== Alert Mangement ==


=== volume-assign [va-add] ===
=== alert-clear [a-clear] ===
Enables access to the specific volume from the specified host.
Deletes the alert with the specified ID.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--id>           :: Unique identifier (GUID) for the object.
<--host-list>    :: A list of one or more hosts by name or ID.
</pre>
</pre>




=== volume-unassign [va-remove] ===
=== alert-clear-all [a-clear-all] ===
Disables access to the specific volume from the specified host.
Clears all the alerts.
 
=== alert-config-get [ac-get] ===
Alert configuration settings indicate where alert notifications should be sent.
 
=== alert-config-set [ac-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>
<pre>
<--volume>      :: Name of the storage volume or its unique ID (GUID).
[--sender-email] :: Sender email address to be used for alert emails sent from the storage
<--host-list>    :: A list of one or more hosts by name or ID.
                            system.
[--smtp-server]  :: IP Address of the SMTP service where emails should be routed through.
[--smtp-user]    :: SMTP user name to use for secure SMTP access to your SMTP server for
                            sending alert emails.
[--smtp-password] :: SMTP password to use for secure SMTP access to your SMTP server.
[--smtp-auth]    :: SMTP security mode.
[--support-email] :: Email address for local customer support.
[--freespace-warning] :: The percentage of free-space left in a pool at which a warning is sent
                            to indicate pool growth plans should be made.
[--freespace-alert] :: The percentage (default=10) of free-space left in a pool at which alerts
                            are generated.
[--freespace-critical] :: The percentage (default=5) of free-space left in a pool at which all
                            provisioning operations are blocked.
[--pagerduty-key] :: Specifies the service key to which alerts will be posted to PagerDuty. 
                            Please see www.pagerduty.com for more detail on service keys.
</pre>
</pre>




=== volume-unassign-all [va-remove-all] ===
=== alert-get [a-get] ===
Disables all access to the specified volume, host, or host group.
Gets information about a specific alert.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--id>           :: Unique identifier (GUID) for the object.
</pre>
</pre>


=== volume-assign-list [va-list] ===
Returns a list of all the volume to host assignments, optionally filtered by host or storage volume.
<pre>
[--volume]      :: Name of the storage volume or its unique ID (GUID).
[--host]        :: Name of the host or its unique ID (GUID).
</pre>
== Alert Mangement ==


=== alert-list [a-list] ===
=== alert-list [a-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.
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-get [a-get] ===
Gets information about a specific alert.
<pre>
<--id>          :: Unique identifier (GUID) for the object.
</pre>


=== alert-raise [a-raise] ===
=== alert-raise [a-raise] ===
Line 144: Line 146:




=== alert-clear [a-clear] ===
=== event-list [ev-list] ===
Deletes the alert with the specified ID.
Returns a list of all the internal events in the event queue (used for service monitoring).
<pre>
<pre>
<--id>          :: Unique identifier (GUID) for the object.
[--index]        :: Starting event index of where to begin listing events from.
[--max]          :: Maximum number of events to enumerate.
[--time-stamp]  :: Time-stamp of the service.
</pre>
</pre>




=== alert-clear-all [a-clear-all] ===
== Backup Policy Management ==
Clears all the alerts.


=== alert-config-get [ac-get] ===
=== backup-job-list [bj-list] ===
Alert configuration settings indicate where alert notifications should be sent.
Returns a list of backup jobs in the system.


=== alert-config-set [ac-set] ===
=== backup-policy-create [bp-create] ===
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.
Creates a ingest backup policy which pull data from NFS shares to the QuantaStor appliance.
<pre>
<pre>
[--sender-email] :: Sender email address to be used for alert emails sent from the storage
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            system.
                            not allowed.
[--smtp-server]  :: IP Address of the SMTP service where emails should be routed through.
<--desc>        :: A description for the object.
[--smtp-user]    :: SMTP user name to use for secure SMTP access to your SMTP server for
<--network-share> :: Name or ID of a CIFS/NFS network share.
                            sending alert emails.
<--remote-hostname> :: Name of the remote host containing NFS shares to be backed up
[--smtp-password] :: SMTP password to use for secure SMTP access to your SMTP server.
<--remote-export-path> :: Remote export path to be mounted to access the data to be backed up.
[--smtp-auth]   :: SMTP security mode.
[--remote-export-type] :: Remote mount type (currently NFS only) [*nfs]
[--support-email] :: Email address for local customer support.
[--retain-rules] :: Retention rules (atime, ctime, mtime) [atime, ctime, *mtime]
[--freespace-warning] :: The percentage of free-space left in a pool at which a warning is sent
[--policy-type] :: Backup policy type [*inbound]
                             to indicate pool growth plans should be made.
[--scan-threads] :: Number of concurrent threads for walking/scanning the specified target
[--freespace-alert] :: The percentage (default=10) of free-space left in a pool at which alerts
                             export
                             are generated.
[--hours]       :: For the specified days of the week, snapshots will be created at the
[--freespace-critical] :: The percentage (default=5) of free-space left in a pool at which all
                             specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                             provisioning operations are blocked.
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--pagerduty-key] :: Specifies the service key to which alerts will be posted to PagerDuty.
[--days]         :: The days of the week on which this schedule should create snapshots.
                             Please see www.pagerduty.com for more detail on service keys.
                             [fri, mon, sat, *sun, thu, tue, wed]
[--retain-period] :: Number of days of file history on the specified filer export to backup
[--purge-policy] :: Indicates how old files should be cleaned up / purged from the backup.  
                             [after-backup, *daily, never, weekly]
[--enabled]      :: Set to enabled to activate the backup policy.
</pre>
</pre>




=== event-list [ev-list] ===
=== backup-policy-delete [bp-delete] ===
Returns a list of all the internal events in the event queue (used for service monitoring).
Deletes the specified backup policy.
<pre>
<--policy>      :: A backup policy name or ID which is associated with a network share to
                            do ingest backups.
</pre>
 
 
=== backup-policy-disable [bp-disable] ===
Disables the specified backup policy so job are not automatically run.
<pre>
<pre>
[--index]        :: Starting event index of where to begin listing events from.
<--policy>      :: A backup policy name or ID which is associated with a network share to  
[--max]          :: Maximum number of events to enumerate.
                            do ingest backups.
[--time-stamp]  :: Time-stamp of the service.
</pre>
</pre>




== Backup Policy Management ==
=== backup-policy-enable [bp-enable] ===
Enables a backup policy that was previously disabled.
<pre>
<--policy>      :: A backup policy name or ID which is associated with a network share to
                            do ingest backups.
</pre>


=== backup-job-list [bj-list] ===
Returns a list of backup jobs in the system.


=== backup-policy-get [bp-get] ===
=== backup-policy-get [bp-get] ===
Line 204: Line 221:
Returns a list of backup policies in the system.
Returns a list of backup policies in the system.


=== backup-policy-create [bp-create] ===
=== backup-policy-modify [bp-modify] ===
Creates a ingest backup policy which pull data from NFS shares to the QuantaStor appliance.
Modifies the specified backup policy settings.
<pre>
<pre>
<--policy>      :: A backup policy name or ID which is associated with a network share to
                            do ingest backups.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
Line 223: Line 242:
[--days]        :: The days of the week on which this schedule should create snapshots.  
[--days]        :: The days of the week on which this schedule should create snapshots.  
                             [fri, mon, sat, *sun, thu, tue, wed]
                             [fri, mon, sat, *sun, thu, tue, wed]
[--retain-period] :: Number of days of file history on the specified filer export to backup
[--retain-period] :: retain-period
[--purge-policy] :: Indicates how old files should be cleaned up / purged from the backup.  
[--purge-policy] :: Indicates how old files should be cleaned up / purged from the backup.  
                             [after-backup, *daily, never, weekly]
                             [after-backup, *daily, never, weekly]
Line 230: Line 249:




=== backup-policy-modify [bp-modify] ===
=== backup-policy-trigger [bp-trigger] ===
Modifies the specified backup policy settings.
Triggers the specified backup policy which in turn starts a backup job.
<pre>
<pre>
<--policy>      :: A backup policy name or ID which is associated with a network share to  
<--policy>      :: A backup policy name or ID which is associated with a network share to  
                             do ingest backups.
                             do ingest backups.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--desc>        :: A description for the object.
<--network-share> :: Name or ID of a CIFS/NFS network share.
<--remote-hostname> :: Name of the remote host containing NFS shares to be backed up
<--remote-export-path> :: Remote export path to be mounted to access the data to be backed up.
[--remote-export-type] :: Remote mount type (currently NFS only) [*nfs]
[--retain-rules] :: Retention rules (atime, ctime, mtime) [atime, ctime, *mtime]
[--policy-type]  :: Backup policy type [*inbound]
[--scan-threads] :: Number of concurrent threads for walking/scanning the specified target
                            export
[--hours]        :: For the specified days of the week, snapshots will be created at the
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--days]        :: The days of the week on which this schedule should create snapshots.
                            [fri, mon, sat, *sun, thu, tue, wed]
[--retain-period] :: retain-period
[--purge-policy] :: Indicates how old files should be cleaned up / purged from the backup.
                            [after-backup, *daily, never, weekly]
[--enabled]      :: Set to enabled to activate the backup policy.
</pre>
</pre>




=== backup-policy-delete [bp-delete] ===
== Ceph Management ==
Deletes the specified backup policy.
 
=== ceph-block-device-get [cebd-get] ===
Gets information about a specific Ceph RDB / block device
<pre>
<pre>
<--policy>       :: A backup policy name or ID which is associated with a network share to
<--ceph-rbd>     :: Ceph RBD/Block Device name or ID
                            do ingest backups.
</pre>
</pre>




=== backup-policy-enable [bp-enable] ===
=== ceph-block-device-list [cebd-list] ===
Enables a backup policy that was previously disabled.
Returns a list of all the Ceph RDB / block devices.
 
=== ceph-cluster-get [cec-get] ===
Gets information about a specific Ceph Cluster
<pre>
<pre>
<--policy>       :: A backup policy name or ID which is associated with a network share to
<--ceph-cluster> :: Ceph Cluster name or ID, default is 'ceph'
                            do ingest backups.
</pre>
</pre>




=== backup-policy-disable [bp-disable] ===
=== ceph-cluster-list [cec-list] ===
Disables the specified backup policy so job are not automatically run.
Returns a list of all the Ceph Clusters
<pre>
<--policy>      :: A backup policy name or ID which is associated with a network share to
                            do ingest backups.
</pre>


 
=== ceph-ha-intf-get [ci-get] ===
=== backup-policy-trigger [bp-trigger] ===
Returns a list of all the Ceph HA failover interface definitions.
Triggers the specified backup policy which in turn starts a backup job.
<pre>
<pre>
<--policy>       :: A backup policy name or ID which is associated with a network share to
<--ceph-ha-interface> :: Ceph HA failover interface name, ID, or IP address
                            do ingest backups.
</pre>
</pre>




== Cloud Container Management ==
=== ceph-ha-intf-list [ci-list] ===
Gets information about a specific Ceph HA failover interface definition.


=== cloud-backup-provider-get [cbp-get] ===
=== ceph-monitor-get [cem-get] ===
Returns detailed information about the specified cloud provider.
Gets information about a specific Ceph Monitor
<pre>
<pre>
<--provider>     :: A cloud provider is a storage provider like Amazon S3 which QuantaStor
<--ceph-monitor> :: Ceph Monitor service name or ID.
                            utilizes for backup in the cloud.
</pre>
</pre>




=== cloud-backup-provider-list [cbp-list] ===
=== ceph-monitor-list [cem-list] ===
Returns the list of supported cloud providers.
Returns a list of all the Ceph Monitors


=== cloud-backup-credentials-add [cbcred-add] ===
=== ceph-osd-create [ceosd-create] ===
Adds cloud provider credentials to enable cloud backup to cloud backup containers.
Creates a new Ceph OSD on the specified storage pool
<pre>
<pre>
<--access-key>   :: The access key provided by your cloud storage provider for accessing
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             your cloud storage account.
                             not allowed.
<--secret-key>   :: The secret key provided by your cloud storage provider for accessing
<--pool>         :: Name of the storage pool or its unique ID (GUID).
                            your cloud storage account.
[--desc]        :: A description for the object.
</pre>
</pre>




=== cloud-backup-credentials-remove [cbcred-remove] ===
=== ceph-osd-delete [ceosd-delete] ===
Removes the specified cloud provider credentials
Deletes the specified Ceph OSD
<pre>
<pre>
<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With
<--ceph-osd>     :: Ceph Object Storage Daemon name or ID
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
</pre>
</pre>




=== cloud-backup-credentials-get [cbcred-get] ===
=== ceph-osd-get [ceosd-get] ===
Returns information about the specified cloud provider credential.
Gets information about a specific Ceph Object Storage Daemon.
<pre>
<pre>
<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With
<--ceph-osd>     :: Ceph Object Storage Daemon name or ID
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
</pre>
</pre>




=== cloud-backup-credentials-list [cbcred-list] ===
=== ceph-osd-list [ceosd-list] ===
Returns a list of all the cloud provider credentials in the system. Passwords are masked.
Returns a list of all the Ceph Object Storage Daemons


=== cloud-backup-container-get [cbc-get] ===
=== ceph-pool-create [cep-create] ===
Returns detailed information on a specific cloud backup container.
Creates a new Ceph pool using the specified OSDs or Storage Pools
<pre>
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up. A
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             cloud backup container is like an unlimited storage pool in the cloud.
                            not allowed.
<--pool-list>    :: List of one or more storage pools.
[--desc]        :: A description for the object.
[--placement-groups] :: Number of placement groups to assign to the Ceph pool.
[--max-replicas] :: Maximum number of replicas (redundancy level) to be created of each
                            block in the Ceph pool.
[--min-replicas] :: Minimum number of replicas to have of each block while still allowing
                            write access to the Ceph pool.
[--pool-type]    :: Type of Ceph pool, 'replica' (mirror based, default) or 'erasure' which
                             is like network RAID5.
</pre>
</pre>




=== cloud-backup-container-list [cbc-list] ===
=== ceph-pool-delete [cep-delete] ===
Returns a list of cloud backup containers in the system.
Deletes the specified Ceph pool
 
=== cloud-backup-container-create [cbc-create] ===
Creates a cloud backup container into which cloud backups of storage volumes can be made.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--ceph-pool>   :: Ceph Pool name or ID
                            not allowed.
<--desc>         :: A description for the object.
<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
<--locaiton>    :: Cloud storage provider endpoint location.
<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud
                            container.
<--enable-nfs>  :: Enable NFS sharing of the cloud container.
</pre>
</pre>




=== cloud-backup-container-delete [cbc-delete] ===
=== ceph-pool-get [cep-get] ===
Deletes the specified cloud backup container. WARNING, all data in the container will be destroyed.
Gets information about a specific Ceph storage pool.
<pre>
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A
<--ceph-pool>    :: Ceph Pool name or ID
                            cloud backup container is like an unlimited storage pool in the cloud.
</pre>
</pre>




=== cloud-backup-container-add [cbc-add] ===
=== ceph-pool-list [cep-list] ===
Returns a list of all the Ceph storage pools.
 
=== ceph-rbd-create [cebd-create] ===
Creates a new Ceph block device (RBD) in the specified Ceph pool.
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--ceph-pool>    :: ceph-pool
<--size>        :: Size may be specified in MiB, GiB, or TiB. examples: 4G, 100M, 1.4T
[--desc]        :: A description for the object.
</pre>
 
 
=== ceph-rbd-delete [cebd-delete] ===
Deletes the specified Ceph block device (RBD)
<pre>
<--ceph-rbd>    :: Ceph RBD/Block Device name or ID
</pre>
 
 
== Cloud Container Management ==
 
=== cloud-backup-container-add [cbc-add] ===
Recovers a cloud backup container that was previously removed or used with a prior installation.
Recovers a cloud backup container that was previously removed or used with a prior installation.
<pre>
<pre>
Line 380: Line 394:




=== cloud-backup-container-modify [cbc-modify] ===
=== cloud-backup-container-create [cbc-create] ===
Modifies the specified cloud backup container settings.
Creates a cloud backup container into which cloud backups of storage volumes can be made.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--desc>        :: A description for the object.
<--desc>        :: A description for the object.
<--container>   :: A cloud backup container into which storage volumes can be backed upA
<--provider-creds> :: Credentials for accessing your cloud storage provider accountWith
                             cloud backup container is like an unlimited storage pool in the cloud.
                             Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
<--locaiton>    :: Cloud storage provider endpoint location.
<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud  
<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud  
                             container.
                             container.
Line 394: Line 409:




=== cloud-backup-container-remove [cbc-remove] ===
=== cloud-backup-container-delete [cbc-delete] ===
Removes the specified cloud backup container from the system but does not delete any backup data in the cloud.
Deletes the specified cloud backup container. WARNING, all data in the container will be destroyed.
<pre>
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
Line 402: Line 417:




=== cloud-backup-container-enable [cbc-enable] ===
=== cloud-backup-container-disable [cbc-disable] ===
Enables a cloud container that was previously disabled or was inaccessible due to network connection issues.
Disables access to the specified cloud container without having to remove it.
<pre>
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
Line 410: Line 425:




=== cloud-backup-container-disable [cbc-disable] ===
=== cloud-backup-container-enable [cbc-enable] ===
Disables access to the specified cloud container without having to remove it.
Enables a cloud container that was previously disabled or was inaccessible due to network connection issues.
<pre>
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
Line 418: Line 433:




=== cloud-backup-container-repair [cbc-repair] ===
=== cloud-backup-container-get [cbc-get] ===
Repairs the specified cloud backup container.
Returns detailed information on a specific cloud backup container.
<pre>
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A  
Line 426: Line 441:




== Gluster Management ==
=== cloud-backup-container-list [cbc-list] ===
Returns a list of cloud backup containers in the system.
 
=== cloud-backup-container-modify [cbc-modify] ===
Modifies the specified cloud backup container settings.
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--desc>        :: A description for the object.
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A
                            cloud backup container is like an unlimited storage pool in the cloud.
<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud
                            container.
<--enable-nfs>  :: Enable NFS sharing of the cloud container.
</pre>


=== gluster-volume-list [gv-list] ===
Returns a list of all the Gluster volumes in the grid


=== gluster-volume-get [gv-get] ===
=== cloud-backup-container-remove [cbc-remove] ===
Gets information about the specified Gluster volume
Removes the specified cloud backup container from the system but does not delete any backup data in the cloud.
<pre>
<pre>
<--gluster-volume> :: Name or ID of the Gluster volume
<--container>   :: A cloud backup container into which storage volumes can be backed up.  A
                            cloud backup container is like an unlimited storage pool in the cloud.
</pre>
</pre>




=== gluster-brick-list [gb-list] ===
=== cloud-backup-container-repair [cbc-repair] ===
Returns a list of all the Gluster bricks
Repairs the specified cloud backup container.
<pre>
<--container>    :: A cloud backup container into which storage volumes can be backed up.  A
                            cloud backup container is like an unlimited storage pool in the cloud.
</pre>


=== gluster-brick-get [gb-get] ===
 
Gets information about a specific Gluster brick.
=== cloud-backup-credentials-add [cbcred-add] ===
Adds cloud provider credentials to enable cloud backup to cloud backup containers.
<pre>
<pre>
<--gluster-brick> :: Name or ID of a Gluster brick
<--access-key>   :: The access key provided by your cloud storage provider for accessing
                            your cloud storage account.
<--secret-key>  :: The secret key provided by your cloud storage provider for accessing
                            your cloud storage account.
</pre>
</pre>




=== gluster-peer-list [gp-list] ===
=== cloud-backup-credentials-get [cbcred-get] ===
Returns a list of all the Gluster peer systems.
Returns information about the specified cloud provider credential.
 
=== gluster-ha-intf-get [gi-get] ===
Returns a list of all the Gluster HA failover interface definitions.
<pre>
<pre>
<--ha-interface> :: High-availability interface for a specific Gluster Volume.
<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
</pre>
</pre>




=== gluster-ha-intf-list [gi-list] ===
=== cloud-backup-credentials-list [cbcred-list] ===
Gets information about a specific Gluster HA failover interface definition.
Returns a list of all the cloud provider credentials in the system. Passwords are masked.


=== gluster-peer-get [gp-get] ===
=== cloud-backup-credentials-remove [cbcred-remove] ===
Gets information about a specific Gluster peer system
Removes the specified cloud provider credentials
<pre>
<pre>
<--gluster-peer> :: Name or ID of the Gluster peer
<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
</pre>
</pre>




=== gluster-volume-create [gv-create] ===
=== cloud-backup-provider-get [cbp-get] ===
Create a new Gluster volume with new Bricks on the specified Storage Pools.
Returns detailed information about the specified cloud provider.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--provider>     :: A cloud provider is a storage provider like Amazon S3 which QuantaStor
                             not allowed.
                             utilizes for backup in the cloud.
[--desc]        :: A description for the object.
<--pool-list>    :: List of one or more storage pools.
<--replica-count> :: Number of replia copies to have of each file in the Gluster volume
<--stripe-volume> :: Enable striping of files across Gluster bricks
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== gluster-volume-delete [gv-delete] ===
=== cloud-backup-provider-list [cbp-list] ===
Deletes the specified Gluster volume.
Returns the list of supported cloud providers.
 
== Gluster Management ==
 
=== gluster-brick-get [gb-get] ===
Gets information about a specific Gluster brick.
<pre>
<pre>
<--gluster-volume> :: Name or ID of the Gluster volume
<--gluster-brick> :: Name or ID of a Gluster brick
</pre>
</pre>




=== gluster-volume-modify [gv-modify] ===
=== gluster-brick-list [gb-list] ===
Modifies the name and/or description of the specified Gluster volume.
Returns a list of all the Gluster bricks
 
=== gluster-ha-intf-get [gi-get] ===
Returns a list of all the Gluster HA failover interface definitions.
<pre>
<pre>
<--gluster-volume> :: Name or ID of the Gluster volume
<--ha-interface> :: High-availability interface for a specific Gluster Volume.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== gluster-volume-start [gv-start] ===
=== gluster-ha-intf-list [gi-list] ===
Starts the specified Gluster volume
Gets information about a specific Gluster HA failover interface definition.
<pre>
<--gluster-volume> :: Name or ID of the Gluster volume
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>


 
=== gluster-peer-get [gp-get] ===
=== gluster-volume-stop [gv-stop] ===
Gets information about a specific Gluster peer system
Stops the specified Gluster volume.
<pre>
<pre>
<--gluster-volume> :: Name or ID of the Gluster volume
<--gluster-peer> :: Name or ID of the Gluster peer
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== gluster-volume-rebalance [gv-rebalance] ===
=== gluster-peer-list [gp-list] ===
Rebalances files across the bricks in the specified Gluster volume
Returns a list of all the Gluster peer systems.
<pre>
<--gluster-volume> :: Name or ID of the Gluster volume
</pre>
 


=== gluster-volume-add-bricks [gv-add-bricks] ===
=== gluster-volume-add-bricks [gv-add-bricks] ===
Line 531: Line 555:




== Ceph Management ==
=== gluster-volume-create [gv-create] ===
 
Create a new Gluster volume with new Bricks on the specified Storage Pools.
=== ceph-block-device-get [cebd-get] ===
Gets information about a specific Ceph RDB / block device
<pre>
<pre>
<--ceph-rbd>     :: Ceph RBD/Block Device name or ID
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
</pre>
                            not allowed.
[--desc]        :: A description for the object.
<--pool-list>   :: List of one or more storage pools.
<--replica-count> :: Number of replia copies to have of each file in the Gluster volume
<--stripe-volume> :: Enable striping of files across Gluster bricks
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>




=== ceph-block-device-list [cebd-list] ===
=== gluster-volume-delete [gv-delete] ===
Returns a list of all the Ceph RDB / block devices.
Deletes the specified Gluster volume.
 
=== ceph-rbd-create [cebd-create] ===
Creates a new Ceph block device (RBD) in the specified Ceph pool.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--gluster-volume> :: Name or ID of the Gluster volume
                            not allowed.
<--ceph-pool>    :: ceph-pool
<--size>         :: Size may be specified in MiB, GiB, or TiB. examples: 4G, 100M, 1.4T
[--desc]        :: A description for the object.
</pre>
</pre>




=== ceph-rbd-delete [cebd-delete] ===
=== gluster-volume-get [gv-get] ===
Deletes the specified Ceph block device (RBD)
Gets information about the specified Gluster volume
<pre>
<pre>
<--ceph-rbd>     :: Ceph RBD/Block Device name or ID
<--gluster-volume> :: Name or ID of the Gluster volume
</pre>
</pre>




=== ceph-pool-list [cep-list] ===
=== gluster-volume-list [gv-list] ===
Returns a list of all the Ceph storage pools.
Returns a list of all the Gluster volumes in the grid


=== ceph-pool-get [cep-get] ===
=== gluster-volume-modify [gv-modify] ===
Gets information about a specific Ceph storage pool.
Modifies the name and/or description of the specified Gluster volume.
<pre>
<pre>
<--ceph-pool>   :: Ceph Pool name or ID
<--gluster-volume> :: Name or ID of the Gluster volume
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== ceph-pool-create [cep-create] ===
=== gluster-volume-rebalance [gv-rebalance] ===
Creates a new Ceph pool using the specified OSDs or Storage Pools
Rebalances files across the bricks in the specified Gluster volume
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--gluster-volume> :: Name or ID of the Gluster volume
                            not allowed.
<--pool-list>   :: List of one or more storage pools.
[--desc]        :: A description for the object.
[--placement-groups] :: Number of placement groups to assign to the Ceph pool.
[--max-replicas] :: Maximum number of replicas (redundancy level) to be created of each
                            block in the Ceph pool.
[--min-replicas] :: Minimum number of replicas to have of each block while still allowing
                            write access to the Ceph pool.
[--pool-type]    :: Type of Ceph pool, 'replica' (mirror based, default) or 'erasure' which
                            is like network RAID5.
</pre>
</pre>




=== ceph-pool-delete [cep-delete] ===
=== gluster-volume-start [gv-start] ===
Deletes the specified Ceph pool
Starts the specified Gluster volume
<pre>
<pre>
<--ceph-pool>   :: Ceph Pool name or ID
<--gluster-volume> :: Name or ID of the Gluster volume
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== ceph-ha-intf-get [ci-get] ===
=== gluster-volume-stop [gv-stop] ===
Returns a list of all the Ceph HA failover interface definitions.
Stops the specified Gluster volume.
<pre>
<pre>
<--ceph-ha-interface> :: Ceph HA failover interface name, ID, or IP address
<--gluster-volume> :: Name or ID of the Gluster volume
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== ceph-ha-intf-list [ci-list] ===
== Storage System Grid Management ==
Gets information about a specific Ceph HA failover interface definition.
 
=== grid-add [mg-add] ===
Adds the specified storage system to the management grid.
<pre>
<--node-ipaddress> :: IP address of a storage system node.
[--node-username] :: Admin user account with permissions to add/remove nodes from the grid.
[--node-password] :: Admin user account password.
</pre>


=== ceph-osd-list [ceosd-list] ===
Returns a list of all the Ceph Object Storage Daemons


=== ceph-osd-get [ceosd-get] ===
=== grid-assoc-get [mg-aget] ===
Gets information about a specific Ceph Object Storage Daemon.
Get general information about the associated storage system management grid.
<pre>
<pre>
<--ceph-osd>     :: Ceph Object Storage Daemon name or ID
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--storage-system> :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== ceph-osd-create [ceosd-create] ===
=== grid-assoc-list [mg-alist] ===
Creates a new Ceph OSD on the specified storage pool
Returns a list of the associated storage system nodes in the grid.
 
=== grid-create [mg-create] ===
Creates a new management grid.  A given storage system can only be a member of one grid at a time.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--vif-enable]  :: Enables the use of a virtual interface for grid management.
[--vif-ipaddress] :: Virtual host IP address to be associated with the master node in a the
                            management grid.
[--vif-netmask]  :: Virtual host netmask to be used with the specified IP address.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--vif-hostname] :: Cluster virtual host name to be associated with the master node in the
                            management grid
[--port]        :: Default physical target port to associate the management grid virtual
                            host IP address with.
[--bind-port]    :: This is the network address to bind with the Corosync cluster.
[--grid-num]    :: Defaults to zero (0), increment this to a unique value between 0-9 if
                            you have more than one grid on your network.
</pre>
</pre>




=== ceph-osd-delete [ceosd-delete] ===
=== grid-delete [mg-delete] ===
Deletes the specified Ceph OSD
Deletes the management grid.  After the grid is deleted each node in the grid operates independently again.
<pre>
 
<--ceph-osd>    :: Ceph Object Storage Daemon name or ID
=== grid-get [mg-get] ===
</pre>
Get general information about the storage system management grid.


=== grid-get-hosts [mg-get-hosts] ===
Returns the /etc/hosts configuration file configuration for grid nodes.


=== ceph-monitor-get [cem-get] ===
=== grid-modify [mg-modify] ===
Gets information about a specific Ceph Monitor
Modify the management grid properties.
<pre>
<pre>
<--ceph-monitor> :: Ceph Monitor service name or ID.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--vif-enable]  :: Enables the use of a virtual interface for grid management.
[--vif-ipaddress] :: Virtual host IP address to be associated with the master node in a the
                            management grid.
[--vif-netmask]  :: Virtual host netmask to be used with the specified IP address.
[--desc]        :: A description for the object.
[--vif-hostname] :: Cluster virtual host name to be associated with the master node in the
                            management grid
[--port]        :: Default physical target port to associate the management grid virtual
                            host IP address with.
[--bind-port]    :: This is the network address to bind with the Corosync cluster.
[--grid-num]    :: Defaults to zero (0), increment this to a unique value between 0-9 if
                            you have more than one grid on your network.
</pre>
</pre>




=== ceph-monitor-list [cem-list] ===
=== grid-remove [mg-remove] ===
Returns a list of all the Ceph Monitors
Removes the specified storage system from the management grid.
 
=== ceph-cluster-get [cec-get] ===
Gets information about a specific Ceph Cluster
<pre>
<pre>
<--ceph-cluster> :: Ceph Cluster name or ID, default is 'ceph'
<--storage-system> :: Name or ID of a storage system in a management grid.
</pre>
</pre>




=== ceph-cluster-list [cec-list] ===
=== grid-set-hosts [mg-set-hosts] ===
Returns a list of all the Ceph Clusters
Configures the /etc/hosts configuration file on all systems to facilitate host name based gluster volume configurations.
<pre>
<--portid-list>  :: List of UUIDs for the ethernet ports to be used for grid wide /etc/hosts
                            file configuration.
</pre>


== Host Mangement ==


=== host-add [h-add] ===
=== grid-set-master [mg-set] ===
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.
Sets the master node for a storage system.
<pre>
<pre>
<--hostname>     :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--storage-system> :: Name or ID of a storage system in a management grid.
                            not allowed.
[--iqn]          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
[--ip-address]  :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--desc]        :: A description for the object.
[--username]    :: Administrator user name for the host, typically 'Administrator' for
                            Windows hosts.
[--password]    :: Administrator password for the host; enables auto-configuration of  
                            host's iSCSI initiator.
[--host-type]    :: Operating system type of the host. [aix, hpux, linux, other, solaris,
                            vmware, *windows, xenserver]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== host-modify [h-modify] ===
== Storage Pool HA Failover Management ==
Modifies a host.
 
=== ha-group-activate [hag-activate] ===
Activates/enables the specified high-availability group to failover can occur on a system outage.
<pre>
<pre>
<--host>         :: Name of the host or its unique ID (GUID).
<--ha-group>     :: Name or UUID of a storage pool high-availability group
[--desc]        :: A description for the object.
</pre>
[--ip-address]  :: IP Address of the host being added; if unspecified the service will look
 
                             it up.
 
[--username]    :: Administrator user name for the host, typically 'Administrator' for
=== ha-group-create [hag-create] ===
                            Windows hosts.
Creates a new storage pool high-availability group.
[--password]    :: Administrator password for the host; enables auto-configuration of
<pre>
                            host's iSCSI initiator.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
[--host-type]   :: Operating system type of the host. [aix, hpux, linux, other, solaris,
                             not allowed.
                            vmware, *windows, xenserver]
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--flags]       :: Optional flags for the operation. [async]
<--sys-secondary> :: Storage system associated with the failover group secondary node
[--sys-primary] :: Storage system associated with the failover group primary node
[--desc]         :: A description for the object.
[--ha-module]   :: Name or UUID of a storage pool high-availability module
</pre>
</pre>




=== host-remove [h-remove] ===
=== ha-group-deactivate [hag-deactivate] ===
Removes the specified host, *WARNING* host's active iSCSI sessions will be dropped.
Deactivates the specified high-availability group so that failover policies are disabled.
<pre>
<pre>
<--host>         :: Name of the host or its unique ID (GUID).
<--ha-group>     :: Name or UUID of a storage pool high-availability group
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== host-list [h-list] ===
=== ha-group-delete [hag-delete] ===
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.
Deletes the specified high-availability group
 
=== host-get [h-get] ===
Gets information about a specific host.
<pre>
<pre>
<--host>         :: Name of the host or its unique ID (GUID).
<--ha-group>     :: Name or UUID of a storage pool high-availability group
</pre>
</pre>




=== host-initiator-get [hi-get] ===
=== ha-group-failover [hag-failover] ===
Gets information about a specific host identified by its initiator IQN.
Manually triggers a failover of the specified storage pool using the associated storage pool HA group policy.
<pre>
<pre>
<--iqn>         :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--storage-system> :: Name or ID of a storage system in a management grid.
</pre>
</pre>




=== host-initiator-add [hi-add] ===
=== ha-group-get [hag-get] ===
Adds an additional iSCSI host initiator IQN to the specified host.
Gets information about the specified storage pool HA group
<pre>
<pre>
<--host>         :: Name of the host or its unique ID (GUID).
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--iqn>          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
</pre>
</pre>




=== host-initiator-list [hi-list] ===
=== ha-group-list [hag-list] ===
Returns a list of all the initiators (IQN) of the specified host
Returns a list of all the HA groups
 
=== ha-group-modify [hag-modify] ===
Modifies the settings for the specified high-availability group
<pre>
<pre>
<--host>         :: Name of the host or its unique ID (GUID).
<--ha-group>     :: Name or UUID of a storage pool high-availability group
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--sys-secondary] :: Storage system associated with the failover group secondary node
[--ha-module]    :: Name or UUID of a storage pool high-availability module
</pre>
</pre>




=== host-initiator-remove [hi-remove] ===
=== ha-interface-create [hai-create] ===
Removes a iSCSI host initiator (IQN) from the specified host.
Creates a new virtual network interface for the specified HA failover group.
<pre>
<pre>
<--host>         :: Name of the host or its unique ID (GUID).
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--iqn>         :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
<--parent-port>  :: Parent network port like 'eth0' which the virtual interface should be
</pre>
                            attached to.  On failover the virtual interface will attach to the port
 
                            with the same name on the failover/secondary node.
<--ip-address>   :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--interface-tag] :: Tags are a alpha-numeric tag which is appended onto a given HA virtual
                            interface for easy identification.
[--desc]        :: A description for the object.
[--gateway]      :: IP address of the network gateway
[--mac-address]  :: MAC Address
[--iscsi-enable] :: Enables or disables iSCSI access to the specified port(s).
</pre>


== Host Group Management ==


=== host-group-create [hg-create] ===
=== ha-interface-delete [hai-delete] ===
Creates a new host group with the specified name.
Deletes the specified virtual network interface resource from the HA group
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--ha-interface> :: Name or UUID of a storage pool high-availability virtual network
                            not allowed.
                            interface
<--host-list>   :: A list of one or more hosts by name or ID.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== host-group-modify [hg-modify] ===
=== ha-interface-get [hai-get] ===
Modifies the properties of a host group such as its name and/or description.
Gets information about the specified storage pool HA virtual network interface
<pre>
<pre>
<--host-group>   :: An arbitrary collection of hosts used to simplify volume ACL management
<--ha-interface> :: Name or UUID of a storage pool high-availability virtual network
                            for grids and other groups of hosts.
                             interface
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             not allowed.
[--desc]        :: A description for the object.
</pre>
</pre>




=== host-group-delete [hg-delete] ===
=== ha-interface-list [hai-list] ===
Returns a list of all the HA interfaces on the specified group
 
=== ha-module-get [ham-get] ===
Gets information about the specified storage pool HA module
<pre>
<--ha-module>    :: Name or UUID of a storage pool high-availability module
</pre>
 
 
=== ha-module-list [ham-list] ===
Returns a list of all the HA failover modules
 
== Host Group Management ==
 
=== host-group-create [hg-create] ===
Creates a new host group with the specified name.
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--host-list>    :: A list of one or more hosts by name or ID.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async]
</pre>
 
 
=== host-group-delete [hg-delete] ===
Removes the specified host group.
Removes the specified host group.
<pre>
<pre>
Line 770: Line 849:
</pre>
</pre>


=== host-group-list [hg-list] ===
Returns a list of all the host groups.


=== host-group-get [hg-get] ===
=== host-group-get [hg-get] ===
Line 800: Line 876:




== Hardware RAID Management ==
=== host-group-list [hg-list] ===
Returns a list of all the host groups.


=== hw-controller-group-list [hwcg-list] ===
=== host-group-modify [hg-modify] ===
Returns a list of all the hardware controller groups.
Modifies the properties of a host group such as its name and/or description.
<pre>
<--host-group>  :: An arbitrary collection of hosts used to simplify volume ACL management
                            for grids and other groups of hosts.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
</pre>


=== hw-controller-group-get [hwcg-get] ===
Returns information about all the support hardware RAID controller group types.
<pre>
<--controller-group> :: Name or ID of a hardware RAID controller group.
</pre>


== Host Mangement ==


=== hw-controller-list [hwc-list] ===
=== host-add [h-add] ===
Returns a list of all the hardware controllers.
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>
<pre>
[--controller-group] :: Name or ID of a hardware RAID controller group.
<--hostname>    :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--iqn]          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
[--ip-address]  :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--desc]         :: A description for the object.
[--username]    :: Administrator user name for the host, typically 'Administrator' for
                            Windows hosts.
[--password]    :: Administrator password for the host; enables auto-configuration of
                            host's iSCSI initiator.
[--host-type]    :: Operating system type of the host. [aix, hpux, linux, other, solaris,
                            vmware, *windows, xenserver]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== hw-controller-get [hwc-get] ===
=== host-get [h-get] ===
Returns information about a specific hardware RAID controller.
Gets information about a specific host.
<pre>
<pre>
<--controller>   :: Name or ID of a hardware RAID controller.
<--host>         :: Name of the host or its unique ID (GUID).
</pre>
</pre>




=== hw-controller-rescan [hwc-rescan] ===
=== host-initiator-add [hi-add] ===
Rescans the hardware controller to look for new disks and RAID units.
Adds an additional iSCSI host initiator IQN to the specified host.
<pre>
<pre>
<--controller>   :: Name or ID of a hardware RAID controller.
<--host>         :: Name of the host or its unique ID (GUID).
<--iqn>          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
</pre>
</pre>




=== hw-controller-import-units [hwc-import-units] ===
=== host-initiator-get [hi-get] ===
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.
Gets information about a specific host identified by its initiator IQN.
<pre>
<pre>
<--controller>   :: Name or ID of a hardware RAID controller.
<--iqn>         :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
</pre>
</pre>




=== hw-controller-create-security-key [hwc-create-security-key] ===
=== host-initiator-list [hi-list] ===
Create the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.
Returns a list of all the initiators (IQN) of the specified host
<pre>
<pre>
<--controller>   :: Name or ID of a hardware RAID controller.
<--host>         :: Name of the host or its unique ID (GUID).
<--security-key> :: Security key on HW Controller card for encryption on FDE-enabled secure
                            disk drives.
</pre>
</pre>




=== hw-controller-change-security-key [hwc-change-security-key] ===
=== host-initiator-remove [hi-remove] ===
Change the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.
Removes a iSCSI host initiator (IQN) from the specified host.
<pre>
<pre>
<--controller>   :: Name or ID of a hardware RAID controller.
<--host>         :: Name of the host or its unique ID (GUID).
<--old-security-key> :: Prior security key on HW Controller card, for changing key, for
<--iqn>         :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
                            encryption on FDE-enabled secure disk drives.
<--security-key> :: Security key on HW Controller card for encryption on FDE-enabled secure
                            disk drives.
</pre>
</pre>




=== hw-enclosure-list [hwe-list] ===
=== host-list [h-list] ===
Returns a list of all the enclosures managed by the specified hardware RAID controller.
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>
 
[--controller]  :: Name or ID of a hardware RAID controller.
=== host-modify [h-modify] ===
Modifies a host.
<pre>
<--host>        :: Name of the host or its unique ID (GUID).
[--desc]        :: A description for the object.
[--ip-address]  :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--username]    :: Administrator user name for the host, typically 'Administrator' for
                            Windows hosts.
[--password]    :: Administrator password for the host; enables auto-configuration of
                            host's iSCSI initiator.
[--host-type]    :: Operating system type of the host. [aix, hpux, linux, other, solaris,
                            vmware, *windows, xenserver]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== hw-enclosure-get [hwe-get] ===
=== host-remove [h-remove] ===
Returns information about a specific enclosure managed by the specified hardware RAID controller.
Removes the specified host, *WARNING* host's active iSCSI sessions will be dropped.
<pre>
<pre>
<--enclosure>   :: Name of a hardware RAID enclosure or it unique ID.
<--host>         :: Name of the host or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== hw-unit-list [hwu-list] ===
== Hardware RAID Management ==
Returns a list of all the RAID units managed by the specified hardware controller.
 
=== hw-alarm-clear-all [hwa-clear-all] ===
Clears all the hardware alarms that have been recorded for the specified hardware RAID controller.
<pre>
<pre>
[--controller]   :: Name or ID of a hardware RAID controller.
<--controller>   :: Name or ID of a hardware RAID controller.
</pre>
</pre>




=== hw-unit-get [hwu-get] ===
=== hw-alarm-get [hwa-get] ===
Returns information about a specific RAID unit managed by the specified hardware RAID controller.
Returns information about a specific hardware alarm.
<pre>
<pre>
<--unit>         :: Name of a hardware RAID unit or it unique ID.
<--id>           :: Unique identifier (GUID) for the object.
</pre>
</pre>




=== hw-unit-identify [hwu-identify] ===
=== hw-alarm-list [hwa-list] ===
Flashes the LED indicator light on all the disks in the RAID unit so that it can be identified in the enclosure.
Returns a list of all the current hardware alarms/alert messages generated from the controller.
<pre>
<pre>
<--unit>        :: Name of a hardware RAID unit or it unique ID.
[--controller]  :: Name or ID of a hardware RAID controller.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-unit-encrypt [hwu-encrypt] ===
=== hw-controller-change-security-key [hwc-change-security-key] ===
Enable hardware SED/FDE encryption for the specified hardware RAID unit.
Change the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.
<pre>
<pre>
<--unit>         :: Name of a hardware RAID unit or it unique ID.
<--controller>   :: Name or ID of a hardware RAID controller.
[--options]      :: Special options to hardware encryption policy.
<--old-security-key> :: Prior security key on HW Controller card, for changing key, for
                            encryption on FDE-enabled secure disk drives.
<--security-key> :: Security key on HW Controller card for encryption on FDE-enabled secure
                            disk drives.
</pre>
</pre>




=== hw-unit-create [hwu-create] ===
=== hw-controller-create-security-key [hwc-create-security-key] ===
Creates a new hardware RAID unit using the specified controller.
Create the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.
<pre>
<pre>
<--raid>         :: Hardware RAID type for a hardware RAID unit. [*AUTO, RAID0, RAID1,
<--controller>  :: Name or ID of a hardware RAID controller.
                            RAID10, RAID5, RAID50, RAID6, RAID60]
<--security-key> :: Security key on HW Controller card for encryption on FDE-enabled secure
<--disk-list>    :: Specifies one or more physical disks connected to a hardware RAID
                            disk drives.
                            controller. Use 'all' to indicate all unused disks.
[--controller]   :: Name or ID of a hardware RAID controller.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== hw-unit-delete [hwu-delete] ===
=== hw-controller-get [hwc-get] ===
Deletes the specified RAID unit.  Note that you must first delete the Storage Pool before you delete the RAID unit.
Returns information about a specific hardware RAID controller.
<pre>
<pre>
<--unit>         :: Name of a hardware RAID unit or it unique ID.
<--controller>   :: Name or ID of a hardware RAID controller.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-disk-identify [hwd-identify] ===
=== hw-controller-group-get [hwcg-get] ===
Flashes the LED indicator light on the specified disk so that it can be identified in the enclosure chassis.
Returns information about all the support hardware RAID controller group types.
<pre>
<pre>
<--unit>         :: Name of a hardware RAID unit or it unique ID.
<--controller-group> :: Name or ID of a hardware RAID controller group.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-disk-delete [hwd-delete] ===
=== hw-controller-group-list [hwcg-list] ===
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.
Returns a list of all the hardware controller groups.
 
=== hw-controller-import-units [hwc-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>
<pre>
<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.
<--controller>   :: Name or ID of a hardware RAID controller.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-disk-list [hwd-list] ===
=== hw-controller-list [hwc-list] ===
Returns a list of all the disks managed by the specified hardware controller.
Returns a list of all the hardware controllers.
<pre>
<pre>
[--controller]   :: Name or ID of a hardware RAID controller.
[--controller-group] :: Name or ID of a hardware RAID controller group.
</pre>
</pre>




=== hw-disk-get [hwd-get] ===
=== hw-controller-rescan [hwc-rescan] ===
Returns information about a specific disk managed by a hardware RAID controller.
Rescans the hardware controller to look for new disks and RAID units.
<pre>
<pre>
<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.
<--controller>   :: Name or ID of a hardware RAID controller.
</pre>
</pre>




=== hw-disk-mark-spare [hwd-mark-spare] ===
=== hw-disk-delete [hwd-delete] ===
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.
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>
<pre>
<--disk>        :: Specifies a physical disk connected to a hardware RAID controller.
<--disk>        :: Specifies a physical disk connected to a hardware RAID controller.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-disk-mark-good [hwd-mark-good] ===
=== hw-disk-get [hwd-get] ===
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.
Returns information about a specific disk managed by a hardware RAID controller.
<pre>
<pre>
<--disk>        :: Specifies a physical disk connected to a hardware RAID controller.
<--disk>        :: Specifies a physical disk connected to a hardware RAID controller.
Line 968: Line 1,072:




=== hw-alarm-list [hwa-list] ===
=== hw-disk-identify [hwd-identify] ===
Returns a list of all the current hardware alarms/alert messages generated from the controller.
Flashes the LED indicator light on the specified disk so that it can be identified in the enclosure chassis.
<pre>
<pre>
[--controller]  :: Name or ID of a hardware RAID controller.
<--unit>        :: Name of a hardware RAID unit or it unique ID.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-alarm-get [hwa-get] ===
=== hw-disk-list [hwd-list] ===
Returns information about a specific hardware alarm.
Returns a list of all the disks managed by the specified hardware controller.
<pre>
<pre>
<--id>          :: Unique identifier (GUID) for the object.
[--controller]  :: Name or ID of a hardware RAID controller.
</pre>
</pre>




=== hw-alarm-clear-all [hwa-clear-all] ===
=== hw-disk-mark-good [hwd-mark-good] ===
Clears all the hardware alarms that have been recorded for the specified hardware RAID controller.
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>
<pre>
<--controller>   :: Name or ID of a hardware RAID controller.
<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.
</pre>
</pre>




== SAS Switch Management ==
=== hw-disk-mark-spare [hwd-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-switch-get [hws-get] ===
Returns detailed information about a storage switch
<pre>
<pre>
<--switch>       :: Name or ID of a SAS/FC storage switch
<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.
</pre>
</pre>




=== hw-switch-list [hws-list] ===
=== hw-enclosure-get [hwe-get] ===
Returns a list of all the discovered storage switches
Returns information about a specific enclosure managed by the specified hardware RAID controller.
<pre>
<pre>
[--switch-adapter] :: Storage switch adapter module ID
<--enclosure>    :: Name of a hardware RAID enclosure or it unique ID.
</pre>
</pre>




=== hw-switch-adapter-get [hwsa-get] ===
=== hw-enclosure-list [hwe-list] ===
Returns information about the specified HW switch management module.
Returns a list of all the enclosures managed by the specified hardware RAID controller.
<pre>
<pre>
<--switch-adapter> :: Storage switch adapter module ID
[--controller]  :: Name or ID of a hardware RAID controller.
</pre>
</pre>




=== hw-switch-adapter-list [hwsa-list] ===
=== hw-unit-create [hwu-create] ===
Returns a list of all the storage switch management adapters
Creates a new hardware RAID unit using the specified controller.
<pre>
<--raid>        :: Hardware RAID type for a hardware RAID unit. [*AUTO, RAID0, RAID1,
                            RAID10, RAID5, RAID50, RAID6, RAID60]
<--disk-list>    :: Specifies one or more physical disks connected to a hardware RAID
                            controller. Use 'all' to indicate all unused disks.
[--controller]  :: Name or ID of a hardware RAID controller.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
 


=== hw-switch-cred-get [hwsc-get] ===
=== hw-unit-delete [hwu-delete] ===
Returns information about specific storage switch login credentials
Deletes the specified RAID unit.  Note that you must first delete the Storage Pool before you delete the RAID unit.
<pre>
<pre>
<--creds>       :: Storage switch credentials (user/pass)
<--unit>         :: Name of a hardware RAID unit or it unique ID.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== hw-switch-cred-list [hwsc-list] ===
=== hw-unit-encrypt [hwu-encrypt] ===
Returns a list of all the storage switch login credentials
Enable hardware SED/FDE encryption for the specified hardware RAID unit.
<pre>
<pre>
[--switch-adapter] :: Storage switch adapter module ID
<--unit>        :: Name of a hardware RAID unit or it unique ID.
[--options]     :: Special options to hardware encryption policy.
</pre>
</pre>




=== hw-switch-cred-add [hwsc-add] ===
=== hw-unit-get [hwu-get] ===
Adds storage switch login credentials for a specific switch management adapter
Returns information about a specific RAID unit managed by the specified hardware RAID controller.
<pre>
<pre>
<--username>    :: Administrator user name for the host, typically 'Administrator' for  
<--unit>        :: Name of a hardware RAID unit or it unique ID.
</pre>
 
 
=== hw-unit-identify [hwu-identify] ===
Flashes the LED indicator light on all the disks in the RAID unit so that it can be identified in the enclosure.
<pre>
<--unit>        :: Name of a hardware RAID unit or it unique ID.
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
 
 
=== hw-unit-list [hwu-list] ===
Returns a list of all the RAID units managed by the specified hardware controller.
<pre>
[--controller]  :: Name or ID of a hardware RAID controller.
</pre>
 
 
== SAS Switch Management ==
 
=== hw-switch-adapter-get [hwsa-get] ===
Returns information about the specified HW switch management module.
<pre>
<--switch-adapter> :: Storage switch adapter module ID
</pre>
 
 
=== hw-switch-adapter-list [hwsa-list] ===
Returns a list of all the storage switch management adapters
 
=== hw-switch-cred-add [hwsc-add] ===
Adds storage switch login credentials for a specific switch management adapter
<pre>
<--username>    :: Administrator user name for the host, typically 'Administrator' for  
                             Windows hosts.
                             Windows hosts.
<--password>    :: Administrator password for the host; enables auto-configuration of  
<--password>    :: Administrator password for the host; enables auto-configuration of  
Line 1,047: Line 1,195:




=== hw-switch-cred-remove [hwsc-remove] ===
=== hw-switch-cred-get [hwsc-get] ===
Removes storage switch login credentials
Returns information about specific storage switch login credentials
<pre>
<pre>
<--creds>        :: Storage switch credentials (user/pass)
<--creds>        :: Storage switch credentials (user/pass)
Line 1,054: Line 1,202:




=== hw-switch-zoneset-get [hwsz-get] ===
=== hw-switch-cred-list [hwsc-list] ===
Returns information about a specific switch zoneset
Returns a list of all the storage switch login credentials
<pre>
<pre>
<--zoneset>      :: Name or ID of a storage switch zoneset
[--switch-adapter] :: Storage switch adapter module ID
</pre>
</pre>




=== hw-switch-zoneset-list [hwsz-list] ===
=== hw-switch-cred-remove [hwsc-remove] ===
Returns a list of all the discovered zonesets
Removes storage switch login credentials
<pre>
<pre>
[--switch]      :: Name or ID of a SAS/FC storage switch
<--creds>        :: Storage switch credentials (user/pass)
</pre>
</pre>




=== hw-switch-zoneset-activate [hwsz-activate] ===
=== hw-switch-failover-group-activate [hwsfg-activate] ===
Activates a specific storage switch zonset
Activates the pools in a switch failover group on the specified storage system
<pre>
<--zoneset>      :: Name or ID of a storage switch zoneset
[--switch]      :: Name or ID of a SAS/FC storage switch
</pre>
 
 
=== hw-switch-failover-group-get [hwsfg-get] ===
Returns information about a specific switch failover group
<pre>
<pre>
<--failover-group> :: Name/ID of a storage switch failover group
<--failover-group> :: Name/ID of a storage switch failover group
</pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
 
 
=== hw-switch-failover-group-list [hwsfg-list] ===
Returns a list of all the switch failover groups
<pre>
[--switch]      :: Name or ID of a SAS/FC storage switch
</pre>
</pre>


Line 1,108: Line 1,242:




=== hw-switch-failover-group-modify [hwsfg-modify] ===
=== hw-switch-failover-group-delete [hwsfg-delete] ===
Modifies the properties of a failover group
Deletes a failover group
<pre>
<--failover-group> :: Name/ID of a storage switch failover group
</pre>
 
 
=== hw-switch-failover-group-get [hwsfg-get] ===
Returns information about a specific switch failover group
<pre>
<--failover-group> :: Name/ID of a storage switch failover group
</pre>
 
 
=== hw-switch-failover-group-list [hwsfg-list] ===
Returns a list of all the switch failover groups
<pre>
[--switch]      :: Name or ID of a SAS/FC storage switch
</pre>
 
 
=== hw-switch-failover-group-modify [hwsfg-modify] ===
Modifies the properties of a failover group
<pre>
<pre>
<--failover-group> :: Name/ID of a storage switch failover group
<--failover-group> :: Name/ID of a storage switch failover group
Line 1,127: Line 1,282:




=== hw-switch-failover-group-delete [hwsfg-delete] ===
=== hw-switch-get [hws-get] ===
Deletes a failover group
Returns detailed information about a storage switch
<pre>
<pre>
<--failover-group> :: Name/ID of a storage switch failover group
<--switch>       :: Name or ID of a SAS/FC storage switch
</pre>
</pre>




=== hw-switch-failover-group-activate [hwsfg-activate] ===
=== hw-switch-list [hws-list] ===
Activates the pools in a switch failover group on the specified storage system
Returns a list of all the discovered storage switches
<pre>
<pre>
<--failover-group> :: Name/ID of a storage switch failover group
[--switch-adapter] :: Storage switch adapter module ID
<--storage-system> :: Name or ID of a storage system in a management grid.
</pre>
</pre>




== License Mangement ==
=== hw-switch-zoneset-activate [hwsz-activate] ===
 
Activates a specific storage switch zonset
=== license-get [lic-get] ===
Shows the current license key info, and any activation request code.
<pre>
<pre>
<--key>         :: Unique license key identifier, use key-enum to get a list of these.
<--zoneset>     :: Name or ID of a storage switch zoneset
[--switch]      :: Name or ID of a SAS/FC storage switch
</pre>
</pre>




=== license-list [lic-list] ===
=== hw-switch-zoneset-get [hwsz-get] ===
Returns a list of all the registered license keys.
Returns information about a specific switch zoneset
 
=== license-add [lic-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>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
<--zoneset>      :: Name or ID of a storage switch zoneset
<--key-file>    :: Key file you received which contains a key block section.
</pre>
</pre>




=== license-remove [lic-remove] ===
=== hw-switch-zoneset-list [hwsz-list] ===
Removes the specified license key.
Returns a list of all the discovered zonesets
<pre>
<pre>
<--key>          :: Unique license key identifier, use key-enum to get a list of these.
[--switch]      :: Name or ID of a SAS/FC storage switch
</pre>
</pre>


== License Mangement ==


=== license-activate [lic-act] ===
=== license-activate [lic-act] ===
Line 1,184: Line 1,335:




== Cloud I/O Stats Management ==
=== license-add [lic-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.
=== metrics-get [lm-get] ===
Get the current username, token, and interval settings for Librato Metrics.
<pre>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
[--storage-system] :: Name or ID of a storage system in a management grid.
<--key-file>    :: Key file you received which contains a key block section.
</pre>
</pre>




=== metrics-set [lm-set] ===
=== license-get [lic-get] ===
Set the username, token, and interval for Librato Metrics posting.
Shows the current license key info, and any activation request code.
<pre>
<--key>          :: Unique license key identifier, use key-enum to get a list of these.
</pre>
 
 
=== license-list [lic-list] ===
Returns a list of all the registered license keys.
 
=== license-remove [lic-remove] ===
Removes the specified license key.
<pre>
<--key>          :: Unique license key identifier, use key-enum to get a list of these.
</pre>
 
 
== Cloud I/O Stats Management ==
 
=== metrics-get [lm-get] ===
Get the current username, token, and interval settings for Librato Metrics.
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
</pre>
 
 
=== metrics-set [lm-set] ===
Set the username, token, and interval for Librato Metrics posting.
<pre>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
[--storage-system] :: Name or ID of a storage system in a management grid.
Line 1,207: Line 1,383:




== Network Share Management ==
== Storage Pool Management ==


=== share-create [shr-create] ===
=== disk-add-spare [pd-add] ===
Creates a new NFSv3 network share.
Adds one or more dedicated hot-spares to the global hotspare pool.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
                            not allowed.
[--flags]       :: Optional flags for the operation. [async, force, *none]
<--pool>         :: Name of the storage pool or its unique ID (GUID).
</pre>
[--desc]         :: A description for the object.
 
[--public]       :: Indicates that the specified network share should be made public and
 
                            open for read/write access to all systems on the network.
=== disk-get [pd-get] ===
[--active]      :: Indicates that the network share should be activated.
Gets information about a specific physical disk.
[--cifs-enable]  :: Enables Samba support for network share.
<pre>
[--user-access-list] :: List of users with permission to access the network share.
<--disk>        :: Name of the physical disk or its unique ID/serial number.
[--cifs-options] :: Additional CIFS/Samba configuration options specified as
                            'key=value,key2=value2,...'.
[--space-quota]  :: Size of the quota for the network share (optional).
[--disable-snap-browsing] :: When this is true, ability to browse snapshot directories over CIFS is
                            disabled.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-modify [shr-modify] ===
=== disk-identify [pd-id] ===
Modifies the properties of the specified network share.
Pulses the disk activity light so that the specified disk can be identified in the cassis.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--disk>         :: Name of the physical disk or its unique ID/serial number.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
[--pattern]     :: Pattern to flash the disk LED lights in, p = short pulse, P = long
                            not allowed.
                             pulse, d = short delay, D = long delay, ex: pattern=pppD
[--desc]        :: A description for the object.
[--duration]     :: Duration in seconds to repeat the disk identification pattern.
[--active]      :: Indicates that the network share should be activated.
</pre>
[--space-quota] :: Size of the quota for the network share (optional).
 
[--sync]        :: Synchroniztion policy to use for handling writes to the storage pool
 
                            (standard, always, none).  standard mode is a hybrid of write-through and
=== disk-list [pd-list] ===
                             write-back caching based on the O_SYNC flag, always mode is write-through
Enumerates all physical disks.
                            to ZIL which could be SSD cache, and disabled indicates to always use
                            async writes. [always, disabled, *standard]
[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] |
                            zle | lz4)
[--copies]       :: Indicates the number of copies of each block should be maintained in the  
                            storage pool.  This is a way of getting duplicates for bit-rot protection
                            on a single device.
[--cifs-enable]  :: Enables Samba support for network share.
[--user-access-list] :: List of users with permission to access the network share.
[--cifs-options] :: Additional CIFS/Samba configuration options specified as
                            'key=value,key2=value2,...'.
[--disable-snap-browsing] :: When this is true, ability to browse snapshot directories over CIFS is
                            disabled.
</pre>


 
=== disk-remove-spare [pd-remove] ===
=== share-delete [shr-delete] ===
Removes one or more dedicated hot-spares from the global hotspare pool.
Deletes the specified network share
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== share-snapshot [shr-snap] ===
=== disk-scan [pd-scan] ===
Creates and instant space efficient snapshot of the specified network share (requires Advanced Storage Pool)
Scans for any new physical disks that may have been hot-plugged into the storage system.
<pre>
<pre>
<--share>        :: Name or ID of a network share.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-clone [shr-clone] ===
=== path-list [pdp-list] ===
Creates a full copy of the specified network share to another storage pool.
Enumerates all physical disk paths for multipath devices.
 
=== pool-add-spare [p-add] ===
Adds a dedicated hot-spare to the specified storage pool.
<pre>
<pre>
<--share>        :: Name or ID of a network share.
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--name]        :: Name for the clone, if not provided the source volume name will be used  
<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
                            as a prefix.
[--flags]        :: Optional flags for the operation. [async]
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-list [shr-list] ===
=== pool-create [p-create] ===
Returns a list of all the network shares in the system.
Creates a new storage pool from which storage volumes can be created.
 
=== share-get [shr-get] ===
Returns information about the specified network share.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
</pre>
                            not allowed.
 
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
 
[--raid-type]   :: RAID type for the storage pool. [*AUTO, RAID0, RAID1, RAID10, RAID5,
=== share-client-add [shr-cadd] ===
                            RAID6]
Adds a client for the specified network share.
[--pool-type]    :: The type of storage pool to be created. [btrfs, ext4, jfs, *xfs, zfs]
<pre>
[--desc]        :: A description for the object.
<--share>        :: Name or ID of a network share.
[--is-default]  :: Indicates that this pool should be utilized as the default storage pool.
<--filter>      :: A filter string for the client
[--ssd]         :: Enable solid state disk (SSD) storage pool optimizations.
[--async]       :: Use asynchronous communication between NFS server and client
[--compress]     :: Enable storage volume compression on the pool, this boosts both read and
[--secure]       :: Requires the requests to originate from an Internet port less than
                             write performance on most IO loads.
                             IPPORT_RESERVED
[--nobarriers]   :: Enable storage pool write optimizations.  This requires that you have a
[--subtree]     :: Enables subtree checking
                            hardware controller with a battery backup unit.
[--rdonly]       :: Allow only read requests for the NFS volume
[--profile]     :: Specifies an optional IO optimization profile for the storage pool. 
[--flags]        :: Optional flags for the operation. [async, force]
                            Storage pool profiles control elements like read-ahead, queue depth and
                            other device configurable settings.
[--raid-set-size] :: Then number of disks to use in each set of disks when creating a RAID50
                            or RAID60 storage pool.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== share-client-remove [shr-cremove] ===
=== pool-destroy [p-destroy] ===
Removes a client for the specified network share.
Deletes a storage pool, *WARNING* any data in the pool will be lost.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--filter>      :: A filter string for the client
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-client-modify [shr-cmodify] ===
=== pool-device-get [spd-get] ===
Modifies a client for the specified network share.
Gets information about a specific storage pool device.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--filter>       :: A filter string for the client
                            not allowed.
[--rdonly]      :: Allow only read requests for the NFS volume
</pre>
[--secure]      :: Requires the requests to originate from an Internet port less than
 
                            IPPORT_RESERVED
 
[--async]        :: Use asynchronous communication between NFS server and client
=== pool-device-list [spd-list] ===
[--subtree]     :: Enables subtree checking
Returns a list of all the storage pool devices.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>


 
=== pool-expand [p-expand] ===
=== share-client-enum [shr-cenum] ===
Expands a storage pool after the underlying hardware RAID unit has been grown underneath.
Returns a list of clients for the specified network share.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== share-client-get [shr-cget] ===
=== pool-export [p-export] ===
Returns information about the specific network share client.
Deactivate and removes the storage pool from the storage system database so that it can be exported and used on another system.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--filter>      :: A filter string for the client
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-leave-domain [shr-ldomain] ===
=== pool-get [p-get] ===
Leaves the current domain.
Gets information about a specific storage pool.
<pre>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--ad-admin]    :: The administrator account of the domain that QuantaStor is a member of.
[--ad-password]  :: The password to the administrator account of the domain that QuantaStor
                            is a member of.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-join-domain [shr-jdomain] ===
=== pool-grow [p-grow] ===
Joins the specified domain/realm.
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>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--domain>      :: The name of the domain to have the QuantaStor system join. (DOMAIN)
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
<--realm>       :: The name of the realm that the domain is in. (DOMAIN.COM)
[--raid-type]    :: RAID type for the storage pool. [*AUTO, RAID0, RAID1, RAID10, RAID5,
<--kdc>          :: The name of the active directory machine.
                             RAID6]
<--ad-admin>    :: The administrator account of the domain that QuantaStor is a member of.
[--flags]        :: Optional flags for the operation. [async]
<--ad-password>  :: The password to the administrator account of the domain that QuantaStor
                             is a member of.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== share-ad-user-group-enum [shr-ad-ug-enum] ===
=== pool-identify [p-id] ===
Returns a list of all the users and groups in the domain that QuantaStor is in.
Pulses the disk activity lights for all disks in the pool so they can be identified in the chassis.
<pre>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--share]       :: Name or ID of a network share.
[--pattern]     :: Pattern to flash the disk LED lights in, p = short pulse, P = long
[--flags]       :: Optional flags for the operation. [async, force]
                            pulse, d = short delay, D = long delay, ex: pattern=pppD
[--duration]     :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




== Remote Replication Management ==
=== pool-list [p-list] ===
Returns a list of all the storage pools.


=== replication-schedule-create [rsch-create] ===
=== pool-modify [p-modify] ===
Creates a new replication schedule to replicate the specified storage volumes and shares to the specified target pool on a schedule.
Modifies the properties of the storage pool such as its name and description.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--target-pool>  :: Target storage pool on remote system to replicate to.
[--is-default]  :: Indicates that this pool should be utilized as the default storage pool.
[--volume-list] :: A list of one or more storage volumes.
[--ssd]         :: Enable solid state disk (SSD) storage pool optimizations.
[--share-list]   :: A list of one or more network shares.
[--compress]     :: Enable storage volume compression on the pool, this boosts both read and
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            write performance on most IO loads.
                             schedule.
[--nobarriers]  :: Enable storage pool write optimizations.  This requires that you have a  
[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated
                             hardware controller with a battery backup unit.
                             times.
[--profile]      :: Specifies an optional IO optimization profile for the storage pool. 
                            Storage pool profiles control elements like read-ahead, queue depth and
                             other device configurable settings.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--cloud]        :: Name of a Storage Cloud or its unique id.
[--sync]         :: Synchroniztion policy to use for handling writes to the storage pool
[--max-replicas] :: Maximum number of replica snapshot checkpoints to retain for this
                             (standard, always, none).  standard mode is a hybrid of write-through and
                             schedule, after which the oldest snapshot is removed before a new one is
                             write-back caching based on the O_SYNC flag, always mode is write-through
                             created.
                            to ZIL which could be SSD cache, and disabled indicates to always use
[--days]        :: The days of the week on which this schedule should create snapshots.
                             async writes. [always, disabled, *standard]
                             [fri, mon, sat, *sun, thu, tue, wed]
[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] |
[--hours]       :: For the specified days of the week, snapshots will be created at the
                             zle | lz4)
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
[--copies]       :: Indicates the number of copies of each block should be maintained in the
                             *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
                            storage pool.  This is a way of getting duplicates for bit-rot protection
[--interval]     :: Interval in minutes between replications, minimum is 15 minutes.
                            on a single device.
[--flags]        :: Optional flags for the operation. [async]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== replication-schedule-modify [rsch-modify] ===
=== pool-profile-get [pp-get] ===
Modifies the name, description or other properties of a replication schedule.
Gets information about a specific storage pool profile.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--profile>      :: Specifies an optional IO optimization profile for the storage pool.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            Storage pool profiles control elements like read-ahead, queue depth and
                            not allowed.
                             other device configurable settings.
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            schedule.
[--enabled]     :: While the schedule is enabled snapshots will be taken at the designated
                            times.
[--desc]        :: A description for the object.
[--cloud]        :: Name of a Storage Cloud or its unique id.
[--max-replicas] :: Maximum number of replica snapshot checkpoints to retain for this
                            schedule, after which the oldest snapshot is removed before a new one is
                            created.
[--days]        :: The days of the week on which this schedule should create snapshots.
                             [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--interval]    :: Interval in minutes between replications, minimum is 15 minutes.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== replication-schedule-delete [rsch-delete] ===
=== pool-profile-list [pp-list] ===
Deletes a replication schedule, snapshots associated with the schedule are not removed.
Returns a list of all the storage pool profiles.
 
=== pool-remove-spare [p-remove] ===
Removes the specified hot-spare from the specified pool.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== replication-schedule-add [rsch-add] ===
=== pool-scan [p-scan] ===
Adds one or more volumes/shares to the specified schedule.
Rescans the specified storage system for storage pools.
<pre>
<pre>
<--schedule>    :: Name or ID of a replication schedule.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
</pre>
</pre>




=== replication-schedule-remove [rsch-remove] ===
=== pool-scrub-start [p-scrub-start] ===
Removes one or more volumes/shares from the specified schedule.
Starts a zpool scrub/verify operation which verifies data integrity and prevents bit-rot.  Use 'zpoolscrub --cron' to setup an automatic monthly scrub.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
</pre>
</pre>




=== replication-schedule-enable [rsch-enable] ===
=== pool-scrub-stop [p-scrub-stop] ===
Enables the specified replication schedule.
Stops the zpool scrub/verify operation if it is currently active on the storage pool.  Only applies to ZFS based storage pools.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== replication-schedule-disable [rsch-disable] ===
=== pool-start [p-start] ===
Disables the specified replication schedule.
Starts up a previously stopped storage pool.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== replication-schedule-trigger [rsch-trigger] ===
=== pool-stop [p-stop] ===
Triggers the specified schedule to run immediately.
Stops all volume activity to the pool and disables it for maintenance.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== replication-schedule-list [rsch-list] ===
== Pool Replication Management (DEPRECATED) ==
Returns a list of all the replication schedules.


=== replication-schedule-get [rsch-get] ===
=== pool-replink-create [prl-create] ===
Returns information about a specific replication schedule.
Create a async remote replication link between two storage pools.
<pre>
<pre>
<--schedule>     :: Name or ID of a replication schedule.
<--primary-pool> :: Primary storage pool, source of data transfer for replication.
<--secondary-pool> :: Secondary storage pool, target of data transfer for replication.
<--primary-address> :: Primary system target port.
<--secondary-address> :: Secondary system target port.
[--protocol-type] :: Replication protocol type
[--resync-rate]  :: Resync rate in KB/sec
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== replica-assoc-stop [rep-assoc-stop] ===
=== pool-replink-delete [prl-delete] ===
Attempts to stop the replication process between a source/target pair of volumes or shares.
Delete the remote replication link between two storage pools.
<pre>
<pre>
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or
<--replication-link> :: Name or ID of the storage pool replication link/configuration
                            share
</pre>
</pre>




=== replica-assoc-rollback [rep-assoc-rollback] ===
=== pool-replink-demote [prl-demote] ===
Reverses the replication to send the changes on the target back to the source volume/share.  Requires the --force flag.
Demote the specified storage pool to be a secondary.
<pre>
<pre>
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or
<--replication-link> :: Name or ID of the storage pool replication link/configuration
                            share
</pre>
</pre>




=== replica-assoc-sync [rep-assoc-sync] ===
=== pool-replink-get [prl-get] ===
Restarts the replication process between a source/target pair of volumes or shares.
Get info about a specific remote replication link between two pools
<pre>
<pre>
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or
<--replication-link> :: Name or ID of the storage pool replication link/configuration
                            share
</pre>
</pre>




=== replica-assoc-delete [rep-assoc-delete] ===
=== pool-replink-list [prl-list] ===
Deletes the specified replication association between a source/target pair of volumes or shares.
List the remote replication links between pools
 
=== pool-replink-modify [prl-modify] ===
Modify the async remote replication link between pools.
<pre>
<pre>
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or  
<--replication-link> :: Name or ID of the storage pool replication link/configuration
                             share
[--sendbuf-size] :: Maximum network send-buffer size.
[--cong-policy]  :: Congestion policy.
[--cong-fill-size] :: Congestion fill size.
[--resync-rate]  :: Resync rate in KB/sec
[--barriers]    :: Disk barriers
[--disk-flushes] :: Disk flushes IO
[--resource]    :: Enable DRBD Proxy
[--source-ip]    :: Source system IP address or port name.
[--target-ip]    :: Target system IP address or port name.
[--replication-portnum] :: Port number on which the replication data flows between the source and
                             target systems (7789-7799)
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== replica-assoc-get [rep-assoc-get] ===
=== pool-replink-promote [prl-promote] ===
Returns details of the specified replication association.
Promote the specified pool to be a primary.
<pre>
<pre>
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or
<--replication-link> :: Name or ID of the storage pool replication link/configuration
                            share
</pre>
</pre>




=== replica-assoc-list [rep-assoc-list] ===
=== pool-replink-resume [prl-resume] ===
Returns a list of all the replication associations.
Resume the replication for the specified pool remote replication link.
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
</pre>


== RBAC Role Management ==


=== role-add [r-add] ===
=== pool-replink-suspend [prl-suspend] ===
Adds a new role to the role based access control (RBAC) system.
Suspend the replication for the specified pool remote replication link.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--replication-link> :: Name or ID of the storage pool replication link/configuration
                            not allowed.
[--desc]        :: A description for the object.
[--permissions]  :: List of permissions and/or permission groups to add to the specified
                            role.
</pre>
</pre>




=== role-modify [r-modify] ===
== Resource Group Quota Management ==
Modifies the name and/or description of a role
 
=== quota-create [q-create] ===
Creates a new storage quota on a pool for the specified storage cloud.
<pre>
<pre>
<--role>         :: Name of a security role or its unique ID (GUID).
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--cloud>        :: Name of a Storage Cloud or its unique id.
[--policy]      :: Indicates the type of quota to be created. [hard, *soft]
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--psize]        :: The total thin-provisionable space allowed by this quota.
[--usize]        :: The total utilizable space allowed by this quota which may be less than
                            the provisionable space.
[--max-volumes]  :: The maximum number of volumes that can be created using this quota,
                            specify 0 for no limit.
[--max-shares]  :: The maximum number of share that can be created using this quota,
                            specify 0 for no limit.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== role-remove [r-remove] ===
=== quota-delete [q-delete] ===
Removes the specified role identified by name or ID
Deletes a storage quota, the associated volumes are not deleted.
<pre>
<pre>
<--role>         :: Name of a security role or its unique ID (GUID).
<--quota>       :: Name or ID of a storage quota.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== role-list [r-list] ===
=== quota-get [q-get] ===
Returns a list of all the defined roles the RBAC system.
Returns information about a specific storage quota.
 
=== role-get [r-get] ===
Gets information about the specified role.
<pre>
<pre>
<--role>         :: Name of a security role or its unique ID (GUID).
<--quota>       :: Name or ID of a storage quota.
</pre>
</pre>




=== role-permission-add [rp-add] ===
=== quota-list [q-list] ===
Adds additional permissions and/or permission groups to the specified role.
Returns a list of all the storage quotas.
 
=== quota-modify [q-modify] ===
Modifies one to change the name and/or description of a storage quota.
<pre>
<pre>
<--role>         :: Name of a security role or its unique ID (GUID).
<--quota>       :: Name or ID of a storage quota.
<--permissions> :: List of permissions and/or permission groups to add to the specified
<--cloud>        :: Name of a Storage Cloud or its unique id.
                            role.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--psize]        :: The total thin-provisionable space allowed by this quota.
[--usize]        :: The total utilizable space allowed by this quota which may be less than
                            the provisionable space.
[--max-volumes] :: The maximum number of volumes that can be created using this quota,
                            specify 0 for no limit.
[--max-shares]  :: The maximum number of share that can be created using this quota,
                            specify 0 for no limit.
[--policy]      :: Indicates the type of quota to be created. [hard, *soft]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== role-permission-remove [rp-remove] ===
=== quota-share-add [qs-add] ===
Removes one or more permissions and/or permission groups from the specified role.
Adds one or more shares to the specified quota.
<pre>
<pre>
<--role>         :: Name of a security role or its unique ID (GUID).
<--quota>       :: Name or ID of a storage quota.
<--permissions> :: List of permissions and/or permission groups to add to the specified
<--share-list>   :: A list of one or more network shares.
                            role.
</pre>
</pre>




== iSCSI Session Management ==
=== quota-share-assoc-list [qs-alist] ===
Returns a list of all the associated quotas of a specified share.
<pre>
<--share>        :: Name or ID of a network share.
</pre>
 


=== session-list [sn-list] ===
=== quota-share-remove [qs-remove] ===
Returns a list of all the active iSCSI sessions.
Removes one or more shares from the specified quota.
<pre>
<pre>
[--volume]      :: Name of the storage volume or its unique ID (GUID).
<--quota>        :: Name or ID of a storage quota.
[--host]        :: Name of the host or its unique ID (GUID).
<--share-list>  :: A list of one or more network shares.
</pre>
</pre>




=== session-get [sn-get] ===
=== quota-volume-add [qv-add] ===
Returns detailed information on a specific iSCSI session.
Adds one or more volumes to the specified quota.
<pre>
<pre>
<--session>     :: iSCSI session identifier for an active iSCSI session.
<--quota>       :: Name or ID of a storage quota.
<--volume-list>  :: A list of one or more storage volumes.
</pre>
</pre>




=== session-close [sn-close] ===
=== quota-volume-assoc-list [qv-alist] ===
Forcibly closes the specified iSCSI session; generally not recommended, use acl-remove instead.
Returns a list of all the associated quotas of a specified volume.
<pre>
<pre>
<--session>     :: iSCSI session identifier for an active iSCSI session.
<--volume>       :: Name of the storage volume or its unique ID (GUID).
</pre>
</pre>




== Snapshot Schedule Management ==
=== quota-volume-remove [qv-remove] ===
 
Removes one or more volumes from the specified quota
=== snap-schedule-create [sch-create] ===
Creates a new snapshot schedule comprised of the specified storage volumes.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--quota>       :: Name or ID of a storage quota.
                            not allowed.
<--volume-list> :: A list of one or more storage volumes.
[--volume-list] :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            schedule.
[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated
                            times.
[--desc]        :: A description for the object.
[--cloud]        :: Name of a Storage Cloud or its unique id.
[--max-snaps]    :: Maximum number of snapshots to retain for this schedule, after which the
                            oldest snapshot is removed before a new one is created.
[--days]        :: The days of the week on which this schedule should create snapshots.
                            [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== snap-schedule-modify [sch-modify] ===
== Remote Replication Management ==
Modifies the name, description or other properties of a snapshot schedule.
 
=== replica-assoc-delete [rep-assoc-delete] ===
Deletes the specified replication association between a source/target pair of volumes or shares.
<pre>
<pre>
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or  
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             share
                             not allowed.
</pre>
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
 
                            schedule.
 
[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated
=== replica-assoc-get [rep-assoc-get] ===
                            times.
Returns details of the specified replication association.
[--desc]        :: A description for the object.
<pre>
[--cloud]       :: Name of a Storage Cloud or its unique id.
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or
[--max-snaps]    :: Maximum number of snapshots to retain for this schedule, after which the  
                             share
                            oldest snapshot is removed before a new one is created.
[--days]        :: The days of the week on which this schedule should create snapshots.
                            [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                             specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== snap-schedule-delete [sch-delete] ===
=== replica-assoc-list [rep-assoc-list] ===
Deletes a snapshot schedule, snapshots associated with the schedule are not removed.
Returns a list of all the replication associations.
 
=== replica-assoc-rollback [rep-assoc-rollback] ===
Reverses the replication to send the changes on the target back to the source volume/share.  Requires the --force flag.
<pre>
<pre>
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or  
[--flags]        :: Optional flags for the operation. [async, force]
                            share
</pre>
</pre>




=== snap-schedule-enable [sch-enable] ===
=== replica-assoc-stop [rep-assoc-stop] ===
Enables the specified snapshot schedule.
Attempts to stop the replication process between a source/target pair of volumes or shares.
<pre>
<pre>
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or  
[--flags]        :: Optional flags for the operation. [async, force]
                            share
</pre>
</pre>




=== snap-schedule-disable [sch-disable] ===
=== replica-assoc-sync [rep-assoc-sync] ===
Disables the specified snapshot schedule.
Restarts the replication process between a source/target pair of volumes or shares.
<pre>
<pre>
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
<--replica-assoc> :: Name or ID of a replica association between a source/target volume or  
[--flags]        :: Optional flags for the operation. [async, force]
                            share
</pre>
</pre>




=== snap-schedule-list [sch-list] ===
=== replication-schedule-add [rsch-add] ===
Returns a list of all the snapshot schedules.
 
=== snap-schedule-get [sch-get] ===
Returns information about a specific snapshot schedule.
<pre>
<--schedule>    :: Name of a snapshot schedule or its unique ID (GUID).
</pre>
 
 
=== snap-schedule-add [sch-add] ===
Adds one or more volumes/shares to the specified schedule.
Adds one or more volumes/shares to the specified schedule.
<pre>
<pre>
<--schedule>    :: Name of a snapshot schedule or its unique ID (GUID).
<--schedule>    :: Name or ID of a replication schedule.
[--volume-list]  :: A list of one or more storage volumes.
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
[--share-list]  :: A list of one or more network shares.
Line 1,718: Line 1,855:




=== snap-schedule-remove [sch-remove] ===
=== replication-schedule-create [rsch-create] ===
Removes one or more volumes/shares from the specified schedule.
Creates a new replication schedule to replicate the specified storage volumes and shares to the specified target pool on a schedule.
<pre>
<pre>
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--target-pool>  :: Target storage pool on remote system to replicate to.
[--volume-list]  :: A list of one or more storage volumes.
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
[--share-list]  :: A list of one or more network shares.
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            schedule.
[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated
                            times.
[--desc]        :: A description for the object.
[--cloud]        :: Name of a Storage Cloud or its unique id.
[--max-replicas] :: Maximum number of replica snapshot checkpoints to retain for this
                            schedule, after which the oldest snapshot is removed before a new one is
                            created.
[--days]        :: The days of the week on which this schedule should create snapshots.
                            [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--interval]    :: Interval in minutes between replications, minimum is 15 minutes.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== snap-schedule-trigger [sch-trigger] ===
=== replication-schedule-delete [rsch-delete] ===
Triggers the specified schedule to run immediately.
Deletes a replication schedule, snapshots associated with the schedule are not removed.
<pre>
<--schedule>    :: Name of a snapshot schedule or its unique ID (GUID).
</pre>
 
 
=== cloud-create [c-create] ===
Creates a new storage cloud comprised of the specified users, resources and chap information.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--schedule>     :: Name or ID of a replication schedule.
                            not allowed.
[--flags]        :: Optional flags for the operation. [async, force]
[--desc]        :: A description for the object.
[--subject-list] :: A list subjects in the following format name:type. Ex:
                            userName:user,groupName:user_group...
[--resource-list] :: A list resources in the following format name:type. Ex:
                            vol:volume,hostname:host...
[--parent-cloud] :: The name or unique id of a storage cloud.
[--tier]        :: The tier of the storage cloud.
[--organization] :: The name of the organization this storage cloud is assigned to.
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== cloud-modify [c-modify] ===
=== replication-schedule-disable [rsch-disable] ===
Modifies the name, description, parent storage cloud, tier, organization, and chap information of a storage cloud.
Disables the specified replication schedule.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--schedule>     :: Name or ID of a replication schedule.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
[--flags]        :: Optional flags for the operation. [async, force]
                            not allowed.
[--desc]        :: A description for the object.
[--parent-cloud] :: The name or unique id of a storage cloud.
[--tier]        :: The tier of the storage cloud.
[--organization] :: The name of the organization this storage cloud is assigned to.
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== cloud-delete [c-delete] ===
=== replication-schedule-enable [rsch-enable] ===
Deletes a storage cloud, the resources and users will not be deleted.
Enables the specified replication schedule.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--schedule>     :: Name or ID of a replication schedule.
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== cloud-get [c-get] ===
=== replication-schedule-get [rsch-get] ===
Returns information of the specified storage clouds.
Returns information about a specific replication schedule.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--schedule>     :: Name or ID of a replication schedule.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== cloud-list [c-list] ===
=== replication-schedule-list [rsch-list] ===
Returns a list of all the storage clouds.
Returns a list of all the replication schedules.
<pre>
[--flags]        :: Optional flags for the operation. [async, force]
</pre>


 
=== replication-schedule-modify [rsch-modify] ===
=== cloud-user-add [cu-add] ===
Modifies the name, description or other properties of a replication schedule.
Add one or more users to the specified storage cloud.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--schedule>    :: Name or ID of a replication schedule.
<--subject-list> :: A list subjects in the following format name:type. Ex:  
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             userName:user,groupName:user_group...
                            not allowed.
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            schedule.
[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated
                            times.
[--desc]        :: A description for the object.
[--cloud]       :: Name of a Storage Cloud or its unique id.
[--max-replicas] :: Maximum number of replica snapshot checkpoints to retain for this
                            schedule, after which the oldest snapshot is removed before a new one is
                            created.
[--days]        :: The days of the week on which this schedule should create snapshots.  
                            [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                             specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--interval]    :: Interval in minutes between replications, minimum is 15 minutes.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== cloud-user-remove [cu-remove] ===
=== replication-schedule-remove [rsch-remove] ===
Remove one or more users from specified storage cloud.
Removes one or more volumes/shares from the specified schedule.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--schedule>     :: Name or ID of a replication schedule.
<--subject-list> :: A list subjects in the following format name:type. Ex:
[--volume-list:: A list of one or more storage volumes.
                            userName:user,groupName:user_group...
[--share-list]  :: A list of one or more network shares.
</pre>
</pre>




=== cloud-resource-add [cr-add] ===
=== replication-schedule-trigger [rsch-trigger] ===
Add one or more resources to the specified storage cloud.
Triggers the specified schedule to run immediately.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--schedule>     :: Name or ID of a replication schedule.
<--resource-list> :: A list resources in the following format name:type. Ex:
[--flags]        :: Optional flags for the operation. [async, force]
                            vol:volume,hostname:host...
</pre>
</pre>




=== cloud-resource-remove [cr-remove] ===
== RBAC Role Management ==
Remove one or more resource from the specified storage cloud.
<pre>
<--cloud>        :: Name of a Storage Cloud or its unique id.
<--resource-list> :: A list resources in the following format name:type. Ex:
                            vol:volume,hostname:host...
</pre>


 
=== role-add [r-add] ===
=== cloud-subject-assoc-list [csub-alist] ===
Adds a new role to the role based access control (RBAC) system.
Returns a list of associated storage clouds to the specified subject.
<pre>
<pre>
<--subject>     :: The unique id of a user or user group.
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
[--flags]       :: Optional flags for the operation. [async, force]
                            not allowed.
[--desc]         :: A description for the object.
[--permissions] :: List of permissions and/or permission groups to add to the specified
                            role.
</pre>
</pre>




=== cloud-resource-mode [cr-mode] ===
=== role-get [r-get] ===
Set the mode of a specified resource in the storage cloud.
Gets information about the specified role.
<pre>
<pre>
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--role>         :: Name of a security role or its unique ID (GUID).
<--resource>    :: The unique id of a volume or volume group or share or host or host group.
<--access-mode>  :: Access mode for the volume.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




== Storage Pool Management ==
=== role-list [r-list] ===
Returns a list of all the defined roles the RBAC system.


=== pool-create [p-create] ===
=== role-modify [r-modify] ===
Creates a new storage pool from which storage volumes can be created.
Modifies the name and/or description of a role
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--role>        :: Name of a security role or its unique ID (GUID).
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
[--raid-type]    :: RAID type for the storage pool. [*AUTO, RAID0, RAID1, RAID10, RAID5,
                            RAID6]
[--pool-type]    :: The type of storage pool to be created. [btrfs, ext4, jfs, *xfs, zfs]
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--is-default]  :: Indicates that this pool should be utilized as the default storage pool.
[--ssd]          :: Enable solid state disk (SSD) storage pool optimizations.
[--compress]    :: Enable storage volume compression on the pool, this boosts both read and
                            write performance on most IO loads.
[--nobarriers]  :: Enable storage pool write optimizations.  This requires that you have a
                            hardware controller with a battery backup unit.
[--profile]      :: Specifies an optional IO optimization profile for the storage pool. 
                            Storage pool profiles control elements like read-ahead, queue depth and
                            other device configurable settings.
[--raid-set-size] :: Then number of disks to use in each set of disks when creating a RAID50
                            or RAID60 storage pool.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-grow [p-grow] ===
=== role-permission-add [rp-add] ===
Grows the specified storage pool by adding an additional disk.  You can only grow storage pools that are using the RAID5 or RAID6 layout.
Adds additional permissions and/or permission groups to the specified role.
<pre>
<pre>
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--role>        :: Name of a security role or its unique ID (GUID).
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
<--permissions> :: List of permissions and/or permission groups to add to the specified
[--raid-type]    :: RAID type for the storage pool. [*AUTO, RAID0, RAID1, RAID10, RAID5,
                             role.
                             RAID6]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-expand [p-expand] ===
=== role-permission-remove [rp-remove] ===
Expands a storage pool after the underlying hardware RAID unit has been grown underneath.
Removes one or more permissions and/or permission groups from the specified role.
<pre>
<pre>
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--role>        :: Name of a security role or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async]
<--permissions>  :: List of permissions and/or permission groups to add to the specified
                            role.
</pre>
</pre>




=== pool-add-spare [p-add] ===
=== role-remove [r-remove] ===
Adds a dedicated hot-spare to the specified storage pool.
Removes the specified role identified by name or ID
<pre>
<pre>
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--role>        :: Name of a security role or its unique ID (GUID).
<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-remove-spare [p-remove] ===
== Snapshot Schedule Management ==
Removes the specified hot-spare from the specified pool.
 
=== cloud-create [c-create] ===
Creates a new storage cloud comprised of the specified users, resources and chap information.
<pre>
<pre>
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
                            not allowed.
[--flags]        :: Optional flags for the operation. [async]
[--desc]        :: A description for the object.
[--subject-list] :: A list subjects in the following format name:type. Ex:
                            userName:user,groupName:user_group...
[--resource-list] :: A list resources in the following format name:type. Ex:
                            vol:volume,hostname:host...
[--parent-cloud] :: The name or unique id of a storage cloud.
[--tier]        :: The tier of the storage cloud.
[--organization] :: The name of the organization this storage cloud is assigned to.
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== pool-modify [p-modify] ===
=== cloud-delete [c-delete] ===
Modifies the properties of the storage pool such as its name and description.
Deletes a storage cloud, the resources and users will not be deleted.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
[--flags]        :: Optional flags for the operation. [async, force]
                            not allowed.
[--is-default]  :: Indicates that this pool should be utilized as the default storage pool.
[--ssd]          :: Enable solid state disk (SSD) storage pool optimizations.
[--compress]    :: Enable storage volume compression on the pool, this boosts both read and
                            write performance on most IO loads.
[--nobarriers]  :: Enable storage pool write optimizations.  This requires that you have a
                            hardware controller with a battery backup unit.
[--profile]      :: Specifies an optional IO optimization profile for the storage pool. 
                            Storage pool profiles control elements like read-ahead, queue depth and
                            other device configurable settings.
[--desc]        :: A description for the object.
[--sync]        :: Synchroniztion policy to use for handling writes to the storage pool
                            (standard, always, none).  standard mode is a hybrid of write-through and
                            write-back caching based on the O_SYNC flag, always mode is write-through
                            to ZIL which could be SSD cache, and disabled indicates to always use
                            async writes. [always, disabled, *standard]
[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] |
                            zle | lz4)
[--copies]      :: Indicates the number of copies of each block should be maintained in the
                            storage pool.  This is a way of getting duplicates for bit-rot protection
                            on a single device.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-destroy [p-destroy] ===
=== cloud-get [c-get] ===
Deletes a storage pool, *WARNING* any data in the pool will be lost.
Returns information of the specified storage clouds.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-start [p-start] ===
=== cloud-list [c-list] ===
Starts up a previously stopped storage pool.
Returns a list of all the storage clouds.
<pre>
<pre>
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-stop [p-stop] ===
=== cloud-modify [c-modify] ===
Stops all volume activity to the pool and disables it for maintenance.
Modifies the name, description, parent storage cloud, tier, organization, and chap information of a storage cloud.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--parent-cloud] :: The name or unique id of a storage cloud.
[--tier]        :: The tier of the storage cloud.
[--organization] :: The name of the organization this storage cloud is assigned to.
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== pool-scrub-start [p-scrub-start] ===
=== cloud-resource-add [cr-add] ===
Starts a zpool scrub/verify operation which verifies data integrity and prevents bit-rot.  Use 'zpoolscrub --cron' to setup an automatic monthly scrub.
Add one or more resources to the specified storage cloud.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--resource-list> :: A list resources in the following format name:type. Ex:
                            vol:volume,hostname:host...
</pre>
</pre>




=== pool-scrub-stop [p-scrub-stop] ===
=== cloud-resource-mode [cr-mode] ===
Stops the zpool scrub/verify operation if it is currently active on the storage pool.  Only applies to ZFS based storage pools.
Set the mode of a specified resource in the storage cloud.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--resource>    :: The unique id of a volume or volume group or share or host or host group.
<--access-mode>  :: Access mode for the volume.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== pool-export [p-export] ===
=== cloud-resource-remove [cr-remove] ===
Deactivate and removes the storage pool from the storage system database so that it can be exported and used on another system.
Remove one or more resource from the specified storage cloud.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
<--resource-list> :: A list resources in the following format name:type. Ex:
                            vol:volume,hostname:host...
</pre>
</pre>




=== pool-list [p-list] ===
=== cloud-subject-assoc-list [csub-alist] ===
Returns a list of all the storage pools.
Returns a list of associated storage clouds to the specified subject.
 
=== pool-get [p-get] ===
Gets information about a specific storage pool.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--subject>     :: The unique id of a user or user group.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-scan [p-scan] ===
=== cloud-user-add [cu-add] ===
Rescans the specified storage system for storage pools.
Add one or more users to the specified storage cloud.
<pre>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
<--cloud>        :: Name of a Storage Cloud or its unique id.
<--subject-list> :: A list subjects in the following format name:type. Ex:
                            userName:user,groupName:user_group...
</pre>
</pre>




=== pool-identify [p-id] ===
=== cloud-user-remove [cu-remove] ===
Pulses the disk activity lights for all disks in the pool so they can be identified in the chassis.
Remove one or more users from specified storage cloud.
<pre>
<pre>
<--pool>         :: Name of the storage pool or its unique ID (GUID).
<--cloud>       :: Name of a Storage Cloud or its unique id.
[--pattern]      :: Pattern to flash the disk LED lights in, p = short pulse, P = long
<--subject-list> :: A list subjects in the following format name:type. Ex:
                             pulse, d = short delay, D = long delay, ex: pattern=pppD
                             userName:user,groupName:user_group...
[--duration]    :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== path-list [pdp-list] ===
=== snap-schedule-add [sch-add] ===
Enumerates all physical disk paths for multipath devices.
Adds one or more volumes/shares to the specified schedule.
 
=== disk-list [pd-list] ===
Enumerates all physical disks.
 
=== disk-scan [pd-scan] ===
Scans for any new physical disks that may have been hot-plugged into the storage system.
<pre>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
<--schedule>    :: Name of a snapshot schedule or its unique ID (GUID).
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]   :: A list of one or more network shares.
</pre>
</pre>




=== disk-get [pd-get] ===
=== snap-schedule-create [sch-create] ===
Gets information about a specific physical disk.
Creates a new snapshot schedule comprised of the specified storage volumes.
<pre>
<pre>
<--disk>        :: Name of the physical disk or its unique ID/serial number.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            schedule.
[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated
                            times.
[--desc]        :: A description for the object.
[--cloud]        :: Name of a Storage Cloud or its unique id.
[--max-snaps]    :: Maximum number of snapshots to retain for this schedule, after which the
                            oldest snapshot is removed before a new one is created.
[--days]        :: The days of the week on which this schedule should create snapshots.
                            [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== disk-identify [pd-id] ===
=== snap-schedule-delete [sch-delete] ===
Pulses the disk activity light so that the specified disk can be identified in the cassis.
Deletes a snapshot schedule, snapshots associated with the schedule are not removed.
<pre>
<pre>
<--disk>         :: Name of the physical disk or its unique ID/serial number.
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
[--pattern]     :: Pattern to flash the disk LED lights in, p = short pulse, P = long
[--flags]       :: Optional flags for the operation. [async, force]
                            pulse, d = short delay, D = long delay, ex: pattern=pppD
[--duration]     :: Duration in seconds to repeat the disk identification pattern.
</pre>
</pre>




=== disk-add-spare [pd-add] ===
=== snap-schedule-disable [sch-disable] ===
Adds one or more dedicated hot-spares to the global hotspare pool.
Disables the specified snapshot schedule.
<pre>
<pre>
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== disk-remove-spare [pd-remove] ===
=== snap-schedule-enable [sch-enable] ===
Removes one or more dedicated hot-spares from the global hotspare pool.
Enables the specified snapshot schedule.
<pre>
<pre>
<--disk-list>   :: Comma delimited list of drives (no spaces) to be used for the operation.
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-device-get [spd-get] ===
=== snap-schedule-get [sch-get] ===
Gets information about a specific storage pool device.
Returns information about a specific snapshot schedule.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
                            not allowed.
</pre>
</pre>




=== pool-device-list [spd-list] ===
=== snap-schedule-list [sch-list] ===
Returns a list of all the storage pool devices.
Returns a list of all the snapshot schedules.


=== pool-profile-get [pp-get] ===
=== snap-schedule-modify [sch-modify] ===
Gets information about a specific storage pool profile.
Modifies the name, description or other properties of a snapshot schedule.
<pre>
<pre>
<--profile>      :: Specifies an optional IO optimization profile for the storage pool.
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
                             Storage pool profiles control elements like read-ahead, queue depth and
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             other device configurable settings.
                            not allowed.
[--start-date]  :: Start date at which the system will begin creating snapshots for a given
                            schedule.
[--enabled]     :: While the schedule is enabled snapshots will be taken at the designated
                            times.
[--desc]        :: A description for the object.
[--cloud]        :: Name of a Storage Cloud or its unique id.
[--max-snaps]    :: Maximum number of snapshots to retain for this schedule, after which the
                             oldest snapshot is removed before a new one is created.
[--days]        :: The days of the week on which this schedule should create snapshots.
                            [fri, mon, sat, *sun, thu, tue, wed]
[--hours]        :: For the specified days of the week, snapshots will be created at the
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm,  
                             *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-profile-list [pp-list] ===
=== snap-schedule-remove [sch-remove] ===
Returns a list of all the storage pool profiles.
Removes one or more volumes/shares from the specified schedule.
<pre>
<--schedule>    :: Name of a snapshot schedule or its unique ID (GUID).
[--volume-list]  :: A list of one or more storage volumes.
[--share-list]  :: A list of one or more network shares.
</pre>


== Pool Replication Management (DEPRECATED) ==


=== pool-replink-create [prl-create] ===
=== snap-schedule-trigger [sch-trigger] ===
Create a async remote replication link between two storage pools.
Triggers the specified schedule to run immediately.
<pre>
<pre>
<--primary-pool> :: Primary storage pool, source of data transfer for replication.
<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
<--secondary-pool> :: Secondary storage pool, target of data transfer for replication.
<--primary-address> :: Primary system target port.
<--secondary-address> :: Secondary system target port.
[--protocol-type] :: Replication protocol type
[--resync-rate]  :: Resync rate in KB/sec
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-replink-modify [prl-modify] ===
== iSCSI Session Management ==
Modify the async remote replication link between pools.
 
=== session-close [sn-close] ===
Forcibly closes the specified iSCSI session; generally not recommended, use acl-remove instead.
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
<--session>     :: iSCSI session identifier for an active iSCSI session.
[--sendbuf-size] :: Maximum network send-buffer size.
[--cong-policy]  :: Congestion policy.
[--cong-fill-size] :: Congestion fill size.
[--resync-rate]  :: Resync rate in KB/sec
[--barriers]    :: Disk barriers
[--disk-flushes] :: Disk flushes IO
[--resource]    :: Enable DRBD Proxy
[--source-ip]    :: Source system IP address or port name.
[--target-ip]    :: Target system IP address or port name.
[--replication-portnum] :: Port number on which the replication data flows between the source and
                            target systems (7789-7799)
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== pool-replink-delete [prl-delete] ===
=== session-get [sn-get] ===
Delete the remote replication link between two storage pools.
Returns detailed information on a specific iSCSI session.
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
<--session>     :: iSCSI session identifier for an active iSCSI session.
</pre>
</pre>




=== pool-replink-demote [prl-demote] ===
=== session-list [sn-list] ===
Demote the specified storage pool to be a secondary.
Returns a list of all the active iSCSI sessions.
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
[--volume]      :: Name of the storage volume or its unique ID (GUID).
[--host]        :: Name of the host or its unique ID (GUID).
</pre>
</pre>




=== pool-replink-promote [prl-promote] ===
== Network Share Management ==
Promote the specified pool to be a primary.
 
=== share-ad-user-group-enum [shr-ad-ug-enum] ===
Returns a list of all the users and groups in the domain that QuantaStor is in.
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
<--storage-system> :: Name or ID of a storage system in a management grid.
[--share]        :: Name or ID of a network share.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-replink-suspend [prl-suspend] ===
=== share-client-add [shr-cadd] ===
Suspend the replication for the specified pool remote replication link.
Adds a client for the specified network share.
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
<--share>       :: Name or ID of a network share.
<--filter>      :: A filter string for the client
[--async]        :: Use asynchronous communication between NFS server and client
[--secure]      :: Requires the requests to originate from an Internet port less than
                            IPPORT_RESERVED
[--subtree]      :: Enables subtree checking
[--rdonly]      :: Allow only read requests for the NFS volume
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-replink-resume [prl-resume] ===
=== share-client-enum [shr-cenum] ===
Resume the replication for the specified pool remote replication link.
Returns a list of clients for the specified network share.
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
<--share>       :: Name or ID of a network share.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== pool-replink-list [prl-list] ===
=== share-client-get [shr-cget] ===
List the remote replication links between pools
Returns information about the specific network share client.
 
=== pool-replink-get [prl-get] ===
Get info about a specific remote replication link between two pools
<pre>
<pre>
<--replication-link> :: Name or ID of the storage pool replication link/configuration
<--share>       :: Name or ID of a network share.
<--filter>      :: A filter string for the client
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




== Storage Pool HA Failover Management ==
=== share-client-modify [shr-cmodify] ===
 
Modifies a client for the specified network share.
=== ha-group-create [hag-create] ===
Creates a new storage pool high-availability group.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--share>       :: Name or ID of a network share.
                            not allowed.
<--filter>       :: A filter string for the client
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--rdonly]      :: Allow only read requests for the NFS volume
<--sys-secondary> :: Storage system associated with the failover group secondary node
[--secure]       :: Requires the requests to originate from an Internet port less than
[--sys-primary] :: Storage system associated with the failover group primary node
                            IPPORT_RESERVED
[--desc]         :: A description for the object.
[--async]       :: Use asynchronous communication between NFS server and client
[--ha-module]   :: Name or UUID of a storage pool high-availability module
[--subtree]      :: Enables subtree checking
[--flags]       :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== ha-group-modify [hag-modify] ===
=== share-client-remove [shr-cremove] ===
Modifies the settings for the specified high-availability group
Removes a client for the specified network share.
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--share>        :: Name or ID of a network share.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--filter>      :: A filter string for the client
                             not allowed.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
 
 
=== share-clone [shr-clone] ===
Creates a full copy of the specified network share to another storage pool.
<pre>
<--share>       :: Name or ID of a network share.
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--name]        :: Name for the clone, if not provided the source volume name will be used
                             as a prefix.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--sys-secondary] :: Storage system associated with the failover group secondary node
[--flags]       :: Optional flags for the operation. [async, force]
[--ha-module]   :: Name or UUID of a storage pool high-availability module
</pre>
</pre>




=== ha-group-delete [hag-delete] ===
=== share-create [shr-create] ===
Deletes the specified high-availability group
Creates a new NFSv3 network share.
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--pool>         :: Name of the storage pool or its unique ID (GUID).
[--desc]        :: A description for the object.
[--public]      :: Indicates that the specified network share should be made public and
                            open for read/write access to all systems on the network.
[--active]      :: Indicates that the network share should be activated.
[--cifs-enable]  :: Enables Samba support for network share.
[--user-access-list] :: List of users with permission to access the network share.
[--cifs-options] :: Additional CIFS/Samba configuration options specified as
                            'key=value,key2=value2,...'.
[--space-quota]  :: Size of the quota for the network share (optional).
[--disable-snap-browsing] :: When this is true, ability to browse snapshot directories over CIFS is
                            disabled.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== ha-group-failover [hag-failover] ===
=== share-delete [shr-delete] ===
Manually triggers a failover of the specified storage pool using the associated storage pool HA group policy.
Deletes the specified network share
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--share>       :: Name or ID of a network share.
<--storage-system> :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== ha-group-activate [hag-activate] ===
=== share-get [shr-get] ===
Activates/enables the specified high-availability group to failover can occur on a system outage.
Returns information about the specified network share.
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--share>       :: Name or ID of a network share.
</pre>
</pre>




=== ha-group-deactivate [hag-deactivate] ===
=== share-join-domain [shr-jdomain] ===
Deactivates the specified high-availability group so that failover policies are disabled.
Joins the specified domain/realm.
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--storage-system> :: Name or ID of a storage system in a management grid.
<--domain>      :: The name of the domain to have the QuantaStor system join. (DOMAIN)
<--realm>        :: The name of the realm that the domain is in. (DOMAIN.COM)
<--kdc>          :: The name of the active directory machine.
<--ad-admin>    :: The administrator account of the domain that QuantaStor is a member of.
<--ad-password>  :: The password to the administrator account of the domain that QuantaStor
                            is a member of.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== ha-group-get [hag-get] ===
=== share-leave-domain [shr-ldomain] ===
Gets information about the specified storage pool HA group
Leaves the current domain.
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--storage-system> :: Name or ID of a storage system in a management grid.
[--ad-admin]    :: The administrator account of the domain that QuantaStor is a member of.
[--ad-password]  :: The password to the administrator account of the domain that QuantaStor
                            is a member of.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== ha-group-list [hag-list] ===
=== share-list [shr-list] ===
Returns a list of all the HA groups
Returns a list of all the network shares in the system.


=== ha-module-get [ham-get] ===
=== share-modify [shr-modify] ===
Gets information about the specified storage pool HA module
Modifies the properties of the specified network share.
<pre>
<pre>
<--ha-module>   :: Name or UUID of a storage pool high-availability module
<--share>       :: Name or ID of a network share.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--active]      :: Indicates that the network share should be activated.
[--space-quota]  :: Size of the quota for the network share (optional).
[--sync]        :: Synchroniztion policy to use for handling writes to the storage pool
                            (standard, always, none).  standard mode is a hybrid of write-through and
                            write-back caching based on the O_SYNC flag, always mode is write-through
                            to ZIL which could be SSD cache, and disabled indicates to always use
                            async writes. [always, disabled, *standard]
[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] |
                            zle | lz4)
[--copies]      :: Indicates the number of copies of each block should be maintained in the
                            storage pool.  This is a way of getting duplicates for bit-rot protection
                            on a single device.
[--cifs-enable]  :: Enables Samba support for network share.
[--user-access-list] :: List of users with permission to access the network share.
[--cifs-options] :: Additional CIFS/Samba configuration options specified as
                            'key=value,key2=value2,...'.
[--disable-snap-browsing] :: When this is true, ability to browse snapshot directories over CIFS is
                            disabled.
</pre>
</pre>




=== ha-module-list [ham-list] ===
=== share-snapshot [shr-snap] ===
Returns a list of all the HA failover modules
Creates and instant space efficient snapshot of the specified network share (requires Advanced Storage Pool)
 
=== ha-interface-create [hai-create] ===
Creates a new virtual network interface for the specified HA failover group.
<pre>
<pre>
<--ha-group>     :: Name or UUID of a storage pool high-availability group
<--share>       :: Name or ID of a network share.
<--parent-port>  :: Parent network port like 'eth0' which the virtual interface should be
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                            attached to.  On failover the virtual interface will attach to the port
                             not allowed.
                            with the same name on the failover/secondary node.
<--ip-address>  :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--netmask]     :: Subnet IP mask (ex: 255.255.255.0)
[--interface-tag] :: Tags are a alpha-numeric tag which is appended onto a given HA virtual
                             interface for easy identification.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--gateway]     :: IP address of the network gateway
[--flags]       :: Optional flags for the operation. [async, force]
[--mac-address] :: MAC Address
[--iscsi-enable] :: Enables or disables iSCSI access to the specified port(s).
</pre>
</pre>




=== ha-interface-delete [hai-delete] ===
== Storage Tier Management ==
Deletes the specified virtual network interface resource from the HA group
 
=== storage-tier-create [st-create] ===
Creates a new storage storage tier comprised of the specified storage pools
<pre>
<pre>
<--ha-interface> :: Name or UUID of a storage pool high-availability virtual network
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                             interface
                            not allowed.
<--pool-list>   :: List of storage pools.
[--desc]        :: A description for the object.
[--storage-class] :: The classification/primary use case of the storage such as
                            Backup/Archive, High-Performance, or General Purpose.
[--storage-type] :: Type of the storage pools included in this tier: SATA, SAS, SSD, SSHD,
                            MULTI, Unknown [AOE, MULTI, *SAS, SATA, SSD, SSHD, UNKNOWN]
[--perf-level]  :: An estimation of the relative performance of the storage teir as a
                             simplified number in the range of 1 to 100.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== ha-interface-get [hai-get] ===
=== storage-tier-delete [st-delete] ===
Gets information about the specified storage pool HA virtual network interface
Deletes the specified storage storage tier (pools are not deleted).
<pre>
<pre>
<--ha-interface> :: Name or UUID of a storage pool high-availability virtual network
<--tier>         :: Storage tier is a group of one or more storage pools used to simplify
                             interface
                             storage provisioning by teir/category/classification.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== ha-interface-list [hai-list] ===
=== storage-tier-get [st-get] ===
Returns a list of all the HA interfaces on the specified group
Returns information about a specific storage storage tier.
<pre>
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
                            storage provisioning by teir/category/classification.
</pre>
 


== Resource Group Quota Management ==
=== storage-tier-list [st-list] ===
Returns a list of all the storage storage tiers.


=== quota-create [q-create] ===
=== storage-tier-modify [st-modify] ===
Creates a new storage quota on a pool for the specified storage cloud.
Modifies the name, description or other property of the specified storage tier.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
                            storage provisioning by teir/category/classification.
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--pool>        :: Name of the storage pool or its unique ID (GUID).
<--cloud>        :: Name of a Storage Cloud or its unique id.
[--policy]      :: Indicates the type of quota to be created. [hard, *soft]
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--psize]        :: The total thin-provisionable space allowed by this quota.
[--storage-class] :: The classification/primary use case of the storage such as
[--usize]       :: The total utilizable space allowed by this quota which may be less than
                             Backup/Archive, High-Performance, or General Purpose.
                             the provisionable space.
[--storage-type] :: Type of the storage pools included in this tier: SATA, SAS, SSD, SSHD,  
[--max-volumes] :: The maximum number of volumes that can be created using this quota,  
                             MULTI, Unknown [AOE, MULTI, *SAS, SATA, SSD, SSHD, UNKNOWN]
                             specify 0 for no limit.
[--perf-level]  :: An estimation of the relative performance of the storage teir as a
[--max-shares]  :: The maximum number of share that can be created using this quota,
                             simplified number in the range of 1 to 100.
                             specify 0 for no limit.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== quota-modify [q-modify] ===
=== storage-tier-pool-add [stp-add] ===
Modifies one to change the name and/or description of a storage quota.
Adds one or more pools to the specified storage tier.
<pre>
<pre>
<--quota>       :: Name or ID of a storage quota.
<--tier>         :: Storage tier is a group of one or more storage pools used to simplify
<--cloud>        :: Name of a Storage Cloud or its unique id.
                             storage provisioning by teir/category/classification.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--pool-list>    :: List of storage pools.
                             not allowed.
[--desc]        :: A description for the object.
[--psize]        :: The total thin-provisionable space allowed by this quota.
[--usize]        :: The total utilizable space allowed by this quota which may be less than
                            the provisionable space.
[--max-volumes]  :: The maximum number of volumes that can be created using this quota,
                            specify 0 for no limit.
[--max-shares]  :: The maximum number of share that can be created using this quota,
                            specify 0 for no limit.
[--policy]      :: Indicates the type of quota to be created. [hard, *soft]
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== quota-delete [q-delete] ===
=== storage-tier-pool-remove [stp-remove] ===
Deletes a storage quota, the associated volumes are not deleted.
Removes one or more pools from the specified storage tier.
<pre>
<pre>
<--quota>       :: Name or ID of a storage quota.
<--tier>         :: Storage tier is a group of one or more storage pools used to simplify
[--flags]        :: Optional flags for the operation. [async, force]
                            storage provisioning by teir/category/classification.
<--pool-list>    :: List of storage pools.
</pre>
</pre>




=== quota-list [q-list] ===
== Storage System Replication Link Management ==
Returns a list of all the storage quotas.


=== quota-get [q-get] ===
=== link-create [sl-create] ===
Returns information about a specific storage quota.
Create a new storage system link so that storage volumes may be replicated between storage systems.
<pre>
<pre>
<--quota>       :: Name or ID of a storage quota.
<--storage-system> :: Name or ID of a storage system in a management grid.
<--remote-ip>    :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--remote-admin] :: Remote admin user account to establish remote storage system link with.
[--remote-passwd] :: Remote admin user password.
[--local-ip]    :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--bw-limit]    :: Limits the replication bandwidth between two storage systems to a set
                            level specified in units of kilobytes per second (KB/sec). Specify 0 to
                            indicate no limit.
[--link-type]    :: Type of storage system link to establish.
[--desc]        :: A description for the object.
</pre>
</pre>




=== quota-volume-add [qv-add] ===
=== link-delete [sl-delete] ===
Adds one or more volumes to the specified quota.
Delete an existing storage system link.
<pre>
<pre>
<--quota>       :: Name or ID of a storage quota.
<--link>         :: Storage system link ID or name.
<--volume-list>  :: A list of one or more storage volumes.
</pre>
</pre>




=== quota-volume-remove [qv-remove] ===
=== link-get [sl-get] ===
Removes one or more volumes from the specified quota
Get information about the storage system link.
<pre>
<pre>
<--quota>       :: Name or ID of a storage quota.
<--link>         :: Storage system link ID or name.
<--volume-list>  :: A list of one or more storage volumes.
</pre>
</pre>




=== quota-share-assoc-list [qs-alist] ===
=== link-list [sl-list] ===
Returns a list of all the associated quotas of a specified share.
List the existing storage system remote replication links.
 
=== link-modify [sl-modify] ===
Modify the properties of the storage system link.
<pre>
<pre>
<--share>       :: Name or ID of a network share.
<--link>         :: Storage system link ID or name.
<--remote-ip>    :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--local-ip]    :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--desc]        :: A description for the object.
[--bw-limit]    :: Limits the replication bandwidth between two storage systems to a set
                            level specified in units of kilobytes per second (KB/sec). Specify 0 to
                            indicate no limit.
[--link-type]    :: Type of storage system link to establish.
</pre>
</pre>




=== quota-volume-assoc-list [qv-alist] ===
=== link-set-credentials [sl-setcred] ===
Returns a list of all the associated quotas of a specified volume.
Change the credentials for an existing storage system link.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--link>         :: Storage system link ID or name.
</pre>
[--remote-admin] :: Remote admin user account to establish remote storage system link with.
 
[--remote-passwd] :: Remote admin user password.
 
=== quota-share-add [qs-add] ===
Adds one or more shares to the specified quota.
<pre>
<--quota>        :: Name or ID of a storage quota.
<--share-list>  :: A list of one or more network shares.
</pre>
 
 
=== quota-share-remove [qs-remove] ===
Removes one or more shares from the specified quota.
<pre>
<--quota>        :: Name or ID of a storage quota.
<--share-list>  :: A list of one or more network shares.
</pre>
</pre>


Line 2,390: Line 2,588:
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.
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-shutdown [shutdown] ===
=== system-metadata-recovery-point-list [smrp-list] ===
Shutdown the storage system.
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>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--service-only] :: Shutdown just the management service and not the system.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
=== system-restart [restart] ===
Restarts the entire storage system.
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
=== system-upgrade [upgrade] ===
Upgrade to the latest version of the core packages.
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>


Line 2,437: Line 2,617:




=== system-metadata-recovery-point-list [smrp-list] ===
=== system-restart [restart] ===
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.
Restarts the entire storage system.
<pre>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




== Network Interface Management ==
=== system-shutdown [shutdown] ===
 
Shutdown the storage system.
=== target-port-get [tp-get] ===
Returns information about the specified target port.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--service-only] :: Shutdown just the management service and not the system.
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== target-port-list [tp-list] ===
=== system-upgrade [upgrade] ===
Returns a list of all the target ports in the system.
Upgrade to the latest version of the core packages.
 
=== target-port-restart [tp-restart] ===
Restarts the specified target port.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== target-port-disable [tp-disable] ===
== Network Interface Management ==
Disables the specified target port.
 
=== bonded-interface-create [bond-create] ===
Creates a bonded network interface by bonding/teaming together a group of one or more physical network ports.
<pre>
<pre>
<--port>         :: Name or MAC address of the target port.
<--ip-address>  :: IP Address of the host being added; if unspecified the service will look
                            it up.
<--port-list>   :: List of target ports to be bonded together.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--gateway]      :: IP address of the network gateway
[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to
                            9000 to enable jumbo frames.
[--desc]        :: A description for the object.
[--bond-mode]    :: Round-robin balancing is the default mode but if you are using bonding
                            across switches you must use LACP and have switch infrastructure that
                            supports it. [lacp, *round-robin]
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== target-port-enable [tp-enable] ===
=== bonded-interface-delete [bond-delete] ===
Enables the specified target port.
Deletes the specified bonded network interface.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
<--port>        :: Name of unique ID of a physical network port/target port.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== target-port-rescan [tp-rescan] ===
=== fiber-channel-port-disable [fcp-disable] ===
Discovers new target ports and/or any manual modifications made to the configuration of the target ports.
Disables the specified fiber channel port.
<pre>
<pre>
[--storage-system] :: Name or ID of a storage system in a management grid.
<--port>        :: Name or MAC address of the target port.
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== target-port-modify [tp-modify] ===
=== fiber-channel-port-enable [fcp-enable] ===
Modifies target port settings including IP address, gateway, mtu, etc.
Enables the specified fiber channel port.
<pre>
<pre>
<--port>        :: Name or MAC address of a target port, or 'all' to modify all ports.
<--port>        :: Name or MAC address of the target port.
[--port-type]    :: Port configuration type. (static, dhcp)
[--ip-address]  :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--gateway]      :: IP address of the network gateway
[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to
                            9000 to enable jumbo frames.
[--iscsi-enable] :: Enables or disables iSCSI access to the specified port(s).
[--desc]        :: A description for the object.
[--float-list]  :: List of physical ports and/or bonded ports that the virtual interface is
                            allowed to float between.  If a physical port goes offline the system
                            will automatically float the virtual interface to one of the online
                            physical ports in the float list.
[--bond-mode]    :: Round-robin balancing is the default mode but if you are using bonding
                            across switches you must use LACP and have switch infrastructure that
                            supports it. [lacp, *round-robin]
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== infiniband-port-list [ibp-list] ===
=== fiber-channel-port-get [fcp-get] ===
Returns a list of all the infiniband ports in the system.
Returns information about the specified fiber channel target port.
 
=== infiniband-port-get [ibp-get] ===
Returns information about the specified infiniband port.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
<--port>        :: Name or MAC address of the target port.
Line 2,527: Line 2,697:
Returns a list of all the fiber channel target ports in the system.
Returns a list of all the fiber channel target ports in the system.


=== fiber-channel-port-get [fcp-get] ===
=== infiniband-port-get [ibp-get] ===
Returns information about the specified fiber channel target port.
Returns information about the specified infiniband port.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
<--port>        :: Name or MAC address of the target port.
Line 2,535: Line 2,705:




=== fiber-channel-port-disable [fcp-disable] ===
=== infiniband-port-list [ibp-list] ===
Disables the specified fiber channel port.
Returns a list of all the infiniband ports in the system.
 
=== target-port-disable [tp-disable] ===
Disables the specified target port.
<pre>
<--port>        :: Name or MAC address of the target port.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
 
 
=== target-port-enable [tp-enable] ===
Enables the specified target port.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
<--port>        :: Name or MAC address of the target port.
Line 2,543: Line 2,724:




=== fiber-channel-port-enable [fcp-enable] ===
=== target-port-get [tp-get] ===
Enables the specified fiber channel port.
Returns information about the specified target port.
<pre>
<pre>
<--port>        :: Name or MAC address of the target port.
<--port>        :: Name or MAC address of the target port.
Line 2,551: Line 2,732:




=== virtual-interface-create [vif-create] ===
=== target-port-list [tp-list] ===
Creates a new virtual network interface which is linked to a physical network port.
Returns a list of all the target ports in the system.
 
=== target-port-modify [tp-modify] ===
Modifies target port settings including IP address, gateway, mtu, etc.
<pre>
<pre>
<--parent-port:: Port that the virtual interface should initially be attached to.
<--port>        :: Name or MAC address of a target port, or 'all' to modify all ports.
<--ip-address>   :: IP Address of the host being added; if unspecified the service will look  
[--port-type]    :: Port configuration type. (static, dhcp)
[--ip-address]   :: IP Address of the host being added; if unspecified the service will look  
                             it up.
                             it up.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--gateway]      :: IP address of the network gateway
[--gateway]      :: IP address of the network gateway
[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to
                            9000 to enable jumbo frames.
[--iscsi-enable] :: Enables or disables iSCSI access to the specified port(s).
[--desc]        :: A description for the object.
[--float-list]  :: List of physical ports and/or bonded ports that the virtual interface is  
[--float-list]  :: List of physical ports and/or bonded ports that the virtual interface is  
                             allowed to float between.  If a physical port goes offline the system  
                             allowed to float between.  If a physical port goes offline the system  
                             will automatically float the virtual interface to one of the online  
                             will automatically float the virtual interface to one of the online  
                             physical ports in the float list.
                             physical ports in the float list.
[--mtu]         :: Maximum transmission unit (MTU) for the target port, commonly set to
[--bond-mode]   :: Round-robin balancing is the default mode but if you are using bonding
                             9000 to enable jumbo frames.
                            across switches you must use LACP and have switch infrastructure that
[--desc]         :: A description for the object.
                             supports it. [lacp, *round-robin]
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== virtual-interface-delete [vif-delete] ===
=== target-port-rescan [tp-rescan] ===
Deletes the specified virtual network interface.
Discovers new target ports and/or any manual modifications made to the configuration of the target ports.
<pre>
<pre>
<--port>        :: Name of unique ID of a physical network port/target port.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== virtual-interface-move [vif-move] ===
=== target-port-restart [tp-restart] ===
Moves the specified virtual network interface to a different physical network port.
Restarts the specified target port.
<pre>
<pre>
<--vif>         :: Name of unique ID (GUID) for the virtual interface.
<--port>         :: Name or MAC address of the target port.
<--port>        :: Name of unique ID of a physical network port/target port.
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== bonded-interface-create [bond-create] ===
=== virtual-interface-create [vif-create] ===
Creates a bonded network interface by bonding/teaming together a group of one or more physical network ports.
Creates a new virtual network interface which is linked to a physical network port.
<pre>
<pre>
<--parent-port>  :: Port that the virtual interface should initially be attached to.
<--ip-address>  :: IP Address of the host being added; if unspecified the service will look  
<--ip-address>  :: IP Address of the host being added; if unspecified the service will look  
                             it up.
                             it up.
<--port-list>    :: List of target ports to be bonded together.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--storage-system] :: Name or ID of a storage system in a management grid.
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
[--gateway]      :: IP address of the network gateway
[--gateway]      :: IP address of the network gateway
[--float-list]  :: List of physical ports and/or bonded ports that the virtual interface is
                            allowed to float between.  If a physical port goes offline the system
                            will automatically float the virtual interface to one of the online
                            physical ports in the float list.
[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to  
[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to  
                             9000 to enable jumbo frames.
                             9000 to enable jumbo frames.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--bond-mode]    :: Round-robin balancing is the default mode but if you are using bonding
                            across switches you must use LACP and have switch infrastructure that
                            supports it. [lacp, *round-robin]
[--flags]        :: Optional flags for the operation. [async, force, *none]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== bonded-interface-delete [bond-delete] ===
=== virtual-interface-delete [vif-delete] ===
Deletes the specified bonded network interface.
Deletes the specified virtual network interface.
<pre>
<pre>
<--port>        :: Name of unique ID of a physical network port/target port.
</pre>
=== virtual-interface-move [vif-move] ===
Moves the specified virtual network interface to a different physical network port.
<pre>
<--vif>          :: Name of unique ID (GUID) for the virtual interface.
<--port>        :: Name of unique ID of a physical network port/target port.
<--port>        :: Name of unique ID of a physical network port/target port.
</pre>
</pre>
Line 2,639: Line 2,837:




== Storage Volume Management ==
== Task Management ==


=== volume-create [v-create] ===
=== task-cancel [t-cancel] ===
Creates a new storage volume in the specified storage pool.
Cancels the specified task that is in the queue or is running.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--task>        :: ID of a task.
                            not allowed.
<--size>        :: Size may be specified in MiB, GiB, or TiB. examples: 4G, 100M, 1.4T
<--pool>        :: Name of the storage pool or its unique ID (GUID).
[--desc]        :: A description for the object.
[--thin]        :: Thin provision (sparse allocate) the storage volume.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--chap-policy]  :: CHAP setting can be 'target' which is unique to a storage volume, 'user'
                            or 'resource-group' which inherits the chap user/pass from your user
                            account or storage cloud respectively. [cloud-defaults, *disabled,
                            target, user-defaults]
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--count]        :: The number of volumes to create, default is 1.
[--blocksize]    :: Volume block size in KB, valid values are 8, 16, 32, 64, 128. Larger
                            values deliver higher performance for workloads with high sequential IO.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-modify [v-modify] ===
=== task-clear-all [t-clear-all] ===
Modifies a the name, description or other properties of the storage volume.
Clears all the completed and/or failed tasks from the task log so that only the running and queued tasks remain, if any.
<pre>
 
<--volume>       :: Name of the storage volume or its unique ID (GUID).
=== task-get [t-get] ===
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
Returns information about the specified task.
<pre>
<--task>         :: ID of a task.
</pre>
 
 
=== task-list [t-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 aquired. 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.
 
== User Group Management ==
 
=== tc-commands ===
List of commands for tab completion
<pre>
[--command]      :: Command to show method args for.
</pre>
 
 
=== user-group-create [ug-create] ===
Creates a new storage user group comprised of the specified users.
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--user-list>    :: A list of one or more users.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--flags]        :: Optional flags for the operation. [async]
[--flags]        :: Optional flags for the operation. [async]
[--chap-policy]  :: CHAP setting can be 'target' which is unique to a storage volume, 'user'
</pre>
                            or 'resource-group' which inherits the chap user/pass from your user
 
                            account or storage cloud respectively. [cloud-defaults, *disabled,
 
                            target, user-defaults]
=== user-group-delete [ug-delete] ===
[--chap-user]    :: An optional iSCSI CHAP username.
Deletes a storage user group, the users are not deleted unless the delete-users flag is set.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--clear-snap-flag] :: Promotes a snapshot volume to standard (non-snapshot) volume.
[--enable-wb-cache] :: Enables the write-back cache on the iSCSI target driver, this option
                            uses volatile system RAM for cache and is not recommended.
[--is-active-checkpoint] :: Tags the checkpoint device so that it cannot be replicated over.  Use
                            this for DR failover and this flag is set automatically when a failover
                            checkpoint volume has an active iSCSI session.
[--sync]        :: Synchroniztion policy to use for handling writes to the storage pool
                            (standard, always, none).  standard mode is a hybrid of write-through and
                            write-back caching based on the O_SYNC flag, always mode is write-through
                            to ZIL which could be SSD cache, and disabled indicates to always use
                            async writes. [always, disabled, *standard]
[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] |
                            zle | lz4)
[--copies]      :: Indicates the number of copies of each block should be maintained in the
                            storage pool.  This is a way of getting duplicates for bit-rot protection
                            on a single device.
</pre>
 
 
=== volume-delete [v-delete] ===
Deletes a storage volume, *WARNING* any data in the volume will be lost.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--user-group>   :: An arbirary group of one or more users.
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-resize [v-resize] ===
=== user-group-get [ug-get] ===
Resizes a storage volume to make it larger, volumes cannot be reduced in size.
Returns information about a specific storage user group.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--user-group>   :: An arbirary group of one or more users.
<--new-size>    :: New larger size for the volume specified in MiB, GiB, or TiB. examples:
                            4G, 100M, 1.4T
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-restore [v-restore] ===
=== user-group-list [ug-list] ===
Restores a storage volume to a previous point in time using a snapshot.
Returns a list of all the storage user groups.
 
=== user-group-modify [ug-modify] ===
Modifies the name and/or description of a storage user group.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--user-group>   :: An arbirary group of one or more users.
<--snapshot>    :: Name or ID of a snapshot volume to use as the restore point.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
[--flags]       :: Optional flags for the operation. [async, force]
                            not allowed.
[--desc]         :: A description for the object.
</pre>
</pre>




=== volume-list [v-list] ===
=== user-group-user-add [ugu-add] ===
Returns a list of all the storage volumes.
Adds one or more users to the specified user group.
 
=== volume-get [v-get] ===
Returns information about a specific storage volume.
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--user-group>   :: An arbirary group of one or more users.
<--user-list>    :: A list of one or more users.
</pre>
</pre>




=== volume-snapshot [v-snap] ===
=== user-group-user-remove [ugu-remove] ===
Creates a space efficient copy of the source volume.
Removes one or more users from the specified user group
<pre>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--user-group>   :: An arbirary group of one or more users.
[--name]        :: Name for the snapshot, if not provided the source volume name will be
<--user-list>    :: A list of one or more users.
                            used as a prefix.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--count]        :: The number of snapshots of the specified volume to create, default is 1.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-clone [v-clone] ===
== User Management ==
Creates a complete block copy of the source volume.
 
=== user-add [u-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>
<pre>
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--name>        :: User names may include any alpha-numeric characters '_' and '-', no
[--name]         :: Name for the clone, if not provided the source volume name will be used
                            spaces are allowed.
                            as a prefix.
<--password>    :: A password for the user to use when accessing the QuantaStor management
                            interface.
<--role>         :: Name of a security role or its unique ID (GUID).
[--first-name]   :: User's first name; enclose in double-quotes if it contains spaces.
[--last-name]    :: User's last name; enclose in double-quotes if it contains spaces.
[--email]        :: An email address of the form 'user@example.com' without the quotes.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--access-mode] :: Access mode for the volume. [none, readonly, *readwrite]
[--default-chap-user] :: Default CHAP username for storage volumes owned by a user account which
[--flags]       :: Optional flags for the operation. [async, force]
                            have the CHAP policy set to 'use user default CHAP settings'
[--default-chap-pass] :: Default CHAP password for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--alerts]       :: Alert types to subscribe to. Alerts at the subscribed level are sent to
                            the user's email address automatically when a SMTP server is configured.  
                            [critical, error, info, *none, warning]
</pre>
</pre>




=== volume-utilization-list [vu-list] ===
=== user-get [u-get] ===
Returns volume utilization information for a specific storage volume or all storage volumes if no volume is specified.
Gets information about the specified user.
<pre>
<pre>
[--volume]      :: Name of the storage volume or its unique ID (GUID).
<--user>        :: Name or ID (GUID) of a existing user.
</pre>
</pre>




=== volume-utilization-get [vu-get] ===
=== user-list [u-list] ===
Returns a specific volume utilization metrics for a single volume and specific date.
Returns a list of all the users.
 
=== user-modify [u-modify] ===
Modifies the specified user name, role, and/or description.
<pre>
<pre>
<--id>           :: Unique identifier (GUID) for the object.
<--user>         :: Name or ID (GUID) of a existing user.
</pre>
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
 
 
== Storage Volume Group Management ==
 
=== volume-group-create [vg-create] ===
Creates a new storage volume group comprised of the specified storage volumes
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
<--volume-list>  :: A list of one or more storage volumes.
[--role]        :: Name of a security role or its unique ID (GUID).
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--flags]       :: Optional flags for the operation. [async]
[--default-chap-user] :: Default CHAP username for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--default-chap-pass] :: Default CHAP password for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--alerts]      :: Alert types to subscribe to. Alerts at the subscribed level are sent to
                            the user's email address automatically when a SMTP server is configured.  
                            [critical, error, info, *none, warning]
</pre>
</pre>




=== volume-group-modify [vg-modify] ===
=== user-password-set [passwd] ===
Modifies the name and/or description of a storage volume group.
Changes the password for the specified user
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--user>         :: Name or ID (GUID) of a existing user.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--new-password> :: New password for the user.
                            not allowed.
[--old-password] :: Old password for the user.
[--desc]         :: A description for the object.
</pre>
</pre>




=== volume-group-delete [vg-delete] ===
=== user-remove [u-remove] ===
Deletes a storage volume group, the volumes are not deleted unless the delete-volumes flag is set.
Removes the specified user identified by name or ID.
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--user>         :: Name or ID (GUID) of a existing user.
[--destroy-volumes] :: If 'true' all the volumes in the group will be deleted with the volume
                            group, default is 'false'.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-group-snapshot [vg-snap] ===
== Storage Volume Access Control (LUN Masking) ==
Creates a space efficient copy of all volumes in the group.
 
=== volume-assign [va-add] ===
Enables access to the specific volume from the specified host.
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--volume>       :: Name of the storage volume or its unique ID (GUID).
[--name-suffix]  :: Name for the snapshot/clone; if unspecified the snapshot/clone will use
<--host-list>    :: A list of one or more hosts by name or ID.
                            the original name with '_snapNN'/'_cloneNN' appended.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--count]        :: The number of snapshots of the specified volume to create, default is 1.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-group-clone [vg-clone] ===
=== volume-assign-list [va-list] ===
Creates a complete block by block copy of all volumes in the group.
Returns a list of all the volume to host assignments, optionally filtered by host or storage volume.
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
[--volume]       :: Name of the storage volume or its unique ID (GUID).
[--pool]         :: Name of the storage pool or its unique ID (GUID).
[--host]         :: Name of the host or its unique ID (GUID).
[--name-suffix] :: Name for the snapshot/clone; if unspecified the snapshot/clone will use
                            the original name with '_snapNN'/'_cloneNN' appended.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== volume-group-list [vg-list] ===
=== volume-unassign [va-remove] ===
Returns a list of all the storage volume groups.
Disables access to the specific volume from the specified host.
 
=== volume-group-get [vg-get] ===
Returns information about a specific storage volume group.
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--volume>      :: Name of the storage volume or its unique ID (GUID).
<--host-list>   :: A list of one or more hosts by name or ID.
</pre>
</pre>




=== volume-group-volume-add [vgv-add] ===
=== volume-unassign-all [va-remove-all] ===
Adds one or more volumes to the specified volume group.
Disables all access to the specified volume, host, or host group.
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--volume>       :: Name of the storage volume or its unique ID (GUID).
<--volume-list>  :: A list of one or more storage volumes.
</pre>
</pre>




=== volume-group-volume-remove [vgv-remove] ===
== Storage Volume Group Management ==
Removes one or more volumes from the specified volume group
 
=== volume-group-clone [vg-clone] ===
Creates a complete block by block copy of all volumes in the group.
<pre>
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--volume-group> :: An arbirary group of one or more storage volumes.
<--volume-list> :: A list of one or more storage volumes.
[--pool]        :: Name of the storage pool or its unique ID (GUID).
[--name-suffix] :: Name for the snapshot/clone; if unspecified the snapshot/clone will use
                            the original name with '_snapNN'/'_cloneNN' appended.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




== Storage System Replication Link Management ==
=== volume-group-create [vg-create] ===
 
Creates a new storage volume group comprised of the specified storage volumes
=== link-get [sl-get] ===
Get information about the storage system link.
<pre>
<pre>
<--link>        :: Storage system link ID or name.
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--volume-list>  :: A list of one or more storage volumes.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async]
</pre>
</pre>




=== link-list [sl-list] ===
=== volume-group-delete [vg-delete] ===
List the existing storage system remote replication links.
Deletes a storage volume group, the volumes are not deleted unless the delete-volumes flag is set.
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
[--destroy-volumes] :: If 'true' all the volumes in the group will be deleted with the volume
                            group, default is 'false'.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>


=== link-delete [sl-delete] ===
 
Delete an existing storage system link.
=== volume-group-get [vg-get] ===
Returns information about a specific storage volume group.
<pre>
<pre>
<--link>         :: Storage system link ID or name.
<--volume-group> :: An arbirary group of one or more storage volumes.
</pre>
</pre>




=== link-create [sl-create] ===
=== volume-group-list [vg-list] ===
Create a new storage system link so that storage volumes may be replicated between storage systems.
Returns a list of all the storage volume groups.
 
=== volume-group-modify [vg-modify] ===
Modifies the name and/or description of a storage volume group.
<pre>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
<--volume-group> :: An arbirary group of one or more storage volumes.
<--remote-ip>    :: IP Address of the host being added; if unspecified the service will look
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            it up.
                             not allowed.
[--remote-admin] :: Remote admin user account to establish remote storage system link with.
[--remote-passwd] :: Remote admin user password.
[--local-ip]    :: IP Address of the host being added; if unspecified the service will look
                            it up.
[--bw-limit]    :: Limits the replication bandwidth between two storage systems to a set
                            level specified in units of kilobytes per second (KB/sec). Specify 0 to
                             indicate no limit.
[--link-type]    :: Type of storage system link to establish.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
</pre>
</pre>




=== link-modify [sl-modify] ===
=== volume-group-snapshot [vg-snap] ===
Modify the properties of the storage system link.
Creates a space efficient copy of all volumes in the group.
<pre>
<pre>
<--link>        :: Storage system link ID or name.
<--volume-group> :: An arbirary group of one or more storage volumes.
<--remote-ip>   :: IP Address of the host being added; if unspecified the service will look
[--name-suffix] :: Name for the snapshot/clone; if unspecified the snapshot/clone will use
                            it up.
                             the original name with '_snapNN'/'_cloneNN' appended.
[--local-ip]     :: IP Address of the host being added; if unspecified the service will look
                             it up.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--bw-limit]     :: Limits the replication bandwidth between two storage systems to a set
[--access-mode] :: Access mode for the volume. [none, readonly, *readwrite]
                            level specified in units of kilobytes per second (KB/sec). Specify 0 to  
[--count]        :: The number of snapshots of the specified volume to create, default is 1.
                            indicate no limit.
[--flags]       :: Optional flags for the operation. [async, force]
[--link-type]   :: Type of storage system link to establish.
</pre>
</pre>




=== link-set-credentials [sl-setcred] ===
=== volume-group-volume-add [vgv-add] ===
Change the credentials for an existing storage system link.
Adds one or more volumes to the specified volume group.
<pre>
<pre>
<--link>         :: Storage system link ID or name.
<--volume-group> :: An arbirary group of one or more storage volumes.
[--remote-admin] :: Remote admin user account to establish remote storage system link with.
<--volume-list>  :: A list of one or more storage volumes.
[--remote-passwd] :: Remote admin user password.
</pre>
</pre>




== Storage System Grid Management ==
=== volume-group-volume-remove [vgv-remove] ===
Removes one or more volumes from the specified volume group
<pre>
<--volume-group> :: An arbirary group of one or more storage volumes.
<--volume-list>  :: A list of one or more storage volumes.
</pre>
 


=== grid-get [mg-get] ===
== Storage Volume Management ==
Get general information about the storage system management grid.


=== grid-create [mg-create] ===
=== volume-clone [v-clone] ===
Creates a new management grid.  A given storage system can only be a member of one grid at a time.
Creates a complete block copy of the source volume.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--volume>       :: Name of the storage volume or its unique ID (GUID).
                            not allowed.
[--name]         :: Name for the clone, if not provided the source volume name will be used
[--vif-enable]   :: Enables the use of a virtual interface for grid management.
                             as a prefix.
[--vif-ipaddress] :: Virtual host IP address to be associated with the master node in a the  
                             management grid.
[--vif-netmask]  :: Virtual host netmask to be used with the specified IP address.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--vif-hostname] :: Cluster virtual host name to be associated with the master node in the
[--access-mode] :: Access mode for the volume. [none, readonly, *readwrite]
                            management grid
[--flags]       :: Optional flags for the operation. [async, force]
[--port]         :: Default physical target port to associate the management grid virtual
                            host IP address with.
[--bind-port]   :: This is the network address to bind with the Corosync cluster.
[--grid-num]     :: Defaults to zero (0), increment this to a unique value between 0-9 if
                            you have more than one grid on your network.
</pre>
</pre>




=== grid-modify [mg-modify] ===
=== volume-create [v-create] ===
Modify the management grid properties.
Creates a new storage volume in the specified storage pool.
<pre>
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are  
                             not allowed.
                             not allowed.
[--vif-enable]  :: Enables the use of a virtual interface for grid management.
<--size>        :: Size may be specified in MiB, GiB, or TiB. examples: 4G, 100M, 1.4T
[--vif-ipaddress] :: Virtual host IP address to be associated with the master node in a the
<--pool>        :: Name of the storage pool or its unique ID (GUID).
                            management grid.
[--vif-netmask]  :: Virtual host netmask to be used with the specified IP address.
[--desc]        :: A description for the object.
[--desc]        :: A description for the object.
[--vif-hostname] :: Cluster virtual host name to be associated with the master node in the
[--thin]        :: Thin provision (sparse allocate) the storage volume.
                            management grid
[--access-mode] :: Access mode for the volume. [none, readonly, *readwrite]
[--port]         :: Default physical target port to associate the management grid virtual
[--chap-policy] :: CHAP setting can be 'target' which is unique to a storage volume, 'user'
                             host IP address with.
                            or 'resource-group' which inherits the chap user/pass from your user
[--bind-port]    :: This is the network address to bind with the Corosync cluster.
                             account or storage cloud respectively. [cloud-defaults, *disabled,
[--grid-num]     :: Defaults to zero (0), increment this to a unique value between 0-9 if
                            target, user-defaults]
                             you have more than one grid on your network.
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]   :: An optional iSCSI CHAP password.
[--count]        :: The number of volumes to create, default is 1.
[--blocksize]    :: Volume block size in KB, valid values are 8, 16, 32, 64, 128. Larger
                             values deliver higher performance for workloads with high sequential IO.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




=== grid-delete [mg-delete] ===
=== volume-delete [v-delete] ===
Deletes the management grid.  After the grid is deleted each node in the grid operates independently again.
Deletes a storage volume, *WARNING* any data in the volume will be lost.
 
=== grid-add [mg-add] ===
Adds the specified storage system to the management grid.
<pre>
<pre>
<--node-ipaddress> :: IP address of a storage system node.
<--volume>       :: Name of the storage volume or its unique ID (GUID).
[--node-username] :: Admin user account with permissions to add/remove nodes from the grid.
[--flags]       :: Optional flags for the operation. [async, force]
[--node-password] :: Admin user account password.
</pre>
</pre>




=== grid-remove [mg-remove] ===
=== volume-get [v-get] ===
Removes the specified storage system from the management grid.
Returns information about a specific storage volume.
<pre>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
<--volume>       :: Name of the storage volume or its unique ID (GUID).
</pre>
</pre>




=== grid-set-hosts [mg-set-hosts] ===
=== volume-list [v-list] ===
Configures the /etc/hosts configuration file on all systems to facilitate host name based gluster volume configurations.
Returns a list of all the storage volumes.
<pre>
 
<--portid-list> :: List of UUIDs for the ethernet ports to be used for grid wide /etc/hosts
=== volume-modify [v-modify] ===
                             file configuration.
Modifies a the name, description or other properties of the storage volume.
<pre>
<--volume>      :: Name of the storage volume or its unique ID (GUID).
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--flags]        :: Optional flags for the operation. [async]
[--chap-policy]  :: CHAP setting can be 'target' which is unique to a storage volume, 'user'
                            or 'resource-group' which inherits the chap user/pass from your user
                            account or storage cloud respectively. [cloud-defaults, *disabled,
                            target, user-defaults]
[--chap-user]    :: An optional iSCSI CHAP username.
[--chap-pass]    :: An optional iSCSI CHAP password.
[--clear-snap-flag] :: Promotes a snapshot volume to standard (non-snapshot) volume.
[--enable-wb-cache] :: Enables the write-back cache on the iSCSI target driver, this option
                            uses volatile system RAM for cache and is not recommended.
[--is-active-checkpoint] :: Tags the checkpoint device so that it cannot be replicated over. Use
                            this for DR failover and this flag is set automatically when a failover
                            checkpoint volume has an active iSCSI session.
[--sync]        :: Synchroniztion policy to use for handling writes to the storage pool
                            (standard, always, none).  standard mode is a hybrid of write-through and
                            write-back caching based on the O_SYNC flag, always mode is write-through
                            to ZIL which could be SSD cache, and disabled indicates to always use
                            async writes. [always, disabled, *standard]
[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] |
                            zle | lz4)
[--copies]      :: Indicates the number of copies of each block should be maintained in the
                            storage pool.  This is a way of getting duplicates for bit-rot protection
                             on a single device.
</pre>
</pre>




=== grid-get-hosts [mg-get-hosts] ===
=== volume-resize [v-resize] ===
Returns the /etc/hosts configuration file configuration for grid nodes.
Resizes a storage volume to make it larger, volumes cannot be reduced in size.
<pre>
<--volume>      :: Name of the storage volume or its unique ID (GUID).
<--new-size>    :: New larger size for the volume specified in MiB, GiB, or TiB. examples:
                            4G, 100M, 1.4T
[--flags]        :: Optional flags for the operation. [async, force]
</pre>


=== grid-assoc-list [mg-alist] ===
Returns a list of the associated storage system nodes in the grid.


=== grid-assoc-get [mg-aget] ===
=== volume-restore [v-restore] ===
Get general information about the associated storage system management grid.
Restores a storage volume to a previous point in time using a snapshot.
<pre>
<pre>
<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are
<--volume>       :: Name of the storage volume or its unique ID (GUID).
                            not allowed.
<--snapshot>     :: Name or ID of a snapshot volume to use as the restore point.
<--storage-system> :: Name or ID of a storage system in a management grid.
[--flags]        :: Optional flags for the operation. [async, force]
[--flags]        :: Optional flags for the operation. [async, force, *none]
</pre>
</pre>




=== grid-set-master [mg-set] ===
=== volume-snapshot [v-snap] ===
Sets the master node for a storage system.
Creates a space efficient copy of the source volume.
<pre>
<pre>
<--storage-system> :: Name or ID of a storage system in a management grid.
<--volume>       :: Name of the storage volume or its unique ID (GUID).
[--name]        :: Name for the snapshot, if not provided the source volume name will be
                            used as a prefix.
[--desc]        :: A description for the object.
[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
[--count]        :: The number of snapshots of the specified volume to create, default is 1.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
</pre>




== Storage Tier Management ==
=== volume-utilization-get [vu-get] ===
Returns a specific volume utilization metrics for a single volume and specific date.
<pre>
<--id>          :: Unique identifier (GUID) for the object.
</pre>


=== storage-tier-create [st-create] ===
Creates a new storage storage tier comprised of the specified storage pools
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--pool-list>    :: List of storage pools.
[--desc]        :: A description for the object.
[--storage-class] :: The classification/primary use case of the storage such as
                            Backup/Archive, High-Performance, or General Purpose.
[--storage-type] :: Type of the storage pools included in this tier: SATA, SAS, SSD, SSHD,
                            MULTI, Unknown [AOE, MULTI, *SAS, SATA, SSD, SSHD, UNKNOWN]
[--perf-level]  :: An estimation of the relative performance of the storage teir as a
                            simplified number in the range of 1 to 100.
[--flags]        :: Optional flags for the operation. [async]
</pre>


 
=== volume-utilization-list [vu-list] ===
=== storage-tier-modify [st-modify] ===
Returns volume utilization information for a specific storage volume or all storage volumes if no volume is specified.
Modifies the name, description or other property of the specified storage tier.
<pre>
<pre>
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
[--volume]       :: Name of the storage volume or its unique ID (GUID).
                            storage provisioning by teir/category/classification.
[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
[--storage-class] :: The classification/primary use case of the storage such as
                            Backup/Archive, High-Performance, or General Purpose.
[--storage-type] :: Type of the storage pools included in this tier: SATA, SAS, SSD, SSHD,
                            MULTI, Unknown [AOE, MULTI, *SAS, SATA, SSD, SSHD, UNKNOWN]
[--perf-level]  :: An estimation of the relative performance of the storage teir as a
                            simplified number in the range of 1 to 100.
</pre>
 
 
=== storage-tier-delete [st-delete] ===
Deletes the specified storage storage tier (pools are not deleted).
<pre>
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
                            storage provisioning by teir/category/classification.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
 
 
=== storage-tier-list [st-list] ===
Returns a list of all the storage storage tiers.
 
=== storage-tier-get [st-get] ===
Returns information about a specific storage storage tier.
<pre>
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
                            storage provisioning by teir/category/classification.
</pre>
 
 
=== storage-tier-pool-add [stp-add] ===
Adds one or more pools to the specified storage tier.
<pre>
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
                            storage provisioning by teir/category/classification.
<--pool-list>    :: List of storage pools.
</pre>
 
 
=== storage-tier-pool-remove [stp-remove] ===
Removes one or more pools from the specified storage tier.
<pre>
<--tier>        :: Storage tier is a group of one or more storage pools used to simplify
                            storage provisioning by teir/category/classification.
<--pool-list>    :: List of storage pools.
</pre>
 
 
== Task Management ==
 
=== task-list [t-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 aquired. 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-get [t-get] ===
Returns information about the specified task.
<pre>
<--task>        :: ID of a task.
</pre>
 
 
=== task-cancel [t-cancel] ===
Cancels the specified task that is in the queue or is running.
<pre>
<--task>        :: ID of a task.
</pre>
 
 
=== task-clear-all [t-clear-all] ===
Clears all the completed and/or failed tasks from the task log so that only the running and queued tasks remain, if any.
 
== User Management ==
 
=== user-add [u-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>
<--name>        :: User names may include any alpha-numeric characters '_' and '-', no
                            spaces are allowed.
<--password>    :: A password for the user to use when accessing the QuantaStor management
                            interface.
<--role>        :: Name of a security role or its unique ID (GUID).
[--first-name]  :: User's first name; enclose in double-quotes if it contains spaces.
[--last-name]    :: User's last name; enclose in double-quotes if it contains spaces.
[--email]        :: An email address of the form 'user@example.com' without the quotes.
[--desc]        :: A description for the object.
[--default-chap-user] :: Default CHAP username for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--default-chap-pass] :: Default CHAP password for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--alerts]      :: Alert types to subscribe to. Alerts at the subscribed level are sent to
                            the user's email address automatically when a SMTP server is configured.
                            [critical, error, info, *none, warning]
</pre>
 
 
=== user-modify [u-modify] ===
Modifies the specified user name, role, and/or description.
<pre>
<--user>        :: Name or ID (GUID) of a existing user.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--role]        :: Name of a security role or its unique ID (GUID).
[--desc]        :: A description for the object.
[--default-chap-user] :: Default CHAP username for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--default-chap-pass] :: Default CHAP password for storage volumes owned by a user account which
                            have the CHAP policy set to 'use user default CHAP settings'
[--alerts]      :: Alert types to subscribe to. Alerts at the subscribed level are sent to
                            the user's email address automatically when a SMTP server is configured.
                            [critical, error, info, *none, warning]
</pre>
 
 
=== user-password-set [passwd] ===
Changes the password for the specified user
<pre>
<--user>        :: Name or ID (GUID) of a existing user.
<--new-password> :: New password for the user.
[--old-password] :: Old password for the user.
</pre>
 
 
=== user-remove [u-remove] ===
Removes the specified user identified by name or ID.
<pre>
<--user>        :: Name or ID (GUID) of a existing user.
</pre>
 
 
=== user-list [u-list] ===
Returns a list of all the users.
 
=== user-get [u-get] ===
Gets information about the specified user.
<pre>
<--user>        :: Name or ID (GUID) of a existing user.
</pre>
 
 
== User Group Management ==
 
=== user-group-create [ug-create] ===
Creates a new storage user group comprised of the specified users.
<pre>
<--name>        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
<--user-list>    :: A list of one or more users.
[--desc]        :: A description for the object.
[--flags]        :: Optional flags for the operation. [async]
</pre>
 
 
=== user-group-modify [ug-modify] ===
Modifies the name and/or description of a storage user group.
<pre>
<--user-group>  :: An arbirary group of one or more users.
[--name]        :: Names may include any alpha-numeric characters '_' and '-', spaces are
                            not allowed.
[--desc]        :: A description for the object.
</pre>
 
 
=== user-group-delete [ug-delete] ===
Deletes a storage user group, the users are not deleted unless the delete-users flag is set.
<pre>
<--user-group>  :: An arbirary group of one or more users.
[--flags]        :: Optional flags for the operation. [async, force]
</pre>
 
 
=== user-group-list [ug-list] ===
Returns a list of all the storage user groups.
 
=== user-group-get [ug-get] ===
Returns information about a specific storage user group.
<pre>
<--user-group>  :: An arbirary group of one or more users.
</pre>
 
 
=== user-group-user-add [ugu-add] ===
Adds one or more users to the specified user group.
<pre>
<--user-group>  :: An arbirary group of one or more users.
<--user-list>    :: A list of one or more users.
</pre>
 
 
=== user-group-user-remove [ugu-remove] ===
Removes one or more users from the specified user group
<pre>
<--user-group>  :: An arbirary group of one or more users.
<--user-list>    :: A list of one or more users.
</pre>
</pre>

Revision as of 01:34, 8 October 2014

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.

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.

CLI 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 

CLI Commands

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.

General Commands

help [h]

Help page for all commands. Try 'help --min' for a compacted list of commands, or just 'help' by itself for a verbose listing of all commands with their input parameters. Optionally you can get help on a specific category or command (ex: help --category=volume).

	[--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).

Alert Mangement

alert-clear [a-clear]

Deletes the alert with the specified ID.

	<--id>           :: Unique identifier (GUID) for the object.


alert-clear-all [a-clear-all]

Clears all the alerts.

alert-config-get [ac-get]

Alert configuration settings indicate where alert notifications should be sent.

alert-config-set [ac-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.

	[--sender-email] :: Sender email address to be used for alert emails sent from the storage 
                            system.
	[--smtp-server]  :: IP Address of the SMTP service where emails should be routed through.
	[--smtp-user]    :: SMTP user name to use for secure SMTP access to your SMTP server for 
                            sending alert emails.
	[--smtp-password] :: SMTP password to use for secure SMTP access to your SMTP server.
	[--smtp-auth]    :: SMTP security mode.
	[--support-email] :: Email address for local customer support.
	[--freespace-warning] :: The percentage of free-space left in a pool at which a warning is sent 
                            to indicate pool growth plans should be made.
	[--freespace-alert] :: The percentage (default=10) of free-space left in a pool at which alerts 
                            are generated.
	[--freespace-critical] :: The percentage (default=5) of free-space left in a pool at which all 
                            provisioning operations are blocked.
	[--pagerduty-key] :: Specifies the service key to which alerts will be posted to PagerDuty.  
                            Please see www.pagerduty.com for more detail on service keys.


alert-get [a-get]

Gets information about a specific alert.

	<--id>           :: Unique identifier (GUID) for the object.


alert-list [a-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-raise [a-raise]

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

	<--message>      :: Message string to be echoed back from the server.
	[--alert-severity] :: Severity of the user generated alert to be raise. [always, critical, 
                            error, *info, warning]


event-list [ev-list]

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

	[--index]        :: Starting event index of where to begin listing events from.
	[--max]          :: Maximum number of events to enumerate.
	[--time-stamp]   :: Time-stamp of the service.


Backup Policy Management

backup-job-list [bj-list]

Returns a list of backup jobs in the system.

backup-policy-create [bp-create]

Creates a ingest backup policy which pull data from NFS shares to the QuantaStor appliance.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--desc>         :: A description for the object.
	<--network-share> :: Name or ID of a CIFS/NFS network share.
	<--remote-hostname> :: Name of the remote host containing NFS shares to be backed up
	<--remote-export-path> :: Remote export path to be mounted to access the data to be backed up.
	[--remote-export-type] :: Remote mount type (currently NFS only) [*nfs]
	[--retain-rules] :: Retention rules (atime, ctime, mtime) [atime, ctime, *mtime]
	[--policy-type]  :: Backup policy type [*inbound]
	[--scan-threads] :: Number of concurrent threads for walking/scanning the specified target 
                            export
	[--hours]        :: For the specified days of the week, snapshots will be created at the 
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm, 
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
	[--days]         :: The days of the week on which this schedule should create snapshots. 
                            [fri, mon, sat, *sun, thu, tue, wed]
	[--retain-period] :: Number of days of file history on the specified filer export to backup
	[--purge-policy] :: Indicates how old files should be cleaned up / purged from the backup. 
                            [after-backup, *daily, never, weekly]
	[--enabled]      :: Set to enabled to activate the backup policy.


backup-policy-delete [bp-delete]

Deletes the specified backup policy.

	<--policy>       :: A backup policy name or ID which is associated with a network share to 
                            do ingest backups.


backup-policy-disable [bp-disable]

Disables the specified backup policy so job are not automatically run.

	<--policy>       :: A backup policy name or ID which is associated with a network share to 
                            do ingest backups.


backup-policy-enable [bp-enable]

Enables a backup policy that was previously disabled.

	<--policy>       :: A backup policy name or ID which is associated with a network share to 
                            do ingest backups.


backup-policy-get [bp-get]

Returns detailed information on a specific backup policy.

	<--policy>       :: A backup policy name or ID which is associated with a network share to 
                            do ingest backups.


backup-policy-list [bp-list]

Returns a list of backup policies in the system.

backup-policy-modify [bp-modify]

Modifies the specified backup policy settings.

	<--policy>       :: A backup policy name or ID which is associated with a network share to 
                            do ingest backups.
	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--desc>         :: A description for the object.
	<--network-share> :: Name or ID of a CIFS/NFS network share.
	<--remote-hostname> :: Name of the remote host containing NFS shares to be backed up
	<--remote-export-path> :: Remote export path to be mounted to access the data to be backed up.
	[--remote-export-type] :: Remote mount type (currently NFS only) [*nfs]
	[--retain-rules] :: Retention rules (atime, ctime, mtime) [atime, ctime, *mtime]
	[--policy-type]  :: Backup policy type [*inbound]
	[--scan-threads] :: Number of concurrent threads for walking/scanning the specified target 
                            export
	[--hours]        :: For the specified days of the week, snapshots will be created at the 
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm, 
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
	[--days]         :: The days of the week on which this schedule should create snapshots. 
                            [fri, mon, sat, *sun, thu, tue, wed]
	[--retain-period] :: retain-period
	[--purge-policy] :: Indicates how old files should be cleaned up / purged from the backup. 
                            [after-backup, *daily, never, weekly]
	[--enabled]      :: Set to enabled to activate the backup policy.


backup-policy-trigger [bp-trigger]

Triggers the specified backup policy which in turn starts a backup job.

	<--policy>       :: A backup policy name or ID which is associated with a network share to 
                            do ingest backups.


Ceph Management

ceph-block-device-get [cebd-get]

Gets information about a specific Ceph RDB / block device

	<--ceph-rbd>     :: Ceph RBD/Block Device name or ID


ceph-block-device-list [cebd-list]

Returns a list of all the Ceph RDB / block devices.

ceph-cluster-get [cec-get]

Gets information about a specific Ceph Cluster

	<--ceph-cluster> :: Ceph Cluster name or ID, default is 'ceph'


ceph-cluster-list [cec-list]

Returns a list of all the Ceph Clusters

ceph-ha-intf-get [ci-get]

Returns a list of all the Ceph HA failover interface definitions.

	<--ceph-ha-interface> :: Ceph HA failover interface name, ID, or IP address


ceph-ha-intf-list [ci-list]

Gets information about a specific Ceph HA failover interface definition.

ceph-monitor-get [cem-get]

Gets information about a specific Ceph Monitor

	<--ceph-monitor> :: Ceph Monitor service name or ID.


ceph-monitor-list [cem-list]

Returns a list of all the Ceph Monitors

ceph-osd-create [ceosd-create]

Creates a new Ceph OSD on the specified storage pool

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--desc]         :: A description for the object.


ceph-osd-delete [ceosd-delete]

Deletes the specified Ceph OSD

	<--ceph-osd>     :: Ceph Object Storage Daemon name or ID


ceph-osd-get [ceosd-get]

Gets information about a specific Ceph Object Storage Daemon.

	<--ceph-osd>     :: Ceph Object Storage Daemon name or ID


ceph-osd-list [ceosd-list]

Returns a list of all the Ceph Object Storage Daemons

ceph-pool-create [cep-create]

Creates a new Ceph pool using the specified OSDs or Storage Pools

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool-list>    :: List of one or more storage pools.
	[--desc]         :: A description for the object.
	[--placement-groups] :: Number of placement groups to assign to the Ceph pool.
	[--max-replicas] :: Maximum number of replicas (redundancy level) to be created of each 
                            block in the Ceph pool.
	[--min-replicas] :: Minimum number of replicas to have of each block while still allowing 
                            write access to the Ceph pool.
	[--pool-type]    :: Type of Ceph pool, 'replica' (mirror based, default) or 'erasure' which 
                            is like network RAID5.


ceph-pool-delete [cep-delete]

Deletes the specified Ceph pool

	<--ceph-pool>    :: Ceph Pool name or ID


ceph-pool-get [cep-get]

Gets information about a specific Ceph storage pool.

	<--ceph-pool>    :: Ceph Pool name or ID


ceph-pool-list [cep-list]

Returns a list of all the Ceph storage pools.

ceph-rbd-create [cebd-create]

Creates a new Ceph block device (RBD) in the specified Ceph pool.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--ceph-pool>    :: ceph-pool
	<--size>         :: Size may be specified in MiB, GiB, or TiB. examples: 4G, 100M, 1.4T
	[--desc]         :: A description for the object.


ceph-rbd-delete [cebd-delete]

Deletes the specified Ceph block device (RBD)

	<--ceph-rbd>     :: Ceph RBD/Block Device name or ID


Cloud Container Management

cloud-backup-container-add [cbc-add]

Recovers a cloud backup container that was previously removed or used with a prior installation.

	<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With 
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
	<--locaiton>     :: Cloud storage provider endpoint location.
	<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud 
                            container.
	<--storage-url>  :: The Amazon S3 or other storage URL used to identify a cloud backup 
                            container.
	<--enable-nfs>   :: Enable NFS sharing of the cloud container.


cloud-backup-container-create [cbc-create]

Creates a cloud backup container into which cloud backups of storage volumes can be made.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--desc>         :: A description for the object.
	<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With 
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.
	<--locaiton>     :: Cloud storage provider endpoint location.
	<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud 
                            container.
	<--enable-nfs>   :: Enable NFS sharing of the cloud container.


cloud-backup-container-delete [cbc-delete]

Deletes the specified cloud backup container. WARNING, all data in the container will be destroyed.

	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.


cloud-backup-container-disable [cbc-disable]

Disables access to the specified cloud container without having to remove it.

	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.


cloud-backup-container-enable [cbc-enable]

Enables a cloud container that was previously disabled or was inaccessible due to network connection issues.

	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.


cloud-backup-container-get [cbc-get]

Returns detailed information on a specific cloud backup container.

	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.


cloud-backup-container-list [cbc-list]

Returns a list of cloud backup containers in the system.

cloud-backup-container-modify [cbc-modify]

Modifies the specified cloud backup container settings.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--desc>         :: A description for the object.
	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.
	<--encryption-key> :: A passphrase which is used to encrypt all the data sent to the cloud 
                            container.
	<--enable-nfs>   :: Enable NFS sharing of the cloud container.


cloud-backup-container-remove [cbc-remove]

Removes the specified cloud backup container from the system but does not delete any backup data in the cloud.

	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.


cloud-backup-container-repair [cbc-repair]

Repairs the specified cloud backup container.

	<--container>    :: A cloud backup container into which storage volumes can be backed up.  A 
                            cloud backup container is like an unlimited storage pool in the cloud.


cloud-backup-credentials-add [cbcred-add]

Adds cloud provider credentials to enable cloud backup to cloud backup containers.

	<--access-key>   :: The access key provided by your cloud storage provider for accessing 
                            your cloud storage account.
	<--secret-key>   :: The secret key provided by your cloud storage provider for accessing 
                            your cloud storage account.


cloud-backup-credentials-get [cbcred-get]

Returns information about the specified cloud provider credential.

	<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With 
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.


cloud-backup-credentials-list [cbcred-list]

Returns a list of all the cloud provider credentials in the system. Passwords are masked.

cloud-backup-credentials-remove [cbcred-remove]

Removes the specified cloud provider credentials

	<--provider-creds> :: Credentials for accessing your cloud storage provider account.  With 
                            Amazon S3 this is your 'Access Key ID' and your 'Secret Access Key'.


cloud-backup-provider-get [cbp-get]

Returns detailed information about the specified cloud provider.

	<--provider>     :: A cloud provider is a storage provider like Amazon S3 which QuantaStor 
                            utilizes for backup in the cloud.


cloud-backup-provider-list [cbp-list]

Returns the list of supported cloud providers.

Gluster Management

gluster-brick-get [gb-get]

Gets information about a specific Gluster brick.

	<--gluster-brick> :: Name or ID of a Gluster brick


gluster-brick-list [gb-list]

Returns a list of all the Gluster bricks

gluster-ha-intf-get [gi-get]

Returns a list of all the Gluster HA failover interface definitions.

	<--ha-interface> :: High-availability interface for a specific Gluster Volume.


gluster-ha-intf-list [gi-list]

Gets information about a specific Gluster HA failover interface definition.

gluster-peer-get [gp-get]

Gets information about a specific Gluster peer system

	<--gluster-peer> :: Name or ID of the Gluster peer


gluster-peer-list [gp-list]

Returns a list of all the Gluster peer systems.

gluster-volume-add-bricks [gv-add-bricks]

Adds one or more bricks on the specified volume.

	<--gluster-volume> :: Name or ID of the Gluster volume
	<--pool-list>    :: List of one or more storage pools.
	<--restripe-volume> :: Restripe files across the new Gluster bricks


gluster-volume-create [gv-create]

Create a new Gluster volume with new Bricks on the specified Storage Pools.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	<--pool-list>    :: List of one or more storage pools.
	<--replica-count> :: Number of replia copies to have of each file in the Gluster volume
	<--stripe-volume> :: Enable striping of files across Gluster bricks
	[--flags]        :: Optional flags for the operation. [async, force, *none]


gluster-volume-delete [gv-delete]

Deletes the specified Gluster volume.

	<--gluster-volume> :: Name or ID of the Gluster volume


gluster-volume-get [gv-get]

Gets information about the specified Gluster volume

	<--gluster-volume> :: Name or ID of the Gluster volume


gluster-volume-list [gv-list]

Returns a list of all the Gluster volumes in the grid

gluster-volume-modify [gv-modify]

Modifies the name and/or description of the specified Gluster volume.

	<--gluster-volume> :: Name or ID of the Gluster volume
	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


gluster-volume-rebalance [gv-rebalance]

Rebalances files across the bricks in the specified Gluster volume

	<--gluster-volume> :: Name or ID of the Gluster volume


gluster-volume-start [gv-start]

Starts the specified Gluster volume

	<--gluster-volume> :: Name or ID of the Gluster volume
	[--flags]        :: Optional flags for the operation. [async, force, *none]


gluster-volume-stop [gv-stop]

Stops the specified Gluster volume.

	<--gluster-volume> :: Name or ID of the Gluster volume
	[--flags]        :: Optional flags for the operation. [async, force, *none]


Storage System Grid Management

grid-add [mg-add]

Adds the specified storage system to the management grid.

	<--node-ipaddress> :: IP address of a storage system node.
	[--node-username] :: Admin user account with permissions to add/remove nodes from the grid.
	[--node-password] :: Admin user account password.


grid-assoc-get [mg-aget]

Get general information about the associated storage system management grid.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--storage-system> :: Name or ID of a storage system in a management grid.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


grid-assoc-list [mg-alist]

Returns a list of the associated storage system nodes in the grid.

grid-create [mg-create]

Creates a new management grid. A given storage system can only be a member of one grid at a time.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--vif-enable]   :: Enables the use of a virtual interface for grid management.
	[--vif-ipaddress] :: Virtual host IP address to be associated with the master node in a the 
                            management grid.
	[--vif-netmask]  :: Virtual host netmask to be used with the specified IP address.
	[--desc]         :: A description for the object.
	[--vif-hostname] :: Cluster virtual host name to be associated with the master node in the 
                            management grid
	[--port]         :: Default physical target port to associate the management grid virtual 
                            host IP address with.
	[--bind-port]    :: This is the network address to bind with the Corosync cluster.
	[--grid-num]     :: Defaults to zero (0), increment this to a unique value between 0-9 if 
                            you have more than one grid on your network.


grid-delete [mg-delete]

Deletes the management grid. After the grid is deleted each node in the grid operates independently again.

grid-get [mg-get]

Get general information about the storage system management grid.

grid-get-hosts [mg-get-hosts]

Returns the /etc/hosts configuration file configuration for grid nodes.

grid-modify [mg-modify]

Modify the management grid properties.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--vif-enable]   :: Enables the use of a virtual interface for grid management.
	[--vif-ipaddress] :: Virtual host IP address to be associated with the master node in a the 
                            management grid.
	[--vif-netmask]  :: Virtual host netmask to be used with the specified IP address.
	[--desc]         :: A description for the object.
	[--vif-hostname] :: Cluster virtual host name to be associated with the master node in the 
                            management grid
	[--port]         :: Default physical target port to associate the management grid virtual 
                            host IP address with.
	[--bind-port]    :: This is the network address to bind with the Corosync cluster.
	[--grid-num]     :: Defaults to zero (0), increment this to a unique value between 0-9 if 
                            you have more than one grid on your network.


grid-remove [mg-remove]

Removes the specified storage system from the management grid.

	<--storage-system> :: Name or ID of a storage system in a management grid.


grid-set-hosts [mg-set-hosts]

Configures the /etc/hosts configuration file on all systems to facilitate host name based gluster volume configurations.

	<--portid-list>  :: List of UUIDs for the ethernet ports to be used for grid wide /etc/hosts 
                            file configuration.


grid-set-master [mg-set]

Sets the master node for a storage system.

	<--storage-system> :: Name or ID of a storage system in a management grid.


Storage Pool HA Failover Management

ha-group-activate [hag-activate]

Activates/enables the specified high-availability group to failover can occur on a system outage.

	<--ha-group>     :: Name or UUID of a storage pool high-availability group


ha-group-create [hag-create]

Creates a new storage pool high-availability group.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	<--sys-secondary> :: Storage system associated with the failover group secondary node
	[--sys-primary]  :: Storage system associated with the failover group primary node
	[--desc]         :: A description for the object.
	[--ha-module]    :: Name or UUID of a storage pool high-availability module


ha-group-deactivate [hag-deactivate]

Deactivates the specified high-availability group so that failover policies are disabled.

	<--ha-group>     :: Name or UUID of a storage pool high-availability group


ha-group-delete [hag-delete]

Deletes the specified high-availability group

	<--ha-group>     :: Name or UUID of a storage pool high-availability group


ha-group-failover [hag-failover]

Manually triggers a failover of the specified storage pool using the associated storage pool HA group policy.

	<--ha-group>     :: Name or UUID of a storage pool high-availability group
	<--storage-system> :: Name or ID of a storage system in a management grid.


ha-group-get [hag-get]

Gets information about the specified storage pool HA group

	<--ha-group>     :: Name or UUID of a storage pool high-availability group


ha-group-list [hag-list]

Returns a list of all the HA groups

ha-group-modify [hag-modify]

Modifies the settings for the specified high-availability group

	<--ha-group>     :: Name or UUID of a storage pool high-availability group
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--sys-secondary] :: Storage system associated with the failover group secondary node
	[--ha-module]    :: Name or UUID of a storage pool high-availability module


ha-interface-create [hai-create]

Creates a new virtual network interface for the specified HA failover group.

	<--ha-group>     :: Name or UUID of a storage pool high-availability group
	<--parent-port>  :: Parent network port like 'eth0' which the virtual interface should be 
                            attached to.  On failover the virtual interface will attach to the port 
                            with the same name on the failover/secondary node.
	<--ip-address>   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--interface-tag] :: Tags are a alpha-numeric tag which is appended onto a given HA virtual 
                            interface for easy identification.
	[--desc]         :: A description for the object.
	[--gateway]      :: IP address of the network gateway
	[--mac-address]  :: MAC Address
	[--iscsi-enable] :: Enables or disables iSCSI access to the specified port(s).


ha-interface-delete [hai-delete]

Deletes the specified virtual network interface resource from the HA group

	<--ha-interface> :: Name or UUID of a storage pool high-availability virtual network 
                            interface


ha-interface-get [hai-get]

Gets information about the specified storage pool HA virtual network interface

	<--ha-interface> :: Name or UUID of a storage pool high-availability virtual network 
                            interface


ha-interface-list [hai-list]

Returns a list of all the HA interfaces on the specified group

ha-module-get [ham-get]

Gets information about the specified storage pool HA module

	<--ha-module>    :: Name or UUID of a storage pool high-availability module


ha-module-list [ham-list]

Returns a list of all the HA failover modules

Host Group Management

host-group-create [hg-create]

Creates a new host group with the specified name.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--host-list>    :: A list of one or more hosts by name or ID.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async]


host-group-delete [hg-delete]

Removes the specified host group.

	<--host-group>   :: An arbitrary collection of hosts used to simplify volume ACL management 
                            for grids and other groups of hosts.
	[--flags]        :: Optional flags for the operation. [async, force]


host-group-get [hg-get]

Gets information about a specific host group.

	<--host-group>   :: An arbitrary collection of hosts used to simplify volume ACL management 
                            for grids and other groups of hosts.


host-group-host-add [hg-host-add]

Adds a host to the specified host group.

	<--host-group>   :: An arbitrary collection of hosts used to simplify volume ACL management 
                            for grids and other groups of hosts.
	<--host-list>    :: A list of one or more hosts by name or ID.


host-group-host-remove [hg-host-remove]

Removes a host from the specified host group.

	<--host-group>   :: An arbitrary collection of hosts used to simplify volume ACL management 
                            for grids and other groups of hosts.
	<--host-list>    :: A list of one or more hosts by name or ID.


host-group-list [hg-list]

Returns a list of all the host groups.

host-group-modify [hg-modify]

Modifies the properties of a host group such as its name and/or description.

	<--host-group>   :: An arbitrary collection of hosts used to simplify volume ACL management 
                            for grids and other groups of hosts.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.


Host Mangement

host-add [h-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.

	<--hostname>     :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--iqn]          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator
	[--ip-address]   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--desc]         :: A description for the object.
	[--username]     :: Administrator user name for the host, typically 'Administrator' for 
                            Windows hosts.
	[--password]     :: Administrator password for the host; enables auto-configuration of 
                            host's iSCSI initiator.
	[--host-type]    :: Operating system type of the host. [aix, hpux, linux, other, solaris, 
                            vmware, *windows, xenserver]
	[--flags]        :: Optional flags for the operation. [async]


host-get [h-get]

Gets information about a specific host.

	<--host>         :: Name of the host or its unique ID (GUID).


host-initiator-add [hi-add]

Adds an additional iSCSI host initiator IQN to the specified host.

	<--host>         :: Name of the host or its unique ID (GUID).
	<--iqn>          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator


host-initiator-get [hi-get]

Gets information about a specific host identified by its initiator IQN.

	<--iqn>          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator


host-initiator-list [hi-list]

Returns a list of all the initiators (IQN) of the specified host

	<--host>         :: Name of the host or its unique ID (GUID).


host-initiator-remove [hi-remove]

Removes a iSCSI host initiator (IQN) from the specified host.

	<--host>         :: Name of the host or its unique ID (GUID).
	<--iqn>          :: IQN (iSCSI Qualified Name) of the host's iSCSI initiator


host-list [h-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-modify [h-modify]

Modifies a host.

	<--host>         :: Name of the host or its unique ID (GUID).
	[--desc]         :: A description for the object.
	[--ip-address]   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--username]     :: Administrator user name for the host, typically 'Administrator' for 
                            Windows hosts.
	[--password]     :: Administrator password for the host; enables auto-configuration of 
                            host's iSCSI initiator.
	[--host-type]    :: Operating system type of the host. [aix, hpux, linux, other, solaris, 
                            vmware, *windows, xenserver]
	[--flags]        :: Optional flags for the operation. [async]


host-remove [h-remove]

Removes the specified host, *WARNING* host's active iSCSI sessions will be dropped.

	<--host>         :: Name of the host or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async, force]


Hardware RAID Management

hw-alarm-clear-all [hwa-clear-all]

Clears all the hardware alarms that have been recorded for the specified hardware RAID controller.

	<--controller>   :: Name or ID of a hardware RAID controller.


hw-alarm-get [hwa-get]

Returns information about a specific hardware alarm.

	<--id>           :: Unique identifier (GUID) for the object.


hw-alarm-list [hwa-list]

Returns a list of all the current hardware alarms/alert messages generated from the controller.

	[--controller]   :: Name or ID of a hardware RAID controller.


hw-controller-change-security-key [hwc-change-security-key]

Change the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.

	<--controller>   :: Name or ID of a hardware RAID controller.
	<--old-security-key> :: Prior security key on HW Controller card, for changing key, for 
                            encryption on FDE-enabled secure disk drives.
	<--security-key> :: Security key on HW Controller card for encryption on FDE-enabled secure 
                            disk drives.


hw-controller-create-security-key [hwc-create-security-key]

Create the security key for encryption on SED/FDE-enabled drives on hardware RAID controller.

	<--controller>   :: Name or ID of a hardware RAID controller.
	<--security-key> :: Security key on HW Controller card for encryption on FDE-enabled secure 
                            disk drives.


hw-controller-get [hwc-get]

Returns information about a specific hardware RAID controller.

	<--controller>   :: Name or ID of a hardware RAID controller.


hw-controller-group-get [hwcg-get]

Returns information about all the support hardware RAID controller group types.

	<--controller-group> :: Name or ID of a hardware RAID controller group.


hw-controller-group-list [hwcg-list]

Returns a list of all the hardware controller groups.

hw-controller-import-units [hwc-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.

	<--controller>   :: Name or ID of a hardware RAID controller.


hw-controller-list [hwc-list]

Returns a list of all the hardware controllers.

	[--controller-group] :: Name or ID of a hardware RAID controller group.


hw-controller-rescan [hwc-rescan]

Rescans the hardware controller to look for new disks and RAID units.

	<--controller>   :: Name or ID of a hardware RAID controller.


hw-disk-delete [hwd-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.

	<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.
	[--duration]     :: Duration in seconds to repeat the disk identification pattern.


hw-disk-get [hwd-get]

Returns information about a specific disk managed by a hardware RAID controller.

	<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.


hw-disk-identify [hwd-identify]

Flashes the LED indicator light on the specified disk so that it can be identified in the enclosure chassis.

	<--unit>         :: Name of a hardware RAID unit or it unique ID.
	[--duration]     :: Duration in seconds to repeat the disk identification pattern.


hw-disk-list [hwd-list]

Returns a list of all the disks managed by the specified hardware controller.

	[--controller]   :: Name or ID of a hardware RAID controller.


hw-disk-mark-good [hwd-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.

	<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.


hw-disk-mark-spare [hwd-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.

	<--disk>         :: Specifies a physical disk connected to a hardware RAID controller.


hw-enclosure-get [hwe-get]

Returns information about a specific enclosure managed by the specified hardware RAID controller.

	<--enclosure>    :: Name of a hardware RAID enclosure or it unique ID.


hw-enclosure-list [hwe-list]

Returns a list of all the enclosures managed by the specified hardware RAID controller.

	[--controller]   :: Name or ID of a hardware RAID controller.


hw-unit-create [hwu-create]

Creates a new hardware RAID unit using the specified controller.

	<--raid>         :: Hardware RAID type for a hardware RAID unit. [*AUTO, RAID0, RAID1, 
                            RAID10, RAID5, RAID50, RAID6, RAID60]
	<--disk-list>    :: Specifies one or more physical disks connected to a hardware RAID 
                            controller. Use 'all' to indicate all unused disks.
	[--controller]   :: Name or ID of a hardware RAID controller.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


hw-unit-delete [hwu-delete]

Deletes the specified RAID unit. Note that you must first delete the Storage Pool before you delete the RAID unit.

	<--unit>         :: Name of a hardware RAID unit or it unique ID.
	[--duration]     :: Duration in seconds to repeat the disk identification pattern.


hw-unit-encrypt [hwu-encrypt]

Enable hardware SED/FDE encryption for the specified hardware RAID unit.

	<--unit>         :: Name of a hardware RAID unit or it unique ID.
	[--options]      :: Special options to hardware encryption policy.


hw-unit-get [hwu-get]

Returns information about a specific RAID unit managed by the specified hardware RAID controller.

	<--unit>         :: Name of a hardware RAID unit or it unique ID.


hw-unit-identify [hwu-identify]

Flashes the LED indicator light on all the disks in the RAID unit so that it can be identified in the enclosure.

	<--unit>         :: Name of a hardware RAID unit or it unique ID.
	[--duration]     :: Duration in seconds to repeat the disk identification pattern.


hw-unit-list [hwu-list]

Returns a list of all the RAID units managed by the specified hardware controller.

	[--controller]   :: Name or ID of a hardware RAID controller.


SAS Switch Management

hw-switch-adapter-get [hwsa-get]

Returns information about the specified HW switch management module.

	<--switch-adapter> :: Storage switch adapter module ID


hw-switch-adapter-list [hwsa-list]

Returns a list of all the storage switch management adapters

hw-switch-cred-add [hwsc-add]

Adds storage switch login credentials for a specific switch management adapter

	<--username>     :: Administrator user name for the host, typically 'Administrator' for 
                            Windows hosts.
	<--password>     :: Administrator password for the host; enables auto-configuration of 
                            host's iSCSI initiator.
	<--domain-password> :: Password for the committing zoneset changes to a storage switch.
	<--ip-address>   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--switch-adapter] :: Storage switch adapter module ID
	[--primary]      :: Primary storage system responsible for managing and discovering the 
                            switch(es)
	[--secondary]    :: Secondary storage system responsible for managing and discovering the 
                            switch(es)


hw-switch-cred-get [hwsc-get]

Returns information about specific storage switch login credentials

	<--creds>        :: Storage switch credentials (user/pass)


hw-switch-cred-list [hwsc-list]

Returns a list of all the storage switch login credentials

	[--switch-adapter] :: Storage switch adapter module ID


hw-switch-cred-remove [hwsc-remove]

Removes storage switch login credentials

	<--creds>        :: Storage switch credentials (user/pass)


hw-switch-failover-group-activate [hwsfg-activate]

Activates the pools in a switch failover group on the specified storage system

	<--failover-group> :: Name/ID of a storage switch failover group
	<--storage-system> :: Name or ID of a storage system in a management grid.


hw-switch-failover-group-create [hwsfg-create]

Creates a new switch failover group

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool-list>    :: List of one or more storage pools.
	<--sys-primary>  :: Storage system associated with the failover group primary node
	<--zoneset-primary> :: Zoneset to be associated with the failover group primary node
	<--sys-secondary> :: Storage system associated with the failover group secondary node
	<--zoneset-secondary> :: Zoneset to be associated with the failover group secondary node
	[--ip-address]   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--gateway]      :: IP address of the network gateway
	[--desc]         :: A description for the object.


hw-switch-failover-group-delete [hwsfg-delete]

Deletes a failover group

	<--failover-group> :: Name/ID of a storage switch failover group


hw-switch-failover-group-get [hwsfg-get]

Returns information about a specific switch failover group

	<--failover-group> :: Name/ID of a storage switch failover group


hw-switch-failover-group-list [hwsfg-list]

Returns a list of all the switch failover groups

	[--switch]       :: Name or ID of a SAS/FC storage switch


hw-switch-failover-group-modify [hwsfg-modify]

Modifies the properties of a failover group

	<--failover-group> :: Name/ID of a storage switch failover group
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--ip-address]   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--gateway]      :: IP address of the network gateway
	[--pool-list]    :: List of one or more storage pools.
	[--sys-primary]  :: Storage system associated with the failover group primary node
	[--zoneset-primary] :: Zoneset to be associated with the failover group primary node
	[--sys-secondary] :: Storage system associated with the failover group secondary node
	[--zoneset-secondary] :: Zoneset to be associated with the failover group secondary node
	[--desc]         :: A description for the object.


hw-switch-get [hws-get]

Returns detailed information about a storage switch

	<--switch>       :: Name or ID of a SAS/FC storage switch


hw-switch-list [hws-list]

Returns a list of all the discovered storage switches

	[--switch-adapter] :: Storage switch adapter module ID


hw-switch-zoneset-activate [hwsz-activate]

Activates a specific storage switch zonset

	<--zoneset>      :: Name or ID of a storage switch zoneset
	[--switch]       :: Name or ID of a SAS/FC storage switch


hw-switch-zoneset-get [hwsz-get]

Returns information about a specific switch zoneset

	<--zoneset>      :: Name or ID of a storage switch zoneset


hw-switch-zoneset-list [hwsz-list]

Returns a list of all the discovered zonesets

	[--switch]       :: Name or ID of a SAS/FC storage switch


License Mangement

license-activate [lic-act]

Activates the system using a activation key received from customer support.

	<--activation-key> :: Activation key you'll receive from customer support after you send the 
                            activation request code.


license-activate-online [lic-aon]

Requests automatic activation via the online activation service.

	[--key]          :: Unique license key identifier, use key-enum to get a list of these.


license-add [lic-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.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	<--key-file>     :: Key file you received which contains a key block section.


license-get [lic-get]

Shows the current license key info, and any activation request code.

	<--key>          :: Unique license key identifier, use key-enum to get a list of these.


license-list [lic-list]

Returns a list of all the registered license keys.

license-remove [lic-remove]

Removes the specified license key.

	<--key>          :: Unique license key identifier, use key-enum to get a list of these.


Cloud I/O Stats Management

metrics-get [lm-get]

Get the current username, token, and interval settings for Librato Metrics.

	<--storage-system> :: Name or ID of a storage system in a management grid.


metrics-set [lm-set]

Set the username, token, and interval for Librato Metrics posting.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	<--username>     :: The username/email of the Librato Metrics account.
	<--token>        :: The API token associated with the Librato Metrics account.
	[--interval]     :: The interval in seconds of how often Quantastor should post data to 
                            Librato Metrics.
	[--dashboards]   :: Autmatically create the QuantaStor system dashboard in Librato Metrics
	[--alert-anno]   :: Add alert annotations to the Librato Metrics postings.
	[--config-anno]  :: Add config annotations to the Librato Metrics postings.


Storage Pool Management

disk-add-spare [pd-add]

Adds one or more dedicated hot-spares to the global hotspare pool.

	<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


disk-get [pd-get]

Gets information about a specific physical disk.

	<--disk>         :: Name of the physical disk or its unique ID/serial number.


disk-identify [pd-id]

Pulses the disk activity light so that the specified disk can be identified in the cassis.

	<--disk>         :: Name of the physical disk or its unique ID/serial number.
	[--pattern]      :: Pattern to flash the disk LED lights in, p = short pulse, P = long 
                            pulse, d = short delay, D = long delay, ex: pattern=pppD
	[--duration]     :: Duration in seconds to repeat the disk identification pattern.


disk-list [pd-list]

Enumerates all physical disks.

disk-remove-spare [pd-remove]

Removes one or more dedicated hot-spares from the global hotspare pool.

	<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


disk-scan [pd-scan]

Scans for any new physical disks that may have been hot-plugged into the storage system.

	[--storage-system] :: Name or ID of a storage system in a management grid.


path-list [pdp-list]

Enumerates all physical disk paths for multipath devices.

pool-add-spare [p-add]

Adds a dedicated hot-spare to the specified storage pool.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
	[--flags]        :: Optional flags for the operation. [async]


pool-create [p-create]

Creates a new storage pool from which storage volumes can be created.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
	[--raid-type]    :: RAID type for the storage pool. [*AUTO, RAID0, RAID1, RAID10, RAID5, 
                            RAID6]
	[--pool-type]    :: The type of storage pool to be created. [btrfs, ext4, jfs, *xfs, zfs]
	[--desc]         :: A description for the object.
	[--is-default]   :: Indicates that this pool should be utilized as the default storage pool.
	[--ssd]          :: Enable solid state disk (SSD) storage pool optimizations.
	[--compress]     :: Enable storage volume compression on the pool, this boosts both read and 
                            write performance on most IO loads.
	[--nobarriers]   :: Enable storage pool write optimizations.  This requires that you have a 
                            hardware controller with a battery backup unit.
	[--profile]      :: Specifies an optional IO optimization profile for the storage pool.  
                            Storage pool profiles control elements like read-ahead, queue depth and 
                            other device configurable settings.
	[--raid-set-size] :: Then number of disks to use in each set of disks when creating a RAID50 
                            or RAID60 storage pool.
	[--flags]        :: Optional flags for the operation. [async]


pool-destroy [p-destroy]

Deletes a storage pool, *WARNING* any data in the pool will be lost.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async, force]


pool-device-get [spd-get]

Gets information about a specific storage pool device.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.


pool-device-list [spd-list]

Returns a list of all the storage pool devices.

pool-expand [p-expand]

Expands a storage pool after the underlying hardware RAID unit has been grown underneath.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async]


pool-export [p-export]

Deactivate and removes the storage pool from the storage system database so that it can be exported and used on another system.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).


pool-get [p-get]

Gets information about a specific storage pool.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).


pool-grow [p-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>         :: Name of the storage pool or its unique ID (GUID).
	<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
	[--raid-type]    :: RAID type for the storage pool. [*AUTO, RAID0, RAID1, RAID10, RAID5, 
                            RAID6]
	[--flags]        :: Optional flags for the operation. [async]


pool-identify [p-id]

Pulses the disk activity lights for all disks in the pool so they can be identified in the chassis.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--pattern]      :: Pattern to flash the disk LED lights in, p = short pulse, P = long 
                            pulse, d = short delay, D = long delay, ex: pattern=pppD
	[--duration]     :: Duration in seconds to repeat the disk identification pattern.


pool-list [p-list]

Returns a list of all the storage pools.

pool-modify [p-modify]

Modifies the properties of the storage pool such as its name and description.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--is-default]   :: Indicates that this pool should be utilized as the default storage pool.
	[--ssd]          :: Enable solid state disk (SSD) storage pool optimizations.
	[--compress]     :: Enable storage volume compression on the pool, this boosts both read and 
                            write performance on most IO loads.
	[--nobarriers]   :: Enable storage pool write optimizations.  This requires that you have a 
                            hardware controller with a battery backup unit.
	[--profile]      :: Specifies an optional IO optimization profile for the storage pool.  
                            Storage pool profiles control elements like read-ahead, queue depth and 
                            other device configurable settings.
	[--desc]         :: A description for the object.
	[--sync]         :: Synchroniztion policy to use for handling writes to the storage pool 
                            (standard, always, none).  standard mode is a hybrid of write-through and 
                            write-back caching based on the O_SYNC flag, always mode is write-through 
                            to ZIL which could be SSD cache, and disabled indicates to always use 
                            async writes. [always, disabled, *standard]
	[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] | 
                            zle | lz4)
	[--copies]       :: Indicates the number of copies of each block should be maintained in the 
                            storage pool.  This is a way of getting duplicates for bit-rot protection 
                            on a single device.
	[--flags]        :: Optional flags for the operation. [async]


pool-profile-get [pp-get]

Gets information about a specific storage pool profile.

	<--profile>      :: Specifies an optional IO optimization profile for the storage pool.  
                            Storage pool profiles control elements like read-ahead, queue depth and 
                            other device configurable settings.


pool-profile-list [pp-list]

Returns a list of all the storage pool profiles.

pool-remove-spare [p-remove]

Removes the specified hot-spare from the specified pool.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	<--disk-list>    :: Comma delimited list of drives (no spaces) to be used for the operation.
	[--flags]        :: Optional flags for the operation. [async]


pool-scan [p-scan]

Rescans the specified storage system for storage pools.

	[--storage-system] :: Name or ID of a storage system in a management grid.


pool-scrub-start [p-scrub-start]

Starts a zpool scrub/verify operation which verifies data integrity and prevents bit-rot. Use 'zpoolscrub --cron' to setup an automatic monthly scrub.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).


pool-scrub-stop [p-scrub-stop]

Stops the zpool scrub/verify operation if it is currently active on the storage pool. Only applies to ZFS based storage pools.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).


pool-start [p-start]

Starts up a previously stopped storage pool.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).


pool-stop [p-stop]

Stops all volume activity to the pool and disables it for maintenance.

	<--pool>         :: Name of the storage pool or its unique ID (GUID).


Pool Replication Management (DEPRECATED)

pool-replink-create [prl-create]

Create a async remote replication link between two storage pools.

	<--primary-pool> :: Primary storage pool, source of data transfer for replication.
	<--secondary-pool> :: Secondary storage pool, target of data transfer for replication.
	<--primary-address> :: Primary system target port.
	<--secondary-address> :: Secondary system target port.
	[--protocol-type] :: Replication protocol type
	[--resync-rate]  :: Resync rate in KB/sec
	[--flags]        :: Optional flags for the operation. [async]


pool-replink-delete [prl-delete]

Delete the remote replication link between two storage pools.

	<--replication-link> :: Name or ID of the storage pool replication link/configuration


pool-replink-demote [prl-demote]

Demote the specified storage pool to be a secondary.

	<--replication-link> :: Name or ID of the storage pool replication link/configuration


pool-replink-get [prl-get]

Get info about a specific remote replication link between two pools

	<--replication-link> :: Name or ID of the storage pool replication link/configuration


pool-replink-list [prl-list]

List the remote replication links between pools

pool-replink-modify [prl-modify]

Modify the async remote replication link between pools.

	<--replication-link> :: Name or ID of the storage pool replication link/configuration
	[--sendbuf-size] :: Maximum network send-buffer size.
	[--cong-policy]  :: Congestion policy.
	[--cong-fill-size] :: Congestion fill size.
	[--resync-rate]  :: Resync rate in KB/sec
	[--barriers]     :: Disk barriers
	[--disk-flushes] :: Disk flushes IO
	[--resource]     :: Enable DRBD Proxy
	[--source-ip]    :: Source system IP address or port name.
	[--target-ip]    :: Target system IP address or port name.
	[--replication-portnum] :: Port number on which the replication data flows between the source and 
                            target systems (7789-7799)
	[--flags]        :: Optional flags for the operation. [async]


pool-replink-promote [prl-promote]

Promote the specified pool to be a primary.

	<--replication-link> :: Name or ID of the storage pool replication link/configuration


pool-replink-resume [prl-resume]

Resume the replication for the specified pool remote replication link.

	<--replication-link> :: Name or ID of the storage pool replication link/configuration


pool-replink-suspend [prl-suspend]

Suspend the replication for the specified pool remote replication link.

	<--replication-link> :: Name or ID of the storage pool replication link/configuration


Resource Group Quota Management

quota-create [q-create]

Creates a new storage quota on a pool for the specified storage cloud.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	<--cloud>        :: Name of a Storage Cloud or its unique id.
	[--policy]       :: Indicates the type of quota to be created. [hard, *soft]
	[--desc]         :: A description for the object.
	[--psize]        :: The total thin-provisionable space allowed by this quota.
	[--usize]        :: The total utilizable space allowed by this quota which may be less than 
                            the provisionable space.
	[--max-volumes]  :: The maximum number of volumes that can be created using this quota, 
                            specify 0 for no limit.
	[--max-shares]   :: The maximum number of share that can be created using this quota, 
                            specify 0 for no limit.
	[--flags]        :: Optional flags for the operation. [async]


quota-delete [q-delete]

Deletes a storage quota, the associated volumes are not deleted.

	<--quota>        :: Name or ID of a storage quota.
	[--flags]        :: Optional flags for the operation. [async, force]


quota-get [q-get]

Returns information about a specific storage quota.

	<--quota>        :: Name or ID of a storage quota.


quota-list [q-list]

Returns a list of all the storage quotas.

quota-modify [q-modify]

Modifies one to change the name and/or description of a storage quota.

	<--quota>        :: Name or ID of a storage quota.
	<--cloud>        :: Name of a Storage Cloud or its unique id.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--psize]        :: The total thin-provisionable space allowed by this quota.
	[--usize]        :: The total utilizable space allowed by this quota which may be less than 
                            the provisionable space.
	[--max-volumes]  :: The maximum number of volumes that can be created using this quota, 
                            specify 0 for no limit.
	[--max-shares]   :: The maximum number of share that can be created using this quota, 
                            specify 0 for no limit.
	[--policy]       :: Indicates the type of quota to be created. [hard, *soft]
	[--flags]        :: Optional flags for the operation. [async]


quota-share-add [qs-add]

Adds one or more shares to the specified quota.

	<--quota>        :: Name or ID of a storage quota.
	<--share-list>   :: A list of one or more network shares.


quota-share-assoc-list [qs-alist]

Returns a list of all the associated quotas of a specified share.

	<--share>        :: Name or ID of a network share.


quota-share-remove [qs-remove]

Removes one or more shares from the specified quota.

	<--quota>        :: Name or ID of a storage quota.
	<--share-list>   :: A list of one or more network shares.


quota-volume-add [qv-add]

Adds one or more volumes to the specified quota.

	<--quota>        :: Name or ID of a storage quota.
	<--volume-list>  :: A list of one or more storage volumes.


quota-volume-assoc-list [qv-alist]

Returns a list of all the associated quotas of a specified volume.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).


quota-volume-remove [qv-remove]

Removes one or more volumes from the specified quota

	<--quota>        :: Name or ID of a storage quota.
	<--volume-list>  :: A list of one or more storage volumes.


Remote Replication Management

replica-assoc-delete [rep-assoc-delete]

Deletes the specified replication association between a source/target pair of volumes or shares.

	<--replica-assoc> :: Name or ID of a replica association between a source/target volume or 
                            share


replica-assoc-get [rep-assoc-get]

Returns details of the specified replication association.

	<--replica-assoc> :: Name or ID of a replica association between a source/target volume or 
                            share


replica-assoc-list [rep-assoc-list]

Returns a list of all the replication associations.

replica-assoc-rollback [rep-assoc-rollback]

Reverses the replication to send the changes on the target back to the source volume/share. Requires the --force flag.

	<--replica-assoc> :: Name or ID of a replica association between a source/target volume or 
                            share


replica-assoc-stop [rep-assoc-stop]

Attempts to stop the replication process between a source/target pair of volumes or shares.

	<--replica-assoc> :: Name or ID of a replica association between a source/target volume or 
                            share


replica-assoc-sync [rep-assoc-sync]

Restarts the replication process between a source/target pair of volumes or shares.

	<--replica-assoc> :: Name or ID of a replica association between a source/target volume or 
                            share


replication-schedule-add [rsch-add]

Adds one or more volumes/shares to the specified schedule.

	<--schedule>     :: Name or ID of a replication schedule.
	[--volume-list]  :: A list of one or more storage volumes.
	[--share-list]   :: A list of one or more network shares.


replication-schedule-create [rsch-create]

Creates a new replication schedule to replicate the specified storage volumes and shares to the specified target pool on a schedule.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--target-pool>  :: Target storage pool on remote system to replicate to.
	[--volume-list]  :: A list of one or more storage volumes.
	[--share-list]   :: A list of one or more network shares.
	[--start-date]   :: Start date at which the system will begin creating snapshots for a given 
                            schedule.
	[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated 
                            times.
	[--desc]         :: A description for the object.
	[--cloud]        :: Name of a Storage Cloud or its unique id.
	[--max-replicas] :: Maximum number of replica snapshot checkpoints to retain for this 
                            schedule, after which the oldest snapshot is removed before a new one is 
                            created.
	[--days]         :: The days of the week on which this schedule should create snapshots. 
                            [fri, mon, sat, *sun, thu, tue, wed]
	[--hours]        :: For the specified days of the week, snapshots will be created at the 
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm, 
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
	[--interval]     :: Interval in minutes between replications, minimum is 15 minutes.
	[--flags]        :: Optional flags for the operation. [async]


replication-schedule-delete [rsch-delete]

Deletes a replication schedule, snapshots associated with the schedule are not removed.

	<--schedule>     :: Name or ID of a replication schedule.
	[--flags]        :: Optional flags for the operation. [async, force]


replication-schedule-disable [rsch-disable]

Disables the specified replication schedule.

	<--schedule>     :: Name or ID of a replication schedule.
	[--flags]        :: Optional flags for the operation. [async, force]


replication-schedule-enable [rsch-enable]

Enables the specified replication schedule.

	<--schedule>     :: Name or ID of a replication schedule.
	[--flags]        :: Optional flags for the operation. [async, force]


replication-schedule-get [rsch-get]

Returns information about a specific replication schedule.

	<--schedule>     :: Name or ID of a replication schedule.


replication-schedule-list [rsch-list]

Returns a list of all the replication schedules.

replication-schedule-modify [rsch-modify]

Modifies the name, description or other properties of a replication schedule.

	<--schedule>     :: Name or ID of a replication schedule.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--start-date]   :: Start date at which the system will begin creating snapshots for a given 
                            schedule.
	[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated 
                            times.
	[--desc]         :: A description for the object.
	[--cloud]        :: Name of a Storage Cloud or its unique id.
	[--max-replicas] :: Maximum number of replica snapshot checkpoints to retain for this 
                            schedule, after which the oldest snapshot is removed before a new one is 
                            created.
	[--days]         :: The days of the week on which this schedule should create snapshots. 
                            [fri, mon, sat, *sun, thu, tue, wed]
	[--hours]        :: For the specified days of the week, snapshots will be created at the 
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm, 
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
	[--interval]     :: Interval in minutes between replications, minimum is 15 minutes.
	[--flags]        :: Optional flags for the operation. [async]


replication-schedule-remove [rsch-remove]

Removes one or more volumes/shares from the specified schedule.

	<--schedule>     :: Name or ID of a replication schedule.
	[--volume-list]  :: A list of one or more storage volumes.
	[--share-list]   :: A list of one or more network shares.


replication-schedule-trigger [rsch-trigger]

Triggers the specified schedule to run immediately.

	<--schedule>     :: Name or ID of a replication schedule.
	[--flags]        :: Optional flags for the operation. [async, force]


RBAC Role Management

role-add [r-add]

Adds a new role to the role based access control (RBAC) system.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--permissions]  :: List of permissions and/or permission groups to add to the specified 
                            role.


role-get [r-get]

Gets information about the specified role.

	<--role>         :: Name of a security role or its unique ID (GUID).


role-list [r-list]

Returns a list of all the defined roles the RBAC system.

role-modify [r-modify]

Modifies the name and/or description of a role

	<--role>         :: Name of a security role or its unique ID (GUID).
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.


role-permission-add [rp-add]

Adds additional permissions and/or permission groups to the specified role.

	<--role>         :: Name of a security role or its unique ID (GUID).
	<--permissions>  :: List of permissions and/or permission groups to add to the specified 
                            role.


role-permission-remove [rp-remove]

Removes one or more permissions and/or permission groups from the specified role.

	<--role>         :: Name of a security role or its unique ID (GUID).
	<--permissions>  :: List of permissions and/or permission groups to add to the specified 
                            role.


role-remove [r-remove]

Removes the specified role identified by name or ID

	<--role>         :: Name of a security role or its unique ID (GUID).


Snapshot Schedule Management

cloud-create [c-create]

Creates a new storage cloud comprised of the specified users, resources and chap information.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--subject-list] :: A list subjects in the following format name:type. Ex: 
                            userName:user,groupName:user_group...
	[--resource-list] :: A list resources in the following format name:type. Ex: 
                            vol:volume,hostname:host...
	[--parent-cloud] :: The name or unique id of a storage cloud.
	[--tier]         :: The tier of the storage cloud.
	[--organization] :: The name of the organization this storage cloud is assigned to.
	[--chap-user]    :: An optional iSCSI CHAP username.
	[--chap-pass]    :: An optional iSCSI CHAP password.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


cloud-delete [c-delete]

Deletes a storage cloud, the resources and users will not be deleted.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	[--flags]        :: Optional flags for the operation. [async, force]


cloud-get [c-get]

Returns information of the specified storage clouds.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	[--flags]        :: Optional flags for the operation. [async, force]


cloud-list [c-list]

Returns a list of all the storage clouds.

	[--flags]        :: Optional flags for the operation. [async, force]


cloud-modify [c-modify]

Modifies the name, description, parent storage cloud, tier, organization, and chap information of a storage cloud.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--parent-cloud] :: The name or unique id of a storage cloud.
	[--tier]         :: The tier of the storage cloud.
	[--organization] :: The name of the organization this storage cloud is assigned to.
	[--chap-user]    :: An optional iSCSI CHAP username.
	[--chap-pass]    :: An optional iSCSI CHAP password.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


cloud-resource-add [cr-add]

Add one or more resources to the specified storage cloud.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	<--resource-list> :: A list resources in the following format name:type. Ex: 
                            vol:volume,hostname:host...


cloud-resource-mode [cr-mode]

Set the mode of a specified resource in the storage cloud.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	<--resource>     :: The unique id of a volume or volume group or share or host or host group.
	<--access-mode>  :: Access mode for the volume.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


cloud-resource-remove [cr-remove]

Remove one or more resource from the specified storage cloud.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	<--resource-list> :: A list resources in the following format name:type. Ex: 
                            vol:volume,hostname:host...


cloud-subject-assoc-list [csub-alist]

Returns a list of associated storage clouds to the specified subject.

	<--subject>      :: The unique id of a user or user group.
	[--flags]        :: Optional flags for the operation. [async, force]


cloud-user-add [cu-add]

Add one or more users to the specified storage cloud.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	<--subject-list> :: A list subjects in the following format name:type. Ex: 
                            userName:user,groupName:user_group...


cloud-user-remove [cu-remove]

Remove one or more users from specified storage cloud.

	<--cloud>        :: Name of a Storage Cloud or its unique id.
	<--subject-list> :: A list subjects in the following format name:type. Ex: 
                            userName:user,groupName:user_group...


snap-schedule-add [sch-add]

Adds one or more volumes/shares to the specified schedule.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
	[--volume-list]  :: A list of one or more storage volumes.
	[--share-list]   :: A list of one or more network shares.


snap-schedule-create [sch-create]

Creates a new snapshot schedule comprised of the specified storage volumes.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--volume-list]  :: A list of one or more storage volumes.
	[--share-list]   :: A list of one or more network shares.
	[--start-date]   :: Start date at which the system will begin creating snapshots for a given 
                            schedule.
	[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated 
                            times.
	[--desc]         :: A description for the object.
	[--cloud]        :: Name of a Storage Cloud or its unique id.
	[--max-snaps]    :: Maximum number of snapshots to retain for this schedule, after which the 
                            oldest snapshot is removed before a new one is created.
	[--days]         :: The days of the week on which this schedule should create snapshots. 
                            [fri, mon, sat, *sun, thu, tue, wed]
	[--hours]        :: For the specified days of the week, snapshots will be created at the 
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm, 
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
	[--flags]        :: Optional flags for the operation. [async]


snap-schedule-delete [sch-delete]

Deletes a snapshot schedule, snapshots associated with the schedule are not removed.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async, force]


snap-schedule-disable [sch-disable]

Disables the specified snapshot schedule.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async, force]


snap-schedule-enable [sch-enable]

Enables the specified snapshot schedule.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async, force]


snap-schedule-get [sch-get]

Returns information about a specific snapshot schedule.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).


snap-schedule-list [sch-list]

Returns a list of all the snapshot schedules.

snap-schedule-modify [sch-modify]

Modifies the name, description or other properties of a snapshot schedule.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--start-date]   :: Start date at which the system will begin creating snapshots for a given 
                            schedule.
	[--enabled]      :: While the schedule is enabled snapshots will be taken at the designated 
                            times.
	[--desc]         :: A description for the object.
	[--cloud]        :: Name of a Storage Cloud or its unique id.
	[--max-snaps]    :: Maximum number of snapshots to retain for this schedule, after which the 
                            oldest snapshot is removed before a new one is created.
	[--days]         :: The days of the week on which this schedule should create snapshots. 
                            [fri, mon, sat, *sun, thu, tue, wed]
	[--hours]        :: For the specified days of the week, snapshots will be created at the 
                            specified hours. [10am, 10pm, 11am, 11pm, 12am, 12pm, 1am, 1pm, 2am, 2pm, 
                            *3am, 3pm, 4am, 4pm, 5am, 5pm, 6am, 6pm, 7am, 7pm, 8am, 8pm, 9am, 9pm]
	[--flags]        :: Optional flags for the operation. [async]


snap-schedule-remove [sch-remove]

Removes one or more volumes/shares from the specified schedule.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).
	[--volume-list]  :: A list of one or more storage volumes.
	[--share-list]   :: A list of one or more network shares.


snap-schedule-trigger [sch-trigger]

Triggers the specified schedule to run immediately.

	<--schedule>     :: Name of a snapshot schedule or its unique ID (GUID).


iSCSI Session Management

session-close [sn-close]

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

	<--session>      :: iSCSI session identifier for an active iSCSI session.


session-get [sn-get]

Returns detailed information on a specific iSCSI session.

	<--session>      :: iSCSI session identifier for an active iSCSI session.


session-list [sn-list]

Returns a list of all the active iSCSI sessions.

	[--volume]       :: Name of the storage volume or its unique ID (GUID).
	[--host]         :: Name of the host or its unique ID (GUID).


Network Share Management

share-ad-user-group-enum [shr-ad-ug-enum]

Returns a list of all the users and groups in the domain that QuantaStor is in.

	<--storage-system> :: Name or ID of a storage system in a management grid.
	[--share]        :: Name or ID of a network share.
	[--flags]        :: Optional flags for the operation. [async, force]


share-client-add [shr-cadd]

Adds a client for the specified network share.

	<--share>        :: Name or ID of a network share.
	<--filter>       :: A filter string for the client
	[--async]        :: Use asynchronous communication between NFS server and client
	[--secure]       :: Requires the requests to originate from an Internet port less than 
                            IPPORT_RESERVED
	[--subtree]      :: Enables subtree checking
	[--rdonly]       :: Allow only read requests for the NFS volume
	[--flags]        :: Optional flags for the operation. [async, force]


share-client-enum [shr-cenum]

Returns a list of clients for the specified network share.

	<--share>        :: Name or ID of a network share.
	[--flags]        :: Optional flags for the operation. [async, force]


share-client-get [shr-cget]

Returns information about the specific network share client.

	<--share>        :: Name or ID of a network share.
	<--filter>       :: A filter string for the client
	[--flags]        :: Optional flags for the operation. [async, force]


share-client-modify [shr-cmodify]

Modifies a client for the specified network share.

	<--share>        :: Name or ID of a network share.
	<--filter>       :: A filter string for the client
	[--rdonly]       :: Allow only read requests for the NFS volume
	[--secure]       :: Requires the requests to originate from an Internet port less than 
                            IPPORT_RESERVED
	[--async]        :: Use asynchronous communication between NFS server and client
	[--subtree]      :: Enables subtree checking
	[--flags]        :: Optional flags for the operation. [async, force]


share-client-remove [shr-cremove]

Removes a client for the specified network share.

	<--share>        :: Name or ID of a network share.
	<--filter>       :: A filter string for the client
	[--flags]        :: Optional flags for the operation. [async, force]


share-clone [shr-clone]

Creates a full copy of the specified network share to another storage pool.

	<--share>        :: Name or ID of a network share.
	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--name]         :: Name for the clone, if not provided the source volume name will be used 
                            as a prefix.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async, force]


share-create [shr-create]

Creates a new NFSv3 network share.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--desc]         :: A description for the object.
	[--public]       :: Indicates that the specified network share should be made public and 
                            open for read/write access to all systems on the network.
	[--active]       :: Indicates that the network share should be activated.
	[--cifs-enable]  :: Enables Samba support for network share.
	[--user-access-list] :: List of users with permission to access the network share.
	[--cifs-options] :: Additional CIFS/Samba configuration options specified as 
                            'key=value,key2=value2,...'.
	[--space-quota]  :: Size of the quota for the network share (optional).
	[--disable-snap-browsing] :: When this is true, ability to browse snapshot directories over CIFS is 
                            disabled.
	[--flags]        :: Optional flags for the operation. [async, force]


share-delete [shr-delete]

Deletes the specified network share

	<--share>        :: Name or ID of a network share.
	[--flags]        :: Optional flags for the operation. [async, force]


share-get [shr-get]

Returns information about the specified network share.

	<--share>        :: Name or ID of a network share.


share-join-domain [shr-jdomain]

Joins the specified domain/realm.

	<--storage-system> :: Name or ID of a storage system in a management grid.
	<--domain>       :: The name of the domain to have the QuantaStor system join. (DOMAIN)
	<--realm>        :: The name of the realm that the domain is in. (DOMAIN.COM)
	<--kdc>          :: The name of the active directory machine.
	<--ad-admin>     :: The administrator account of the domain that QuantaStor is a member of.
	<--ad-password>  :: The password to the administrator account of the domain that QuantaStor 
                            is a member of.
	[--flags]        :: Optional flags for the operation. [async, force]


share-leave-domain [shr-ldomain]

Leaves the current domain.

	<--storage-system> :: Name or ID of a storage system in a management grid.
	[--ad-admin]     :: The administrator account of the domain that QuantaStor is a member of.
	[--ad-password]  :: The password to the administrator account of the domain that QuantaStor 
                            is a member of.
	[--flags]        :: Optional flags for the operation. [async, force]


share-list [shr-list]

Returns a list of all the network shares in the system.

share-modify [shr-modify]

Modifies the properties of the specified network share.

	<--share>        :: Name or ID of a network share.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--active]       :: Indicates that the network share should be activated.
	[--space-quota]  :: Size of the quota for the network share (optional).
	[--sync]         :: Synchroniztion policy to use for handling writes to the storage pool 
                            (standard, always, none).  standard mode is a hybrid of write-through and 
                            write-back caching based on the O_SYNC flag, always mode is write-through 
                            to ZIL which could be SSD cache, and disabled indicates to always use 
                            async writes. [always, disabled, *standard]
	[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] | 
                            zle | lz4)
	[--copies]       :: Indicates the number of copies of each block should be maintained in the 
                            storage pool.  This is a way of getting duplicates for bit-rot protection 
                            on a single device.
	[--cifs-enable]  :: Enables Samba support for network share.
	[--user-access-list] :: List of users with permission to access the network share.
	[--cifs-options] :: Additional CIFS/Samba configuration options specified as 
                            'key=value,key2=value2,...'.
	[--disable-snap-browsing] :: When this is true, ability to browse snapshot directories over CIFS is 
                            disabled.


share-snapshot [shr-snap]

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

	<--share>        :: Name or ID of a network share.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async, force]


Storage Tier Management

storage-tier-create [st-create]

Creates a new storage storage tier comprised of the specified storage pools

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--pool-list>    :: List of storage pools.
	[--desc]         :: A description for the object.
	[--storage-class] :: The classification/primary use case of the storage such as 
                            Backup/Archive, High-Performance, or General Purpose.
	[--storage-type] :: Type of the storage pools included in this tier: SATA, SAS, SSD, SSHD, 
                            MULTI, Unknown [AOE, MULTI, *SAS, SATA, SSD, SSHD, UNKNOWN]
	[--perf-level]   :: An estimation of the relative performance of the storage teir as a 
                            simplified number in the range of 1 to 100.
	[--flags]        :: Optional flags for the operation. [async]


storage-tier-delete [st-delete]

Deletes the specified storage storage tier (pools are not deleted).

	<--tier>         :: Storage tier is a group of one or more storage pools used to simplify 
                            storage provisioning by teir/category/classification.
	[--flags]        :: Optional flags for the operation. [async, force]


storage-tier-get [st-get]

Returns information about a specific storage storage tier.

	<--tier>         :: Storage tier is a group of one or more storage pools used to simplify 
                            storage provisioning by teir/category/classification.


storage-tier-list [st-list]

Returns a list of all the storage storage tiers.

storage-tier-modify [st-modify]

Modifies the name, description or other property of the specified storage tier.

	<--tier>         :: Storage tier is a group of one or more storage pools used to simplify 
                            storage provisioning by teir/category/classification.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--storage-class] :: The classification/primary use case of the storage such as 
                            Backup/Archive, High-Performance, or General Purpose.
	[--storage-type] :: Type of the storage pools included in this tier: SATA, SAS, SSD, SSHD, 
                            MULTI, Unknown [AOE, MULTI, *SAS, SATA, SSD, SSHD, UNKNOWN]
	[--perf-level]   :: An estimation of the relative performance of the storage teir as a 
                            simplified number in the range of 1 to 100.


storage-tier-pool-add [stp-add]

Adds one or more pools to the specified storage tier.

	<--tier>         :: Storage tier is a group of one or more storage pools used to simplify 
                            storage provisioning by teir/category/classification.
	<--pool-list>    :: List of storage pools.


storage-tier-pool-remove [stp-remove]

Removes one or more pools from the specified storage tier.

	<--tier>         :: Storage tier is a group of one or more storage pools used to simplify 
                            storage provisioning by teir/category/classification.
	<--pool-list>    :: List of storage pools.


Storage System Replication Link Management

link-create [sl-create]

Create a new storage system link so that storage volumes may be replicated between storage systems.

	<--storage-system> :: Name or ID of a storage system in a management grid.
	<--remote-ip>    :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--remote-admin] :: Remote admin user account to establish remote storage system link with.
	[--remote-passwd] :: Remote admin user password.
	[--local-ip]     :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--bw-limit]     :: Limits the replication bandwidth between two storage systems to a set 
                            level specified in units of kilobytes per second (KB/sec). Specify 0 to 
                            indicate no limit.
	[--link-type]    :: Type of storage system link to establish.
	[--desc]         :: A description for the object.


link-delete [sl-delete]

Delete an existing storage system link.

	<--link>         :: Storage system link ID or name.


link-get [sl-get]

Get information about the storage system link.

	<--link>         :: Storage system link ID or name.


link-list [sl-list]

List the existing storage system remote replication links.

link-modify [sl-modify]

Modify the properties of the storage system link.

	<--link>         :: Storage system link ID or name.
	<--remote-ip>    :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--local-ip]     :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--desc]         :: A description for the object.
	[--bw-limit]     :: Limits the replication bandwidth between two storage systems to a set 
                            level specified in units of kilobytes per second (KB/sec). Specify 0 to 
                            indicate no limit.
	[--link-type]    :: Type of storage system link to establish.


link-set-credentials [sl-setcred]

Change the credentials for an existing storage system link.

	<--link>         :: Storage system link ID or name.
	[--remote-admin] :: Remote admin user account to establish remote storage system link with.
	[--remote-passwd] :: Remote admin user password.


Storage System Management

system-get [sys-get]

Get general information about the storage system.

	[--storage-system] :: Name or ID of a storage system in a management grid.


system-list [sys-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-metadata-recovery-point-list [smrp-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.

	[--storage-system] :: Name or ID of a storage system in a management grid.


system-modify [sys-modify]

Modifies the name and/or description of the storage system.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--location]     :: Optional description indicating the location of the storage system.
	[--domain]       :: The domain name suffix for your network such as example.com
	[--search]       :: The default domain search suffix for your network such as example.com
	[--arp-filter-mode] :: ARP filtering should be enabled when you have more than one network card 
                            on the same network. [*auto, disabled, enabled]
	[--bond-mode]    :: Round-robin balancing is the default mode but if you are using bonding 
                            across switches you must use LACP and have switch infrastructure that 
                            supports it. [lacp, *round-robin]
	[--ext-hostname] :: Specifies the external hostname for the system.  This is useful for 
                            creating grids of systems in the cloud like in Amazon's EC2.
	[--grid-port]    :: Designated port for grid communication
	[--flags]        :: Optional flags for the operation. [async, force, *none]


system-restart [restart]

Restarts the entire storage system.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


system-shutdown [shutdown]

Shutdown the storage system.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--service-only] :: Shutdown just the management service and not the system.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


system-upgrade [upgrade]

Upgrade to the latest version of the core packages.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


Network Interface Management

bonded-interface-create [bond-create]

Creates a bonded network interface by bonding/teaming together a group of one or more physical network ports.

	<--ip-address>   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	<--port-list>    :: List of target ports to be bonded together.
	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--gateway]      :: IP address of the network gateway
	[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to 
                            9000 to enable jumbo frames.
	[--desc]         :: A description for the object.
	[--bond-mode]    :: Round-robin balancing is the default mode but if you are using bonding 
                            across switches you must use LACP and have switch infrastructure that 
                            supports it. [lacp, *round-robin]
	[--flags]        :: Optional flags for the operation. [async, force, *none]


bonded-interface-delete [bond-delete]

Deletes the specified bonded network interface.

	<--port>         :: Name of unique ID of a physical network port/target port.


fiber-channel-port-disable [fcp-disable]

Disables the specified fiber channel port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


fiber-channel-port-enable [fcp-enable]

Enables the specified fiber channel port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


fiber-channel-port-get [fcp-get]

Returns information about the specified fiber channel target port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


fiber-channel-port-list [fcp-list]

Returns a list of all the fiber channel target ports in the system.

infiniband-port-get [ibp-get]

Returns information about the specified infiniband port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


infiniband-port-list [ibp-list]

Returns a list of all the infiniband ports in the system.

target-port-disable [tp-disable]

Disables the specified target port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


target-port-enable [tp-enable]

Enables the specified target port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


target-port-get [tp-get]

Returns information about the specified target port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


target-port-list [tp-list]

Returns a list of all the target ports in the system.

target-port-modify [tp-modify]

Modifies target port settings including IP address, gateway, mtu, etc.

	<--port>         :: Name or MAC address of a target port, or 'all' to modify all ports.
	[--port-type]    :: Port configuration type. (static, dhcp)
	[--ip-address]   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--gateway]      :: IP address of the network gateway
	[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to 
                            9000 to enable jumbo frames.
	[--iscsi-enable] :: Enables or disables iSCSI access to the specified port(s).
	[--desc]         :: A description for the object.
	[--float-list]   :: List of physical ports and/or bonded ports that the virtual interface is 
                            allowed to float between.  If a physical port goes offline the system 
                            will automatically float the virtual interface to one of the online 
                            physical ports in the float list.
	[--bond-mode]    :: Round-robin balancing is the default mode but if you are using bonding 
                            across switches you must use LACP and have switch infrastructure that 
                            supports it. [lacp, *round-robin]
	[--flags]        :: Optional flags for the operation. [async, force, *none]


target-port-rescan [tp-rescan]

Discovers new target ports and/or any manual modifications made to the configuration of the target ports.

	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


target-port-restart [tp-restart]

Restarts the specified target port.

	<--port>         :: Name or MAC address of the target port.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


virtual-interface-create [vif-create]

Creates a new virtual network interface which is linked to a physical network port.

	<--parent-port>  :: Port that the virtual interface should initially be attached to.
	<--ip-address>   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--gateway]      :: IP address of the network gateway
	[--float-list]   :: List of physical ports and/or bonded ports that the virtual interface is 
                            allowed to float between.  If a physical port goes offline the system 
                            will automatically float the virtual interface to one of the online 
                            physical ports in the float list.
	[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to 
                            9000 to enable jumbo frames.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


virtual-interface-delete [vif-delete]

Deletes the specified virtual network interface.

	<--port>         :: Name of unique ID of a physical network port/target port.


virtual-interface-move [vif-move]

Moves the specified virtual network interface to a different physical network port.

	<--vif>          :: Name of unique ID (GUID) for the virtual interface.
	<--port>         :: Name of unique ID of a physical network port/target port.


vlan-interface-create [vlan-create]

Creates a new VLAN interface on the specified physical port.

	<--parent-port>  :: Port that the virtual interface should initially be attached to.
	<--ip-address>   :: IP Address of the host being added; if unspecified the service will look 
                            it up.
	<--vlan-id>      :: VLAN ID (typically 1-255)
	[--storage-system] :: Name or ID of a storage system in a management grid.
	[--netmask]      :: Subnet IP mask (ex: 255.255.255.0)
	[--gateway]      :: IP address of the network gateway
	[--vlan-qos]     :: VLAN Quality of Service (QoS) can be in the range of 0 (lowest, default) 
                            to 7 (highest) and represents the Class of Service (CoS) user priority of 
                            the VLAN traffic.
	[--mtu]          :: Maximum transmission unit (MTU) for the target port, commonly set to 
                            9000 to enable jumbo frames.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async, force, *none]


vlan-interface-delete [vlan-delete]

Deletes the specified VLAN interface.

	<--port>         :: Name of unique ID of a physical network port/target port.


Task Management

task-cancel [t-cancel]

Cancels the specified task that is in the queue or is running.

	<--task>         :: ID of a task.


task-clear-all [t-clear-all]

Clears all the completed and/or failed tasks from the task log so that only the running and queued tasks remain, if any.

task-get [t-get]

Returns information about the specified task.

	<--task>         :: ID of a task.


task-list [t-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 aquired. 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.

User Group Management

tc-commands

List of commands for tab completion

	[--command]      :: Command to show method args for.


user-group-create [ug-create]

Creates a new storage user group comprised of the specified users.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--user-list>    :: A list of one or more users.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async]


user-group-delete [ug-delete]

Deletes a storage user group, the users are not deleted unless the delete-users flag is set.

	<--user-group>   :: An arbirary group of one or more users.
	[--flags]        :: Optional flags for the operation. [async, force]


user-group-get [ug-get]

Returns information about a specific storage user group.

	<--user-group>   :: An arbirary group of one or more users.


user-group-list [ug-list]

Returns a list of all the storage user groups.

user-group-modify [ug-modify]

Modifies the name and/or description of a storage user group.

	<--user-group>   :: An arbirary group of one or more users.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.


user-group-user-add [ugu-add]

Adds one or more users to the specified user group.

	<--user-group>   :: An arbirary group of one or more users.
	<--user-list>    :: A list of one or more users.


user-group-user-remove [ugu-remove]

Removes one or more users from the specified user group

	<--user-group>   :: An arbirary group of one or more users.
	<--user-list>    :: A list of one or more users.


User Management

user-add [u-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.

	<--name>         :: User names may include any alpha-numeric characters '_' and '-', no 
                            spaces are allowed.
	<--password>     :: A password for the user to use when accessing the QuantaStor management 
                            interface.
	<--role>         :: Name of a security role or its unique ID (GUID).
	[--first-name]   :: User's first name; enclose in double-quotes if it contains spaces.
	[--last-name]    :: User's last name; enclose in double-quotes if it contains spaces.
	[--email]        :: An email address of the form 'user@example.com' without the quotes.
	[--desc]         :: A description for the object.
	[--default-chap-user] :: Default CHAP username for storage volumes owned by a user account which 
                            have the CHAP policy set to 'use user default CHAP settings'
	[--default-chap-pass] :: Default CHAP password for storage volumes owned by a user account which 
                            have the CHAP policy set to 'use user default CHAP settings'
	[--alerts]       :: Alert types to subscribe to. Alerts at the subscribed level are sent to 
                            the user's email address automatically when a SMTP server is configured. 
                            [critical, error, info, *none, warning]


user-get [u-get]

Gets information about the specified user.

	<--user>         :: Name or ID (GUID) of a existing user.


user-list [u-list]

Returns a list of all the users.

user-modify [u-modify]

Modifies the specified user name, role, and/or description.

	<--user>         :: Name or ID (GUID) of a existing user.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--role]         :: Name of a security role or its unique ID (GUID).
	[--desc]         :: A description for the object.
	[--default-chap-user] :: Default CHAP username for storage volumes owned by a user account which 
                            have the CHAP policy set to 'use user default CHAP settings'
	[--default-chap-pass] :: Default CHAP password for storage volumes owned by a user account which 
                            have the CHAP policy set to 'use user default CHAP settings'
	[--alerts]       :: Alert types to subscribe to. Alerts at the subscribed level are sent to 
                            the user's email address automatically when a SMTP server is configured. 
                            [critical, error, info, *none, warning]


user-password-set [passwd]

Changes the password for the specified user

	<--user>         :: Name or ID (GUID) of a existing user.
	<--new-password> :: New password for the user.
	[--old-password] :: Old password for the user.


user-remove [u-remove]

Removes the specified user identified by name or ID.

	<--user>         :: Name or ID (GUID) of a existing user.


Storage Volume Access Control (LUN Masking)

volume-assign [va-add]

Enables access to the specific volume from the specified host.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	<--host-list>    :: A list of one or more hosts by name or ID.


volume-assign-list [va-list]

Returns a list of all the volume to host assignments, optionally filtered by host or storage volume.

	[--volume]       :: Name of the storage volume or its unique ID (GUID).
	[--host]         :: Name of the host or its unique ID (GUID).


volume-unassign [va-remove]

Disables access to the specific volume from the specified host.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	<--host-list>    :: A list of one or more hosts by name or ID.


volume-unassign-all [va-remove-all]

Disables all access to the specified volume, host, or host group.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).


Storage Volume Group Management

volume-group-clone [vg-clone]

Creates a complete block by block copy of all volumes in the group.

	<--volume-group> :: An arbirary group of one or more storage volumes.
	[--pool]         :: Name of the storage pool or its unique ID (GUID).
	[--name-suffix]  :: Name for the snapshot/clone; if unspecified the snapshot/clone will use 
                            the original name with '_snapNN'/'_cloneNN' appended.
	[--desc]         :: A description for the object.
	[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
	[--flags]        :: Optional flags for the operation. [async, force]


volume-group-create [vg-create]

Creates a new storage volume group comprised of the specified storage volumes

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--volume-list>  :: A list of one or more storage volumes.
	[--desc]         :: A description for the object.
	[--flags]        :: Optional flags for the operation. [async]


volume-group-delete [vg-delete]

Deletes a storage volume group, the volumes are not deleted unless the delete-volumes flag is set.

	<--volume-group> :: An arbirary group of one or more storage volumes.
	[--destroy-volumes] :: If 'true' all the volumes in the group will be deleted with the volume 
                            group, default is 'false'.
	[--flags]        :: Optional flags for the operation. [async, force]


volume-group-get [vg-get]

Returns information about a specific storage volume group.

	<--volume-group> :: An arbirary group of one or more storage volumes.


volume-group-list [vg-list]

Returns a list of all the storage volume groups.

volume-group-modify [vg-modify]

Modifies the name and/or description of a storage volume group.

	<--volume-group> :: An arbirary group of one or more storage volumes.
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.


volume-group-snapshot [vg-snap]

Creates a space efficient copy of all volumes in the group.

	<--volume-group> :: An arbirary group of one or more storage volumes.
	[--name-suffix]  :: Name for the snapshot/clone; if unspecified the snapshot/clone will use 
                            the original name with '_snapNN'/'_cloneNN' appended.
	[--desc]         :: A description for the object.
	[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
	[--count]        :: The number of snapshots of the specified volume to create, default is 1.
	[--flags]        :: Optional flags for the operation. [async, force]


volume-group-volume-add [vgv-add]

Adds one or more volumes to the specified volume group.

	<--volume-group> :: An arbirary group of one or more storage volumes.
	<--volume-list>  :: A list of one or more storage volumes.


volume-group-volume-remove [vgv-remove]

Removes one or more volumes from the specified volume group

	<--volume-group> :: An arbirary group of one or more storage volumes.
	<--volume-list>  :: A list of one or more storage volumes.


Storage Volume Management

volume-clone [v-clone]

Creates a complete block copy of the source volume.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	[--name]         :: Name for the clone, if not provided the source volume name will be used 
                            as a prefix.
	[--desc]         :: A description for the object.
	[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
	[--flags]        :: Optional flags for the operation. [async, force]


volume-create [v-create]

Creates a new storage volume in the specified storage pool.

	<--name>         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	<--size>         :: Size may be specified in MiB, GiB, or TiB. examples: 4G, 100M, 1.4T
	<--pool>         :: Name of the storage pool or its unique ID (GUID).
	[--desc]         :: A description for the object.
	[--thin]         :: Thin provision (sparse allocate) the storage volume.
	[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
	[--chap-policy]  :: CHAP setting can be 'target' which is unique to a storage volume, 'user' 
                            or 'resource-group' which inherits the chap user/pass from your user 
                            account or storage cloud respectively. [cloud-defaults, *disabled, 
                            target, user-defaults]
	[--chap-user]    :: An optional iSCSI CHAP username.
	[--chap-pass]    :: An optional iSCSI CHAP password.
	[--count]        :: The number of volumes to create, default is 1.
	[--blocksize]    :: Volume block size in KB, valid values are 8, 16, 32, 64, 128. Larger 
                            values deliver higher performance for workloads with high sequential IO.
	[--flags]        :: Optional flags for the operation. [async, force]


volume-delete [v-delete]

Deletes a storage volume, *WARNING* any data in the volume will be lost.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	[--flags]        :: Optional flags for the operation. [async, force]


volume-get [v-get]

Returns information about a specific storage volume.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).


volume-list [v-list]

Returns a list of all the storage volumes.

volume-modify [v-modify]

Modifies a the name, description or other properties of the storage volume.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	[--name]         :: Names may include any alpha-numeric characters '_' and '-', spaces are 
                            not allowed.
	[--desc]         :: A description for the object.
	[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
	[--flags]        :: Optional flags for the operation. [async]
	[--chap-policy]  :: CHAP setting can be 'target' which is unique to a storage volume, 'user' 
                            or 'resource-group' which inherits the chap user/pass from your user 
                            account or storage cloud respectively. [cloud-defaults, *disabled, 
                            target, user-defaults]
	[--chap-user]    :: An optional iSCSI CHAP username.
	[--chap-pass]    :: An optional iSCSI CHAP password.
	[--clear-snap-flag] :: Promotes a snapshot volume to standard (non-snapshot) volume.
	[--enable-wb-cache] :: Enables the write-back cache on the iSCSI target driver, this option 
                            uses volatile system RAM for cache and is not recommended.
	[--is-active-checkpoint] :: Tags the checkpoint device so that it cannot be replicated over.  Use 
                            this for DR failover and this flag is set automatically when a failover 
                            checkpoint volume has an active iSCSI session.
	[--sync]         :: Synchroniztion policy to use for handling writes to the storage pool 
                            (standard, always, none).  standard mode is a hybrid of write-through and 
                            write-back caching based on the O_SYNC flag, always mode is write-through 
                            to ZIL which could be SSD cache, and disabled indicates to always use 
                            async writes. [always, disabled, *standard]
	[--compression-type] :: Type of compression to be used. (on | off | lzjb | gzip | gzip-[1-9] | 
                            zle | lz4)
	[--copies]       :: Indicates the number of copies of each block should be maintained in the 
                            storage pool.  This is a way of getting duplicates for bit-rot protection 
                            on a single device.


volume-resize [v-resize]

Resizes a storage volume to make it larger, volumes cannot be reduced in size.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	<--new-size>     :: New larger size for the volume specified in MiB, GiB, or TiB. examples: 
                            4G, 100M, 1.4T
	[--flags]        :: Optional flags for the operation. [async, force]


volume-restore [v-restore]

Restores a storage volume to a previous point in time using a snapshot.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	<--snapshot>     :: Name or ID of a snapshot volume to use as the restore point.
	[--flags]        :: Optional flags for the operation. [async, force]


volume-snapshot [v-snap]

Creates a space efficient copy of the source volume.

	<--volume>       :: Name of the storage volume or its unique ID (GUID).
	[--name]         :: Name for the snapshot, if not provided the source volume name will be 
                            used as a prefix.
	[--desc]         :: A description for the object.
	[--access-mode]  :: Access mode for the volume. [none, readonly, *readwrite]
	[--count]        :: The number of snapshots of the specified volume to create, default is 1.
	[--flags]        :: Optional flags for the operation. [async, force]


volume-utilization-get [vu-get]

Returns a specific volume utilization metrics for a single volume and specific date.

	<--id>           :: Unique identifier (GUID) for the object.


volume-utilization-list [vu-list]

Returns volume utilization information for a specific storage volume or all storage volumes if no volume is specified.

	[--volume]       :: Name of the storage volume or its unique ID (GUID).