Supported Unified Manager CLI commands
As a storage administrator you can use the CLI commands to perform queries on the storage objects; for example, on clusters, aggregates, volumes, qtrees, and LUNs. You can use the CLI commands to query the Unified Manager internal database and the ONTAP database. You can also use CLI commands in scripts that are executed at the beginning or end of an operation or are executed when an alert is triggered.
All commands must be preceded with the command um cli login
and a valid user name and password for authentication.
For running the um run command, ensure that your account has the console application access. |
CLI command | Description | Output |
---|---|---|
|
Logs in to the CLI. Because of security implications, you should enter only the user name following the "-u" option. When used in this manner you will be prompted for the password, and the password will not be captured in the history or process table. The session expires after three hours from the time of login, after which the user must login again. |
Displays the corresponding message. |
|
Logs out of the CLI. |
Displays the corresponding message. |
|
Displays all first level subcommands. |
Displays all first level subcommands. |
|
The simplest way to run a command on one or more hosts. Mainly used for alert scripting to get or perform an operation on ONTAP. The optional timeout argument sets a maximum time limit (in seconds) for the command to complete on the client. The default is 0 (wait forever). |
As received from ONTAP. |
|
Executes an SQL query. Only queries that read from the database are allowed. Any update, insert, or delete operations are not supported. |
Results are displayed in a tabular form. If an empty set is returned, or if there is any syntax error or bad request, it displays the appropriate error message. |
|
Adds a datasource to the list of managed storage systems. A datasource describes how connections to storage systems are made. The options -u (username) and -P (password) must be specified when adding a datasource. The option -t (protocol) specifies the protocol used to communicate with the cluster (http or https). If the protocol is not specified, then both protocols will be attempted The option -p (port) specifies the port used to communicate with the cluster. If the port is not specified, then the default value of the appropriate protocol will be attempted. This command can be executed only by the storage admin. |
Prompts for the user accept the certificate and prints the corresponding message. |
|
Displays the datasources for managed storage systems. |
Displays the following values in tabular format: |
|
Modifies one or more datasource options. Can be executed only by the storage admin. |
Displays the corresponding message. |
|
Removes the datasource (cluster) from Unified Manager. |
Displays the corresponding message. |
|
Lists all the options that you can configure using the set command. |
Displays the following values in tabular format: |
|
Sets one or more options. The command can be executed only by the storage admin. |
Displays the corresponding message. |
|
Displays the Unified Manager software version. |
|
|
Lists the LUNs after filtering on the specified object. -q is applicable for all commands to show no header. ObjectType can be lun, qtree, cluster, volume, quota, or svm. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the LUNs within the cluster with ID 1. |
Displays the following values in tabular format: |
|
Lists the storage VMs after filtering on the specified object. ObjectType can be lun, qtree, cluster, volume, quota, or svm. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the storage VMs within the cluster with ID 1. |
Displays the following values in tabular format: |
|
Lists the qtrees after filtering on the specified object. -q is applicable for all commands to show no header. ObjectType can be lun, qtree, cluster, volume, quota, or svm. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the qtrees within the cluster with ID 1. |
Displays the following values in tabular format: |
|
Lists the disks after filtering on the specified object. ObjectType can be disk, aggr, node, or cluster. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the disks within the cluster with ID 1. |
Displays the following values in tabular format |
|
Lists the clusters after filtering on the specified object. ObjectType can be disk, aggr, node, cluster, lun, qtree, volume, quota, or svm. For example:
In this example, "-aggr" is the objectType and "1" is the objectId. The command lists the cluster to which the aggregate with ID 1 belongs. |
Displays the following values in tabular format: |
|
Lists the cluster nodes after filtering on the specified object. ObjectType can be disk, aggr, node, or cluster. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the nodes within the cluster with ID 1. |
Displays the following values in tabular format |
|
Lists the volumes after filtering on the specified object. ObjectType can be lun, qtree, cluster, volume, quota, svm, or aggregate. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the volumes within the cluster with ID 1. |
Displays the following values in tabular format |
|
Lists the quota users after filtering on the specified object. ObjectType can be qtree, cluster, volume, quota, or svm. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the quota users within the cluster with ID 1. |
Displays the following values in tabular format |
|
Lists the aggregates after filtering on the specified object. ObjectType can be disk, aggr, node, cluster, or volume. For example:
In this example, "-cluster" is the objectType and "1" is the objectId. The command lists all the aggregates within the cluster with ID 1. |
Displays the following values in tabular format |
|
Acknowledges one or more events. |
Displays the corresponding message. |
|
Resolves one or more events. |
Displays the corresponding message. |
|
Assigns an event to a user. |
Displays the corresponding message. |
|
Lists the events generated by the system or user. Filters events based on source, state, and IDs. |
Displays the following values in tabular format |
|
Restores a MySQL database backup using .7z files. |
Displays the corresponding message. |