Storage and Volumes
drive-list
drive-list [options]
List disk drives
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
The ID of the disk drive to list. Required unless "--node-name" is specified
--node-name
The node name. Required unless "--id" is specified
logical-volume-create
logical-volume-create [options]
Create logical volume
Options
--device-path
The physical device path
--force
Force creation will reformat existing volume
--help
Display this help and exit
--node-name
The node name
logical-volume-delete
logical-volume-delete [options]
Delete logical volume
Options
--help
Display this help and exit
--id
The logical volume ID (Required)
logical-volume-discover
logical-volume-discover [options]
Discover information about logical volume
Options
--help
Display this help and exit
--id
The logical volume ID (Required)
logical-volume-list
logical-volume-list [options]
List logical volumes
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
The ID of the logical volume to list. Required unless "--node-name" is specified
--node-name
The node name. Required unless "--id" is specified
node-add
node-add [options]
Create a node in the system
Options
--access-id
Authentication username. This option is mandatory for third-party nodes. This option is mutually exclusive with the cert option
--additional-info
Additional value. Format: key=value
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--cert
The node’s authentication certificate. This option is mandatory for third-party nodes, and
is mutually exclusive of the access-id and secret options
--create-placement-objectives
Create default "place-on", "confine-to" and "exclude-from" objectives for this node
--help
Display this help and exit
--ignore-ip-conflicts
Proceed even if the node is configured with IP addresses already in use within the cluster. Warning: if this is used in order to add the same system multiple times, it can cause behavior inconsistencies
--ip
Node IP address. This option is mandatory for third-party nodes
--name
The name to assign to the node (Required)
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--secret
Authentication password. This option is mandatory for third-party nodes. This option is mutually exclusive with the cert option
--type
Node type (Required)
Possible values
PD | NETAPP_CMODE | NETAPP_7MODE | NETAPP_CLOUD | EMC_ISILON | EMC_VNX | EMC_UNITY | GOOGLE_CLOUD_FILESTORE | QUMULO | RCLONE | HNAS | ROZOFS | ROZOFS_HS | SOFTNAS_CLOUD | WINDOWS_FILE_SERVER | DELL_ENAS | PURE_FB | VAST | WEKA | NETAPP_FSX | OTHER
node-list
node-list [options]
List all nodes in the system
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
The ID of the node to list
--internal-id
The internal ID of the node to list
--name
The name of the node to list
--name-contains
Filter nodes by name substring (case-sensitive)
--name-regex
Filter nodes by name regular expression pattern
--name-starts-with
Filter nodes by name prefix (case-sensitive)
--type
Filter nodes by a specific NodeType
--unauthorized
List only discovered unauthorized nodes connected to the system
node-mode-change
node-mode-change [options]
Modify node’s mode
Options
--help
Display this help and exit
--id
Node ID. Required unless any of the following is specified: --internal-id, --name
--internal-id
Node internal ID. Required unless any of the following is specified: --name, --id
--mode
Target mode. Possible values: ONLINE | MAINTENANCE | POWEROFF | REBOOT. (Required)
--name
Node name. Required unless any of the following is specified: --internal-id, --id
node-refresh
node-refresh [options]
Refresh a node in the system
Options
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--help
Display this help and exit
--id
Node ID. Required unless any of the following is specified: --internal-id, --name
--internal-id
Node internal ID. Required unless any of the following is specified: --name, --id
--name
Node name. Required unless any of the following is specified: --internal-id, --id
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--reconcile-components
Remove components from persisted model that have been removed from the node
--rescan
Rescan disk drives in node
node-remove
node-remove [options]
Remove a node from the system. A node that contains system services cannot be removed
Options
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--force
Force remove, whether the node is up or down, possibly leaving the node in an irreparable state
--help
Display this help and exit
--id
The ID of the node to remove. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the node to remove. Required unless any of the following is specified: --name, --id
--name
The name of the node to remove. Required unless any of the following is specified: --internal-id, --id
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
node-storage-repair
node-storage-repair [options]
Repair node storage volumes
Options
--help
Display this help and exit
--id
Node ID to be repaired. Required unless "--name" is specified
--name
Node name to be repaired. Required unless "--id" is specified
node-update
node-update [options]
Update a node in the system
Options
--access-id
Authentication username
--additional-info
Additional value. Format: key=value
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--cert
The node’s authentication certificate
--help
Display this help and exit
--id
Node ID. Required unless any of the following is specified: --internal-id, --name
--internal-id
Node internal ID. Required unless any of the following is specified: --name, --id
--ip
Node IP address
--name
Node name. Required unless any of the following is specified: --internal-id, --id
--new-name
The name to assign to this node
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--secret
Authentication password
nvmeof-config
nvmeof-config [options]
Configure and view NVMe-oF enclosures and configurations
Options
--connect-all
Connect all targets of the specified NVMe-oF enclosure
--connect-nqn
Subsystem NQN(s) to connect
--ctrl-loss-tmo
Number of seconds to wait for a controller to reconnect before giving up (-1 retries indefinitely)
--disconnect-all
Disconnect all targets of the specified NVMe-oF enclosure
--disconnect-nqn
Subsystem NQN(s) to disconnect
--dsx-id
The ID of the DSX node when adding an NVMe-oF enclosure
--dsx-internal-id
The internal ID the DSX when adding an NVMe-oF enclosure
--dsx-name
The name of the DSX node when adding an NVMe-oF enclosure
--enclosure-add
Add an NVMe-oF enclosure to a DSX
--enclosure-id
UUID of enclosure to operate on
--enclosure-name
The name of the enclosure to be operated on
--enclosure-remove
Remove an NVMe-oF enclosure by name or Id
--full
Print extra information for each element
--help
Display this help and exit
--io-policy
Controller I/O policy. Possible values: ROUND_ROBIN | NUMA | QUEUE_DEPTH.
--io-queue-pairs
Number of request/completion queue pairs
--list
List all NVMe-oF enclosures across all DSXs
--queue-depth
Maximum number of I/O queue entries
--target
The target(s) and optionally port and transport type when adding or updating an enclosure
--target 10.10.1.1
--target nvme1.local
--target 10.10.1.1,8009
--target nvme2.local,1234,TCP
--target-port
Network target port
--transport
Network transport type. Possible values: TCP | RDMA.
object-logical-volume-discover
object-logical-volume-discover [options]
Discover information about an object logical volume (bucket)
Options
--help
Display this help and exit
--id
The logical volume ID (Required)
object-storage-add
object-storage-add [options]
Add an object storage node to the product
Options
--access-id
Object Storage access identifier
--allow-self-signed-certificate
Trust the server’s certificate without checking its CA chain
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--aws-instance-profile-auth
When the product is running in AWS, use the STS token supplied by the EC2 instance for authentication. When this option is enabled, access-id/secret are not required.
--bucket-naming-virtual-host
Bucket names are prefixed to the hostname (mybucket.example.org)
--create-placement-objectives
Create default "place-on", "confine-to" and "exclude-from" objectives for this object storage node
--endpoint
-
Object storage endpoint. Required unless --type specifies AMAZON_S3, AZURE, or GOOGLE_CLOUD
--help
Display this help and exit
--name
The name to assign to the object storage (Required)
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--project-name
for GOOGLE_CLOUD types, overrides the email suffix found in the access-id for purposes of specifying a project name
--proxy-host
Proxy host name/IP
--proxy-password
Proxy password
--proxy-port
Proxy port
--proxy-username
Proxy username
--s3-signing-type
S3 auth signing type. Possible values: S3_DEFAULT_SIGNING | S3_V4_SIGNING.
--secret
Object Storage secret
--security-token
AWS STS token. Only valid for AMAZON_S3. When setting, the access_id and secret must be correct for the token.
--type
Object storage type
Possible values
AMAZON_S3 | ACTIVE_SCALE_S3 | IBM_S3 | CLOUDIAN_S3 | ECS_S3 | GENERIC_S3 | GOOGLE_S3 | SCALITY_S3 | STORAGE_GRID_S3 | AZURE | GOOGLE_CLOUD | HCP_S3 | WASABI_S3 | NETAPP_S3 | SNOWFLAKE | INTERNAL_S3 | PURE_FB_S3 | SEAGATE_LYVE_S3 | CARINGO_SWARM_S3 | ISILON_S3 | BACKBLAZE_S3 | HAMMERSPACE_S3 | STORJ_S3
object-storage-update
object-storage-update [options]
Update an object storage node
Options
--access-id
Object storage access key
--allow-self-signed-certificate
Trust the server’s certificate without checking its CA chain
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--aws-instance-profile-auth-disable
Do not use the STS token supplied by an AWS EC2 instance for authentication
--aws-instance-profile-auth-enable
When the product is running in AWS, use the STS token supplied by the EC2 instance for authentication. When this option is enabled, access-id/secret are not required.
--bucket-naming-path-style
Bucket names are suffixed as a path (example.org/mybucket)
--bucket-naming-virtual-host
Bucket names are prefixed to the hostname (mybucket.example.org)
--disallow-self-signed-certificate
Validate the server certificate’s CA chain
--endpoint
-
Object storage endpoint. Required unless --type specifies AMAZON_S3, AZURE, or GOOGLE_CLOUD
--endpoint-clear
Reset the endpoint to its default
--help
Display this help and exit
--id
The ID of the object storage to update. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object storage to update. Required unless any of the following is specified: --name, --id
--name
The name of the object storage to update. Required unless any of the following is specified: --internal-id, --id
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--project-name
for GOOGLE_CLOUD types, overrides the email suffix found in the access-id for purposes of specifying a project name
--project-name-clear
Clears the project name override
--proxy-clear
Remove the proxy definitions, i.e. don’t use proxy for this Object storage
--proxy-host
Proxy host name/IP
--proxy-password
Proxy password
--proxy-port
Proxy port
--proxy-username
Proxy username
--secret
Object storage secret key
--security-token
AWS STS token. Only valid for AMAZON_S3. When setting, the access_id and secret must be correct for the token.
--security-token-clear
Clear the AWS STS token. When clearing, the access_id and secret must be set for use without a token.
--skip-object-volume-validations
Force update even when new configuration may cause object storage volumes to become unusable
--type
Object storage type
Possible values
AMAZON_S3 | ACTIVE_SCALE_S3 | IBM_S3 | CLOUDIAN_S3 | ECS_S3 | GENERIC_S3 | GOOGLE_S3 | SCALITY_S3 | STORAGE_GRID_S3 | AZURE | GOOGLE_CLOUD | HCP_S3 | WASABI_S3 | NETAPP_S3 | SNOWFLAKE | INTERNAL_S3 | PURE_FB_S3 | SEAGATE_LYVE_S3 | CARINGO_SWARM_S3 | ISILON_S3 | BACKBLAZE_S3 | HAMMERSPACE_S3 | STORJ_S3
object-volume-add
object-volume-add [options]
Add an object storage volume to the product
Options
--access-key
Access key, if not provided, the object storage credentials will be used
--availability
Volume availability capability, specified as the number of nines (number between 0 and 20)
--create-placement-objectives
Create default "place-on", "confine-to" and "exclude-from" objectives for this object volume
--durability
Volume durability capability, specified as the number of nines (number between 0 and 20)
--gc-disable
Disable coordinated garbage collection. Only applicable for shared object volumes.
--gc-enable
Enable coordinated garbage collection. Only applicable for shared object volumes.
--help
Display this help and exit
--high-threshold
The percent [0,100] of total capacity which when reached, will trigger the system to begin evacuating data from the volume. When not specified, 75 percent is used
--logical-volume-id
object logical volume ID. Required unless "--logical-volume-name" is specified
--logical-volume-name
object logical volume. Required unless "--logical-volume-id" is specified
--low-threshold
When the high threshold is reached and data is moving off of the volume, this is the target percent [0,high threshold] to reach before stopping the evacuation of data. When not specified, the default is the high threshold * 0.8
--max-suspected-time
The amount of time a volume may remain in a SUSPECTED operational state before its storage volume state is automatically transitioned to UNAVAILABLE. May be formatted as 10seconds, 1minute, "1 hour 30 minutes", etc. When no units are specified, minutes are assumed
--name
The object storage volume name. If not provided, a default name will be assigned
--native
Data is stored as non-chunked, unencrypted, and uncompressed.
--no-compression
Do not compress when storing.
--no-encryption
Do not encrypt.
--node-id
The node ID. Required unless "--node-name" is specified
--node-name
The node name. Required unless "--node-id" is specified
--online-delay
Max time (in nanoseconds) for the file to be restored
--secret-key
Secret key, if not provided, the object storage credentials will be used
--shared
Indicates that the ownership of the object volume is, or will be, shared with other sites
--total-capacity
Specifies the total amount of data allowed to be stored on the volume. When not specified, a practically unlimited amount is assumed
--use-high-compression
Use high compression when storing.
object-volume-decommission
object-volume-decommission [options]
Start the object volume decommission process (DEPRECATED)
Decommission runs as a restartable task, although this command itself is deprecated.
If normal garbage collection is active when decommission cleaning starts, garbage collection is aborted gracefully and the task waits for it to finish before the cleaner starts.
The task then follows the cleaning session:
-
PENDINGandIN_PROGRESS— the task continues polling. -
COMPLETED— the task advances to the next stage. -
ABORTED,FAILED, orCANCELLED— the task starts one replacement cleaning session. If that session also ends in a terminal state, or cannot start at all, the task fails rather than hanging.
A failure at this point leaves the object storage volume in DECOMMISSIONING at the cleaning stage. To recover, rerun object-volume-remove. The task-resume command cannot restart a cleaning session that has already ended.
Start-cleaning, cleaning, unprepare, and final removal cannot be cancelled once entered. Use object-volume-decommission-cancel before those stages begin.
|
Options
--force
Force decommission, even if it will impact access to data
--help
Display this help and exit
--id
Object Storage Volume ID. Required unless any of the following is specified: --internal-id, --name
--internal-id
Object Storage Volume internal ID. Required unless any of the following is specified: --name, --id
--name
Object Storage Volume name. Required unless any of the following is specified: --internal-id, --id
--replace-with
List of locations to replace the decommissioned volume. Example: node:<name>,volume-group:<name>,volume:<name>,object-volume:<name>
object-volume-decommission-cancel
object-volume-decommission-cancel [options]
Cancel the object storage volume decommission process (DEPRECATED)
Options
--help
Display this help and exit
--id
Object Storage Volume identifier. Required unless any of the following is specified: --internal-id, --name
--internal-id
Object Storage Volume internal ID. Required unless any of the following is specified: --name, --id
--name
Object Storage Volume name. Required unless any of the following is specified: --internal-id, --id
object-volume-fail
object-volume-fail [options]
Set an object volume to the FAILED state. Typically used to allow the removal of an object volume that no longer exists
Options
--help
Display this help and exit
--id
The ID of the object volume to set to the FAILED state. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume to set to the FAILED state. Required unless any of the following is specified: --name, --id
--name
The name of the object volume to set to the FAILED state. Required unless any of the following is specified: --internal-id, --id
object-volume-gc-start
object-volume-gc-start [options]
Start garbage collection on a given object volume.
Options
--help
Display this help and exit
--id
The ID of the object volume. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume. Required unless any of the following is specified: --name, --id
--name
The name of the object volume. Required unless any of the following is specified: --internal-id, --id
object-volume-gc-stop
object-volume-gc-stop [options]
Stop garbage collection on a given object volume.
Options
--help
Display this help and exit
--id
The ID of the object volume. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume. Required unless any of the following is specified: --name, --id
--name
The name of the object volume. Required unless any of the following is specified: --internal-id, --id
object-volume-list
object-volume-list [options]
List object volumes
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
The ID of the volume to list
--internal-id
The internal ID of the volume to list
--name
The name of the volume to list
object-volume-remove
object-volume-remove [options]
Remove an object volume from the system.
If the volume is currently in a FAILED or DECOMMISSIONED state, it will be removed immediately. Otherwise, the
volume’s state will transition from DECOMMISSIONING to CLEANING to DECOMMISSIONED before being removed.
Options
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--help
Display this help and exit
--id
The ID of the object volume to remove. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume to remove. Required unless any of the following is specified: --name, --id
--name
The name of the object volume to remove. Required unless any of the following is specified: --internal-id, --id
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--replace-with
List of locations to replace references to the removed object volume with. Example: node:<name>,volume-group:<name>,volume:<name>,object-volume:<name>
--skip-gfs-validation
Skip validation to ensure that removing this object volume will not negatively impact data replication
object-volume-remove-cancel
object-volume-remove-cancel [options]
Cancel the removal of an object volume. The volume must be in the DECOMMISSIONING state
Options
--help
Display this help and exit
--id
The ID of the object volume whose removal will be cancelled. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume whose removal will be cancelled. Required unless any of the following is specified: --name, --id
--name
The name of the object volume whose removal will be cancelled. Required unless any of the following is specified: --internal-id, --id
object-volume-reservation-delete
object-volume-reservation-delete [options]
Delete a site’s reservation from an object volume. This is typically done in order to clean up a reservation file left on the object volume when a site has failed or been removed without first removing the object volume. WARNING: deleting a site’s reservation from an object volume where the site is still using that object volume may result in data loss. Before using this command, verify that the site is no longer using the object volume.
Options
--force
Required to acknowledge the potentially destructive nature of this command (Required)
--help
Display this help and exit
--id
The ID of the volume from which to delete the reservation. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the volume from which to delete the reservation. Required unless any of the following is specified: --name, --id
--name
The name of the volume from which to delete the reservation. Required unless any of the following is specified: --internal-id, --id
--site-id
The ID of the site whose reservation is to be deleted. Required unless any of the following is specified: --site-name, --site-internal-id
--site-internal-id
The internal ID of the site whose reservation is to be deleted. Required unless any of the following is specified: --site-id, --site-name
--site-name
The name of the site whose reservation is to be deleted. Required unless any of the following is specified: --site-id, --site-internal-id
object-volume-set-available
object-volume-set-available [options]
Mark an unavailable object volume as available
Options
--help
Display this help and exit
--id
The ID of the object volume to mark available. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume to mark available. Required unless any of the following is specified: --name, --id
--name
The name of the object volume to mark available. Required unless any of the following is specified: --internal-id, --id
object-volume-set-unavailable
object-volume-set-unavailable [options]
Mark an object volume as unavailable
Options
--force
Force unavailable, even if it will break existing replication agreements
--help
Display this help and exit
--id
The ID of the object volume to mark unavailable. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the object volume to mark unavailable. Required unless any of the following is specified: --name, --id
--name
The name of the object volume to mark unavailable. Required unless any of the following is specified: --internal-id, --id
object-volume-update
object-volume-update [options]
Update object volume
Options
--access-key
Access key
--availability
Volume availability capability, specified as the number of nines (number between 0 and 20)
--durability
Volume durability capability, specified as the number of nines (number between 0 and 20)
--gc-disable
Disable coordinated garbage collection. Only applicable for shared object volumes.
--gc-enable
Enable coordinated garbage collection. Only applicable for shared object volumes.
--help
Display this help and exit
--high-threshold
The percent [0,100] of total capacity which when reached, will trigger the system to begin evacuating data from the volume
--high-threshold-clear
Reset the high threshold to its default (75 percent)
--id
object volume ID. Required unless any of the following is specified: --internal-id, --name
--internal-id
object volume internal ID. Required unless any of the following is specified: --name, --id
--low-threshold
When the high threshold is reached and data is moving off of the volume, this is the target percent [0,high threshold] to reach before stopping the evacuation of data
--low-threshold-clear
Reset the low threshold to its default (20 percent less than the high threshold)
--max-suspected-time
The amount of time a volume may remain in a SUSPECTED operational state before its storage volume state is automatically transitioned to UNAVAILABLE. May be formatted as 10seconds, 1minute, "1 hour 30 minutes", etc. When no units are specified, minutes are assumed
--name
object volume name. Required unless any of the following is specified: --internal-id, --id
--new-name
object storage new name
--no-compression
Do not compress when storing.
--no-encryption
Do not encrypt.
--online-delay
Max time (in nanoseconds) for the file to be restored
--secret-key
Secret key
--total-capacity
Specifies the total amount of data allowed to be stored on the volume
--total-capacity-clear
Resets the total-capacity to its default
--use-default-encryption
Use the system-configured KMS (if one is configured) for encrypting.
--use-high-compression
Use high compression when storing.
s3-server-bucket-create
s3-server-bucket-create [options]
Add a new bucket or bucket container to an existing S3 server
Options
--acl
Access permissions applied to the bucket. Possible values: PUBLIC | GROUP | PRIVATE.
--alias
Optional bucket alias
--bucket-container
Create a bucket container
--default-container
Make this bucket container the default for new buckets
--deny-create
Disallow creation of new buckets in a bucket container (allowed by default)
--deny-delete
Do not allow this bucket to be deleted, or child buckets to be deleted if creating a bucket container (allowed by default)
--help
Display this help and exit
--owner
User that owns the bucket
--path
Additional path below the share root (defaults to '/')
--region
The geographic region for this bucket. If creating a container then this will be the default region for buckets created in the container
--server-id
ID of an S3 server. Required unless any of the following is specified: --server-name, --server-internal-id
--server-internal-id
Internal ID of an S3 server. Required unless any of the following is specified: --server-name, --server-id
--server-name
Name of an S3 server. Required unless any of the following is specified: --server-id, --server-internal-id
--share-id
ID of a share. Required unless any of the following is specified: --share-internal-id, --share-name
--share-internal-id
Internal ID of a share. Required unless any of the following is specified: --share-id, --share-name
--share-name
Name of a share. Required unless any of the following is specified: --share-id, --share-internal-id
--umask
Umask for objects created in the bucket
s3-server-bucket-remove
s3-server-bucket-remove [options]
Remove a bucket or bucket container from an S3 server
Options
--delete-content
Delete bucket data
--help
Display this help and exit
--name
Name of bucket or bucket container to remove (Required)
--server-id
ID of an S3 server. Required unless any of the following is specified: --server-name, --server-internal-id
--server-internal-id
Internal ID of an S3 server. Required unless any of the following is specified: --server-name, --server-id
--server-name
Name of an S3 server. Required unless any of the following is specified: --server-id, --server-internal-id
s3-server-create
s3-server-create [options]
Create an S3 server
Options
--acl
Access permissions applied to the bucket. Possible values: PUBLIC | GROUP | PRIVATE.
--default-server
Make this the default server, only one is allowed at a time
--endpoint-prefix
Endpoint prefix, used to support virtual host bucket addressing. Default is 's3'
--endpoints
One or more DNS endpoints for the server. Required unless this is the default server
--help
Display this help and exit
--identity-provider
Identity provider for users of this service. Possible values: LOCAL | AD. (Required)
--max-keys
The maximum number of entries to return when listing objects in a bucket, default is 1,000
--mpu-abort-threshold-days
Multipart uploads will be aborted and cleaned up if initiated this many days ago
--name
Management name for the S3 server (Required)
--ports
TCP port(s) to listen on, must be one or both of 80 and 443. Defaults to 443
--region
The default geographic region for buckets
--strict-bucket-listing
Only list buckets owned by requester, off by default
--strict-bucket-naming
Enforce AWS bucket name requirements
--umask
Umask for objects created in buckets
s3-server-delete
s3-server-delete [options]
Delete an S3 server
Options
--help
Display this help and exit
--id
ID of S3 server to delete
--internal-id
Internal ID of S3 server to delete
--name
Name of S3 server to delete
s3-server-list
s3-server-list [options]
List S3 servers
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
View an S3 server by ID
--internal-id
View an S3 server by internal ID
--name
View an S3 server by name
s3-server-update
s3-server-update [options]
Update an S3 server
Options
--acl
Access permissions applied to buckets. Possible values: PUBLIC | GROUP | PRIVATE.
--acl-clear
Remove default ACL
--default-server
Make this the default server, only one is allowed at a time
--default-server-clear
Remove default server designation, requires that at least one endpoint is assigned
--endpoint-prefix
Endpoint prefix, used to support virtual host bucket addressing. Default is 's3'
--endpoint-prefix-clear
Clear the endpoint prefix setting, revert to default 's3'
--endpoints
One or more DNS endpoints for the server. Required unless this is the default server
--endpoints-clear
Remove all endpoints from the server
--help
Display this help and exit
--id
Id of the S3 server to update. Required unless any of the following is specified: --internal-id, --name
--internal-id
Internal Id of the S3 server to update. Required unless any of the following is specified: --name, --id
--max-keys
The maximum number of entries to return when listing objects in a bucket, default is 1,000
--mpu-abort-threshold-days
Multipart uploads will be aborted and cleaned up if initiated this many days ago
--name
Management name of the S3 server to update. Required unless any of the following is specified: --internal-id, --id
--ports
TCP port(s) to listen on, must be one or both of 80 and 443. Defaults to 443
--region
Default geographic region for buckets
--region-clear
Remove default region
--strict-bucket-listing
Only list buckets owned by requester, off by default
--strict-bucket-listing-clear
Bucket list will show buckets for all bucket owners
--strict-bucket-naming
Enforce AWS bucket name requirements
--strict-bucket-naming-clear
Do not enforce AWS bucket name requirements
--umask
Umask for objects created in buckets
--umask-clear
Remove any umask set for this server
s3-server-user-add
s3-server-user-add [options]
Add an authorized users to an S3 server
Options
--access-key
S3 access key for user (Required)
--help
Display this help and exit
--secret-key
S3 secret key for user (Required)
--server-id
ID of an S3 server. Required unless any of the following is specified: --server-name, --server-internal-id
--server-internal-id
Internal ID of an S3 server. Required unless any of the following is specified: --server-name, --server-id
--server-name
Name of an S3 server. Required unless any of the following is specified: --server-id, --server-internal-id
--username
Name of AD or local user to add (Required)
s3-server-user-remove
s3-server-user-remove [options]
Remove user from an S3 server
Options
--help
Display this help and exit
--server-id
ID of an S3 server. Required unless any of the following is specified: --server-name, --server-internal-id
--server-internal-id
Internal ID of an S3 server. Required unless any of the following is specified: --server-name, --server-id
--server-name
Name of an S3 server. Required unless any of the following is specified: --server-id, --server-internal-id
--username
Name of the AD or local user to remove (Required)
volume-add
volume-add [options]
Add a storage volume to the product
Options
--access-type
The access type of the storage volume. Possible values: READ_ONLY | READ_WRITE.
--additional-ip
Allows specification of addresses which are not listed among the logical volume’s IP addresses and which may be used to access data on the volume. This is a comma-separated tuple consisting of: IP, port, transport, node-num, stripe-class, failover-class (where port, transport, node-num, stripe-class and failover-class are optional). The IP may be in CIDR format. The transport may be one of: tcp, tcp6, rdma, rdma6. The node-num allows grouping of IPs which are common to a physical node. The stripe-class allows grouping of IPs which may be used to access the same instance stripe. When omitted, striping is not enabled via this address The failover-class allows grouping of IPs which may be used interchangeably for node failover. A value may be omitted by leaving it empty. 10.20.30.40,,rdma,1 is an example where the port, stripe-class and failover-class are omitted. This parameter may be repeated
--assimilation
Assimilate data from the volume
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--availability
The storage volume availability capability, specified as the number of nines (number between 0 and 20)
--availability-drop-enabled
Causes the volume’s advertised availability to other components to drop to zero when the volume’s storage volume state becomes UNAVAILABLE. This has the effect of causing files with instances on the volume to be re-mirrored/moved
--cost
Estimated cost of the storage volume
--create-placement-objectives
Create default "place-on", "confine-to" and "exclude-from" objectives for this storage volume
--destination-path
The path within the share into which data is assimilated
--disable-offloaded-cloning
Disable support for performing offloaded cloning on the volume
--durability
The storage volume durability capability, specified as the number of nines (number between 0 and 20)
--exclude-free-space
Exclude the volume from the calculation of the cluster’s free capacity
--excluded-ip
A comma-separated list of IP addresses and/or ranges (x.x.x.x-y.y.y.y) to exclude from the list of discovered IP addresses
--force
Delete a previous installation’s data from the volume
--help
Display this help and exit
--high-threshold
The percent [0,100] of total capacity which when reached, will trigger the system to begin evacuating data from the volume. When not specified, 75 percent is used
--log-assimilation
Causes assimilation to log data into <share/mount/path>/assimilation-logs-<date>/
--logical-volume-id
The logical volume ID. Required unless "--logical-volume-name" is specified
--logical-volume-name
The logical volume name. Required unless "--logical-volume-id" is specified
--low-threshold
When the high threshold is reached and data is moving off of the volume, this is the target percent [0,high threshold] to reach before stopping the evacuation of data. When not specified, the default is the high threshold * 0.8
--max-suspected-time
The amount of time a volume may remain in a SUSPECTED operational state before its storage volume state is automatically transitioned to UNAVAILABLE. May be formatted as 10seconds, 1minute, "1 hour 30 minutes", etc. When no units are specified, minutes are assumed
--name
The storage volume name. If not provided, default name will be assigned
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--node-id
The node ID. Required unless "--node-name" is specified
--node-name
The node name. Required unless "--node-id" is specified
--path
The path within the share into which data is assimilated
--random-writes-disabled
Disable random writes for the volume
--read-bandwidth
The storage volume read bandwidth (in kb/sec)
--read-iops
The storage volume read number of IOPS
--read-latency
The storage volume read latency (in microseconds)
--share-id
The ID of the share into which data is assimilated
--share-name
The name of the share into which data is assimilated
--skip-configuration-test
Do not verify the configuration of the volume being added
--skip-file-access-test
Skip file access test when assimilating data from the volume
--skip-performance-test
Do not calculate performance metrics while adding the volume
--smb-default-group
An Active Directory group to use for SID mapping if a group SID does not have a mapping (because the group has been deleted). Valid forms are <name>@<domain>, <domain>\\<name> or <name>. If <name> is used, the current AD domain is assumed.
--smb-default-user
An Active Directory user to use for SID mapping if a user SID does not have a mapping (because the account has been deleted). Valid forms are <name>@<domain>, <domain>\\<name> or <name>. If <name> is used, the current AD domain is assumed.
--smb-password
Password for SMB username used to assimilate SMB data
--smb-path
A UNC-style path (e.g. //example.com/Share/path/to/data) which must include the fully-qualified domain name of the SMB server from which data is being assimilated as well as the SMB share name from which data is being assimilated. It may also contain an SMB source path for cases where the SMB source path differs from the NFS path specified in the source-path parameter
--smb-username
SMB username used to assimilate SMB data. Valid forms are <name>@<domain>, <domain>\\<name> or <name>. If <name> is used, the current AD domain is assumed.
--source-path
The path within the volume from which data is assimilated (the named directory will itself be assimilated). This is used as the NFS source path, and when doing SMB assimilation, and the UNC-style smb_path is missing the path part, this is also used as the SMB source path
--stripe-alignment
The stripe alignment size in bytes when striping is supported. When specified, there should be at least two different stripe-class values among the effective addresses (use additional-ip to specify stripe classes)
--stripe-alignment-default
Sets the stripe alignment to the default value for the volume
--tolerable-read-latency
The storage volume tolerable read latency (in nanoseconds)
--tolerable-write-latency
The storage volume tolerable write latency (in nanoseconds)
--write-bandwidth
The storage volume write bandwidth (in kb/sec)
--write-iops
The storage volume write number of IOPS
--write-latency
The storage volume write latency (in microseconds)
volume-assimilation
volume-assimilation [options]
Assimilate an existing storage volume
Options
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--destination-path
The path within the share into which data is assimilated
--help
Display this help and exit
--id
The volume ID. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the volume. Required unless any of the following is specified: --name, --id
--log
Causes assimilation to log data into <share/mount/path>/assimilation-logs-<date>/
--name
The volume name. Required unless any of the following is specified: --internal-id, --id
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--path
The path within the share into which data is assimilated
--share-id
The ID of the share into which data is assimilated. Required unless "--share-name" is specified
--share-name
The name of the share into which data is assimilated. Required unless "--share-id" is specified
--skip-file-access-test
Skip file access test when assimilating data from the volume
--smb-default-group
An Active Directory group to use for SID mapping if a group SID does not have a mapping (because the group has been deleted). Valid forms are <name>@<domain>, <domain>\\<name> or <name>. If <name> is used, the current AD domain is assumed.
--smb-default-user
An Active Directory user to use for SID mapping if a user SID does not have a mapping (because the account has been deleted). Valid forms are <name>@<domain>, <domain>\\<name> or <name>. If <name> is used, the current AD domain is assumed.
--smb-password
Password for SMB username used to assimilate SMB data
--smb-path
A UNC-style path (e.g. //example.com/Share/path/to/data) which must include the fully-qualified domain name of the SMB server from which data is being assimilated as well as the SMB share name from which data is being assimilated. It may also contain an SMB source path for cases where the SMB source path differs from the NFS path specified in the source-path parameter
--smb-username
SMB username used to assimilate SMB data. Valid forms are <name>@<domain>, <domain>\\<name> or <name>. If <name> is used, the current AD domain is assumed.
--source-path
The path within the volume from which data is assimilated (the named directory will itself be assimilated). This is used as the NFS source path, and when doing SMB assimilation, and the UNC-style smb_path is missing the path part, this is also used as the SMB source path
volume-assimilation-cancel
volume-assimilation-cancel [options]
Cancel a running assimilation
Options
--help
Display this help and exit
--task-id
The task ID associated with the running assimilation (Required)
volume-decommission
volume-decommission [options]
Start the storage volume decommission process (DEPRECATED)
Options
--help
Display this help and exit
--id
Storage Volume identifier. Required unless any of the following is specified: --internal-id, --name
--internal-id
Storage Volume internal identifier. Required unless any of the following is specified: --name, --id
--name
Storage Volume name. Required unless any of the following is specified: --internal-id, --id
--replace-with
List of locations to replace the decommissioned volume. Example: node:<name>,volume-group:<name>,volume:<name>,object-volume:<name>
volume-decommission-cancel
volume-decommission-cancel [options]
Cancel the storage volume decommission process (DEPRECATED)
Options
--help
Display this help and exit
--id
Storage Volume identifier. Required unless any of the following is specified: --internal-id, --name
--internal-id
Storage Volume internal identifier. Required unless any of the following is specified: --name, --id
--name
Storage Volume name. Required unless any of the following is specified: --internal-id, --id
volume-fail
volume-fail [options]
Set a storage volume to the FAILED state. Typically used to allow the removal of a storage volume that no longer exists
| Be aware that failed volumes cannot be recovered! |
Options
--help
Display this help and exit
--id
The ID of the storage volume to set to the FAILED state. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the storage volume to set to the FAILED state. Required unless any of the following is specified: --name, --id
--name
The name of the storage volume to set to the FAILED state. Required unless any of the following is specified: --internal-id, --id
volume-group-create
volume-group-create [options]
Create a new volume group
Options
--description
The volume group’s description
--expressions
The volume group expression(s). Expressions are separated by '&'
--help
Display this help and exit
--name
The volume group name (Required)
volume-group-delete
volume-group-delete [options]
Delete a volume group
Options
--help
Display this help and exit
--id
The ID of the volume group to delete. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the volume group to delete. Required unless any of the following is specified: --name, --id
--name
The name of the volume group to delete. Required unless any of the following is specified: --internal-id, --id
volume-group-list
volume-group-list [options]
Display a detailed list of all volume groups available in the system
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
The ID of the volume group to list
--internal-id
The internal ID of the volume group to list
--name
The name of the volume group to list
volume-group-update
volume-group-update [options]
Update a volume group
Options
--description
The volume group’s description. Required unless any of the following is specified: --expressions, --expressions-clear, --new-name, --description-clear
--description-clear
Clear the volume group’s description. Required unless any of the following is specified: --expressions, --expressions-clear, --description, --new-name
--expressions
The volume group expression(s). Expressions are separated by '&'. Required unless any of the following is specified: --expressions-clear, --description, --new-name, --description-clear
--expressions-clear
Clear the volume group expression(s). Required unless any of the following is specified: --expressions, --description, --new-name, --description-clear
--help
Display this help and exit
--id
The ID of the volume group to update. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the volume group to update. Required unless any of the following is specified: --name, --id
--name
The name of the volume group to update. Required unless any of the following is specified: --internal-id, --id
--new-name
The volume group updated name. Required unless any of the following is specified: --expressions, --expressions-clear, --description, --description-clear
volume-list
volume-list [options]
Display a detailed list of all storage volumes available in the system. Two types of lists can be displayed: a detailed list and a Summary list (default)
Options
--full
Print extra information for each element
--help
Display this help and exit
--id
The ID of the storage volume to list
--internal-id
The internal ID of the volume to list
--name
The name of the storage volume to list
volume-remove
volume-remove [options]
Remove a storage volume from the system.
If the volume is currently in a FAILED or DECOMMISSIONED state, it will be removed immediately. Otherwise, the
volume’s state will transition from DECOMMISSIONING to CLEANING to DECOMMISSIONED before being removed.
Options
--async
Causes the command to be executed asynchronously. A reference task identifier will be returned
--help
Display this help and exit
--id
The ID of the storage volume to remove. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the storage volume to remove. Required unless any of the following is specified: --name, --id
--name
The name of the storage volume to remove. Required unless any of the following is specified: --internal-id, --id
--no-timeout
When running a task-based command synchronously, monitor for task completion indefinitely
--replace-with
List of locations to replace references to the removed storage volume with. Example: node:<name>,volume-group:<name>,volume:<name>,object-volume:<name>
volume-remove-cancel
volume-remove-cancel [options]
Cancel the removal of a storage volume. The volume must be in the DECOMMISSIONING state
Options
--help
Display this help and exit
--id
The ID of the storage volume whose removal will be cancelled. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the storage volume whose removal will be cancelled. Required unless any of the following is specified: --name, --id
--name
The name of the storage volume whose removal will be cancelled. Required unless any of the following is specified: --internal-id, --id
volume-set-available
volume-set-available [options]
Mark an unavailable storage volume as available
Options
--help
Display this help and exit
--id
The ID of the storage volume to mark available. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the storage volume to mark available. Required unless any of the following is specified: --name, --id
--name
The name of the storage volume to mark available. Required unless any of the following is specified: --internal-id, --id
volume-set-unavailable
volume-set-unavailable [options]
Mark a storage volume as unavailable
Options
--help
Display this help and exit
--id
The ID of the storage volume to mark unavailable. Required unless any of the following is specified: --internal-id, --name
--internal-id
The internal ID of the storage volume to mark unavailable. Required unless any of the following is specified: --name, --id
--name
The name of the storage volume to mark unavailable. Required unless any of the following is specified: --internal-id, --id
volume-update
volume-update [options]
Update storage volume attributes, including the volume performance and availability attributes
Options
--additional-ip-add
Add an address which is listed among the logical volume’s IP addresses and which may be used to access data on the volume. This is a comma-separated tuple consisting of: IP, port, transport, node-num, stripe-class, failover-class (where port, transport, node-num, stripe-class and failover-class are optional). The IP may be in CIDR format. The transport may be one of: tcp, tcp6, rdma, rdma6. The node-num allows grouping of IPs which are common to a physical node. The stripe-class allows grouping of IPs which may be used to access the same instance stripe. When omitted, striping is not enabled via this address The failover-class allows grouping of IPs which may be used interchangeably for node failover. A value may be omitted by leaving it empty. 10.20.30.40,,rdma,1 is an example where the port, stripe-class and failover-class are omitted. This parameter may be repeated
--additional-ip-remove
Remove a value from the list of additional IP addresses. The format is the same as that for additional-ip-add, but the port and transport are not optional. This parameter may be repeated
--additional-ips-clear
Remove all values from the list of additional IP addresses
--availability
The storage volume availability capability, specified as the number of nines (number between 0 and 20)
--availability-drop-disabled
Causes the volume’s advertised availability to other components to remain unaltered when the volume’s storage volume state becomes UNAVAILABLE.
--availability-drop-enabled
Causes the volume’s advertised availability to other components to drop to zero when the volume’s storage volume state becomes UNAVAILABLE. This has the effect of causing files with instances on the volume to be re-mirrored/moved
--disable-offloaded-cloning
Disallow offloaded cloning from being performed on the volume, whether supported or not
--durability
The storage volume durability capability, specified as the number of nines (number between 0 and 20)
--enable-offloaded-cloning
Allow offloaded cloning to be performed on the volume when supported
--exclude-free-space
Exclude the volume from the calculation of the cluster’s free capacity
--exclude-free-space-clear
Stop excluding the volume from the calculation of the cluster’s free capacity
--excluded-ip-add
A comma-separated list of IP addresses and/or ranges (x.x.x.x-y.y.y.y) to be added to the list of excluded IP addresses
--excluded-ip-remove
A comma-separated list of IP addresses and/or ranges (x.x.x.x-y.y.y.y) to be removed from the list of excluded IP addresses
--excluded-ips-clear
Remove all values from the list of excluded IP addresses
--help
Display this help and exit
--high-threshold
The percent [0,100] of total capacity which when reached, will trigger the system to begin evacuating data from the volume
--high-threshold-clear
Reset the high threshold to its default (75 percent)
--id
The ID of the storage volume to update. Required unless any of the following is specified: --internal-id, --name, --volume-group-internal-id, --volume-group-name, --volume-group-id
--internal-id
The internal ID of the storage volume to update. Required unless any of the following is specified: --name, --volume-group-internal-id, --id, --volume-group-name, --volume-group-id
--low-threshold
When the high threshold is reached and data is moving off of the volume, this is the target percent [0,100] to reach before stopping the evacuation of data
--low-threshold-clear
Reset the low threshold to its default (20 percent less than the high threshold)
--max-suspected-time
The amount of time a volume may remain in a SUSPECTED operational state before its storage volume state is automatically transitioned to UNAVAILABLE. May be formatted as 10seconds, 1minute, "1 hour 30 minutes", etc. When no units are specified, minutes are assumed.
--name
The name of the storage volume to update. Required unless any of the following is specified: --internal-id, --volume-group-internal-id, --id, --volume-group-name, --volume-group-id
--new-name
The storage volume new name
--random-writes-disabled
Disable random writes for the volume
--random-writes-enabled
Enable random writes for the volume
--read-bandwidth
The storage volume read bandwidth (in kb/sec)
--read-iops
The storage volume read number of IOPS
--read-latency
The storage volume read latency (in microseconds)
--stripe-alignment
The stripe alignment size in bytes when striping is supported. When specified, there should be at least two different stripe-class values among the effective addresses (use additional-ip to specify stripe classes)
--stripe-alignment-clear
Clear the stripe alignment size (disable striping)
--stripe-alignment-default
Sets the stripe alignment to the default value for the volume
--tolerable-read-latency
The storage volume tolerable read latency (in nanoseconds)
--tolerable-write-latency
The storage volume tolerable write latency (in nanoseconds)
--volume-group-id
The ID a volume group which represents all volumes to be updated. Required unless any of the following is specified: --internal-id, --volume-group-internal-id, --name, --volume-group-name, --id
--volume-group-internal-id
The internal ID of a volume group which represents all volumes to be updated. Required unless any of the following is specified: --internal-id, --name, --volume-group-name, --id, --volume-group-id
--volume-group-name
The name of a volume group which represents all volumes to be updated. Required unless any of the following is specified: --internal-id, --volume-group-internal-id, --name, --id, --volume-group-id
--write-bandwidth
The storage volume write bandwidth (in kb/sec)
--write-iops
The storage volume write number of IOPS
--write-latency
The storage volume write latency (in microseconds)