Dell Unity: How to Use UEMCLI Commands

Summary: The article describes how to start using UEMCLI on Unity arrays for array management, configuration or monitoring.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Goal

This article contains helpful information in order to start using Unisphere CLI (UEMCLI). This includes: 

  • The tool/utility you need to install before being able to run UEMCLI commands from a management station or PC.
  • How to access UEMCLI commands as a service user over SSH, without the need to install the Unisphere CLI utility.
  • UEMCLI command examples.
  • UEMCLI command guide reference.

Facts

Dell Unity arrays can be managed and monitored through the Unisphere UI, Unisphere CLI or the REST API. This article discusses the Unisphere CLI option.

Solution

UEMCLI commands can run using two methods:

  1. From a host or PC which has the Unisphere CLI tool installed.

  2. Through SSH.

Both methods require that you are on the same management network as the Storage Processors.

Using The Unisphere CLI Tool

To download and install Unisphere CLI (UEMCLI):

  1. Navigate to Downloads on the Unity product support page.
  2. Expand the Product Tools section.
  3. Locate Unisphere CLI (UEMCLI) in the list of available tools for the supported operating systems.
  4. Download the version that matches the target operating system.
  5. Install the tool according to the installation procedure for the selected operating system.

After installation, and the installation directory being added to the PATH system variable, you can now launch UEMCLI.

To verify that the installation completed successfully, open a Windows command prompt or shell and enter the following command:

uemcli.exe

On Linux, open a terminal window and enter the following command:

/usr/bin/uemcli

 

Note: These commands should show a help page showing various available options to run.

The following syntax is required to connect to the Unity primary SP and execute commands:

uemcli.exe -d <management IP> -u <user> -p <password> <object path> <action>

 

Note: Additional object and action qualifiers are available to provide greater control over which objects are targeted.

Using SSH

Alternatively, the primary SP can be accessed directly through an SSH client. SSH access must first be enabled on the Unity array using the Unisphere UI.

System > Service > Service Tasks > Enable SSH > Execute
Unisphere path to enable SSH 

Note: This prompts for the service account password.

Once SSH access is enabled, connect to the Unity management IP address using an SSH client and authenticate with the service user credentials. UEMCLI commands can then be run directly from the SSH session without specifying the IP address or user credential parameters in the command syntax.

UEMCLI Command Syntax and Usage

UEMCLI commands always require an object path to identify the object being viewed or configured. For example, to display storage pools on the system, use the following command syntax:

uemcli /stor/config/pool show

The /stor/config/pool is the object path part of the command and show is the action to run on all objects under that path.
To see all the available object paths, type:

uemcli / --help

To see available actions to run on a certain object, type:

uemcli <object path> --help


command structure explanation 

Affected Products

Dell EMC Unity, Dell EMC Unity XT 380, Dell EMC Unity XT 380F, Dell EMC Unity XT 480, Dell EMC Unity XT 480F, Dell EMC Unity XT 680, Dell EMC Unity XT 680F, Dell EMC Unity Family |Dell EMC Unity All Flash, Dell EMC Unity Hybrid

Products

Dell Unity 450F DC, Dell Unity 300 DC, Dell Unity 350F DC, Dell Unity 400 DC, Dell EMC Unity XT 880, Dell EMC Unity XT 880F, Dell Unity Operating Environment (OE)
Article Properties
Article Number: 000205901
Article Type: How To
Last Modified: 21 Aug 2026
Version:  13
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.