Chapter 1. Overview

- Introduction

Introduction

Cisco HyperFlex currently supports two command line interfaces (CLI):

- hxcli

- stcli

The Cisco HyperFlex hxcli commands are replacing stcli commands. When possible, use the hxcli commands as they perform much faster than the same stcli commands.

Intended Audience

The Cisco HyperFlex CLI are intended for use by customers and partners. When performing advanced operations, TAC assistance is recommended.

Chapter 2. hxcli Commands

hxcli Commands

HX Data Platform Command Line Interface (CLI) commands all begin with hxcli .

hxcli [-h] {about | cluster | dataprotection | datastore | disk | encryption | events | node | security | services | tasks | iscsi | vcenter | version}

Syntax Description

Option

Required or Optional

Description

iscsi

One of set required.

Commands supported in the iSCSI namespace.

Note

hxcli iscsi commands are located in this guide. For details on other hxcli commands, see the HX CLI Reference.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the hxcli command with one of the positional arguments enclosed in { } or optionally, arguments enclosed in [ ].

hxcli cluster Command

Displays the list of commands available in the cluster namespace.

hxcli cluster {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster about Command

Displays information about the server version and the product details for each node in the storage cluster.

hxcli cluster about {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster about.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster about command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster detail Command

Displays detailed configuration information for each node in the storage cluster.

hxcli cluster detail {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster detail.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster detail command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster health Command

Displays the resiliency health of the storage cluster.

hxcli cluster health {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster health.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster health command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster info Command

Displays detailed configuration, capacity, health, and disks information for each node in the storage cluster.

hxcli cluster info {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster info.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster shutdown Command

Shuts down the HyperFlex storage cluster.

hxcli cluster shutdown {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster shutdown.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster shutdown command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster start Command

Starts the HyperFlex cluster.

hxcli cluster start {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster start.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster start command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster stats Command

Displays information related to cluster space savings and capacity statistics.

hxcli cluster stats {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster stats.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster stats command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli cluster Command

Displays the list of commands available in the cluster namespace.

hxcli cluster {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for cluster.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli cluster command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection Command

Commands supported in the Data Protection namespace.

hxcli dataprotection {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection network Command

Commands supported in the Data Protection network namespace.

hxcli dataprotection network {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection network.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection network command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection network edit Command

Provides means to the edit the range of IPs and set the replication bandwidth limit for a storage cluster that has replication configured.

hxcli dataprotection network edit {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection network edit

-b, --bandwidth int

Replication incoming and outgoing bandwidth (Mbits/s). (default -1)

-s, --beginAddress string

Replication IP pool begin address.

-e, --endAddress string

Replication IP pool end address.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the stcli services asup command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection network info Command

Displays detailed information about the replication network that is configured on the storage cluster.

hxcli dataprotection network info {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection network info

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection network info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup Command

Commands supported in the Data Protection svgroup namespace.

hxcli dataprotection svgroup {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup create Command

Creates a Storage Volume Group of HX iSCSI LUNs.

hxcli dataprotection svgroup create {flags}

Alias

You can also use the alias "cr" as a shortcut to specify create.

hxcli dataprotection svgroup cr [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup create.

-d, --description string

Description of the group.

-m, --members string

Members of the group. Comma(,) separated list of HX iSCSI LUN serial numbers.

-n, --name string

Name of the group.

-q, --quiesce

Quiesce

Note

Not supported in Cisco HX Release 5.0(x) and later.

-r, --replicationIntervalInMinutes

Replication interval in minutes.

Note

Not supported in Cisco HX Release 5.0(x) and later.

-s, --snapshotRetentionCount int

Snapshot retention limit (default 32)

-t, --targetName string

Name of the target.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Note

The -r, --replicationIntervalInMinutes and -q, --quiesce keywords are not supported in this release.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup create command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup delete Command

Deletes a Storage Volume Group of HX iSCSI LUNs

hxcli dataprotection svgroup delete {flags}

Alias

You can also use the alias "del", "remove", "rm" as a shortcut to specify create.

hxcli dataprotection svgroup del [flags]

hxcli dataprotection svgroup rm [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup delete.

-g, --group-id string

ID of the group.

Command History

HX Release

Modification

5.0

Not supported in Cisco HX Release 5.0(x) and later.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup delete command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup list Command

Lists all Storage Volume Groups with detailed information about each group.

hxcli dataprotection svgroup list {flags}

Alias

You can also use the alias "ls", "li" as a shortcut to specify create.

hxcli dataprotection svgroup ls [flags]

hxcli dataprotection svgroup li [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup list.

-g, --group-id string

ID of the group

-n, --group-name string

Name of the group.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

--no header

When using the default or custom-column output format, don't print headers (default print headers).

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup snapshot Command

Commands supported in the Data Protection svgroup namespace.

hxcli dataprotection svgroup snapshot {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup snapshot.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup snapshot command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup snapshot create Command

Create a Storage Volume Group snapshot.

hxcli dataprotection svgroup snapshot create {flags}

Alias

You can also use the alias "cr" as a shortcut to specify create.

hxcli dataprotection snapshot svgroup cr [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup snapshot create.

-d, --description string

Description of the snapshot.

-g, --group-id string

ID of the group.

-q, --quiesce

Quiesce

-s, --snap-name string

Name of the snapshot.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup snapshot create command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup snapshot prepare Command

Prepare for Storage Volume Group snapshot.

hxcli dataprotection svgroup snapshot prepare {flags}

Alias

You can also use the alias "pre" as a shortcut to specify prepare.

hxcli dataprotection svgroup snapshot pre [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup snapshot prepare.

-g, --group-id string

ID of the group.

-s, --snap-name string

Name of the snapshot.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup snapshot prepare command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup snapshot delete Command

Deletes a Storage Volume Group of HX iSCSI LUNs

hxcli dataprotection svgroup snapshot delete {flags}

Alias

You can also use the alias "del", "remove", "rm" as a shortcut to specify delete.

hxcli dataprotection svgroup snapshot del [flags]

hxcli dataprotection svgroup snapshot rm [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup delete.

-g, --group-id string

ID of the group.

-s, --snap-id string

ID of the snapshot.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup snapshot delete command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup snapshot list Command

Lists Storage Volume Group snapshots.

hxcli dataprotection svgroup snapshot list {flags}

Alias

You can also use the alias "ls", "li" as a shortcut to specify list.

hxcli dataprotection svgroup snapshot ls [flags]

hxcli dataprotection svgroup snapshot li [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for list.

-g, --group-id string

ID of the group.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

-s, --snapshot-id string

ID of the snapshot.

-n, --snapshot-name string

Name of the snapshot.

--no header

When using the default or custom-column output format, don't print headers (default print headers).

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup snapshot list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli dataprotection svgroup snapshot export Command

Export a Storage Volume Group snapshot.

hxcli dataprotection svgroup snapshot export {flags}

Alias

You can also use the alias "exp" as a shortcut to specify export.

hxcli dataprotection snapshot svgroup exp [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Help for dataprotection svgroup snapshot export.

-g, --group-id string

ID of the group.

-s, --snap-id string

ID of the snapshot.

-t, --target-name string

Name of the target.

Command History

HX Release

Modification

5.0

This command was introduced in Cisco HX Release 5.0.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli dataprotection svgroup snapshot export command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore Command

Displays the list of commands available in the datastore namespace.

datastore {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore create.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore create Command

Creates a logical container used by the HX Data Platform plug-in to manage your storage use and the storage resources.

datastore create {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore create command.

-b, --block-size string

Block size. One of [4K|8K] (default "8K")

-n, --name string

New name of the datastore

-s, --size int

Size of the datastore

-u, --unit string

Unit. One of [tb|gb]

-e, --unit string

Optional

Creates an encrypted datastore if this option is provided.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore create command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore delete Command

Deletes the selected datastore.

datastore delete {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore delete command.

-i, --id string

ID of the datastore

-n, --name string

New name of the datastore

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore delete command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore edit Command

Provides means to edit the name or capacity of the selected datastore.

datastore edit {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore edit command.

-b, --block-size string

Block size. One of [4K|8K] (default "8K")

-i, --id string

ID of the datastore

-n, --name string

New name of the datastore

-s, --size int

Size of the datastore

-u, --unit string

Unit. One of [tb|gb]

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore edit command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore info Command

Displays detailed information about the name of the datastore, mount summary, status, size, and free space for the specified datastore.

datastore info {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore info command.

-i, --id string

ID of the datastore

-n, --name string

New name of the datastore

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore list Command

Lists the storage cluster datastores. Displays detailed information about the mount summary, status, size, and free space for the datastores.

datastore list {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore list command.

--no-header

When using the default or custom-column output format, do not print headers (default print headers).

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore mount Command

Mounts the specified storage cluster datastore.

datastore mount {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore mount command.

-i, --id string

ID of the datastore

-n, --name string

New name of the datastore

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore mount command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli datastore unmount Command

Unmounts the specified storage cluster datastore.

datastore unmount {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for datastore unmount command.

-i, --id string

ID of the datastore

-n, --name string

New name of the datastore

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli datastore unmount command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli disk Command

Displays the list of commands available in the disks namespace.

hxcli disk {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for disk commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli disk command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli disk list Command

Lists the storage cluster disks in the node. Displays detailed information about the name of the disk, type, status, slot, capacity and usage for the disks.

hxcli disk list {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for disk list command.

-h, --no-header

When using the default or custom-column output format, do not print headers (default print headers).

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

-s, --sort int

Sorts the list by index. Starts from 0

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli disk list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli encryption backup-keys

Performs a keys back-up to safeguard against any corruption and eventually loss of data, after successfully configuring software-encryption on the cluster.

Note

It is recommended to backup DEK after HX Software Encryption is enabled and after every Rekey. A preivously backed-up DEK cannot be restored after you perform a Rekey on your cluster.

To restore encrypted DEK configuration to the cluster when lost or corrupted from a previously saved back-up, contact TAC.

Note

After performing the backup, you need to scp/download the file from the node for storage off cluster.

hxcli encryption backup-keys {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for encryption back-up keys.

-f, --filename string

Filename path.

Note

Filename path should start with "/home/admin".

Note

It is highly recommended to save the DEK backup file to a secure location outside the HX CVM.

Command History

HX Release

Modification

5.0(1b)

This command was introduced in Cisco HX Release 5.0(1b).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli encryption backup-keys -f <path to file name> command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli encryption info

Displays configuration status of the software-encryption on the cluster.

hxcli encryption info {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for encryption info.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

5.0(1b)

This command was introduced in Cisco HX Release 5.0(1b).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli encryption info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli encryption support

Indicates whether software-encryption is supported on the cluster.

hxcli encryption supported

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for encryption info.

Command History

HX Release

Modification

5.0(1b)

This command was introduced in Cisco HX Release 5.0(1b).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli encryption supported command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli events Command

Displays the list of commands available in the events namespace.

hxcli events {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for events commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli events command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli events list Command

Displays information related to state changes resulting from user actions and system actions that occur on the HyperFlex storage cluster.

hxcli events list {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for events list command.

-t, --eventType string

Event type. One of: [cluster|node|virtualmachine|all] (default "all")

-l, --limit int

Limit of the number of events (default 10)

--no-header

When using the default or custom-column output format, don't print headers (default print headers).

-f, --offset int

Offset of the events

-r, --order string

Ascending or descending order of events. One of [ASCEND|DESCEND] (default "DESCEND")

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

-v, --severity string

Event severity. One of: [info|warning|error|critical|all] (default "all")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli events list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi Command

Displays the list of commands available in the iSCSI namespace.

hxcli iscsi [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

Note

Command line interface for iSCSI is supported only in hxcli. There is no planned support for iSCSI in stcli.

hxcli iscsi network Command

Displays detailed configuration information for your iSCSI network.

hxcli iscsi network [-h] {edit | info}

Syntax Description

Option

Required or Optional

Description

edit

Required

Provides means to edit the selected network.

delete

Required

Provides means to delete the selected network.

info

Required

Displays detailed information about the selected network.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi network command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli iscsi network info Command

- hxcli iscsi network create Command

- hxcli iscsi network edit Command

- hxcli iscsi network delete Command

hxcli iscsi network info Command

Detailed information about iscsi network configuration.

hxcli iscsi network info [-h] [--output string]

Syntax Description

Option

Required or Optional

Description

-o, --output string

Required

Output format. One of: [json|yaml|wide]. The default is wide.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi network command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi network create Command

iSCSI network configuration.

hxcli iscsi network create [-h] {--output string | --payload string |--ucs-host string | --user-name string }

Syntax Description

Option

Required or Optional

Description

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

-p, --payload string

Payload for create Network.

-n, --ucs-host string

UCS Manager Host IP or FQDN.

-u, --user-name string

User name for authentication with UCS.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi network command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi network edit Command

iSCSI network configuration.

hxcli iscsi network edit [-h] {--output string | --payload string |--ucs-host string | --user-name string }

Syntax Description

Option

Required or Optional

Description

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

-p, --payload string

Payload for create Network.

-n, --ucs-host string

UCS Manager Host IP or FQDN.

-u, --user-name string

User name for authentication with UCS.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi network command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi network delete Command

iSCSI network configuration.

hxcli iscsi network delete [-h] {--output string | --payload string |--ucs-host string | --user-name string }

Syntax Description

Option

Required or Optional

Description

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

-p, --payload string

Payload for create Network.

-n, --ucs-host string

UCS Manager Host IP or FQDN.

-u, --user-name string

User name for authentication with UCS.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi network command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi target Command

Displays the list of commands available in the iSCSI Target command.

hxcli iscsi target [flags]

Alias

You can also use the alias "tgt" or "targets" as a shortcut to specify target.

hxcli iscsi tgt [flags]

hxcli iscsi targets [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI Target commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi target command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli iscsi target info Command

- hxcli iscsi target list Command

- hxcli iscsi target create Command

- hxcli iscsi target edit Command

- hxcli iscsi target delete Command

hxcli iscsi target info Command

Displays detailed information about the name of the target, authentication method, initiator groups and LUNs.

hxcli iscsi target info [-h] {--name string | --output string | --targetUuid string }

Syntax Description

Option

Required or Optional

Description

-n, --name string

Target name

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

-t, --targetUuid string

Target ID

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi target command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi target list Command

Lists the iSCSI targets in the cluster. Displays detailed information about the name, IQN, and Auth Method for the targets.

hxcli iscsi target list [-h] { --limit int | --offset int | --order string | --output string }

Syntax Description

Option

Required or Optional

Description

-l, --limit int

Required

Limit of the number of list. The default value is 10.

-f, --offset int

Required

Offset of the list

-r, --order string

Required

Ascending or descending order of list. One of [ASCEND|DESCEND]. The defaulr value is DECEND.

-o, --output string

Required

Output format. One of: [json|yaml|wide]. The default value is wide

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi target command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi target create Command

Creates an iSCSI target.

hxcli iscsi target create [flags]

Alias

You can also use the alias "cr" as a shortcut to specify create.

hxcli iscsi target cr [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Required

Help for create.

-p, --payload string

Required

Payload for Target.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi target command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi target edit Command

Provides means to edit the name or authentication of the selected target.

hxcli iscsi target edit [-h] {--payload string | --targetUuid string}

Syntax Description

Option

Required or Optional

Description

-p, --payload string

Target payload

-t, --targetUuid string

Target ID

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi target command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi target delete Command

Deletes the selected target.

hxcli iscsi target delete [-h] {--name string | --targetUuid string}

Syntax Description

Option

Required or Optional

Description

-n, --name string

Target name

-t, --targetUuid string

Target ID

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi target command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi initiator-group Command

Displays configuration information for iSCSI Initiator Groups..

hxcli iscsi initiator-group [-h] {create | delete | edit | info | list }

Alias

You can also use the alias "ig", "igroup", or "igroups" as a shortcut to specify initiator-group.

hxcli iscsi ig [-h] {create | delete | edit | info | list }

hxcli iscsi igroup [-h] {create | delete | edit | info | list }

hxcli iscsi igroups [-h] {create | delete | edit | info | list }

Syntax Description

Option

Required or Optional

Description

create

Required

Create an iSCSI Initiator Group

delete

Required

Delete an iSCSI Initiator Group

edit

Required

Edit data for an iSCSI Initiator Group

info

Required

Displays information about a specified iSCSI Initiator Group

list

Required

Lists iSCSI Initiator Groups on a network.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi initiatior-group command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli iscsi initiator-group info Command

- hxcli iscsi initiator-group list Command

- hxcli iscsi initiator-group create Command

- hxcli iscsi initiator-group edit Command

- hxcli iscsi initiator-group delete Command

hxcli iscsi initiator-group info Command

Displays detailed information of an initiator group with name and initiator count.

hxcli iscsi initiator-group info [-h] { --initiator-group-uuid string | --name string | --output string }

Syntax Description

Option

Required or Optional

Description

-i, --initiator-group-uuid string

required/optional

ID of the Initiator group

-n, --name string

required/optional

Initiator group name

-o, --output string

required/optional

Output format.

Valid values: json, yaml, and wide. The default is wide.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi initiatior-group command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi initiator-group list Command

Lists the iSCSI initiator groups in the cluster. Displays detailed information about the name, IQN, and IPs for the initiator groups.

hxcli iscsi initiator-group list [-h] { --limit int | --offset int | --order string | --output string}

Syntax Description

Option

Required or Optional

Description

-l, --limit int

Limit of the number of list

The default value is: 10

-f, --offset int

Offset of the list.

-r, --order string

Ascending or descending order of list.

Valid Values: ASCEND, DESCEND. The default value is: DESCEND

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi initiatior-group command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi initiator-group create Command

Creates an initiator group with name and initiators.

hxcli iscsi initiator-group create [-h] {--payload string}

Syntax Description

Option

Required or Optional

Description

-p, --payload string

Required

Initiator group payload.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi initiatior-group command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi initiator-group edit Command

Provides the ability to edit the name, iqn and IPs of an initiator group.

hxcli iscsi initiator-group edit [-h] {--initiator-group-uuid string | --payload string}

Syntax Description

Option

Required or Optional

Description

-i, --initiator-group-uuid string

required/optional

ID of the Initiator group

-p, --payload string

required/optional

Payload for Initiator group

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi initiatior-group command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi initiator-group delete Command

Deletes an initiator group.

hxcli iscsi initiator-group delete [-h] { --initiator-group-uuid | --name string }

Syntax Description

Option

Required or Optional

Description

-i, --initiator-group-uuid string

ID of the Initiator group.

-n, --name string

Name for the Initiator Group

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi initiatior-group command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi allowlist Command

Displays the list of commands available in the iSCSI allowlist namespace.

hxcli iscsi allowlist [flags]

Aliases

You can also use the alias "al" as a shortcut to specify allowlist.

hxcli iscsi al [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI allowlist commands.

Command History

Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi allowlist command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli iscsi allowlist add Command

- hxcli iscsi allowlist clear Command

- hxcli iscsi allowlist remove Command

- hxcli iscsi allowlist show Command

hxcli iscsi allowlist add Command

Allows you to add IPs to iSCSI allow list.

hxcli iscsi allowlist add [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI allowlist add command.

-p, --ips stringArray

Displays the list of IPs to be allowed

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi allowlist add command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi allowlist clear Command

Allows you to clear IPs on the iSCSI allow list.

hxcli iscsi allowlist clear [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI allowlist clear command.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi allowlist clear command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi allowlist remove Command

Allows you to remove IPs to iSCSI allow list.

hxcli iscsi allowlist remove [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI allowlist remove command.

-p, --ips stringArray

Displays list of the IPs to be removed

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi allowlist remove command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi allowlist show Command

Displays list of IPs on the iSCSI allow list.

hxcli iscsi allowlist show [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for iSCSI allowlist show command.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi allowlist show command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi lun Command

Displays the configuration information for the iSCSI LUN command.

hxcli iscsi lun [-h] {clone | create | delete | edit | info | list }

Syntax Description

Option

Required or Optional

Description

clone

Required

Clones an existing iSCSI LUN.

create

Required

Creates a new iSCSI LUN.

delete

Required

Deletes an existing iSCSI LUN.

edit

Required

Provides means to edit the name or size of the selected LUN.

info

Required

Displays configuration info about an existing iSCSI LUN

list

Required

Lists iSCSI LUNs on the network.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli iscsi lun info Command

- hxcli iscsi lun list Command

- hxcli iscsi lun create Command

- hxcli iscsi lun edit Command

- hxcli iscsi lun delete Command

- hxcli iscsi lun clone Command

hxcli iscsi lun info Command

Displays detailed information about the name of the LUN, status, LUN ID, and size, available and used space for the specified LUN.

hxcli iscsi lun info [-h] { --lunUuid string | --output string | --targetUuid string }

Syntax Description

Option

Required or Optional

Description

-l, --lunUuid string

LUN uuid.

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

-t, --targetUuid string

Target uuid.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi lun list Command

Displays information about LUNS on the target.

hxcli iscsi lun list [-h] { --limit int| --offset int | --order string | --output string | --targetUuid string}

Syntax Description

Option

Required or Optional

Description

-l, --limit int

Limit of the number of list. The default is 10.

-f, --offset int

Offset of the list.

-r, --order string

Ascending or descending order of list. Valid values: ASCEND, DESCEND. The default is DESCEND.

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

-t, --targetUuid string

Target uuid.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi lun create Command

Creates an iSCSI LUN.

hxcli iscsi lun clone [-h] [--payload string | --targetUuid string]

Syntax Description

Option

Required or Optional

Description

-p, --payload string

Payload for the LUN.

-t, --targetUuid string

Defines the target UUID.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun create command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi lun edit Command

Provides means to edit the name or size of the selected LUN.

hxcli iscsi lun edit [-h] { --lunUuid string | --output string | --payload string | --targetUuid string}

Syntax Description

Option

Required or Optional

Description

-l, --lunUuid string

LUN uuid

-o, --output string

Output format.

Valid values: json, yaml, and wide. The default is wide.

-p, --payload string

Payload for create LUN.

-t, --targetUuid string

Target uuid.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi lun delete Command

Deletes the selected LUN.

hxcli iscsi lun delete [-h] {--lunUuid string | --targetUuid string}

Syntax Description

Option

Required or Optional

Description

-l, --lunUuid string

LUN uuid

-t, --targetUuid string

Target uuid

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli iscsi lun clone Command

Use this command to clone iSCSI LUNs.

hxcli iscsi lun clone [-h] [--payload | --vss-username string]

Syntax Description

Option

Required or Optional

Description

-p, --payload string

iSCSI LUNs payload.

-u, --vss-username string

Username used to authenticate with Volume Shadow copy Service.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli iscsi lun clone command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume Command

Displays the list of commands available in the volume namespace.

hxcli volume [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume info Command

Displays detailed information about the name of the datastore, namespace, capacity, target details, datastore id of the specified volume.

hxcli volume info [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume info command.

-n, --name string

Displays the Volume name.

-t, --clientid string

Displays the Client ID.

-i, --id string

Displays the Volume ID.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume list Command

Lists information about the volume including the volume id, namespace, capacity, target details, datastore id.

hxcli volume list [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume list command.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume stats Command

Displays volume capacity and space savings.

hxcli volume stats [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume stats command.

-t, --clientid string

Displays the Client ID

-i, --id string

Displays the Volume id

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command default

None.

Usage Guidelines

Accompany the hxcli volume stats command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume edit Command

Allows you to reconfigure the size of a volume.

hxcli volume edit [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume edit command.

-c, --capacity int

Displays the capacity of the datastore in Bytes.

-t, ----clientid string

Displays the Client ID.

-i, --id string

Displays the Volume ID.

-n, --name string

Displays the new name of the volume.

-s, --namespace string

Displays the namespace of the volume.

-r, --serialNo string

Displays the LUN serial number.

-t, --targetName string

Displays the Target Name.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume edit command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume delete Command

Allows you to delete the selected volume.

hxcli volume delete [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume delete command.

-t, --clientid string

Displays the Client ID.

-i, --id string

Displays the Volume ID.

-n, --name string

Displays the name of the volume.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume delete command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume allowlist Command

Allows you to grant access for the IP.

hxcli volume allowlist [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume allowlist command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume allowlist command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli volume allowlist create Command

Allows you to add IPs to allow list to grant access.

hxcli volume allowlist create [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for volume allowlist create command.

-c, --clientid string

Displays the Client ID.

-u, --payload string

Displays the Payload for granting access to IP.

-t, --task string

Allows you to ADD or REMOVE IP from the allow list. The default value is ADD.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli volume allowlist create command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli node Command

Displays the list of commands available in the node namespace.

hxcli node {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for node commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli node command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli node info Command

Displays detailed information about the specified node in the storage cluster.

hxcli node info {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for the node info command.

-i, --ip string

Node UUID

-p, --ip-address string

Hypervisor Address

-n, --name string

Node name

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli node info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli node list Command

Lists the nodes in the storage cluster. Displays detailed information about the name of the node, hypervisor address and status, controller address and status, and the model.

hxcli node list {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for the node list command.

--no-header

When using the default or custom-column output format, don't print headers (default print headers).

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli node list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli security Command

Displays the list of commands available in the security namespace.

hxcli security {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for security commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli security command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli security password Command

Displays the list of commands available in the security namespace.

hxcli security password {flags}

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for the security password command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli security password command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli security password set Command

Sets user password for all the controller VMs in the storage cluster.

hxcli security password set [-h][--user string][--user diag]

Syntax Description

Option

Required or Optional

Description

-h, --help

Optional

Displays help for the security password set command.

--user string

Optional

User name (default "root").

--user diag

Optional

Admin user account with escalated privileges designed for troubleshooting

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

5.0(2a)

This command was modified. The diag keyword was added.

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli security password set command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services Command

Displays the list of commands available in the services namespace.

hxcli services [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for services commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services asup Command

Displays the list of all ASUP commands.

hxcli services asup [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for ASUP commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services asup command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli services asup list Command

hxcli services asup list Command

Displays extended ASUP info - RecipientList (if enabled)

hxcli services asup list [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for the ASUP list command.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services asup list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services dns Command

Displays the list of commands available in the DNS namespace.

hxcli services dns [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for dns

Displays help for the services dns command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services dns command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli services dns list Command

- hxcli services dns add Command

- hxcli services dns clear Command

- hxcli services dns set Command

hxcli services dns list Command

Lists the DNS servers available in the storage cluster.

hxcli services dns list [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for list

Displays help for the services dns list command.

-o, --output string Output format. One of: [json|yaml|wide] (default "wide")

The output format. One of: [json|yaml|wide] (default "wide").

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services dns list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services dns add Command

Adds servers to the DNS server list.

Note

Use this command when the cluster is offine.

hxcli services dns add [<space seperated ip addresses>] [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for add

Displays help for the services dns add command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services dns add command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services dns clear Command

Use the command to remove one or more, or all DNS servers from the existing list of servers in the DNS server list.

Note

Use this command when the cluster is offine.

hxcli services dns clear [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for clear

Displays help for the services dns clear command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services dns clear command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services dns set Command

Deletes and replaces the existing list of servers in the DNS server list.

Note

Use this command when the cluster is offine.

hxcli services dns set [<space seperated ip addresses>] [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for set

Displays help for services dns set command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services dns set command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services ntp Command

Displays the list of commands available in the NTP namespace.

hxcli services ntp [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for ntp

Displays help for the services ntp command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services ntp command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli services ntp list Command

- hxcli services ntp add Command

- hxcli services ntp clear Command

- hxcli services ntp set Command

hxcli services ntp list Command

Lists the NTP servers available in the storage cluster.

hxcli services ntp list [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for list

required/optional

Displays help for the services ntp list command.

-o, --output string Output format. One of: [json|yaml|wide] (default "wide")

The output format. One of: [json|yaml|wide] (default "wide").

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services ntp list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services ntp add Command

Adds one or more NTP servers to the list of DNS servers.

Note

Use this command when the cluster is offine.

hxcli services ntp add [<space seperated ip addresses>] [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for add

Displays help for the services ntp add command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services ntp add command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services ntp clear Command

Use the command to remove one or more, or all NTP servers from the existing list of servers in the DNS server list.

Note

Use this command when the cluster is offine.

hxcli services ntp clear [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for clear

Displays help for the services ntp clear command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services ntp clear command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services ntp set Command

Deletes and replaces the existing list of servers in the NTP server list.

Note

Use this command when the cluster is offine.

hxcli services ntp set [<space seperated ip addresses>] [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for set

Displays help for the services ntp set command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli services ntp set command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services timezone Command

Displays the list of commands available in the TimeZone namespace.

hxcli services timezone [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for TimeZone commands.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services timezone command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- hxcli services timezone list Command

- hxcli services timezone edit Command

hxcli services timezone list Command

Displays time zone configured in the system.

hxcli services timezone list [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for the time zone list command.

-o, --output string

Output format. One of: [json|yaml|wide] (default "wide")

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services timezone list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli services timezone edit Command

Enables you to set time zone in the system.

hxcli services timezone edit[flags]

Syntax Description

Option

Required or Optional

Description

-h, --help

Displays help for the set time zone command.

-t, --timezone string

New time zone value.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

None.

Usage Guidelines

Accompany the hxcli services timezone edit command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli tasks Command

Displays the list of commands available in the task namespace.

hxcli tasks [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for tasks

Displays help for the tasks command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli tasks list command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli tasks info Command

Displays detailed information related to the tasks completed in the storage cluster.

hxcli tasks info [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for info

Displays help for the tasks info command.

-h, --help help for info

The task ID.

-h, --help help for info

The output format. One of: [json|yaml|wide] (default "wide").

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli tasks info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli tasks list Command

Displays detailed information related to the tasks completed in the storage cluster.

hxcli tasks list [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for info

Displays help for the tasks list command.

-h, --help help for info

The task ID.

-h, --help help for info

The output format. One of: [json|yaml|wide] (default "wide").

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the stcli services asup command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli tasks watch Command

View the tasks being executed in the storage cluster.

hxcli tasks watch [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for info

Displays help for the tasks watch command.

-h, --help help for info

The task ID.

-h, --help help for info

The output format. One of: [json|yaml|wide] (default "wide").

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli tasks watch command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli vcenter Command

Displays the list of commands available in the vCenter namespace.

hxcli vcenter [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for vcenter

Displays help for the vcenter command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli vcenter command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli vcenter info Command

Displays detailed information about the cluster name, vCenter URL, vCenter clustername and ID, and vCenter datacenter name and ID.

hxcli vcenter info [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for info

Displays help for the vcenter info command.

-o, --output string

The output format. One of: [json|yaml|wide] (default "wide").

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the stcli services asup command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

hxcli version Command

Displays the HX CLI version.

hxcli version [flags]

Syntax Description

Option

Required or Optional

Description

-h, --help help for version

Displays help for the version command.

Command History

HX Release

Modification

4.5(1a)

This command was introduced in Cisco HX Release 4.5(1a).

Command Default

Default (or None.)

Usage Guidelines

Example: Accompany the hxcli version command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

Chapter 3. stcli Commands

Important

The stcli commands are being deprecated. We recommend that you use the hxcli commands instead.

stcli Commands

Note

The stcli Commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX Data Platform Command Line Interface (CLI) commands all begin with stcli .

stcli [-h] {about | services | vm | dp | snapshot-schedule | cluster | appliance | node | disk | datastore | file | security | license }

Syntax Description

Option

Required or Optional

Description

about

One of set required.

About controller VM service, the storage manager, stMgr.

appliance

One of set required.

Commands supported in the storage cluster appliance namespace.

cluster

One of set required.

Commands supported in the storage cluster namespace.

datastore

One of set required.

Commands supported in the storage cluster datastore namespace.

disk

One of set required.

Commands supported in the storage cluster disk namespace.

file

One of set required.

Commands supported in the storage cluster VM file namespace.

license

One of set required.

Commands supported in the Smart License namespace.

node

One of set required.

Commands supported in the storage cluster node namespace. A storage cluster node is comprised of a hypervisor node and the storage controller. The storage cluster node uses the hypervisor ID/IP for identification.

security

One of set required.

Commands supported in the storage cluster security namespace.

services

One of set required.

Commands supported in the storage cluster system services namespace.

snapshot-schedule

One of set required.

Enables / disables snapshot schedules for all the objects in this storage cluster.

vm

One of set required.

Commands supported in the storage cluster VM namespace.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli command with one of the positional arguments enclosed in { } or optionally, arguments enclosed in [ ].

stcli about Command

Note

The stcli Commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays information about the HX controller VM's service, storage manager, stMgr. This is the service that manages the controller VM.

stcli about

Command Default

None.

Usage Guidelines

Run the stcli about command.

# stcli about

serviceType: stMgr
instanceUuid:
name: HyperFlex StorageController
locale: English (United States)
serialNumber:
apiVersion: 0.1
modelNumber: X9DRT
build: 2.0.1a-19584 (master)
displayVersion: 2.0(1a)
fullName: HyperFlex StorageController 2.0.1a
productVersion: 2.0.1a-19584

stcli -help Command

Note

The stcli Commands are being deprecated. We recommend that you use the hxcli Commands instead.

Help option on all stcli commands.

stcli [COMMAND] [-h]

Syntax Description

Option

Required or Optional

Description

-h, --help

Required

Shows the help message relative to the listed command and exits.

Command Default

None.

Usage Guidelines

Accompany the stcli command with one of the positional commands or arguments and the --help option.

stcli appliance Command

Note

The stcli Commands are being deprecated. We recommend that you use the hxcli Commands instead.

Appliance operations.

stcli appliance [-h] {list | discover}

Syntax Description

Option

Required or Optional

Description

list

One of set required.

Lists the storage cluster appliances in the storage cluster.

discover

One of set required.

Discover new storage cluster appliances in the network.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli appliance command with one of the positional arguments enclosed in { }, or optional arguments enclosed in [ ].

stcli appliance list Command

Note

The stcli Commands are being deprecated. We recommend that you use the hxcli Commands instead.

Lists the storage cluster appliances in the storage cluster.

stcli appliance list [-h]

Command Default

None.

Usage Guidelines

Run the stcli appliance list appliance command.

This example shows a truncated response:

# stcli appliance list

ps:
----------------------------------------
status: green
name: Power Supply 1 PS1 Status: Power Supply AC lost - Deassert
----------------------------------------
status: green
name: Power Supply 2: Running/Full Power-Enabled
----------------------------------------
status: green
name: Power Supply 1: Running/Full Power-Enabled
----------------------------------------
status: green
name: Power Supply 1 PS1 Status: Predictive failure - Deassert
----------------------------------------
status: green
name: Power Supply 2 PS2 Status: Failure status - Deassert
----------------------------------------
status: green
name: Power Supply 2 PS2 Status: Predictive failure - Deassert
----------------------------------------
status: green
name: Power Supply 2 PS2 Status: Power Supply AC lost - Deassert
----------------------------------------
status: green
name: Power Supply 1 PS1 Status: Failure status - Deassert
----------------------------------------

serialNumber:
disks:
EntityRef(type=10, id='5000c500642d17ad:0000000000000000', name='/dev/sde'):
status: online
serialNumber: 9XG4XS2V
capacity: 931.5G
slotNumber: 1.1.4
logicalname: /dev/sde
modelNumber: ST91000640NS
entityRef:
type: pdisk
id: 5000c500642d17ad:0000000000000000
name: /dev/sde
version: SN03
vendor: Seagate
EntityRef ...

modelNumber: X9DRT
pnics:
EntityRef(type=3, id='00000000-0000-0000-0000-002590d423b2', name='cs-002a'):
----------------------------------------
device: vmnic2
mac: 90:e2:ba:54:6d:04
pci: 0000:04:00.0
speedMb: 10000
----------------------------------------
...
----------------------------------------
EntityRef(type=3, id='00000000-0000-0000-0000-002590d42388', name='cs-002c'):
----------------------------------------
device: vmnic0
mac: 00:25:90:d4:23:88
pci: 0000:02:00.0
speedMb: 1000
----------------------------------------
...
----------------------------------------

nodes:
A:
state: online
upgradeState: ok
storfsIp:
addr: 10.104.48.24
stService: stctl
vlanId: 311
gateway: 10.104.48.1
subnetMask: 255.255.240.0
method: static
pNode:
about:
serviceType: sysmAgent
instanceUuid: d8e6ec9a564de28a:9d870ca45456c471
name:
locale: en-US
serialNumber: unset
apiVersion: 0.0.1
modelNumber: unset
build: 2.0.1-release-20569
displayVersion: 2.0(1a)
fullName: HyperFlex StorageController-2.0.1a
productVersion: 2.0.1a-20569
retired: False
compression: True
ip: 10.104.48.24
disks:
----------------------------------------
blacklistCount: 0
medium: rotational
capacity: 931.5G
state: ready
version: 0
entityRef:
type: disk
id: 5000c500642e0f8f:0000000000000000
usage: persistence
path: /dev/sdd
lastModifiedTime: 1484715441000
usedCapacity: 9.2G
----------------------------------------
...
----------------------------------------

dedup: True
nsPrimary: True
dataWriteThruEnabled: True
state: ready
bootTime: 0
master: False
entityRef:
type: pnode
id: d8e6ec9a564de28a:9d870ca45456c471
name: 10.104.48.24
version: 0
lastModifiedTime: 1484715441000
name: 10.104.48.24

host:
state: online
about:
serviceType: HostAgent
instanceUuid: 00000000-0000-0000-0000-002590d423b2
name: VMware ESXi
locale: English (United States)
serialNumber: 0123456789
apiVersion: 6.0
modelNumber: X9DRT
build: 3380124
fullName: VMware ESXi 6.0.0 build-3380124
productVersion: 6.0.0

stctlvm:
name: stCtlVM-0123456789 (2)
ip: 10.104.48.24
guestHostname:
mgmtClusterIp: 10.104.32.32
storageNetworkIp: 10.104.48.24
moid: vm-885
role: storage
entityRef:
type: virtmachine
id: vm-885
name: stCtlVM-0123456789 (2)
version: 2.1.1
passthrough: pci
guestState: running
mgmtNetworkIp: 10.104.32.28

name: cs-002a
ip:
addr: 10.104.32.21
stService: hypervisor
vlanId: 0
gateway: 10.104.32.1
subnetMask: 255.255.240.0
method: static
moid: host-879
ipmiSettings:
addr: 10.104.32.20
stService: ipmi
gateway: 10.104.32.1
subnetMask: 255.255.240.0
method: dhcp

ioVisor:
about:
serviceType: scvmclient
instanceUuid:
name: Springpath I/O Visor
locale:
serialNumber:
apiVersion:
modelNumber:
build:
fullName: Springpath I/O Visor
productVersion: 2.0.1a-20569
state: offline

bootTime: 0
entityRef:
type: node
id: 00000000-0000-0000-0000-002590d423b2
name: cs-002a
vMotionIp:
addr: 10.104.48.20
vlanId: 311
gateway: 10.104.32.1
subnetMask: 255.255.240.0
method: static
enclosureSerialNumber:

entityRef:
type: node
id: 00000000-0000-0000-0000-002590d423b2
name: cs-002a
progress:
----------------------------------------
completion: 100
parent:
type: node
id: 00000000-0000-0000-0000-002590d423b2
name: 10.104.48.24
name: Disk Prepare /dev/sdb
state: succeeded
entity:
type: disk
id: 55cd2e404b6d511e:0000000000000000
description: Ignored solid state drive /dev/sdb
----------------------------------------
...

----------------------------------------
upgradeVersion: 2.0.1a-20569
C:
state: online
upgradeState: ok
storfsIp:
addr: 10.104.48.27
stService: stctl
vlanId: 311
gateway: 10.104.48.1
subnetMask: 255.255.240.0
method: static
pNode: ...

stcli appliance discover Command

Note

The stcli Commands are being deprecated. We recommend that you use the hxcli Commands instead.

Discover new storage cluster appliances in the network. If none are found, only the time spent searching is returned.

stcli appliance discover [-h]

Command Default

None.

Usage Guidelines

Run the stcli appliance discover command.

stcli cluster Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX Data Platform storage cluster operations.

stcli cluster [-h] {prepare | create | info | diag | refresh | shutdown | start | upgrade | upgrade-status | upgrade-kernel | version | create-config | recreate | reregister | get-data-replication-factor | get-cluster-access-policy | set-cluster-access-policy | enable-data-write-thru | disable-data-write-thru | storage-summary | get-zone | set-zone}

Syntax Description

Option

Required or Optional

Description

create

One of set required.

Creates a storage cluster with the name and the given nodes identified by IP addresses.

create-config

One of set required.

Creates a storage cluster from a configuration file.

diag

One of set required.

Provides diagnostic messages about the storage cluster.

disable-data-write-thru

One of set required.

Disables data write through on the storage cluster.

enable-data-write-thru

One of set required.

Enables data write through on the storage cluster.

get-cluster-access-policy

One of set required.

Gets storage cluster Cluster Access Policy.

get-data-replication-factor

One of set required.

Gets storage cluster Data Replication Factor.

info

One of set required.

Provides information about the currently configured storage cluster.

prepare

One of set required.

Prepares network configuration for storage cluster for the set of nodes identified by IP addresses.

recreate

One of set required.

Recreates an existing storage cluster with force option.

refresh

One of set required.

Refreshes storage cluster status.

reregister

One of set required.

Reregister an existing storage cluster from one vCenter to another.

set-cluster-access-policy

One of set required.

Sets storage cluster Cluster Access Policy.

shutdown

One of set required.

Shuts down storage cluster.

start

One of set required.

Starts the storage cluster

storage-summary

One of set required.

Provides storage summary about the currently configured storage cluster.

upgrade

One of set required.

Upgrades the storage cluster

upgrade-kernel

One of set required.

Provides transitional information about storage cluster upgrade kernel.

upgrade-status

One of set required.

Provides transitional information about storage cluster upgrade status.

version

One of set required.

Provides information about storage cluster version.

get-zone

One of set required

Gets the zone details. This option is used to check if the zone is enabled.

set-zone

One of set required

Enable or disable zone(s).

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli cluster command with one of the positional arguments enclosed in { }, or optional arguments enclosed in [ ].

stcli cluster prepare Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Prepares network configuration for the storage cluster for the set of nodes identified by IP addresses.

Note

The stcli cluster prepare command is only supported when the cluster is not yet deployed. Use the automated workflow for a running cluster.

Note

This is an advanced command. Do not use without TAC assistance.

stcli cluster prepare [-h] {--node-ips NODEIPS [NODEIPS . . .] | --config CONFIG} [--hypervisor-ips HYPERVISORIPS [HYPERVISORIPS . . .]] [--storefs-ips STORFSIPS [STORFSIPS . . .]] [--ipmi-ips IPMIIPS [IPMIIPS . . .]] [--vmotion-ips VMOTIONIPS [VMOTIONIPS . . .]] [--netmask NETMASK] [--gateway GATEWAY] [--vlan VLAN] [--netmask1 NETMASK1] [--gateway1 GATEWAY1] [--vlan1 VLAN1] [--dns DNS [DNS . . .]] [--ntp NTP [NTP . . .]] [--timezone TIMEZONE] [--smtp STMPSERVER] [--fromaddress FROMADDRESS] [--dryrun]

Syntax Description

Option

Required or Optional

Description

--config CONFIG

Require one from set.

Network configuration file.

--node-ips NODEIPS [NODEIPS . . .]

Require one from set.

IPs of storage cluster nodes to add to configuration. Separate multiple IPS with a space.

--dns DNS [DNS . . .]

Optional.

IPs of DNS server. Separate multiple IPS with a space.

--dryrun

Optional.

Only validate input parameters.

--fromaddress FROMADDRESS

Optional.

Address to send Auto Support emails from.

--gateway GATEWAY

Optional.

Default gateway.

--gateway1 GATEWAY1

Optional.

Default gateway1.

--hypervisor-ips HYPERVISORIPS [HYPERVISORIPS . . .]

Optional.

IPs of hypervisor to be applied. Separate multiple IPS with a space.

--ipmi-ips IPMIIPS [IPMIIPS . . .]

Optional.

IPs of IPMI to be applied. Separate multiple IPS with a space.

--netmask NETMASK

Optional.

Subnet mask.

--netmask1 NETMASK1

Optional.

Subnet mask1.

--ntp NTP [NTP . . .]

Optional.

IPs of NTP servers. Separate multiple server IDs with a space.

--smtp SMTPSERVER

Optional.

SMTP server.

--storefs-ips STORFSIPS [STORFSIPS . . .]

Optional.

IPs of storage cluster to be applied. Separate multiple IPS with a space.

--timezone TIMEZONE

Optional.

Timezone.

--vlan VLAN

Optional.

VLAN tag.

--vlan1 VLAN1

Optional.

VLAN tag1.

--vmotion-ips VMOTIONIPS [VMOTIONIPS . . .]

Optional.

IPs of vMotion to be applied. Separate multiple IPS with a space.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli cluster prepare command with one of the positional arguments enclosed in { } and optionally arguments enclosed in [ ].

Note

Do not use this command without TAC assistance.

stcli cluster create Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a storage cluster with the name and the given nodes identified by IP addresses.

Important

Please enter password when prompted.

stcli cluster create [-h] --name NAME --ip IP --mgmt-ip MGMTIP [--vcenter-datacenter DATACENTER] [--vcenter-cluster VCENTERCLUSTER] [--vcenter-url VCENTERURL] [--vcenter-sso-url VCENTERSSOURL] [--vcenter-user VCENTERUSER] --node-ips NODEIPS [NODEIPS . . .] [--data-zk-ip DATAZKIP] --data-replication-factor {2 | 3} [--cluster-access-policy {strict | lenient}] [--zone { 0 | 1}] [--vdi-only-deployment] [--clusterType {0,1,2}] [-f] [--dryrun] [--esx-username ESXUSERNAME] [--deploymentMode {0,1}] [--managedBy {0,1}]

Syntax Description

Option

Required or Optional

Description

--ip IP

Required

IP address of storage cluster node. The IP is listed in the stcli cluster info command.

--mgmt-ip MGMTIP

Required

IP of storage cluster management server.

--name NAME

Required

Name of storage cluster.

--node-ips NODEIPS [NODEIPS . . .]

Required

IPs of all converged nodes to add to storage cluster.

--vcenter-user VCENTERUSER

Optional

User name of vCenter administrator.

Enter vCenter administrator password when prompted.

--cluster-access-policy {strict, lenient}

Optional. Default lenient

Cluster Access Policy (strict or lenient).

[--data-zk-ip DATAZKIP]

Optional

IP of Data ZK server

--data-replication-factor {2, 3}

Optional. Default 3

Data Replication Factor (2 or 3). This can only be set during initial storage cluster creation.

--dryrun

Optional

Only validate input parameters.

--esx-username ESXUSERNAME

Optional

User name of ESX administrator.

Enter ESX administrator password when prompted.

-f, --force

Optional

Force create storage cluster. This ignores network configuration errors and creates the cluster with provided information.

--vcenter-cluster VCENTERCLUSTER

Optional

Name of vCenter cluster.

--vcenter-sso-url VCENTERSSOURL

Optional

URL of vCenter SSO server. This is inferred from --vcenter-url, if not specified.

--vcenter-url VCENTERURL

Optional

URL of vCenter, <vcentername>. Where <vcentername> can be FQDN or IP.

--vdi-only-deployment

Optional. Default is VSI.

Set Workload Type as VDI.

--clusterType {0,1,2}

Optional

0: Default cluster, 1: Stretch cluster, 2: Two Node Edge Cluster

-zone {0,1}

Optional

Enable (1) or Disable (0) zones.

--deploymentMode {0,1}

Optional

0: EDGE, 1: FI

--managedBy {0,1}

Optional

0: HX CONNECT, 1: INTERSIGHT

Controller VM root user password

Optional

All nodes must have the same password.

Enter controller VM password when prompted.

Command Default

None. See table for list of required and optional parameters.

Usage Guidelines

Accompany the stcli cluster create command with appropriate positional arguments.

stcli cluster info Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays detailed information about the storage cluster and each node in the storage cluster.

stcli cluster info [-h] --summary

Syntax Description

Option

Required or Optional

Description

--summary

Optional.

Return summary of information only.

Command Default

Returns full cluster information.

Usage Guidelines

Accompany the stcli cluster info command with the optional positional argument enclosed in [ ] to return a summary of the cluster information.

Note

When vCenter or stMgr is down, the error message from stcli data protection operations may not be self-explanatory. Please validate that the vCenter connection is good and that the “stcli cluster info” command returns cluster healthy status before running stcli data protection operations.

# stcli cluster info

about:
serviceType: stMgr
instanceUuid: 345258cf-12d4-4d71-ba9e-b91e47d15e49
name: HyperFlex StorageController
locale: English (United States)
serialNumber:
apiVersion: 0.1
modelNumber: X9DRT
build: 2.0.1a-20569 (internal)
displayVersion: 2.0(1a)
fullName:  HyperFlex StorageController 2.0.1a
productVersion: 2.0.1a-20569

vCluster:
state: online
boottime: 0
entityRef:
type: virtcluster
id: domain-c876
name: cs002-cl
virtNodes:
----------------------------------------
type: virtnode
id: 00000000-0000-0000-0000-002590d423a4
----------------------------------------
type: virtnode
id: 00000000-0000-0000-0000-002590d42388
----------------------------------------
type: virtnode
id: 00000000-0000-0000-0000-002590d423b2
----------------------------------------
virtDatastores:

upgradeState: ok
upgradeVersion: 2.0.1a-20569
cluster:
allFlash: False
healthState: healthy
capacity: 5.0T
state: online
compliance: 1
resiliencyInfo:
nodeFailuresTolerable: 1
state: 1
messages:
Storage cluster is healthy.
cachingDeviceFailuresTolerable: 1
persistentDeviceFailuresTolerable: 1

activeNodes: 3
uptime: 18:53:15
boottime: 1484703014
entityRef:
type: cluster
id: 345258cf12d44d71:456146e1b82ea1b7
downtime: 0:00:00
healingInfo:
inProgress: False
freeCapacity: 5.0T
usedCapacity: 55.0G
config:
clusterUuid: 345258cf12d44d71:456146e1b82ea1b7
ip: 10.104.48.28
dataReplicationFactor: 2
clusterAccessPolicy: lenient
size: 3

nodes:
----------------------------------------
type: pnode
id: bf7a0223564d0db8:88974e15886ab3e0
name: 10.104.48.27
----------------------------------------
type: pnode
id: d1b5bc18564da19b:bc1e977ebd9aafec
name: 10.104.48.26
----------------------------------------
type: pnode
id: d8e6ec9a564de28a:9d870ca45456c471
name: 10.104.48.24
----------------------------------------
rawCapacity: 10.0T
state: online

stNodes:
----------------------------------------
type: node
id: 00000000-0000-0000-0000-002590d423b2
name: cs-002a
----------------------------------------
type: node
id: 00000000-0000-0000-0000-002590d42388
name: cs-002c
----------------------------------------
type: node
id: 00000000-0000-0000-0000-002590d423a4
name: cs-002d
----------------------------------------

entityRef:
type: cluster
id: 3770173484459904369:4999354996629610935
name: cs002-cl
config:
clusterUuid: 3770173484459904369:4999354996629610935
name: cs002-cl
mgmtIp:
addr: 10.104.32.32
method: dhcp
vCenterDatacenter: cs002-dc
ip:
addr: 10.104.48.28
method: dhcp
vCenterClusterName: cs002-cl
dataReplicationFactor: 2
workloadType: 2
vCenterClusterId: domain-c876
nodeIPSettings:
cs-002d:
cs-002c:
cs-002a:
vCenterDatacenterId: datacenter-871
clusterAccessPolicy: lenient
vCenterURL: cs-vc6
dnsServers:
size: 3

stcli cluster diag Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Provides diagnostic messages about the cluster.

stcli cluster diag [-h] [--id ID | --ip NAME] [--type TYPE]

Syntax Description

Option

Required or Optional

Description

--id ID

Optional.

ID of storage cluster node. The ID is listed in the stcli cluster info command.

--ip NAME

Optional.

IP address of storage cluster node. The IP is listed in the stcli cluster info command.

--type TYPE

Optional.

Type of storage cluster node. Options are: converged or compute

Command Default

If no node is specified, default applies to all nodes in the storage cluster.

Usage Guidelines

Accompany the stcli cluster diag command with optionally, arguments enclosed in [ ].

stcli cluster refresh Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Refreshes storage cluster status.

stcli cluster refresh [-h]

Command Default

Returns refreshed cluster status.

Usage Guidelines

Run the stcli cluster refresh command to manually refresh the cluster status.

stcli cluster shutdown Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Stops storage cluster operations and shuts it down.

stcli cluster shutdown [-h] [--formatchange]

Syntax Description

Option

Required or Optional

Description

--formatchange

Optional.

Enable disk format change after cluster shutdown.

Command Default

None.

Usage Guidelines

Run the stcli cluster shutdown command with optionally arguments enclosed in [ ].

stcli cluster start Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Starts the storage cluster.

stcli cluster start [-h]

Command Default

None.

Usage Guidelines

The stcli cluster start command does not have any additional options.

stcli cluster upgrade Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Upgrades HX Data Platform software to the latest version.

Important

Enter password when prompted.

stcli cluster upgrade [-h] [--status] [--info] [--components COMPONENTS {hxdp | ucs-fw}] [--location LOCATION] [--hypervisor-bundle HYPERVISOR-BUNDLE] [--vcenter-user VCENTERUSER] [--checksum CHECKSUM] [--ucsm-host UCSMHOST] [--ucsm-user UCSMUSER] [--ucsfw-version UCSFR-VERSION] [--ucsm5-fw-version UCSM5-FW-VERSION] [--dryrun]

Syntax Description

Option

Required or Optional

Description

--checksum CHECKSUM

Optional

Checksum of the installer.

--components COMPONENTS

Required

Comma separated upgrade components {hxdp, ucs-fw, mgmt-only, hypervisor}

--dryrun

Optional

Validate cluster upgrade can be possible.

--info

Optional

Check for upgrade information.

--location LOCATION

Optional

Location of the upgrade package. Best case use /tmp on the controller VM.

- Download the upgrade package to your computer.

- Upload it (using scp or a similar tool) to the controller VM of the appliance on which you run the upgrade command.

--hypervisor-bundle HYPERVISOR-BUNDLE

Optional

Location of the ESXi offline bundle. Best case use /tmp on the controller VM.

- Download the upgrade package to your computer.

- Upload it (using scp or a similar tool) to the controller VM of the appliance on which you run the upgrade command.

--status

Optional

Check for upgrade status.

--ucsfw-version UCSFW-VERSION

Optional

UCS Server Firmware target version.

--ucsm5-fw-version UCSM5-FW-VERSION

Optional

UCS Server Firmware target version for M5 servers.

--ucsm6-fw-version UCSM6-FW-VERSION

Optional

UCS Server Firmware target version for M6 servers.

--ucsm-host UCSMHOST

Optional

Hostname or IP of UCS Manager server.

--ucsm-user UCSMUSER

Conditionally required

User name of UCS Manager server.

Required only if upgrading the UCS Manager component.

--vcenter-user VCENTERUSER

Conditionally required

User name of vCenter administrator. Required only if upgrading the vCenter component.

Enter vCenter administrator password when prompted.

--vcenter-password VCENTERPWD

Conditionally required

Password for vCenter server.

Required only if upgrading the vCenter component.

Command Default

Assumes settings of existing storage cluster if additional options are not provided.

Usage Guidelines

Accompany the stcli cluster upgrade command with one or more of the optional arguments enclosed enclosed in [ ].

See the Cisco HyperFlex Systems Upgrade Guide.

stcli cluster upgrade-status Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays the last known upgrade status of the HX Data Platform software. If the upgrade is in progress, transitional status is listed. Once the upgrade is complete, the status lists the most recent upgrade. This also lists if an upgrade is available or you are due for an upgrade.

stcli cluster upgrade-status [-h]

Command Default

No available options.

Usage Guidelines

Accompany the stcli cluster upgrade-status command.

This example shows :

# stcli cluster upgrade-status

Nodes up to date: [cs-002a(10.104.32.21), cs-002c(10.104.32.25), cs-002d(10.104.32.27)]
Cluster upgrade succeeded.

stcli cluster upgrade-kernel Command

Note

This command is not supported. .

stcli cluster version Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays the version number of each node in the storage cluster.

stcli cluster version [-h]

Command Default

No options available.

Usage Guidelines

Run the stcli cluster version command.

This example shows :

# stcli cluster version

Cluster version: 2.0(1a)
Node cs-002c version: 2.0(1a)
Node cs-002a version: 2.0(1a)
Node cs-002d version: 2.0(1a)

stcli cluster create-config Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a storage cluster from a configuration file.

Important

Please enter password when prompted.

stcli cluster create-config [-h] [-f] [--dryrun] --vcenter-user VCENTERUSER [--esx-username ESXUSERNAME] config

Syntax Description

Option

Required or Optional

Description

config

Required

Configuration storage cluster file.

--dryrun

Optional

Only validate input parameters.

--esx-username ESXUSERNAME

Optional

User name of ESX administrator.

Enter ESX administrator password when prompted.

-f, --force

Optional

Force create storage cluster. This ignores network configuration errors and creates the cluster with provided information.

--vcenter-user VCENTERUSER

Optional

User name of vCenter administrator.

Enter vCenter administrator password when prompted.

Controller VM root user password

Optional

All nodes must have the same password.

Enter controller VM password when prompted.

Command Default

None. See table for list of required and optional parameters.

Usage Guidelines

Accompany the stcli cluster create-config command with the appropriate positional arguments.

See the Cisco HyperFlex Systems Installation Guide for VMware ESXi for requirements.

stcli cluster recreate Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Recreates an existing storage cluster with force option.

Important

When prompted, type and enter the password.

stcli cluster recreate [-h] --vcenter-user VCENTERUSER

Syntax Description

Option

Required or Optional

Description

--vcenter-user VCENTERUSER

Required

User name of vCenter administrator.

Enter vCenter administrator password when prompted.

Controller VM root user password

Optional

All nodes must have the same password.

Enter controller VM password when prompted.

Command Default

None.

Usage Guidelines

Accompany the stcli cluster recreate command with the positional argument and optionally arguments enclosed in [ ].

stcli cluster reregister Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Caution

The re-registration process should be performed exclusively via Cisco HyperFlex Connect. For more information, see Re-registering Hyperflex Cluster to a New vCenter via HX Connect in 4.5+ Releases. Using the stcli reregister command causes the password scanning process to fail.

Shift registration of an existing storage cluster from one vCenter to another.

Note

- vCenter must be up and running to complete this command.

- When prompted, type and enter the password.

stcli cluster reregister [-h] --vcenter-datacenter NEWDATACENTER --vcenter-cluster NEWVCENTERCLUSTER --vcenter-url NEWVCENTERURLIP [--vcenter-sso-url NEWVCENTERSSOURL] --vcenter-user NEWVCENTERUSER

Syntax Description

Option

Required or Optional

Description

--vcenter-cluster NEWVCENTERCLUSTER

Required

Name of the new vCenter cluster.

--vcenter-datacenter NEWDATACENTER

Required

Name of the new vCenter datacenter.

--vcenter-sso-url NEWVCENTERSSOURL

Optional

URL of the new vCenter SSO server. This is inferred from --vcenter-url, if not specified.

--vcenter-url NEWVCENTERURLIP

Required

URL of the new vCenter, <vcentername>. Where <vcentername> can be IP or FQDN of new vCenter.

--vcenter-user NEWVCENTERUSER

Required

User name of the new vCenter administrator.

Enter vCenter administrator password when prompted.

Command Default

None.

Usage Guidelines

Accompany the stcli cluster reregister command with the required arguments and optional arguments enclosed in [ ], as needed.

Use when moving a storage cluster from one vCenter server to another vCenter server. Task includes moving the storage cluster, registering the storage cluster with the new vCenter, and unregistering the storage cluster from the old vCenter. See the Cisco HyperFlex Data Platform Administration Guide.

stcli cluster get-data-replication-factor Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Gets storage cluster Data Replication Factor.

stcli cluster get-data-replication-factor [-h]

Command Default

Returns cluster setting.

Usage Guidelines

Run the stcli cluster get-data-replication-factor command.

# stcli cluster get-data-replication-factor

3

stcli cluster get-cluster-access-policy Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Gets storage cluster Cluster Access Policy.

stcli cluster get-cluster-access-policy [-h]

Command Default

Return cluster setting.

Usage Guidelines

Enter the stcli cluster get-cluster-access-policy command.

# stcli cluster get-cluster-access-policy

lenient

stcli cluster set-cluster-access-policy Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Sets storage cluster Cluster Access Policy.

stcli cluster set-cluster-access-policy [-h] --name {strict | lenient}

Syntax Description

Option

Required or Optional

Description

--name {strict, lenient}

Required.

Select the storage cluster Cluster Access Policy.

- Strict - Applies policies to protect against data loss.

- Lenient - Applies policies to support longer storage cluster availability.

Command Default

No default using the stcli cluster set-cluster-access-policy command line. Using the HX Data Platform Installer, the default is lenient.

Usage Guidelines

Used to change the setting applied during storage cluster creation. Accompany the stcli cluster set-cluster-access-policy command with one of the positional arguments enclosed in { }.

This example shows setting the cluster Access Policy to strict. The command returns the applied setting.

# stcli cluster set-cluster-access-policy --name strict

strict

stcli cluster enable-data-write-thru Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Enable data write through on the storage cluster.

stcli cluster enable-data-write-thru [-h] [--id ID | --ip NAME]

Syntax Description

Option

Required or Optional

Description

--id ID

Optional.

ID of storage cluster node. The ID is listed in the stcli cluster info command.

--ip NAME

Optional.

IP address of storage cluster node. The IP is listed in the stcli cluster info command.

Command Default

If no node is specified, default applies to all nodes in the storage cluster.

Usage Guidelines

Accompany the stcli cluster enable-data-write-thru command with optionally positional arguments enclosed in [ ].

stcli cluster disable-data-write-thru Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Disable data write through on the storage cluster.

stcli cluster disable-data-write-thru [-h] [--id ID | --ip NAME]

Syntax Description

Option

Required or Optional

Description

--id ID

Optional.

ID of storage cluster node. The ID is listed in the stcli cluster info command.

--ip NAME

Optional.

IP address of storage cluster node. The IP is listed in the stcli cluster info command.

Command Default

If no node is specified, default applies to all nodes in the storage cluster.

Usage Guidelines

Accompany the stcli cluster disable-data-write-thru command with optionally positional arguments enclosed in [ ].

stcli cluster storage-summary Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Provides storage summary about the currently configured the storage cluster.

stcli cluster storage-summary [-h] [--uncached]

Syntax Description

Option

Required or Optional

Description

--uncached

Optional.

Provides storage summary about the currently configured storage cluster.

Command Default

No additional options available.

Usage Guidelines

Run stcli cluster storage-summary --uncached command to display the result.

# stcli cluster storage-summary --uncached

admin:~$ stcli cluster storage-summary --uncached
address: 10.104.17.158
name: ucs305_12_cl
state: online
uptime: 6 days 0 hours 39 minutes 16 seconds
activeNodes: 4 of 5
compressionSavings: 81.16%
deduplicationSavings: 0.0%
freeCapacity: 8.3T
healingInfo:
messages:
Auto healing in progress, 53% completed.
inProgress: True
percentComplete: 53
estimatedCompletionTimeInSeconds: 24
resiliencyInfo:
messages:
Storage cluster is unhealthy.
state: 2
nodeFailuresTolerable: 1
cachingDeviceFailuresTolerable: 2
persistentDeviceFailuresTolerable: 1
zoneResInfoList: None
spaceStatus: normal
totalCapacity: 8.4T
totalSavings: 81.16%
usedCapacity: 82.3G
zkHealth: online
clusterAccessPolicy: lenient
dataReplicationCompliance: non_compliant
dataReplicationFactor: 3

stcli cluster get-zone Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Gets the zone details. This option is used to check if the zone is enabled.

stcli cluster get-zone

Command Default

No user input is required.

Usage Guidelines

The stcli cluster get-zone command does not have any additional options.

stcli cluster set-zone Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Enable or disable zone(s).

stcli cluster set-zone < --zone option_arg {1:enable, 0:disable}> [--numzones option_arg]

Command Default

If the option < --numzones> is not specified, storfs will automatically decide on the number of zones to be configured based on the active number of nodes in the cluster at the point of invocation.

Usage Guidelines

Accompany the stcli cluster set-zone command with the zone option to enable or disable zone(s).

stcli cluster set-zone --zone 0 (to disable a zone)

stcli cluster set-zone --zone 1 (to enable and create default number of zones)

stcli cluster set-zone --zone 1 –numzones <integer-value> (to enable zones and create a specific number of zones)

Warning

Support for the stcli rebalance command is limited to Cisco Tech support only. General use is not supported.

stcli datastore Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Operations for storage cluster datastores.

stcli datastore [-h] {list | create | info | update | delete | mount | unmount}

Syntax Description

Option

Required or Optional

Description

create

One of set required.

Creates a storage cluster datastore with the name and size.

delete

One of set required.

Deletes a storage cluster datastore.

info

One of set required.

Provides information about the specified storage cluster datastore.

list

One of set required.

Lists the storage cluster datastores.

mount

One of set required.

Mounts a storage cluster datastore.

unmount

One of set required.

Unmounts a storage cluster datastore.

update

One of set required.

Updates a storage cluster datastore's name and/or size.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli datastore command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli datastore list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Lists the storage cluster datastores.

stcli datastore list [-h]

Command Default

No available options.

Usage Guidelines

Run the stcli datastore list command or add the optional argument enclosed in [ ].

stcli datastore create Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a storage cluster datastore with the provided name and size.

stcli datastore create [-h] --name NAME --size SIZE [--unit {kb | mb | gb | tb}] [--blocksize {8k,4k}]

Syntax Description

Option

Required or Optional

Description

--blocksize

Optional.

Block size for stored data. Default 8K for all datastores. In VDI workloads, 4K is default.

--name NAME

Required.

Name of storage cluster datastore.

--size SIZE

Required.

Size of storage cluster datastore.

--unit {kb,mb,gb,tb}

Optional.

Unit for size. Default GB.

Command Default

ID or NAME must be specified. Default unit of measure is GB. Default blocksize is 8K.

Usage Guidelines

Accompany the stcli datastore create command with both of the required parameters, and the optional parameter, if needed.

stcli datastore info Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Provides information about the specified storage cluster datastore.

stcli datastore info [-h] {--id ID | --name NAME}

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of datastore.

--name NAME

One of set required.

Name of datastore.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli datastore info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli datastore update Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Updates a storage cluster datastore's name and/or size.

stcli datastore update [-h] {--id ID | --name NAME} [--newname NEWNAME] [--size SIZE] [--unit {kb | mb | gb | tb}]

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of datastore.

--name NAME

One of set required.

Name of datastore.

--name NAME

Optional.

New name of storage cluster datastore.

--size SIZE

Optional.

New size of storage cluster datastore.

--unit {kb,mb,gb,tb}

Optional.

Unit for size. Default GB.

Command Default

None. One option from the set is required. Default unit is GB.

Usage Guidelines

Accompany the stcli datastore update command with the required parameters, and any of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli datastore delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Deletes a storage cluster datastore.

stcli datastore delete [-h] {--id ID | --name NAME}

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of datastore.

--name NAME

One of set required.

Name of the datastore.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli datastore delete command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli datastore mount Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Mounts a storage cluster datastore.

stcli datastore [-h] {--id ID | --name NAME}

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of datastore.

--name NAME

One of set required.

Name of datastore.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli datastore mount command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli datastore unmount Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Unmounts a storage cluster datastore.

stcli datastore unmount [-h] {--id ID | --name NAME}

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of datastore.

--name NAME

One of set required.

Name of datastore.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli datastore unmount command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli disk Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Operations on the storage cluster disks.

stcli disk [-h] {list | add}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Adds discovered new disks and specified blacklisted disks to the storage cluster.

list

One of set required.

Lists the storage cluster disks in the node.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli disk command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli disk list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Lists the storage cluster disks in the node.

stcli disk list [-h] {--id ID | --name NAME} [--rescan]

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of storage cluster node. The ID is listed in the stcli cluster info command. local defaults to the local node.

--ip NAME

One of set required.

IP address of storage cluster node. The IP is listed in the stcli cluster info command. localhost defaults to the local node.

--rescan

Optional.

Rescan disks.

Command Default

None. One option from the set is required. Defaults for the options are: local for ID and localhost for NAME.

Usage Guidelines

Accompany the stcli disk list command with one of the positional arguments or optional arguments enclosed in [ ].

Note

Sometimes when a disk is removed, it continues to be listed in cluster summary information. To refresh this, restart the HX cluster.

stcli disk add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Adds discovered new disks and specified blacklisted disks to the storage cluster.

stcli disk add [-h] {--id ID | --name NAME} --blacklisted-disk-ids [DISKIDS [DISKIDS . . .]]

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

ID of storage cluster node.

--name NAME

One of set required.

Name of storage cluster node.

--blacklisted-disk-ids [DISKIDS [DISKIDS . . .]]

Required.

Blacklisted disks to add to storage cluster. Separate multiple IDs with a space.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli disk add command with one of the positional arguments enclosed in { } plus required --blacklisted-disk-ids option, or optional arguments enclosed in [ ].

stcli dp Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Data protection (DP) commands for replication and disaster recovery.

stcli dp [-h] (vm | group | peer | schedule)

Syntax Description

Option

Required or Optional

Description

group

One of set required.

Data protection group snapshot operations.

peer

One of set required.

Site replication pairing operations.

schedule

One of set required.

Pause and resume replication, cluster wide for the sending cluster.

vm

One of set required.

VM data protection with replication snapshot operations.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp vm Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX Data Platform disaster recovery and native replication commands applied to virtual machines individually and not through the protection group.

stcli dp vm [-h] {snapshot | add | list | info | delete | movein | moveout | schedule | prepareReverseProtect | reverseProtect | failover | testfailover | prepareFailover | migrate | hxtask}

Syntax Description

Option

Required or Optional

Description

snapshot

Unsupported

Beginning with HX Release 3.5(2g), the support for snapshot command was limited to Cisco Technical support only. General use is not supported.

add

One of set required.

Add data protection to a virtual machine.

list

One of set required.

List virtual machines under data protection.

info

One of set required.

Display information about virtual machines under data protection.

delete

One of set required.

Delete data protection from a virtual machine.

movein

One of set required.

Move in data protection virtual machines to a protection group.

moveout

One of set required.

Move out data protection virtual machines from a protection group.

schedule

One of set required.

Schedule data protection for a virtual machine.

prepareReverseProtect

One of set required.

Prepare reverse protection actions for the given virtual machine.

reverseProtect

One of set required.

Perform reverse protection actions for the given virtual machine.

failover

One of set required.

Failover the individual virtual machines from the recovery HX Storage Cluster.

testfailover

One of set required.

Test recovery of individual virtual machines from the recovery HX Storage Cluster.

prepareFailover

One of set required.

Prepare failover action for the given virtual machine.

migrate

One of set required.

Migrate the given virtual machine.

hxtask

One of set required.

Data protection related operations.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp vm command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

- stcli dp vm snapshot Commands

- stcli dp vm add Command

- stcli dp vm list Command

- stcli dp vm info Command

- stcli dp vm delete Command

- stcli dp vm movein Command

- stcli dp vm moveout Command

- stcli dp vm schedule Commands

- stcli dp vm prepareReverseProtect Command

- stcli dp vm failover Command

- stcli dp vm testfailover Command

- stcli dp vm prepareFailover Command

- stcli dp vm migrate Command

- stcli dp vm hxtask Command

stcli dp vm snapshot Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Data protection virtual machine replication snapshot operations.

Note

This command and its subcommands are not supported.

stcli dp vm snapshot [-h] {create | replicate | list | info | delete}

Syntax Description

Option

Required or Optional

Description

create

One of set required.

Creates a replication snapshot for a virtual machine.

replicate

One of set required.

Replicates a replication snapshot for a virtual machine.

list

One of set required.

List replication snapshots available on this cluster.

info

One of set required.

Show info for a replication snapshot.

delete

One of set required.

Delete the specified replication snapshot.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp vm snapshot command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

- stcli dp vm snapshot create Command

- stcli dp vm snapshot replicate Command

- stcli dp vm snapshot list Command

- stcli dp vm snapshot info Command

- stcli dp vm snapshot delete Command

stcli dp vm snapshot create Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a replication snapshot for a virtual machine.

stcli dp vm snapshot create [-h] --vmid VMID [--vmidtype {VMBIOSUUID}] --snapname SNAPSHOTNAME [--desc DESCRIPTION] [--quiesce] [--offline]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

--snapname SNAPSHOTNAME

Required.

Name of the replication snapshot.

--desc DESCRIPTION

Optional.

Description of the replication snapshot.

--quiesce

Optional.

Whether to use VMware Tools to quiesce the VMs before replication. VMware Tools must be installed in all the VMs in the replication group.

--Offline

Optional

Take offline snapshot.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm snapshot create command with the required arguments with leading two dashes (--), one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp vm snapshot replicate Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Replicates a snapshot of a virtual machine to a remote cluster.

stcli dp vm snapshot replicate [-h] --vmid VMID [--vmidtype {VMBIOSUUID}] --snapshot-id SNAPSHOT-ID --outgoing OUTGOING

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

--snapshot-id SNAPSHOTID

Required.

Snapshot ID of the VM to replicate.

--outgoing OUTGOING

Required.

ID of the outgoing/target cluster where data is replicated to.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm snapshot replicate command with the required arguments with leading two dashes (--), one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp vm snapshot list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List replication snapshots available on this cluster.

stcli dp vm snapshot list [-h] --vmid VMID [--vmidtype {VMBIOSUUID}]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm snapshot list command with the required arguments with leading two dashes (--), one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp vm snapshot info Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Show details of the VM snapshot.

stcli dp vm snapshot info [-h] --vmid VMID [--vmidtype {VMBIOSUUID}] --snapshot-id SNAPSHOTID

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

--snapshot-id SNAPSHOTID

Required.

Snapshot ID of the VM.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm snapshot info command with the required arguments with leading two dashes (--), one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp vm snapshot delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Delete the specified snapshot.

stcli dp vm snapshot delete [-h] --vmid VMID [--vmidtype {VMBIOSUUID}] --snapshot-id SNAPSHOTID

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

--snapshot-id SNAPSHOTID

Required.

Snapshot ID of the VM to be deleted.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm snapshot delete command with the required arguments with leading two dashes (--), one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp vm add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Add data protection on a virtual machine.

Command syntax for Cisco HyperFlex Release 5.0(2a) and earlier.

stcli dp vm add [-h] --vmid VMID [--vmidtype {VMBIOSUUID}]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). For vCenter, specify the unique VMBIOSUUID of the virtual machine.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

ID ype of the virtual machine (vmbiosuuid). For vCenter, specify the unique virtual machine VMBIOSUUID.

Command Default

None.

Usage Guidelines

This command is only supported in Cisco HyperFlex Release 5.0(2a) and earlier.

Accompany the stcli dp vm add command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List virtual machines with data protection. Display includes replication schedule.

stcli dp vm list [-h] [--vmname VMNAME] [--vmid VMID] [--brief]

Syntax Description

Option

Required or Optional

Description

--vmname VMNAME

Optional.

Lists the protected virtual machine that matches the specified name.

--vmid VMID

Optional.

Run command on the virtual machine that matches the specified internal original VM ID used to track the VM through its entire life cycle (also referred to as the BIOS UUID).

--brief

Optional.

Display brief summary only.

Command Default

Default lists all protected virtual machines.

Usage Guidelines

Accompany the stcli dp vm list command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

This example shows a summary list of protected virtual machines.

# stcli dp vm list --brief

vmInfo:
----------------------------------------
name: dslvm-2
uuid: 423f11c4-20c9-893b-0dd8-2a0ad59ad634
----------------------------------------
name: dslvm-1
uuid: 423f1d85-990a-4e06-ebef-a215c0ec4cf8
----------------------------------------

stcli dp vm info Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List the data protection virtual machine information.

stcli dp vm info [-h] --vmid VMID [--vmidtype {VMBIOSUUID}]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). For vCenter, specify the unique virtual machine VMBIOSUUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

ID type of the virtual machine (vcmoid, vmbiosuuid). For vCenter, specify the unique virtual machine VMBIOSUUID.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm info command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Delete data protection from a virtual machine.

stcli dp vm delete [-h] --vmid VMID [--vmidtype {VMBIOSUUID}]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). For vCenter, specify the unique virtual machine VMBIOSUUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

ID type of the virtual machine (vmbiosuuid). For vCenter, specify the unique virtual machine VMBIOSUUID.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm delete command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm movein Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Move in data protection virtual machines to a protection group.

stcli dp vm movein [-h] --vmids VMIDS [VMIDS ...] --groupid GROUPID

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). If using vCenter, specify the unique virtual machine VMBIOSUUID.

--groupid GROUPID

Optional.

ID of the group to which you want to move in the standalone virtual machine.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm movein command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm moveout Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Move out data protection virtual machine to a protection group.

stcli dp vm moveout [-h] (--vmids VMIDS [VMIDS ...] | --allVMs) --groupid GROUPID

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). If using vCenter, specify the unique virtual machine VMBIOSUUID.

--allVMs

Optional.

Move out all virtual machines from a group.

--groupid GROUPID

Optional.

ID of the group from which you want to move out the standalone virtual machine.

Command Default

None.

Usage Guidelines

- Accompany the stcli dp vm moveout command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

- allVMs can only be performed on a secondary. allVMs moves all the VMs out of the group and prepares them for Recovery. Use this option only if you plan to perform recovery on all VMs of the group. The allVMs option is deprecated and will be removed in a future release.

stcli dp vm schedule Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HyperFlex data protection VM schedule operations.

stcli dp vm schedule [-h] {set,get}

Syntax Description

Option

Required or Optional

Description

--set

Required one of set.

Set VM schedule operations.

--get

Required one of set.

Get VM schedule.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm schedule command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

- stcli dp vm schedule get Command

- stcli dp vm schedule set Command

stcli dp vm schedule get Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Get the VM replication schedule information.

stcli dp vm schedule get [-h] --vmid VMID [--vmidtype {VMBIOSUUID}]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm schedule get command with the required arguments with leading two dashes (--), or optionally, the arguments enclosed in [ ].

stcli dp vm schedule set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Set the VM replication schedule.

stcli dp vm schedule set [-h] --vmid VMID [--vmidtype {VMBIOSUUID}] --replication-interval REPLICATIONINTERVALINMINUTES [--start-time REPLICATIONSTARTTIME] [--quiesce-using-tools] [--outgoing OUTGOING]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--vmidtype {VMBIOSUUID}

Optional.

Run the command on the virtual machine that matches the specified ID type.

--replication-interval REPLICATIONINTERVALINMINUTES

Required.

Replication interval in minutes

--start-time REPLICATIONSTARTTIME

Optional

Replication start time in the format: mm/dd/yy_HH_MM.

--quiesce-using-tools

Optional

Whether to use VMware Tools to quiesce the VMs before replication. VMware Tools must be installed in all the VMs in the replication group.

--outgoing OUTGOING

Optional

ID of the outgoing/target cluster where data is replicated to.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm schedule set command with the required arguments with leading two dashes (--), or optionally, the arguments enclosed in [ ].

stcli dp vm prepareReverseProtect Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Prepare reverse protection actions for the given virtual machine.

stcli dp vm prepareReverseProtect [-h] --vmid VMID [--force]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). If using vCenter, specify the unique virtual machine VMBIOSUUID.

--force

Optional.

Perform force reverse protect preparation without validating the arguments.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm prepareReverseProtect command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm failover Command

To failover the individual virtual machines from the recovery HX Storage Cluster. Where the recovery HX Storage Cluster is the target cluster for the replication pair protecting the virtual machines.

This command outputs the JOB-ID that is used for monitoring by the status command.

stcli dp vm failover [-h] --vmid VMID [--resourcepool-id RESOURCEPOOL-ID | --resourcepool-name RESOURCEPOOL-NAME] [--folder-id FOLDER-ID | --folder-name FOLDER-NAME] [--network-mapping NETWORKMAPPING [NETWORKMAPPING ...]] [--poweron] [--force]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

--resourcepool-id RESOURCEPOOL-ID

One of optional pair.

Place the recovered VM(s) on the resource pool with the listed ID.

--resourcepool-name RESOURCEPOOL-NAME

One of optional pair.

Place the recovered VM(s) on the resource pool with the listed name.

--folder-id FOLDER-ID

One of optional pair.

Place the recovered VM(s) in the folder with the listed ID.

--folder-name FOLDER-NAME

One of optional pair.

Place the recovered VM(s) in the folder with the listed name.

--network-mapping NETWORKMAPPING [NETWORKMAPPING ...]

Optional.

Map the source to destination network. Format source_network:destination_network. For example:

--network-mapping "source_network1:destination_network1", "source_network2:destination_network2"

--poweron

Optional.

Power on the VM after recovery

--force

Optional.

Do not validate the arguments and perform recovery

Command Default

Location defaults to command execution path.

Usage Guidelines

Accompany the stcli dp vm failover command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm testfailover Command

To test recovery of individual virtual machines from the recovery HX Storage Cluster. Where the recovery HX Storage Cluster is the target cluster for the replication pair protecting the virtual machines.

This command outputs the JOB-ID that is used for monitoring by the status command.

stcli dp vm testfailover [-h] --vmid VMID [--resourcepool-id RESOURCEPOOL-ID | --resourcepool-name RESOURCEPOOL-NAME] [--folder-id FOLDER-ID | --folder-name FOLDER-NAME] [--test-network TESTNETWORK] [--network-mapping NETWORKMAPPING [NETWORKMAPPING ...]] [--poweron] [--force] [--newname NEWNAME]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Lists the virtual machine that matches the specified BIOS UUID.

--resourcepool-id RESOURCEPOOL-ID

One of optional pair.

Place the recovered VM(s) on the resource pool with the listed ID.

--resourcepool-name RESOURCEPOOL-NAME

One of optional pair.

Place the recovered VM(s) on the resource pool with the listed name.

--folder-id FOLDER-ID

One of optional pair.

Place the recovered VM(s) in the folder with the listed ID.

--folder-name FOLDER-NAME

One of optional pair.

Place the recovered VM(s) in the folder with the listed name.

--test-network TESTNETWORK

Optional.

Test network to be used for test recovery. All source networks are assigned to this network after recovery.

--network-mapping NETWORKMAPPING [NETWORKMAPPING ...]

Optional.

Map the source to destination network. Format source_network:destination_network. For example:

--network-mapping "source_network1:destination_network1","source_network2:destination_network2"

--poweron

Optional.

Power on the VM after recovery.

--force

Optional.

Perform recovery without validating the arguments.

--newname NEWNAME

Optional.

New name for the test recovered VM.

Command Default

By default test recovery recovers the VM with the same name in the HxTestRecovery folder.

Usage Guidelines

Accompany the stcli dp vm testfailover command with the required arguments with leading two dashes (--), or optionally, the arguments enclosed in [ ].

stcli dp vm prepareFailover Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Prepare failover action for the given virtual machine.

stcli dp vm prepareFailover [-h] --vmid VMID [--force]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). If using vCenter, specify the unique virtual machine VMBIOSUUID.

--force

Optional.

Perform force reverse failover preparation without validating the arguments.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm prepareFailover command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm migrate Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Migrate the given virtual machine.

stcli dp vm migrate [-h] --vmid VMID [--resourcepool-id RESOURCEPOOL-ID | --resourcepool-name RESOURCEPOOL-NAME] [--folder-id FOLDER-ID | --folder-name FOLDER-NAME] [--network-mapping NETWORKMAPPING [NETWORKMAPPING ...]] [--poweron]

Syntax Description

Option

Required or Optional

Description

--vmid VMID

Required.

Run command on the virtual machine that matches the specified BIOS UUID.

ID of the virtual machine (vmbiosuuid). If using vCenter, specify the unique virtual machine VMBIOSUUID.

--resourcepool-id RESOURCEPOOL-ID

Optional.

ID of the resource pool on which the recovered virtual machines have to be placed.

--resourcepool-name RESOURCEPOOL-NAME

Optional.

Name of the resource pool on which the recovered virtual machines have to be placed.

--folder-id FOLDER-ID

Optional.

ID of the folder on which the recovered virtual machines have to be placed.

--folder-name FOLDER-NAME

Optional.

Name of the folder on which the recovered virtual machines have to be placed.

--network-mapping NETWORKMAPPING [NETWORKMAPPING ...]

Optional.

Source to destination network map, in the format: "Source Network":"Destination Network".

--poweron

Optional.

Power on the virtual machine after recovery.

Command Default

None.

Usage Guidelines

Accompany the stcli dp vm migrate command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp vm hxtask Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Data protection related operations.

stcli dp vm hxtask [-h] [--vmid VMID] [--id ID] [--name NAME][--state {new,starting,running,suspended,shutting_down,completed,terminated,cancelled,exception,stalled}]

Syntax Description

Option

Required or Optional

Description

– vmid VMID

Required

ID of the virtual machine to add to the protection group.

--id ID

Optional

ID of the virtual machine.

--name NAME

Optional.

Reference name assigned to the replication network.

Note

The hx task commands start with lower case, but the filtering of --name will start with uppercase. For example use – TestFailover instead of testFailover.

The name to be filtered are on:

TestFailover

Failover

PrepareReverseProtect

PrepareFailover

ReverseProtect

Migrate

--state

Optional.

State of the replication process:

new

starting

running

suspended

shutting_down

completed

terminated

canceled

exception

stalled

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp vm hxtask command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp group Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX Data Platform disaster recovery and native replication commands applied to virtual machine protection groups and not to individual virtual machines.

stcli dp group [-h] {add | list | delete | vm | snapshot | schedule}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Add data protection group.

list

One of set required.

List of data protection groups.

delete

One of set required.

Delete data protection group.

vm

One of set required.

VM tasks in a data protection group.

snapshot

One of set required.

Snapshot operations in a data protection group.

This command is not supported.

schedule

One of set required.

Schedule replication for a data protection group.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp group command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

Note

Beginning with HX Release 3.5(2g), support for the <command name> command was limited to Cisco Tech support only. General use is not supported.

- stcli dp group add Command

- stcli dp group list Command

- stcli dp group delete Command

- stcli dp group vm Commands

- stcli dp group vm add Command

- stcli dp group vm list Command

- stcli dp group schedule Commands

- stcli dp group schedule get Command

- stcli dp group schedule set Command

stcli dp group add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Add data protection group.

Command syntax for Cisco HyperFlex Release 5.0(2a) and earlier.

stcli dp group add [-h] --groupname GROUPNAME

Syntax Description

Option

Required or Optional

Description

--groupname GROUPNAME

Required.

Name of the protection group.

Command Default

None.

Usage Guidelines

This command is only supported in Cisco HyperFlex Release 5.0(2a) and earlier.

Accompany the stcli dp group add command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp group list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List data protection group configuration and schedule.

stcli dp group list [-h] [--groupname GROUPNAME] [--groupid GROUPID]

Syntax Description

Option

Required or Optional

Description

--groupname GROUPNAME

Optional.

List the protection group with given group name.

--groupid GROUPID

Optional.

List the protection group with given ID.

--brief

Optional.

Display brief summary only.

Command Default

List all data protection groups.

Usage Guidelines

Accompany the stcli dp group list command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

This example shows a list of data protection groups.

# stcli dp group list

clusterEr:
type: cluster
id: 21038104951568023:6930626691413900957
name: source17-2.5.1a
vmGroupState: active
vmGroupEr:
type: dp_vmgroup
id: 4de5d40f-82d6-40f6-9425-e4942bdd9be9
name: group1
members:
----------------------------------------
idtype: 2
type: dp_vm
id: 423f38fd-9754-a25c-0d60-1ddacacaac60
----------------------------------------
idtype: 2
type: dp_vm
id: 423fc732-4841-3a0a-8d75-6c7bdcf8de67
----------------------------------------
schedules:
replicationSchedule:
targetClusterEr:
type: cluster
id: 1279191129902762643:7329250794747596775
name: target17-2.5.1a
enabled: True
mode: 2
startTime: 07/19/17_20:24
intervalInMinutes: 15

stcli dp group delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Delete the specified data protection group.

stcli dp group delete [-h] --groupid GROUPID

Syntax Description

Option

Required or Optional

Description

--groupid GROUPID

Required.

ID of the protection group.

To delete a protection group, all virtual machines must be removed.

Command Default

None.

Usage Guidelines

Accompany the stcli dp group delete command with the required arguments with leading two dashes (--), or optionally, the arguments enclosed in [ ].

stcli dp group vm Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Hyperflex data protection group VM operations.

stcli dp group vm [-h] {add | list | delete}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Add VM to data protection group.

list

One of set required.

List VMs in data protection group.

delete

One of set required.

Delete VM from data protection group.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp group vm command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp group vm add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Add a VM to a data protection group.

stcli dp group vm add [-h] --groupid GROUPID --vmid VMID [--vmidtype {VMBIOSUUID}]

Syntax Description

Option

Required or Optional

Description

--groupid GROUPID

Required.

ID of the data protection group where the VMs reside.

--vmid VMID

Required.

ID of the virtual machine to add to the protection group.

--vmidtype {VMBIOSUUID}

Optional.

ID type for the virtual machine to add to the protection group.

The VCMOID option is not supported.

Command Default

None.

Usage Guidelines

Accompany the stcli dp group vm add command with optionally, the arguments enclosed in [ ].

stcli dp group vm list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List the VMs included in the data protection group.

stcli dp group vm list [-h] --groupid GROUPID

Syntax Description

Option

Required or Optional

Description

--groupid GROUPID

Required.

ID of the data protection group where the VMs reside.

Command Default

None.

Usage Guidelines

Accompany the stcli dp group vm list command with optionally, the arguments enclosed in [ ].

stcli dp group schedule Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Hyperflex protection group schedule operations.

stcli dp group schedule [-h] {set | get}

Syntax Description

Option

Required or Optional

Description

set

One of set required.

Set the replication schedule for a data protection group.

get

One of set required.

Get the replication schedule for a data protection group.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp group schedule command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp group schedule get Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List the replication schedule information for a data protection group.

stcli dp group schedule get [-h] --groupid GROUPID [--outgoing OUTGOING]

Syntax Description

Option

Required or Optional

Description

--groupid GROUPID

Required.

ID of the data protection group where the VMs reside.

--outgoing OUTGOING

Optional.

ID of the outgoing/target cluster where data is replicated to.

Command Default

Outgoing cluster is the paired remote cluster.

Usage Guidelines

Accompany the stcli dp group schedule get command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp group schedule set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Set the replication schedule for a data protection group.

stcli dp group schedule set [-h] --groupid GROUPID --replication-interval REPINTERVALINMINS [--start-time REPSTARTTIME] [--quiesce-using-tools] [--outgoing OUTGOING]

Syntax Description

Option

Required or Optional

Description

--groupid GROUPID

Required.

ID of the data protection group where the VMs reside.

--replication-interval REPINTERVALINMINS

Required.

Replication interval (frequency) in minutes. This sets how often the VMs are replicated to the target cluster.

--start-time REPSTARTTIME

Optional.

Replication start time in format mm/dd/yy_HH_MM. Specifies when the first replication begins.

--quiesce-using-tools

Optional.

Whether to use VMware Tools to quiesce the VMs before replication. VMware Tools must be installed in all the VMs in the replication group.

--outgoing OUTGOING

Optional.

ID of the outgoing/target cluster where data is replicated to.

Command Default

Start time is immediately upon execution of the command. Quiesce is not set. Outgoing cluster is the paired remote cluster.

Usage Guidelines

Accompany the stcli dp group schedule set command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp peer Commands

Note

The stcli ommands are being deprecated. We recommend that you use the hxcli Commands instead.

Hyperflex data protection operations on the remote (peer) cluster in a replication pair.

stcli dp peer [-h] {get | add | list | query | edit | datastore | delete | forget | schedule}

Syntax Description

Option

Required or Optional

Description

get

One of set required.

Get peer cluster details.

add

One of set required.

Add a pair using given inputs.

list

One of set required.

Show all pairs.

query

One of set required.

Query a pair to get pair-details.

edit

One of set required.

Edit pair description for peer management IP.

datastore

One of set required.

Edit mapped datastores in existing pair.

delete

One of set required.

Delete a replication pair.

forget

One of set required.

Forget peer using given inputs.

schedule

One of set required.

Peer schedule operations.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp peer command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

- stcli dp peer get Command

- stcli dp peer add Command

- stcli dp peer list Command

- stcli dp peer query Command

- stcli dp peer edit Command

- stcli dp peer datastore Commands

- stcli dp peer datastore add Command

- stcli dp peer datastore edit Command

- stcli dp peer datastore delete Command

- stcli dp peer datastore editSchedule Command

- stcli dp datastore editstatus Command

- stcli dp peer datastore forget Command

- stcli dp schedule Commands

- stcli dp peer delete Command

- stcli dp peer forget Command

stcli dp peer get Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

List the peer cluster details.

Note

Please enter password when prompted.

stcli dp peer get [-h] --mgmtIp MGMTIP --username USERNAME

Syntax Description

Option

Required or Optional

Description

--mgmtIp MGMTIP

Required.

Peer cluster's management IP.

--username USERNAME

Required.

Peer cluster's user name.

Enter peer cluster's user password when prompted.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer get command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp peer add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Add a replication pair using given inputs.

Attention

Please enter password when prompted.

Note

This command does not invoke and verify the Test Remote Replication Network similar to the verification process that gets done automatically while configuring replication pair in HX Connect.

stcli dp peer add [-h] --name NAME --description DESCRIPTION --mgmtIp MGMTIP --username USERNAME

Syntax Description

Option

Required or Optional

Description

--name NAME

Required.

Name of cluster-pair.

--description DESCRIPTION

Required.

Description of cluster-pair.

--mgmtIp MGMTIP

Required.

Peer cluster's management IP.

--username USERNAME

Required.

Peer cluster's user name.

Enter peer cluster's password when prompted.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer add command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp peer list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Show all replication pairs.

stcli dp peer list [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer list command with optionally, the arguments enclosed in [ ].

stcli dp peer query Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Query a replication pair for pair details.

stcli dp peer query [-h] --name NAME

Syntax Description

Option

Required or Optional

Description

--name NAME

Required.

Name of cluster replication pair.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer query command with optionally, the arguments enclosed in [ ].

stcli dp peer edit Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Edit pair description or peer mgmtIp

Note

This command is not supported.

stcli dp peer edit [-h] --name NAME [--description DESCRIPTION] [--mgmtIp MGMTIP] --username USERNAME --password PASSWORD

Syntax Description

Option

Required or Optional

Description

--name NAME

Required.

Name of cluster-pair

--description DESCRIPTION

Required

Description of cluster-pair

--mgmtIp MGMTIP

Required

Peer cluster's management Ip

--username USERNAME

Required

Peer cluster's user name

Enter peer cluster's user password when prompted.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer edit command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp peer datastore Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Edit mapped datastores in existing replication pair.

Note

This command does not invoke and verify the Test Remote Replication Network similar to the verification process that gets done automatically while editing the pair in HX Connect.

stcli dp peer datastore [-h] {edit | add | delete | editSchedule | editstatus | forget | }

Syntax Description

Option

Required or Optional

Description

edit

One of set required.

Edit mapped datastores in existing pair.

add

One of set required.

Add a datastore mapping in existing cluster pair

delete

One of set required.

Delete a datastore mapping in existing cluster pair

editSchedule

One of set required.

Edit schedule of a datastore mapping in existing cluster pair.

editstatus

One of set required.

Status of datastore edit job.

forget

One of set required.

Forget datastore pair edit-in-progress; Forget datastore pairs

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp peer datastore command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp peer datastore add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Add mapped datastores in existing replication pair.

stcli dp peer datastore add [-h] --name NAME --localDs LOCALDS --peerDs PEERDS [--storageOnly] [--replication-interval REPLICATIONINTERVALINMINUTES] [--backupOnly] [--quiesce] [--fallbackToCrashConsistent]

Syntax Description

Option

Required or Optional

Description

-h

Optional.

Displays help message.

--name NAME

Required.

Name of cluster-pair.

--localDs LOCALDS

Required.

Local cluster's datastore name.

--peerDs PEERDS

Required.

Peet cluster's datastore name.

--storageOnly

Required.

SRM or an external DR orchestrator will manage the input datastore pair.

--replication-interval REPLICATIONINTERVALINMINUTES

Required.

Replication interval in minutes.

--backupOnly

Required.

The input datastore pair will be used for Backup only.

--quiesce

Required.

When backupOnly is set, this flag specifies whether quiesce is preferred.

--fallbackToCrashConsistent

Required.

When backupOnly and quiesce are set, and VM tools check fails, this flag specifies whether fallback to Crash Consistent snapshot is preferred.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer datastore add command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp peer datastore edit Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Edit mapped datastores in existing replication pair.

stcli dp peer datastore edit [-h] --name NAME --datastore DATASTORE [--storageOnly] [--replication-interval REPLICATIONINTERVALINMINUTES] [--backupOnly] [--quiesce] [-fallbackToCrashConsistent]

Syntax Description

Option

Required or Optional

Description

--name NAME

Required.

Name of cluster-pair.

--datastore DATASTORE

Required.

Datastore pairs with operations. Format is:

local_ds:remote_ds:OPERATION

Operation choices are: ADD, DELETE.

--storageOnly

Required.

SRM or an external DR orchestrator will manage the input datastore pair.

--replication-interval REPLICATIONINTERVALINMINUTES

Required.

Replication interval in minutes.

--backupOnly

Required.

The input datastore pair will be used for Backup only.

--quiesce

Required.

When backupOnly is set, this flag specifies whether quiesce is preferred.

--fallbackToCrashConsistent

Required.

When backupOnly and quiesce are set, and VM tools check fails, this flag specifies whether fallback to Crash Consistent snapshot is preferred.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer datastore edit command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

This example shows changing the datastores associated with the replication pair.

# stcli dp peer datastore edit

<local ds 1>:<peer ds 1>:ADD,<local ds 2>:<peer ds 2>:DELETE,..

stcli dp peer datastore delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Delete a datastore mapping in an existing replication pair.

stcli dp peer datastore delete [-h] --name NAME --localDs LOCALDS --peerDs PEERDS [--storageOnly] [--replication-interval REPLICATIONINTERVALINMINUTES] [--backupOnly] [--quiesce] [--fallbackToCrashConsistent]

Syntax Description

Option

Required or Optional

Description

-h

Optional.

Displays help message.

--name NAME

Required.

Name of cluster-pair.

--localDs LOCALDS

Required.

Local cluster's datastore name.

--peerDs PEERDS

Required.

Peer cluster's datastore name.

--storageOnly

Required.

SRM or an external DR orchestrator will manage the input datastore pair.

--replication-interval REPLICATIONINTERVALINMINUTES

Required.

Replication interval in minutes.

--backupOnly

Required.

The input datastore pair will be used for Backup only.

--quiesce

Required.

When backupOnly is set, this flag specifies whether quiesce is preferred.

--fallbackToCrashConsistent

Required.

When backupOnly and quiesce are set, and VM tools check fails, this flag specifies whether fallback to Crash Consistent snapshot is preferred.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer datastore delete command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp peer datastore editSchedule Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Edit schedule of a datastore mapping in an existing replication pair.

stcli dp peer datastore editSchedule [-h] --name NAME --localDs LOCALDS --peerDs PEERDS [--storageOnly] [--replication-interval REPLICATIONINTERVALINMINUTES] [--backupOnly] [--quiesce] [--fallbackToCrashConsistent]

Syntax Description

Option

Required or Optional

Description

-h

Optional.

Displays help message

--name NAME

Required.

Name of cluster-pair.

--localDs LOCALDS

Required.

Local cluster's datastore name

--peerDs PEERDS

Required.

Peer cluster's datastore name

--storageOnly

Required.

SRM or an external DR orchestrator will manage the input datastore pair.

--replication-interval REPLICATIONINTERVALINMINUTES

Required.

Replication interval in minutes.

--backupOnly

Required.

The input datastore pair will be used for Backup only.

--quiesce

Required.

When backupOnly is set, this flag specifies whether quiesce is preferred.

--fallbackToCrashConsistent

Required.

When backupOnly and quiesce are set, and VM tools check fails, this flag specifies whether fallback to Crash Consistent snapshot is preferred.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer datastore editSchedule command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp datastore editstatus Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

View the status of the datastore mapping change for the replication pair.

stcli dp peer datastore editstatus [-h] [--jobid JOBID]

Syntax Description

Option

Required or Optional

Description

--jobid JOBID

Optional.

Job ID for a datastore change task.

Command Default

Job ID default is all displays status of all datastore edits.

Usage Guidelines

Accompany the stcli dp peer datastore editstatus command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

This example shows changing the datastores associated with the replication pair.

# stcli dp peer datastore editstatus

[<jobid>,<jobid>...,<jobid>]

stcli dp peer datastore forget Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Forget datastore pair edit-in-progress; Forget datastore pairs.

stcli dp peer datastore forget [-h] --name NAME [ --all [editPairOnly]

Syntax Description

Option

Required or Optional

Description

-h

Optional.

Displays help message

--name NAME

Required.

Name of cluster-pair.

--all

Required.

Perform this action for all Cluster Pairs.

--editPairOnly

Required.

If set, only forget datastore pair edits that are in progress, while preserving existing datastore pairing.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer datastore forget command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp schedule Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Data protection schedule operations.

stcli dp schedule [-h] {pause | resume | status}

Syntax Description

Option

Required or Optional

Description

pause

One of set required.

Pause replication. Stop sending replication snapshot bits to the remote cluster.

resume

One of set required.

Resume replication. Resume sending replication snapshot bits to the remote cluster.

status

One of set required.

Query the scheduler state. That is the database state, not the status of scheduled events. It does not imply that the scheduler is full.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp schedule command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli dp peer delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Delete the peer from the replication pair.

Important

Please enter password when prompted.

stcli dp peer delete [-h] --name NAME --username USERNAME [--mgmtIp MGMTIP]

Syntax Description

Option

Required or Optional

Description

--name NAME

Required.

Name of cluster replication pair.

--username USERNAME

Required.

Peer cluster's user name.

Enter peer cluster's user password when prompted.

--mgmtIp MGMTIP

Optional.

Peer cluster's management IP.

Command Default

Management IP is assumed to be the currently associated peer.

Usage Guidelines

Accompany the stcli dp peer delete command with the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

stcli dp peer forget Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

This removes the pairing between peers: the source and target clusters. Freeing up each cluster to be paired with a different cluster.

stcli dp peer forget [-h] [--name NAME] [--all]

Syntax Description

Option

Required or Optional

Description

--all

One of set required.

Remove the pairing between peers, for all partially-paired and successfully paired clusters.

--name NAME

One of set required.

Remove the pairing between peers, (the source and target clusters), for the cluster pair with the listed name.

Command Default

None.

Usage Guidelines

Accompany the stcli dp peer forget command the required arguments with leading two dashes (--) or optionally, the arguments enclosed in [ ].

Note

NR/NFS cleanup time delay—During the VM replication process, the message "Please retry again after outstanding replication jobs are complete", or "DP Peer forget failed: Failed to clean connection cache for peer replication CIP <IP address>. Replication jobs (#) in progress. Please retry again after outstanding replication jobs are complete." may appear indicating that detaching policies may fail. If you receive this message try again after a few minutes as there is a time delay in the NR/NFS cleanup.

stcli dp schedule Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Data protection schedule operations.

stcli dp schedule [-h] {pause | resume | status}

Syntax Description

Option

Required or Optional

Description

pause

One of set required.

Pause replication. Stop sending replication snapshot bits to the remote cluster.

resume

One of set required.

Resume replication. Resume sending replication snapshot bits to the remote cluster.

status

One of set required.

Query the scheduler state. That is the database state, not the status of scheduled events. It does not imply that the scheduler is full.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli dp schedule command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

- stcli dp schedule pause Command

- stcli dp schedule resume

- stcli dp schedule status

stcli dp schedule pause Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Pause replication. Stop monitoring existing jobs and stop creating new jobs sending replication snapshot bits to the remote cluster.

stcli dp schedule pause [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli dp schedule pause command optionally, the arguments enclosed in [ ].

stcli dp schedule resume

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Resume replication. Resume monitoring existing jobs and resume creating new jobs sending data replication bits to the remote cluster.

stcli dp schedule resume [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli dp schedule resume command optionally, the arguments enclosed in [ ].

stcli dp schedule status

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Query the scheduler state. That is the database state, not the status of scheduled events. It does not imply that the scheduler is full.

stcli dp schedule status [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli dp schedule status command optionally, the arguments enclosed in [ ].

stcli drnetwork cleanup Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Remove the DR network.

stcli drnetwork cleanup [-h]

Command Default

None.

Usage Guidelines

Use the stcli drnetwork cleanup command as part of the DR Network cleanup operations.

Note

The drnetwork cleanup operation is supported when there is no dr pairing or protection configurated. For information about cleaning up the configuration, see the Managing Virtual Machine Disaster RecoveryManaging Virtual Machine Disaster Recovery topic for your release.

stcli license Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Smart Licensing operations.

stcli license [-h] {register | deregister | show | renew}

Syntax Description

Option

Required or Optional

Description

register

One of set required.

Register Smart Licensing with an ID token.

deregister

One of set required.

Deregister Smart Licensing.

show

One of set required.

Show Smart Licensing options. Includes summary, unique device identifier (UDI), usage count, technical support details, registration and authorization status, and instance name.

renew

One of set required.

Renew Smart Licensing operations.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli license command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli license register Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Register a Smart License with an ID token.

stcli license register [-h] --idtoken IDTOKEN [--force]

Syntax Description

Option

Required or Optional

Description

--idtoken IDTOKEN

Required.

Registration ID token.

--force

Optional.

Force the registration when the cluster is already registered.

Command Default

None.

Usage Guidelines

Accompany the stcli license register command with the required arguments with leading two dashes (--), or optionally, the arguments enclosed in [ ].

# stcli license register--idtoken

ZmM2YTVhZjMtZTQxNi00...1LTE0ODg0NzkppYmF...A3OD0%3D%0...8caERE

stcli license deregister Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Deregister Smart Licensing.

stcli license deregister [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli license deregister command with optionally, the arguments enclosed in [ ].

stcli license reservation install Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Reseve a Smart License with a file path.

stcli license reservation install [-h]

Syntax Description

Option

Required or Optional

Description

--file FILE_PATH

Optional.

Auth code file path.

Command Default

None.

Usage Guidelines

Accompany the stcli license reservtion install command with the required arguments with leading two dashes (--), or optionally, the arguments enclosed in [ ].

# stcli license reservation install -h  --file FILE_PATH

stcli license show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Show Smart License information based on option selected.

stcli license show

Syntax Description

Option

Required or Optional

Description

all

Optional.

Show all license information.

auth-status

Optional.

Show Smart Licensing authorization status.

inst-name

Optional.

Show cluster instance name.

reg-status

Optional.

Show Smart Licensing registration status.

status

Optional.

Show Smart Licensing registration, authorization, and license status.

summary

Optional.

Show Smart Licensing summary.

tech-support

Optional.

Show Smart Licensing technical support details.

udi

Optional.

Show Smart Licensing unique device identifier (UDI).

usage

Optional.

Show Smart Licensing usage count.

Command Default

None.

Usage Guidelines

Accompany the stcli license show command with the required option, no leading dashes (--) required. Optionally, include the arguments enclosed in [ ].

An example when license not registered

# stcli license show status

Smart Licensing is ENABLED
Registration: Status: UNREGISTERED
Export-Controlled Functionality: Not Allowed
License Authorization: Status: EVAL MODE
Evaluation Period Remaining: 89 days, 23 hr, 57 min, 3 sec
Last Communication Attempt: NONE

An example when license is registered

# stcli license show summary

Smart Licensing is ENABLED
Registration:
Status: REGISTERED
Smart Account: HyperFlex License Test
Virtual Account: derek
Last Renewal Attempt: None
Next Renewal Attempt: Aug 1 17:47:06 2017 PDT
License Authorization:
Status: AUTHORIZED
Last Communication Attempt: SUCCEEDED
Next Communication Attempt: Mar 4 16:47:11 2017 PST
License Usage:
License                  Entitlement Tag                                                                Count        Status
------------------------------------------------------------------------------------------------------------------------------
Cisco Vendor String XYZ  regid.2016-11.com.cisco.HX-SP-DP-S001,1.0_1c06...d45203  InCompliance

stcli license renew Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Renew Smart Licensing operations.

stcli license renew [-h] {id | auth}

Syntax Description

Option

Required or Optional

Description

auth

One of set required.

Renew Smart Licensing authorization.

id

One of set required.

Renew registration and registration ID certificate information.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli license review command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli node Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Operations performed on the storage cluster nodes.

Note

Do not perform conflicting actions simultaneously. For example, do not run node add and node remove at the same time: stcli node add --node-ips NODEIPS remove --id-1 ID1

stcli nodes [-h] {discover | list | info | identify | disks | disk | add | remove | maintenanceMode}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Adds the set of nodes to the storage cluster.

discover

One of set required.

Lists the storage cluster nodes discoverable on the same subnet as this node.

disk

One of set required.

Locate a physical disk in the node.

disks

One of set required.

Provides information about the physical disks of the storage cluster node.

identify

One of set required.

Turns on/off the node beacon to identify a node.

info

One of set required.

Provides information about the specified storage cluster node.

list

One of set required.

Lists the storage cluster nodes in the storage cluster.

maintenanceMode

One of set required.

Enter or exit maintenance mode.

remove

One of set required.

Removes the node from the storage cluster.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli node command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli node discover Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Lists the storage cluster nodes discoverable on the same subnet as this node.

stcli node discover [-h]

Command Default

None. No additional parameters.

Usage Guidelines

Run the stcli node discover command on the storage cluster.

# stcli node discover

state:
storfsIp:
addr:
stService:
gateway:
subnetMask:
method:

host:
state:
about:
serviceType:
instanceUuid:
name:
locale:
serialNumber:
apiVersion:
modelNumber:
build:
fullName:
productVersion:

stctlvm:
name:
ip:
guestHostname:
storageNetworkIp:
moid:
role:
entityRef:
type:
id: v
name:
version:
passthrough:
guestState:
mgmtNetworkIp:

name:
ip:
addr:
stService:
vlanId:
gateway:
subnetMask:
method:

moid:
ipmiSettings:
addr:
stService:
gateway:
subnetMask:
method:

ioVisor:
about:
serviceType:
instanceUuid:
name:
locale:
serialNumber:
apiVersion:
modelNumber:
build:
fullName:
productVersion:
state:

bootTime:
entityRef:
type:
id:
name:
vMotionIp:
addr:
vlanId:
gateway:
subnetMask:
method:
enclosureSerialNumber:

entityRef:
type:
id:
name:
progress:

stcli node list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Lists the nodes in the storage cluster.

stcli node list [-h] --summary

Syntax Description

Option

Required or Optional

Description

--summary

Optional.

Display summary only.

Command Default

None.

Usage Guidelines

Run the stcli node list command and optionally include arguments enclosed in [ ].

# stcli node list

----------------------------------------
upgradeState:
state:
storfsIp:
addr:
stService:
vlanId:
gateway:
subnetMask:
method:

pNode:
about:
serviceType:
instanceUuid:
name:
locale:
serialNumber:
apiVersion:
modelNumber:
build:
displayVersion:
fullName:
productVersion:

retired:
compression:
ip:
dedup:
nsPrimary:
dataWriteThruEnabled:
state:
bootTime:
master:
entityRef:
type:
id:
name:
version:
lastModifiedTime:
name:

host:
state:
about:
serviceType:
instanceUuid:
name:
locale:
serialNumber:
apiVersion:
modelNumber:
build:
fullName:
productVersion:

stctlvm:
name:
storageClusterIp:
ip:
guestHostname:
mgmtClusterIp:
storageNetworkIp:
moid:
role:
entityRef:
type:
id:
name:
version:
passthrough:
guestState:
mgmtNetworkIp:

name:
ip:
addr:
stService:
vlanId:
gateway:
subnetMask:
method:

moid:
ipmiSettings:
addr:
stService:
gateway:
subnetMask:
method:

ioVisor:
about:
serviceType:
instanceUuid:
name:
locale:
serialNumber:
apiVersion:
modelNumber:
build:
fullName:
productVersion:
state:

bootTime:
entityRef:
type:
id:
name:
vMotionIp:
addr:
vlanId:
gateway:
subnetMask:
method:
enclosureSerialNumber:

entityRef:
type:
id:
name:
upgradeVersion:
----------------------------------------

stcli node info Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Provides information about the specified storage cluster node.

stcli node info [-h] {--id ID | --ip NAME} [--summary]

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

A unique ID number for the storage cluster node. The ID is listed in the stcli cluster info command under the stNode field id.

--ip NAME

One of set required.

IP address of storage cluster node. The IP is listed in the stcli cluster info command under the stNode field name.

The --ip option is currently not supported.

--summary

Optional.

Display summary only.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli node info command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli node identify Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Turns on/off the node beacon to identify a node.

Important

Please enter password when prompted.

stcli node identify [-h] --ipmiIp IPMIIP [--interval INTERVAL] [--user USER]

Syntax Description

Option

Required or Optional

Description

--ipmiIp IPMIIP

Required

Ipmi IP address.

--interval INTERVAL

Optional

Number of seconds to turn the beacon on. If not specified, turns the beacon off.

---user USER

Optional

The IPMI admin user name.

Enter IPMI admin password when prompted.

Command Default

None.

Usage Guidelines

Accompany the stcli node identify command with the required arguments with leading two dashes (--), and optionally, one or more of the positional arguments enclosed in [ ].

stcli node disks Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Provides information about the physical disks of the storage cluster node.

stcli node disks [-h] {--id ID | --ip NAME}

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

A unique ID number for the storage cluster node. The ID is listed in the stcli cluster info command under the stNode field id.

--ip NAME

One of set required.

IP address of storage cluster node. The IP is listed in the stcli cluster info command under the stNode field name.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli node disks command with one of the positional arguments enclosed in { }.

stcli node disk Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Locate a physical disk in the node.

stcli node disk [-h] {--id ID | --ip NAME} [--lighton | lightoff]

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

A unique ID number for the storage cluster node. The ID is listed in the stcli cluster info command under the stNode field id.

--ip NAME

One of set required.

IP address of storage cluster node. The IP is listed in the stcli cluster info command under the stNode field name.

--lighton

Optional.

Turn the ID light on the disk on.

--lightoff

Optional.

Turn the ID light on the disk off.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli node disk command with one of the positional arguments enclosed in { }, and optionally arguments enclosed in [ ].

stcli node add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Adds the specified nodes to the storage cluster.

Note

- Please enter password when prompted.

- Only use the stcli node add command when the storage cluster is online and healthy.

- Do not perform conflicting actions simultaneously. For example, do not run node add and node remove at the same time: stcli node add --node-ips NODEIPS remove --id-1 ID1

For standard cluster or edge cluster:
stcli node add [-h] --node-ips NODEIPS [NODEIPS . . .] [--esx-username ESXUSERNAME] [--dryrun]

For stretched cluster:
stcli node add [-h] --node-ips NODEIPS [NODEIPS . . .]:<Site Name> [--esx-username ESXUSERNAME] [--dryrun]

Syntax Description

Option

Required or Optional

Description

--node-ips NODEIPS [NODEIPS . . .]

Required

ESXi management/vmk0 IP addresses of the nodes to be add to the storage cluster.

--dryrun

Optional

Only validate input parameters.

Site Name

Required for stretched cluster

Site name of the node.

--esx-username ESCUSERNAME

Optional

User name of ESX administrator.

Enter ESX administrator password when prompted.

Controller VM root user password

Optional

All nodes must have the same password.

Enter controller VM password when prompted.

Command Default

None. Node identification is required.

Usage Guidelines

Accompany the stcli node add command with the --node-ips and optionally, the arguments enclosed in [ ].

Note

When you add a new node to a storage cluster, if the storage cluster is in an Out of Space condition, the system automatically rebalances the storage cluster. Otherwise, it schedules a nightly rebalance.

stcli node remove Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

IMPORTANT: Use the stcli node remove command to permanently remove a node from the cluster. Do not run the stcli node remove command if you intend to add the same node back into the same cluster later. Adding a node back into a cluster that it was already part of is not supported.

Note

For HX 4.5(1a) and later, you can only remove 1 converged node.

Note

Do not perform conflicting actions simultaneously. For example, do not run node add and node remove at the same time: stcli node add --node-ips NODEIPS remove --id-1 ID1

Warning

Prior to removing a node or nodes for HyperFlex clusters with Logical Availability Zones (LAZ) configured, LAZ must be disabled.

If LAZ is utilized in the HyperFlex cluster, then the number of remaining nodes must be in a balanced configuration that supports LAZ per the LAZ Guidelines and Considerations prior to reenabling LAZ.

stcli node remove [-h] {--id-1 ID1 | --ip-1 NAME1} [-f]

Syntax Description

Option

Required or Optional

Description

--id-1 ID1

One of set required.

A unique ID number for the storage cluster node. The ID is listed in the stcli cluster info command under the stNode field id.

--ip-1 NAME1

One of set required.

IP address of storage cluster node. The IP is listed in the stcli cluster info command under the stNode field name.

-f, --force

Optional.

Forcibly remove storage cluster nodes.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli node remove command with one of the positional arguments enclosed in { }, or optional arguments enclosed in [ ].

- Before you remove a node from a storage cluster, ensure that DRS is enabled. DRS migrates only powered-on VMs.

- For ESXi nodes, you must first put the node in Maintenance Mode before performing a node remove.

- For cluster sizes less than 5, please schedule a maintenance window and shut down the cluster before performing a node removal.

- If your network has powered-off VMs, you must manually migrate them to the storage cluster. Otherwise, they are inaccessible after you remove the node.

- If DRS is not enabled, manually migrate the VMs.

- Removing a node requires that the storage cluster is healthy and that removing the node will not reduce the number of available nodes below the minimum 3 nodes which would make the storage cluster unhealthy.

stcli node maintenanceMode Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Puts the ESX server in the storage cluster into HX maintenance mode.

stcli node maintenanceMode [-h] {--id ID | ip NAME} --mode MODE {enter | exit} [--timeout TIMEOUT]

Syntax Description

Option

Required or Optional

Description

--id ID

One of set required.

A unique ID number for the storage cluster node. The ID is listed in the stcli cluster info command under the stNode field id.

--ip NAME

One of set required.

IP address of storage cluster node. The IP is listed in the stcli cluster info command under the stNode field name.

--mode MODE

Required

Mode to set enter or exit HX maintenance mode.

--timeout TIMEOUT

Optional.

Set timeout in seconds for HX maintenance mode.

Command Default

None. One option from the set is required and the --mode type

Usage Guidelines

Accompany the stcli node maintenanceMode command with one of the positional arguments enclosed in { } and the --mode type, plus optionally arguments enclosed in [ ].

stcli security Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Security related operations.

stcli security [-h] {password | whitelist | ssh | encryption}

Syntax Description

Option

Required or Optional

Description

password

One of set required.

Commands supported in the Storage security password manipulation namespace.

ssh

One of set required.

Commands supported in the Storage security ssh namespace.

whitelist

One of set required.

Commands supported in the Storage security ip whitelist namespace.

encryption

One of set required.

Commands supported in the Storage security encryption namespace.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli security command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli security encryption Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Encryption management operations.

stcli security encryption [-h] {ucsm-ro-user}

Syntax Description

Option

Required or Optional

Description

ucsm-ro-user

Required.

Commands supported in the security encryption UCSM RO user namespace.

Command Default

None.

Usage Guidelines

Accompany the stcli security encryption command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

- stcli security encryption ucsm-ro-user Commands

- stcli security encryption ucsm-ro-user create Command

- stcli security encryption ucsm-ro-user delete Command

- stcli security encryption ucsm-ro-user show Command

stcli security encryption ucsm-ro-user Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Encryption UCSM read only (RO) user operations.

stcli security encryption ucsm-ro-user [-h] {show | create | delete}

Syntax Description

Option

Required or Optional

Description

create

Required one of set.

Create UCSM RO user.

delete

Required one of set.

Delete UCSM RO user.

show

Required one of set.

Show UCSM RO user credentials.

Command Default

None.

Usage Guidelines

Accompany the stcli security encryption ucsm-ro-user command with one of the positional arguments enclosed in { } or optionally, the arguments enclosed in [ ].

stcli security encryption ucsm-ro-user create Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Encryption UCSM read only (RO) user create operations.

Important

Please enter password when prompted.

stcli security encryption ucsm-ro-user create [-h] --hostname HOSTNAME [--username USERNAME]

Syntax Description

Option

Required or Optional

Description

--hostname HOSTNAME

Required.

UCSM host name.

--username USERNAME

Optional.

UCSM user name.

Note

The UCSM user used to create the RO user should be the local UCSM user, and not an LDAP or AD user.

Enter UCSM admin level password when prompted.

Command Default

Username default is admin.

Usage Guidelines

Accompany the stcli security encryption ucsm-ro-user create command with the required arguments with leading two dashes (--), and optionally, the arguments enclosed in [ ].

stcli security encryption ucsm-ro-user delete Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Encryption UCSM read only (RO) user delete operations.

Important

Please enter password when prompted.

stcli security encryption ucsm-ro-user delete [-h] --hostname HOSTNAME [--username USERNAME]

Syntax Description

Option

Required or Optional

Description

--hostname HOSTNAME

Required.

UCSM host name.

--username USERNAME

Optional.

UCSM user name. Must be UCSM admin level user.

Enter UCSM admin level password when prompted.

Command Default

Username default is admin.

Usage Guidelines

Accompany the stcli security encryption ucsm-ro-user delete command with the required arguments with leading two dashes (--), and optionally, the arguments enclosed in [ ].

stcli security encryption ucsm-ro-user show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Encryption UCSM read only (RO) show users.

stcli security encryption ucsm-ro-user show [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli security encryption ucsm-ro-user show command optionally, the arguments enclosed in [ ].

stcli security password Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

SSH key management operations. Sets user password for all the controller VMs in the storage cluster.

Important

Enter password when prompted

stcli security password set [-h] [--user USER][--user diag]

Syntax Description

Option

Required or Optional

Description

set

Required.

Sets user password for all the controller VMs in the storage cluster.

--user USER

Optional.

User must be either admin or root. User root is assumed if not specified.

--user diag

Optional

Admin user account with escalated privileges designed for troubleshooting. Support introduced in 5.0(2a)

Command Default

Default controller VM username, root and password, Cisco123.

Usage Guidelines

Accompany the stcli security password set command with one of the optional arguments enclosed in [ ].

stcli security ssh Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

SSH key management operations. Resyncs SSH keys in storage cluster.

stcli security ssh [-h] resync

Syntax Description

Option

Required or Optional

Description

resync

Required.

Resyncs SSH keys in storage cluster.

Command Default

None.

Usage Guidelines

Run the stcli security ssh command with the resync positional argument, or include the optional arguments enclosed in [ ].

stcli security whitelist Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

IP tables white-listing operations.

stcli security whitelist [-h] [list | add | remove | clear}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Adds IP addresses to IP table white-list.

clear

One of set required.

Clears IP addresses from IP table white-list.

list

One of set required.

List IP table white-listed entries.

remove

One of set required.

Removes IP addresses from IP table white-list.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli security whitelist command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli security whitelist list Command

- stcli security whitelist add Command

- stcli security whitelist remove Command

- stcli security whitelist clear Command

stcli security whitelist list Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays the list of white list entries in the IP table.

stcli security whitelist list [-h]

Command Default

None.

Usage Guidelines

Accompany the stcli security whitelist list command, or include optional arguments enclosed in [ ].

# stcli security whitelist list

10.1.1.2
10.1.2.3

stcli security whitelist add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Adds IP addresses to the IP table white list.

stcli security whitelist add [-h] --ips IP [IP . . .]

Syntax Description

Option

Required or Optional

Description

--ips IP [IP . . .]

Required.

The IP addresses to add to white list.

Command Default

None. IP addresses required.

Usage Guidelines

Accompany the stcli security whitelist add command with the IPs of the servers to add.

# stcli security whitelist add --ips 10.1.2.3 10.3.4.5

stcli security whitelist remove Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Deletes the specified IP addresses from the IP table white list.

stcli security whitelist remove [-h] --ips IP [IP . . .]

Syntax Description

Option

Required or Optional

Description

--ips IP [IP . . .]

Required.

IP addresses to remove from white list.

Command Default

None.

Usage Guidelines

Accompany the stcli security whitelist remove command with the IP addresses to remove from the white list.

# stcli security whitelist remove --ips 10.1.2.3

stcli security whitelist clear Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Deletes the entire list of IP addresses in the IP table white list.

stcli security whitelist clear [-h]

Command Default

None.

Usage Guidelines

Run the stcli security whitelist clear command to delete IP addresses from the white list.

stcli services Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

System services related operations.

stcli services [-h] [smtp | dns | ntp | asup | sch | remotesupport | timezone]

Syntax Description

Option

Required or Optional

Description

asup

One of set required.

Commands supported in the autosupport (ASUP) configuration namespace.

dns

One of set required.

Commands supported in the storage DNS configuration namespace.

ntp

One of set required.

Commands supported in the storage NTP configuration namespace.

remotesupport

One of set required.

Commands supported for support remote access.

sch

One of set required.

Commands supported in the Smart Call Home configuration namespace.

smtp

One of set required.

Commands supported in the storage SMTP for autosupport configuration namespace.

timezone

One of set required.

Commands supported in the timezone configuration namespace.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services command with at least one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

stcli services smtp Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

The HX Data Platform Simple Mail Transfer Protocol (SMTP) configuration options. SMTP is an Internet standard for email transmission. The SMTP servers are used with the HX ASUP feature.

stcli services smtp [-h] {show | set | clear}

Syntax Description

Option

Required or Optional

Description

clear

One of set required.

Removes all SMTP servers from the storage cluster configuration settings.

set

One of set required.

Add all SMTP servers to the storage cluster configuration.

show

One of set required.

Lists all SMTP servers configured for the storage cluster.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services smtp command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services smtp show Command

- stcli services smtp set Command

- stcli services smtp clear Command

stcli services smtp show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays the storage cluster configured SMTP servers.

stcli services smtp show [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services smtp show command to view all SMTP servers in storage cluster configuration.

# stcli services smtp show

smtpServer: mailhost.eng.mycompany.com
fromAddress: admin@mycompany.com

stcli services smtp set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Adds SMTP servers to the storage cluster configuration settings.

stcli services smtp set [-h] --smtp SMTPSERVER --fromaddress FROMADDRESS

Syntax Description

Option

Required or Optional

Description

--smtp SMTPSERVER

Required.

The hosting address of the SMTP server.

--fromaddress FROMADDRESS

Required.

Email address to send Auto Support emails from. The address used by the SMTP server to send email notifications to the recipients.

Command Default

None. Server information is required.

Usage Guidelines

Accompany the stcli services smtp set command with the required parameters.

To verify the SMTP servers are configured, check the /etc/msmtprc file.

# stcli services smtp set --smtp mailhost.eng.mycompany.com --fromAddress smtpnotice@mycompany.com

stcli services smtp clear Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Removes all SMTP servers from the storage cluster configuration settings.

stcli services smtp clear [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services smtp clear command to remove all SMTP servers from storage cluster configuration.

To verify the SMTP servers are removed, check that the /etc/msmtprc file is missing.

# stcli services smtp clear

stcli services dns Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Domain Name Server (DNS) server configuration operations. DNS is a hierarchical distributed naming system for computers, services, or any resource connected to the Internet or a private network.

stcli services dns [-h] {show | set | add | remove}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Adds servers to the DNS server list.

set

One of set required.

Replace the DNS server list with this new list.

show

One of set required.

Show the DNS server list.

remove

One of set required.

Delete a server from the DNS server list.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services dns command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services dns show Command

- stcli services dns set Command

- stcli services dns add Command

- stcli services dns remove Command

stcli services dns show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays the DNS server list.

stcli services dns show [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services dns show command.

# stcli services dns show

10.64.1.8
10.64.1.9

stcli services dns set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Replaces existing list of servers in the DNS server list. Deletes current list To add servers to an existing list, use dns add.

stcli services dns set [-h] --dns DNSSERVER [DNSSERVER . . .]

Syntax Description

Option

Required or Optional

Description

--dns DNSSERVER [DNSSERVER . . .]

Required.

List at least one server to replace the current list of DNS servers.

Command Default

None. At least one server ID is required.

Usage Guidelines

Accompany the stcli services dns set command with at least one DNS server ID. Separate servers with a space.

# stcli services dns set --dns 10.60.1.1

stcli services dns add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Adds servers to the DNS server list.

stcli services dns add [-h] --dns DNSSERVER [DNSSERVER . . .]

Syntax Description

Option

Required or Optional

Description

--dns DNSSERVER [DNSSERVER . . .]

Required.

List at least one server to add to the list of DNS servers.

Command Default

None. At least one server ID is required.

Usage Guidelines

Accompany the stcli services dns add command with at least one DNS server ID. Separate servers with a space.

# stcli services dns add --dns 10.60.8.9

stcli services dns remove Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Removes one or more or all servers from the existing list of servers in the DNS server list.

stcli services dns remove [-h] --dns DNSSERVER [DNSSERVER . . .]

Syntax Description

Option

Required or Optional

Description

--dns DNSSERVER [DNSSERVER . . .]

Optional.

List at least one server to delete from the current list of DNS servers.

Command Default

Default removes all DNS servers from the list.

Usage Guidelines

Accompany the stcli services dns remove command with none, one, or more DNS server IDs. Separate servers with a space.

# stcli services dns remove --dns 10.60.6.7

stcli services ntp Commands

The HX Data Platform Network Time Protocol (NTP) configuration operations.

NTP is a protocol that is used to synchronize computer clock times in a network of computers so that you can correlate events when you receive system logs and other time-specific events from multiple network devices. NTP uses the User Datagram Protocol (UDP) as its transport protocol. All NTP communications use Coordinated Universal Time (UTC).

stcli services ntp [-h] {add | set | show | remove}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Add one or more servers to the list of storage NTP servers.

set

One of set required.

Replace the existing list of NTP servers with the listed DNS servers.

show

One of set required.

Display the list of storage NTP servers.

remove

One of set required.

Remove one or more servers from the list of storage NTP servers.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services ntp command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services ntp add Command

- stcli services ntp set Command

- stcli services ntp show Command

- stcli services ntp remove Command

stcli services ntp add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Add one or more servers to the list of storage DNS servers.

stcli services ntp add [-h] --ntp NTPSERVER [NTPSERVER . . .]

Syntax Description

Option

Required or Optional

Description

--ntp NTPSERVER [NTPSERVER . . .]

Required.

Add one or more servers to the list of storage NTP servers.

Command Default

None. At least one server ID is required.

Usage Guidelines

Accompany the stcli services ntp add command with at least one server ID.

# stcli services ntp add --ntp 136.158.1.0

stcli services ntp set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Replaces existing list of NTP servers with new list. To add servers to an existing list, use ntp add.

stcli services ntp set [-h] --ntp NTPSERVER [NTPSERVER . . .]

Syntax Description

Option

Required or Optional

Description

--ntp NTPSERVER [NTPSERVER . . .]

Required.

Provide one or more servers to replace the current the list of storage NTP servers.

Command Default

None. At least one server ID is required.

Usage Guidelines

Accompany the stcli services ntp set command with at least one server ID.

# stcli services ntp set --ntp 10.12.1.1

stcli services ntp show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Display the list of storage DNS servers.

stcli services ntp show [-h]

Command Default

No options available.

Usage Guidelines

Run the stcli services ntp show command.

# stcli services ntp show

0.company.pool.ntp.org
ntp.ubuntu.com

stcli services ntp remove Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Delete one or more servers from the list of storage DNS servers.

stcli services ntp remove [-h] --ntp NTPSERVER [NTPSERVER . . .]

Syntax Description

Option

Required or Optional

Description

--ntp NTPSERVER [NTPSERVER . . .]

Optional.

Remove one or more servers from the list of storage DNS servers.

Command Default

Default removes all NTP servers from the list of storage NTP servers.

Usage Guidelines

Accompany the stcli services ntp remove command with at least one server ID.

# stcli services ntp remove --ntp 136.158.1.0

stcli services asup Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

This section lists and describes the Cisco Automatic Support (ASUP) commands. ASUP enables you to proactively obtain information about failures and responds immediately. It also helps in planning system performance and capacity.

Note

ASUP relies on SMTP. Before you enable ASUP, ensure that you configure SMTP in your network.

stcli services asup [-h] {enable | disable | show | recipients}

Syntax Description

Option

Required or Optional

Description

disable

One of set required.

Disables ASUP.

enable

One of set required.

Enables ASUP.

recipients

One of set required.

Commands to support ASUP recipients list configuration.

show

One of set required.

Shows the ASUP configuration.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services asup command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services asup enable Command

- stcli services asup disable Command

- stcli services asup show Command

- stcli services asup recipients Commands

stcli services asup enable Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Enables HX auto support (ASUP) support.

stcli services asup enable [-h]

Command Default

No additional options.

Usage Guidelines

1. Ensure SMTP is configured. See the stcli services asup smtp command.

2. Run the stcli services asup enable command.

# stcli services asup enable

stcli services asup disable Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Disables HX auto support (ASUP) support.

stcli services asup disable [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services asup disable command.

# stcli services asup disable

stcli services asup show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Shows the ASUP configuration, this includes the ASUP recipient list and whether ASUP is enabled or disabled.

stcli services asup show [-h]

Command Default

No additional options available.

Usage Guidelines

Run the stcli services asup show command to list the applied ASUP settings.

This sample response indicates that ASUP is not enabled and there are no email addresses in the recipient list.

# stcli services asup show

recipientList:
enabled: False

stcli services asup recipients Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX auto support (ASUP) recipient configuration operations.

stcli services asup recipients [-h] {set | clear | add | remove}

Syntax Description

Option

Required or Optional

Description

add

One of set required.

Adds ASUP email recipients to an existing list of ASUP recipients.

clear

One of set required.

Deletes the entire ASUP recipient list. To remove individual recipients, use asup recipients remove.

remove

One of set required.

Deletes the specified ASUP email recipients from an existing list.

set

One of set required.

Sets the ASUP recipient list. Replaces previously set list of recipients. To add recipients to an existing list, use asup recipients add.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services asup recipients command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- Use clear option to delete all recipients from an existing list of recipients.

- Use remove option to delete specific email addresses from the list of recipients.

- Use add option to add new email addresses to the list of recipients.

- Use set option to replace the previous list of recipients with a new list of recipients.

- stcli services asup recipients set Command

- stcli services asup recipients clear Command

- stcli services asup recipients add Command

- stcli services asup recipient remove Command

stcli services asup recipients set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Replaces an existing list of ASUP email recipients with a provided list of email addresses. This deletes all recipients on the existing list. To add recipients to an existing list and not deleted the existing recipients, use asup recipients add.

stcli services asup recipients set [-h] --recipients RECIPIENTS [RECIPIENTS . . .]

Syntax Description

Option

Required or Optional

Description

--recipients RECIPIENTS [RECIPIENTS . . .]

Required.

Add one or more email addresses to replace the existing list of recipients to receive ASUP notifications. Separate email recipients with a space.

Command Default

None. At least one recipient is required.

Usage Guidelines

Accompany the stcli services asup recipients set command with at least one recipient. Separate multiple recipients with a space between email addresses.

# stcli services asup recipients set --recipients user1@mycompany.com user2@mycompany.com

stcli services asup recipients clear Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Deletes the entire ASUP recipient list. To remove individual recipients, use asup recipients remove.

stcli services asup recipients clear [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services asup recipients clear command to delete all email addresses from the recipient list.

stcli services asup recipients add Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Adds ASUP email recipients to an existing list of ASUP recipients. The existing list can be currently empty. Use this command to add one or more recipients.

stcli services asup recipients add [-h] --recipients RECIPIENTS [RECIPIENTS . . .]

Syntax Description

Option

Required or Optional

Description

--recipients RECIPIENTS [RECIPIENTS . . .]

Required.

Add one or more email addresses to the current list of recipients that receive ASUP notifications.

Command Default

None. At least one recipient is required.

Usage Guidelines

Accompany the stcli services asup recipients add command with at least one recipient. Separate multiple recipients with a space between email addresses.

# stcli services asup recipients add --recipients user1@mycompany.com user2@mycompany.com

stcli services asup recipient remove Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Deletes the specified individual email recipients from an existing list of ASUP recipients.

stcli services asup recipients remove [-h] --recipients RECIPIENTS [RECIPIENTS . . .]

Syntax Description

Option

Required or Optional

Description

--recipients RECIPIENTS [RECIPIENTS . . .]

Required.

Delete individual email addresses from the current list of recipients that receive ASUP notifications.

Command Default

None. At least one recipient is required.

Usage Guidelines

Accompany the stcli services asup recipients remove command with at least one recipient. Separate multiple recipients with a space between email addresses.

# stcli services asup recipients remove --recipients user1@mycompany.com user2@mycompany.com

stcli services sch Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

This section lists and describes the Cisco Smart Call Home (SCH) commands. Smart call home provides continuous monitoring, proactive diagnostics, alerts, service ticket notifications, and remediation recommendations about the HX storage cluster to the designated ASUP customer contacts. It also provides a means to provide the information through HTTPS and a proxy server, if needed.

Note

If your HX storage cluster is behind a firewall, a proxy server is required for access.

The stcli services cli support both HTTP and HTTPS proxy.

stcli services sch [-h] {enable | disable | show | ping | clear | set}

Syntax Description

Option

Required or Optional

Description

clear

One of set required.

Clears the smart call home configuration.

disable

One of set required.

Disables smart call home.

enable

One of set required.

Enables smart call home.

ping

One of set required.

Pings the smart call home endpoint.

set

One of set required.

Commands for smart call home registration, including proxy server for HTTPS access

show

One of set required.

Shows the smart call home configuration.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services sch command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services sch enable Command

- stcli services sch disable Command

- stcli services sch show Command

- stcli services sch ping Command

- stcli services sch clear Command

- stcli services sch set Command

stcli services sch enable Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Enables HX smart call home. See stcli services sch set to configure the notification email address.

stcli services sch enable [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services sch enable command.

# stcli services sch enable

stcli services sch disable Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Disables HX smart call home.

stcli services sch disable [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services sch disable command.

# stcli services sch disable

stcli services sch show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Shows the smart call home configuration, this includes configured notification email and proxy settings, and whether smart call home is enabled or disabled.

stcli services sch show [-h]

Command Default

No additional options available.

Usage Guidelines

Run the stcli services sch show command to list the applied smart call home settings.

This sample response indicates that smart call home is enabled, but the email addresses and proxy settings are not configured.

# stcli services sch show

proxyPort: 0
proxyUser:
enabled: True
proxyPassword:
cloudEnvironment: production
proxyUrl:
emailAddress:
portalUrl:
cloudAsupEndpoint: https://diag-hyperflex.io/

stcli services sch ping Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Pings the Smart Call Home endpoint.

stcli services sch ping [-h]

Command Default

No options.

Usage Guidelines

Run the stcli services sch ping command.

This example shows:

# stcli services sch ping

ping to callhome endpoint was successful

stcli services sch clear Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Removes the smart call home email and proxy settings from the storage cluster configuration.

stcli services sch clear [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services sch clear command to remove the smart call home notification email and proxy settings from storage cluster configuration.

# stcli services sch clear

stcli services sch set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Configures the smart call home service required contact and proxy server.

Important

Please enter password when prompted.

The stcli services cli support both HTTP and HTTPS proxy.

stcli services sch set [-h] --email EMAILADDRESS [--proxy-url PROXYURL] [--proxy-port PROXYPORT] [--proxy-user PROXYUSER] [--portal-url PORTALURL] [--enable-proxy ENABLEPROXY]

Syntax Description

Option

Required or Optional

Description

--email EMAILADDRESS

Required.

Add an email address for someone to receive email from Cisco support. Recommendation is to use a distribution list or alias.

--enable-proxy ENABLEPROXY

Optional.

Explicitly enable or disable use of proxy.

--portal-url PORTALURL

Optional.

Specify an alternative Smart Call Home portal URL, if applicable.

--proxy-url PROXYURL

Optional.

Specify the HTTP or HTTPS proxy URL, if applicable.

--proxy-port PROXYPORT

Optional.

Specify the HTTP or HTTPS proxy port, if applicable.

--proxy-user PROXYUSER

Optional.

Specify the HTTP or HTTPS proxy user, if applicable.

Specify the HTTP or HTTPS proxy password, when prompted.

Command Default

None. Email address is required. Proxy server is not configured by default.

Usage Guidelines

Accompany the stcli services sch set command with an email recipient address. Set the proxy server if your HX storage cluster is behind a firewall.

To use the smart call home service, ensure it is enabled. See the stcli services sch show and stcli services sch enable commands.

# stcli services sch set --email alias@mycompany.com

stcli services remotesupport Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

This section lists and describes the remote support commands. This command allows Cisco support to access your HX storage cluster to collect information about cluster operations, for example, configured notification email and proxy settings and support triggered support bundles.

This is enabled by default.

stcli services remotesupport [-h] {set | show}

Syntax Description

Option

Required or Optional

Description

set

One of set required.

Commands to configure remote support.

show

One of set required.

Shows the remote support configuration.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services remotesupport command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services remotesupport set Command

- stcli services remotesupport show Command

stcli services remotesupport set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Set configuration for remote support access and actions.

stcli services remotesupport set [-h] --enable ENABLE_RS_VALUE [--enable-support-bundle-action ENABLE_RSB_VALUE]

Syntax Description

Option

Required or Optional

Description

--enable ENABLE_RS_VALUE

Required.

Enable or disable remote support. Specify either value true or false.

--enable-support-bundle-action ENABLE_RSB_VALUE

Optional.

Enable or disable support bundle actions. Specify either true or false.

Allows TAC to remotely trigger building a support bundle.

Command Default

Remote support is enabled by default.

Usage Guidelines

Accompany the stcli services remotesupport set command with the required parameter.

# stcli services remotesupport set --enable false

stcli services remotesupport show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Shows the remote support configuration, this includes configured notification email and proxy settings, and whether remote support is enabled or disabled and if support triggered support bundles are enabled or disabled.

stcli services remotesupport show [-h]

Command Default

No additional options available.

Usage Guidelines

Run the stcli services remotesupport show command to list the applied settings.

This sample response indicates that remote access by support and remotely triggering support bundles are enabled.

# stcli services remotesupport show

enableSupportBundleAction: True
enabled: True

stcli services timezone Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX Data Platform timezone configuration operations.

stcli services timezone [-h] {show | set}

Syntax Description

Option

Required or Optional

Description

set

One of set required.

Specifies the time zone for the controller VMs.

show

One of set required.

Displays the system time zone that is currently set.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli services timezone command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli services timezone show Command

- stcli services timezone set Command

stcli services timezone show Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Displays the system time zone that is currently set for the controller VMs.

stcli services timezone show [-h]

Command Default

No additional options.

Usage Guidelines

Run the stcli services timezone show command to view the timezone currently set.

# stcli services timezone show

America/New_York

stcli services timezone set Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Specifies the time zone for the controller VMs.

stcli services timezone set [-h] --timezone TIMEZONE

Syntax Description

Option

Required or Optional

Description

--timezone TIMEZONE

Required.

Specify a value for the time zone.

For a list of valid time zone values, go to:

http://manpages.ubuntu.com/manpages/jaunty/ma%20n3/DateTime::TimeZone::Catalog.3pm.html

- Ensure that you specify a (case-sensitive) value for the time zone only from this list; for example: Europe/Paris or America/Los_Angeles.

- Any value that is not in this list is invalid.

- If you specify an invalid time zone, the system reverts to GMT.

Command Default

None. Timezone is required.

Usage Guidelines

Accompany the stcli services timezone set command with a valid timezone.

# stcli services timezone set --timezone America/Los_Angeles

stcli file clone Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a HX clone for the given file.

stcli file clone [-h] --name NAME --clone CLONE [--parentname PARENTNAME] [--replfirst] [--repl] [--readonly] [--thick]

Syntax Description

Option

Required or Optional

Description

--clone CLONE

Required.

Name to assign to the file clone.

--name NAME

Required.

Name of the file to be cloned.

--parentname PARENTNAME

Optional.

Name of the parent file of the file to be cloned.

--replfirst

Optional.

First replication file clone.

--repl

Optional.

Replication file clone.

--readonly

Optional.

Read only file clone.

--thick

Optional.

Thick file clone.

Command Default

None. File name and clone name required.

Usage Guidelines

Accompany the stcli file clone command with the positional arguments and optionally the arguments enclosed in [ ].

stcli snapshot-schedule Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Enables or disables native snapshot schedules for all the objects in this cluster.

stcli snapshot-schedule [-h] {--enable | --disable}

Syntax Description

Option

Required or Optional

Description

--enable

One of set required.

Enable the native snapshot schedule.

--disable

One of set required.

Disable the native snapshot schedule.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli snapshot-schedule command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

Use the HX Data Platform plug-in to create the native snapshot schedule. This command allows you to disable the schedule and re-enable it without requiring you to rebuild the schedule.

stcli vm Commands

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

HX Data Platform VM ReadyClone and Native Snapshot operations.

stcli vm [-h] {clone | snapshot}

Syntax Description

Option

Required or Optional

Description

clone

One of set required.

Creates a specified number of ReadyClones for the given VM.

snapshot

One of set required.

Creates a native snapshot for the given VM.

Command Default

None. One option from the set is required.

Usage Guidelines

Accompany the stcli vm command with one of the positional arguments enclosed in { } or optional arguments enclosed in [ ].

- stcli vm clone Command

- stcli vm snapshot Command

stcli vm clone Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a specified number of ReadyClones for the given VM.

stcli vm clone [-h] {--id ID | --name NAME} --clone CLONE --number NUMBER [--poweron] [--custspec CUSTSPEC] [--guestname GUESTNAME] [--startnumber STARTNUMBER] [--increment INCREMENT] [--resourcepool-id RP-ID | --resourcepool-name RP-NAME]

Syntax Description

Option

Required or Optional

Description

--clone CLONE

Required.

Name of the ReadyClone.

--id ID

One of set required.

ID of source VM. The ID is listed in the stcli cluster info command.

--name NAME

One of set required.

Name of the source VM.

-number NUMBER

Required.

Number of ReadyClones to create.

--custspec CUSTSPEC

Optional.

Guest customization spec for the ReadyClones. See vCenter Customize Guest OS feature.

--guestname GUESTNAME

Optional.

Specify a guest name for the ReadyClones so it can be different from source VM name.

Default is the DNS name for the host. This name must be DNS resolvable before specifying it.

--increment INCREMENT

Optional.

Suffix to use for incrementing the ReadyClone names.

Note

Do not try to increment clone numbers using a value = or > 10000000000.

--poweron

Optional.

Power on the created ReadyClone after cloning.

--resourcepool-id RP-ID

Optional.

ID of the resource pool to place the ReadyClones.

--resourcepool-name RP-NAME

Optional.

Name of the resource pool to place the ReadyClones.

--startnumber STARTNUMBER

Optional.

Starting number for the incrementing suffix for the ReadyClone names.

Command Default

None. Specified options are required.

Usage Guidelines

Accompany the stcli vm clone command with one of the required positional arguments listed and optionally, arguments enclosed in [ ].

stcli vm snapshot Command

Note

The stcli commands are being deprecated. We recommend that you use the hxcli Commands instead.

Creates a native snapshot for the given VM.

stcli vm snapshot [-h] {id ID | --name NAME | --folder-id FOLDER-ID | --folder-name FOLDER-NAME | --resourcepool-id RP-ID | --resourcepool-name RP-NAME} --snapshot SNAPSHOT [--desc DESC] [--memory | --quiesce]

Syntax Description

Option

Required or Optional

Description

--snapshot SNAPSHOT

Required.

Name of the native snapshot.

-folder-id FOLDER-ID

One of set required.

ID of the folder used to create the native snapshot.

--folder-name FOLDER-NAME

One of set required.

Name of the folder used to create the native snapshot.

--id ID

One of set required.

ID of the source VM used to create the native snapshot.

--name NAME

One of set required.

Name of the source VM used to create the native snapshot.

--resourcepool-id RP-ID

One of set required.

ID of the resource pool used to create the native snapshot.

--resourcepool-name RP-NAME

One of set required.

Name of the resource pool used to create the native snapshot.

--desc DESC

Optional.

Description of the native snapshot.

--memory

One of pair optional.

Memory for the native snapshot.

--quiesce

One of pair optional.

Quiesce the file system in the virtual machine.

Command Default

None. Specified options are required.

Usage Guidelines

Accompany the stcli vm snapshot command with one of the required positional arguments listed and optionally, arguments enclosed in [ ].

Communications, Services, Bias-free Language, and Additional Information

- To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.

- To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.

- To submit a service request, visit Cisco Support.

- To discover and browse secure, validated enterprise-class apps, products, solutions and services, visit Cisco Marketplace.

- To obtain general networking, training, and certification titles, visit Cisco Press.

- To find warranty information for a specific product or product family, access Cisco Warranty Finder.

Documentation Feedback

To provide feedback about Cisco technical documentation, use the feedback form available in the right pane of every online document.

Cisco Bug Search Tool

Cisco Bug Search Tool (BST) is a web-based tool that acts as a gateway to the Cisco bug tracking system that maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. BST provides you with detailed defect information about your products and software.

Bias-Free Language

The documentation set for this product strives to use bias-free language. For purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on standards documentation, or language that is used by a referenced third-party product.

Full Cisco Trademarks with Software License

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.

Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)