Dell Unity 300 Unity™ Family Unisphere® Command L
Dell Unity 300 Manual
View all Dell Unity 300 manuals
Add to My Manuals
Save this manual to your list of manuals |
Dell Unity 300 manual content summary:
- Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 1
Dell Unity™ Family Unisphere® Command Line Interface User Guide Version 5.x Part Number: 302-002-578 April 2022 Rev. 10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 2
of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2016 - 2022 Dell Inc. or its subsidiaries. All rights reserved. Dell - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 3
Contents Additional resources...16 Chapter 1: Introduction...17 Overview...17 Storage types...17 Use Unisphere CLI in scripts...17 Set up the Unisphere CLI client...18 Install the Unisphere CLI client...18 Launch the Unisphere CLI client...18 Certificate verification...18 Unisphere CLI syntax...19 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 4
Change general system settings...37 Manually fail back NAS servers...38 Perform a system health check...38 61 Enable or change Integrated ESRS...61 Check Integrated ESRS network connection...62 Check support credential readiness for integrated ESRS 62 Test Integrated ESRS...63 Request access code - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 5
settings...74 Configure user account settings...75 View user account settings...77 Manage support credentials...78 View support credentials...78 Configure or change support credentials...78 Delete support credentials...79 Manage system limits...79 View system limits...80 View installed feature - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 6
View NAS servers...113 Change NAS server settings...114 Delete NAS servers...117 Check and update user mappings for multiprotocol NAS servers 118 Manage FTP settings...120 Manage LDAP settings of a NAS server...126 Manage NAS interfaces...131 Manage NAS routes...137 Manage Kerberos settings...141 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 7
an FSN...198 View FSN settings...199 Change an FSN...200 Delete an FSN...201 Manage DNS settings...201 Configure DNS settings...202 View default DNS addresses...203 View DNS server domains...203 Configure a DNS domain...203 Manage NTP server settings...204 Create an NTP server record...205 View - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 8
Change NIS server domains...208 Manage SMTP server settings...209 View SMTP server settings...210 Configure SMTP server settings...210 Manage NDMP server settings...211 View NDMP server settings...212 Configure NDMP server settings ...212 Manage LDAP settings...213 Configure LDAP settings...215 View - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 9
Manage host initiator paths...254 View initiator paths...255 Manage iSCSI CHAP accounts for one-way CHAP authentication 255 Create iSCSI CHAP accounts...256 View iSCSI CHAP accounts...256 Change iSCSI CHAP account settings...257 Delete iSCSI CHAP accounts...258 Manage iSCSI connections...258 Create - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 10
...324 Manage FAST VP general settings...326 Change FAST VP general settings...327 View FAST VP general settings...328 Manage FAST Cache (supported physical deployments only 329 Create FAST Cache...329 View FAST Cache settings...330 Extend FAST Cache...330 Shrink FAST Cache...331 Delete FAST - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 11
View recommended drive group configurations 338 Manage storage system capacity settings...339 View system capacity settings...339 Manage system tier capacity settings...340 View system tier capacity...340 Manage file systems...340 Create file systems...346 View file systems...350 Change file system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 12
Delete NFS datastores...416 Manage VMware VMFS datastores...417 Create VMware VMFS datastores...420 View VMware VMFS datastores...423 Change VMware VMFS datastore settings...425 Delete VMware VMFS datastores...427 Refresh thin clones of a VMFS datastore...428 Manage VMware protocol endpoints...429 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 13
Pause replication sessions...493 Resume replication sessions...493 Manually synchronize replication sessions...495 Delete replication sessions...495 only 503 Change encryption setting for KMIP support (physical deployments only 504 Manage KMIP support (physical deployments only 504 View KMIP - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 14
...556 View SNMP destinations...558 Change SNMP destination settings...558 Delete SNMP destinations...559 Chapter 10: Service the System 561 Change the service password...561 Service the system...562 Restart management software...562 Shut down the system...562 Reinitialize the system...563 Collect - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 15
Reboot...568 Reimage...568 Chapter 11: Manage Metrics...569 Manage metrics service...569 View metrics service settings...569 Configure metrics service...570 Manage metrics settings...570 View metrics settings...571 Manage historical metrics values...573 View historical metrics settings...574 Manage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 16
feature documentation or release notes, go to Unity Technical Documentation at: dell.com/unitydocs. Troubleshooting For information about products, software updates, licensing, and service, go to Support (registration required) at: dell.com/ support. After logging in, locate the appropriate product - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 17
and monitoring the system ● Managing users ● Provisioning storage ● Protecting data ● Controlling host access to storage Storage types The Unisphere CLI supports provisioning and management of network block and file-based storage, including: ● File system storage, which contains one or more shares - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 18
task To install the Unisphere CLI client: Steps 1. Go to your support website. 2. Download the Unisphere CLI client for your operating system. 3. default installation location is: ○ 64-bit systems: C:\Program Files (x86)\Dell EMC\Unity\Unisphere CLI ○ 32-bit systems: C:\Program Files\Dell EMC\Unity - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 19
or medium after the RPM package has been installed: low medium (default) The certificate verification process will not be used to access the array bin/setlevel.sh (low|medium|l|m) Then follow the prompts. The tool will guide you through the steps to set the security level. For more information, see - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 20
are always required. Action commands provides details on each of the action commands. Example In the following example for changing the password of a user account, the action is set: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /user/account -id local_user set -passwd NewPassword456! -oldpasswd - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 21
Table 1. Size qualifiers Qualifier K M G T P Measurement Kilobyte Megabyte Gigabyte Terabyte Petabyte Speed qualifiers The following qualifiers are defined for the speed values.The qualifiers are case-insensitive. Table 2. Speed qualifiers Qualifier Measurement Kbps, Kb/s 1,000 bits per - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 22
is creating using the set command. This guide often refers to those actions as configure the set action command to change the password for a user account. The path /user format displays output as a table, with column headers and rows. By default, values that are too long to fit in a column are cut - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 23
Qualifier -filter Description Comma-separated list of attributes which are included into the command output. Name-value pair format 1: ID SP Ports Health state 2: ID SP Ports Health state = la0_SPA = SPA = eth0_SPA,eth1_SPA = OK (5) = la0_SPB = SPB = eth0_SPB,eth1_SPB = OK (5) Table - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 24
|CMD|-upload|-download|-version|-saveUser|-removeUser|-removeAllUsers|default|-certList|-certClear|-certDel|-certImport} [Get help on objects or actions] uemcli [-d ] [-port ] [-u ] [-p ] [-sslPolicy {interactive|reject|accept|store}] [-t ] [-silent - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 25
destination address as the default for this client] uemcli -d -port [-silent] -default [List certificates saved for the object type followed by the -help switch to view a list of supported action commands. Example The following command displays the action commands to set (change - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 26
downloaded from the system. Format -sslPolicy Switch Switch -sslPolicy Description Value is one of the following: ● interactive - Client prompts the user to take action (default). ● reject - Client automatically rejects the certificates. 26 Introduction - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 27
Switch Description ● accept - Client automatically accepts the certificates. ● store - Client automatically accepts and stores the certificates in the lockbox. View certificates View a list of all SSL certificates stored in the lockbox. NOTE: The show action command explains how to change the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 28
password. -timeout|-t Timeout (in seconds) after which you are automatically logged out of the system due to user inactivity or a system problem. The default with their IDs. -certImport Import a certificate from a file. Supported formats are: ● Privacy Enhanced Mail (PEM) ● Distinguished Encoding - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 29
-type and -service parameters. ● -f|-file file type - For file, type the path and filename of the file to upload. For type, type the file type to upload. ● parameter = value - Optional parameter=value pairs for including specific parameters during the upload. NOTE: For a list of supported file types - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 30
necessary to collect this information and to establish a process for sending the file to customer support. ○ config - Save details about the configuration settings on the storage system to a file. Service personnel can use this file to assist you with reconfiguring your system after a major system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 31
send to your service provider to help troubleshoot and resolve system issues. Service account credentials are password, you cannot access the CLI with the service user account with-saveUser enabled. Remove the specified user account from the lockbox. Save the destination and port pair as the default - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 32
supports one set of saved credentials for the system. This means that this switch should not be enabled if the admin and service passwords are different, as this will prevent successful log in of the service through default port 443. -default Save the destination and port pair as the default system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 33
10.0.0.1 as user Local/joe with password 12345: uemcli -d 10.0.0.1 -u Local default: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! -default Example 4 The following example accesses the default upgrade candidate file that you download from the support website and use the -upload qualifier. Once - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 34
you run Unisphere CLI: ● User access credentials, including your username and password, for each system you access. For more information, see the -saveUser address and the system port number. For more information, see the -default switch in View the switches. Unisphere CLI saves the settings to a - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 35
Manage user account settings • Manage support credentials • Manage system limits • Enable or disable automatic failback for SP. ● Manually fail back NAS servers. ● Perform a check NOTE: Failover occurs when there is a hardware or software problem with an SP. This failover causes all NAS servers that - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 36
) Power (Rolling Average) (physical deployments only) Supported SP upgrades(physical deployments only) Description Base value - Working correctly. ● OK BUT (7) - Working correctly, but there could be a problem. ● Degraded/Warning (10) - Working and performing all functions, but the performance may - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 37
Storage system port: 443 HTTPS connection 1: System name = demo Model = Unity 300 UUID Base = 0 System UUID = Product serial number = demo Power (Present) = 572 watts Power (Rolling Average) = 573 watts Supported SP upgrades = SP400, SP500, SP600 Example 2 (virtual deployments only) - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 38
: 443 HTTPS connection Operation completed successfully. Manually fail back NAS servers Manually fail back all failed over NAS servers series of checks on the state of your system to ensure that no underlying problems exist. NOTE: Before upgrading the system software, a system health check must be - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 39
error is preventing the health check from completing successfully. Record the error code and search the EMC Online Support website for available support options. [Error Code: platform::check_boot_control_status_2] Operation completed successfully. NOTE: ● The results of the health check may show - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 40
Example The following command displays the general setting information for the system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/info show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: Contact first name = Zach Contact last name = Arnold Contact - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 41
uploaded to the system manually by a user, or that have been automatically pushed down to the system by support. NOTE: Support will not push down any version. NOTE: This value is empty for downloaded software, firmware, and language packs. Reboot required Pause allowed Image filename Indication - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 42
Reboot required = Pause allowed = Image filename = Unity-Drive-Firmware-V2-Dec-19-2016.tgz.bin.gpg Prepare system software version Prepare an automatically downloaded software image for installation. NOTE: Support will not push down any software images to your system without prior user consent - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 43
: ID = ASD_1 Type = downloaded Version = 4.2.0.9215195 Release date = Image type = software Reboot required = Pause allowed = Image filename = Unity-_dev_001- upgrade-4.2.0.9215195.9215195-4.2.0.9215195.9215195-GNOSIS_DEBUG.tgz.bin.gpg View faulted storage resources This command shows - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 44
sessions. The upgrade session installs an upgrade candidate file that was uploaded to the system. Download the latest upgrade candidate from the support website. Use the -upload switch to upload it to the system before creating the upgrade session. The latest software upgrade candidate contains - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 45
an offline storage processor upgrade rather than an online (default) storage processor upgrade. -pauseBetweenReboots Optional parameter for SP is upgraded. This will allow you to suspend the upgrade until you manually resume the upgrade using /sys/upgrade resume. Example 1 The following command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 46
HTTPS connection Operation completed successfully. Example 4 The following command initiates a software upgrade that pauses after the first SP reboots. uemcli /sys/upgrade create -type software -pauseBetweenReboots Storage system address: 10.64.75.201 Storage system port: 443 HTTPS connection - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 47
website for available support options. [Error Code: platform::check_boot_control_status_2]","Error: One or more LUNs are in degraded state. Record the error code and contact your service provider. [Error Code: flr::check_if_lun_recovery_is_required_2]" Resume upgrade session Resume an existing - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 48
are: ● enabled ● disabled NOTE: Default value is disabled. Indicates the lowest version of the TLS protocol that the system supports for SSL communication. Valid values are: restricted shell enabled for the Service account. Valid values are: ● enabled ● disabled NOTE: Default value is enabled. View - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 49
is specified: ● Replication from or to OE versions earlier than 4.3 are not supported. ● For Unisphere, if a browser is restricted to use TLS 1.1 and to connect with Unity. -restrictedShellEnabled Enables or disables restricted shell on the storage processor for the Service account. Valid values - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 50
Guide for backward compatibility. This change may impact running operations (e.g. replication) and the management services service script to configure the supported TLS protocol versions for a NAS server. For more information about this service script, refer to the Dell EMC Unity Family Service - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 51
Format /sys/time show Example The following command displays the system time: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/time show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: Time = 2011-01-01 03:00:00 Change system time Change the system time. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 52
Operation completed successfully Manage schedule time zone The following table lists the schedule time zone attributes: NOTE: Schedule time zone applies only to snapshot scheduling, and asynchronous replication throttling scheduling. It is not a general system time zone setting. Table 10. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 53
y / n: yes Operation completed successfully. The following command shows all the supported time zones that can be retrieved in the name list: uemcli /sys/ the account on the proxy server. ● Password of the account. ● Whether the support contracts list is updated automatically on a weekly basis - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 54
address of the support services proxy server. Support proxy server port Port number of the support services proxy server Support proxy server user name Name of the account on the support proxy server. Support proxy server password Password of the account on the support proxy server. Automatic - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 55
proxy server. -supportProxyUser Specify the user name of an account on the support services proxy server. -supportProxyPasswd Specify the password for the support services proxy server account. -supportProxyPasswdSecure Specifies the password in secure mode - the user is prompted to input the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 56
contracts on the system. The following table lists the support contracts attributes: Table 12. Support contracts attributes Attributes ID Status Service type Start date Expiration date Description Support contract identifier. State of the support contract. Value is one of the following: ● active - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 57
storage systems associated with the gateway. The ESRS Gateway is a remote support solution application that is installed on one or more customer-supplied dedicated Secondary Address Secondary Port Description Indicates whether the Centralized ESRS service is enabled. Valid values are: ● yes ● no - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 58
cluster as the primary gateway. Example 1 The following command specifies the Centralized ESRS parameters: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/support/esrsc set -enable yes -address 10.10.22.22 Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 59
connectivity from Centralized ESRS to the Dell EMC servers. If there is any failure, Centralized ESRS cannot be enabled. Format /sys/support/esrsc checkNetwork -address [-port ] Action qualifier Qualifier -address -port Description Type the IP address of Centralized ESRS VE. Type - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 60
Center. You can select one of the following remote service connectivity options for Integrated ESRS: ● Outbound/Inbound, which is the default, from the storage system to the Support Center and from the Support Center to the storage system for remote access using https. ● Outbound only from the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 61
yes EULA accepted = yes Type = Two way Enable or change Integrated ESRS Enable or change the Integrated ESRS configuration. Format /sys/support/esrsi set {-enable {yes|no}|-acceptEula yes|-type {oneWay|twoWay}} Action qualifiers Qualifier -enable Description Specifies whether to enable or re - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 62
values are: ● oneWay (Outbound only) ● twoWay (Outbound/Inbound) (default) Example The following command enables Integrated ESRS, accepts the EULA, and sets ESRS: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/support/esrsi set -enable yes -acceptEula yes -type oneWay Storage system address - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 63
command will check the connection back to Dell EMC. Format /sys/support/esrsi test Example 1 The following example shows the results of running this server. To check the status of the actual test, log into Service 360 to view recent Service Requests (SRs). If the call home was received by the ESRS - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 64
that was received by email to the email account user. The received access code will only be valid for 30 minutes. Format /sys/support/esrsi validateAccessCode -accessCode Example The following command displays the response to validating the access code part of the email verification process - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 65
Name of the account on the policy proxy server Proxy password Password of the account on the policy proxy server Proxy protocol Protocol default) View Policy Manager and proxy server configuration View details about the Policy Manager and proxy server configuration. Format /sys/support - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 66
the account on the policy manager proxy server. -proxyPasswd Specifies the password of the account on the policy manager proxy server. -proxyProtocol Example uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/support/esrsi/policymgr set -enable no Storage system address: 10.0.0.1 Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 67
system event and error histories that can be used by support for diagnosing and troubleshooting issues. Table 16. Connect Home attributes Attribute Enabled for Connect Home. uemcli -d 10.0.0.1 -u admin -p Password /sys/support/connecthome show -detail Storage system address: 10.0.0.1 Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 68
. If not specified, a default value formatted as @emc.com will be used. Example This example enables Connect Home and specifies that it will use SMTP server 10.10.22.22. uemcli -d 10.0.0.1 -u local/joe -p Password /sys/support/connecthome set -enable yes - smtpServer 10.10.22.22 Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 69
Table 17. User role attributes (continued) Attributes Description Description ● administrator- Administrator role: Can view system data, edit system settings, and perform all major administrator tasks. ● storageadmin- Storage administrator role: Can view system data and edit settings. Cannot add - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 70
each identity. When users connect to the system through the CLI or Unisphere UI, the system prompts them to type their username and password to gain access. Table 18. User account attributes Attributes ID Description Identifier of the specific user account. Name Account name. Role The role - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 71
a number, and a special character from this list _ ~ ● When changing a password, do not reuse any of the last 3 passwords. -passwdSecure Specifies the password in secure mode - the user will be prompted to input the password and the password confirmation. -role Type the name of the role for the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 72
be 8 to 40 characters in length and cannot contain spaces. ● Passwords must include mixed case, a number, and a special character from this list * ? _ ~ ● When changing a password, do not reuse any of the last 3 passwords. Specifies the password in secure mode. The user will be prompted to input - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 73
the administrator or security administrator role, and only on STIG-enabled systems. Example The following command changes the password for user account user_user1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /user/account -id user_user1 set -passwd NewPassword456! -oldpasswd OldPassword456 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 74
is valid for before it expires. Value range is 1-180 days. An empty value indicates the password does not expire. Default values are: ● Default enabled value: 60 ● Disabled value: no expiration (empty) The number of consecutive failed login attempts allowed within the failed login period before - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 75
all other subsequent options can be specified. If the subsequent options are not specified when user account settings -enabled is set to yes, the default enabled value specified below will be used. The disabled value for these options when user account settings -enabled is set to no are detailed in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 76
is 1-180 days. If neither this value nor -noPasswdPeriod is specified, user account setting default enabled value is 60. NOTE: This setting is not applicable to local admin user accounts. Specifies that the password does not have an expiry period for local user accounts. Specifies the number of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 77
Specifies that the account will remain locked until manually unlocked by an administrator. Specifies the time period If neither this value, nor -noSessionIdleTimeout is specified, the user account settings default enabled value is 600. Specifies that the session will never time out due to - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 78
period = 900 Account lockout period = 3600 Session idle timeout = 600 Default admin lockout enabled = no Manage support credentials Manage support credentials settings on the system, including: ● User name of the user account. ● Password of the user account. The following table lists the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 79
Specify the user name of the support account. Specify the new password of the support account. Specifies the password in secure mode - the user will be prompted to input the password. Example The following command specifies the new password of the support account: uemcli -d 10.0.0.1 -u Local/joe - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 80
Table 21. System limit attributes (continued) Attribute Limit value Threshold value License Description Upper boundary of the limit that cannot be exceeded. Threshold of the specified limit above which the system will generate an alert. License identifier related to the given limit. Some system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 81
View installed feature licenses View details for purchased feature licenses. These licenses were purchased when your system was purchased. You must install licenses on your system before you can use a particular feature or perform tasks, such as creating storage. To install a license, use the - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 82
Name = Internet Small Computer System Interface (iSCSI) Description = This license enables you to use the iSCSI protocol for block storage. Installed = yes Version = 1.1 Issued = 2009-11-09 Expires = 2010-11-09 Health state = OK (5) 2: ID = CIFS Name = Common Internet File System ( - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 83
Example The following command accepts the EULA: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/eula set -agree yes Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Manage Unisphere Central Management/Monitoring Unisphere Central - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 84
Example uemcli /sys/ur create -addr 10.10.0.1 -certificate 2fd4e1c67a2d28fced849ee1bb76e7391b93eb12 -passphrase password Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = ur_0 Operation completed successfully. View remote manager configuration Displays the remote - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 85
ssoEnabled Specify whether you want to set the remote manager as the authentication server for the local system. Valid values are yes or no. The default value is set to no, which indicates that the authentication server is the local system. Example uemcli /sys/ur set -addr 10.10.0.2 Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 86
be identical to any existing remote host address. -port Type the port number on which the host will receive the transferred log information. Default is 514. -protocol Type the protocol for transferring the log files. Valid values are (case-insensitive): ● tcp ● udp -facility Type the facility - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 87
remote host. Value is one of the following (case-insensitive): ● emergency ● alert ● critical ● error ● warning ● notice ● info ● debug NOTE: For example, debug is the default severity. When it is typed, all user/audit logs are sent to the remote host. When emergency is typed, only logs of emergency - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 88
IP address and port combination cannot be identical to any existing remote host address. -port Type the port number on the remote host. Default is 514. -protocol Type the protocol for transferring the log files. Valid values are (case-insensitive): ● tcp ● udp -facility Type the facility that - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 89
remote host. Value is one of the following (case-insensitive): ● emergency ● alert ● critical ● error ● warning ● notice ● info ● debug NOTE: For example, debug is the default severity. When it is typed, all user/audit logs are sent to the remote host. When emergency is typed, only logs of emergency - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 90
Certificate identifier. Type Certificate type. Valid certificate types are: ● CA ● Server ● Client ● TrustedPeer Service Service with which the certificate is associated. The services supported are: ● Mgmt_LDAP ● Mgmt_KMIP ● VASA_HTTP Scope Scope of the certificate. The certificate can have - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 91
/sys/cert -id vasa_http-vc1-cacert-1 show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: - R3 - R3 ID Type Service Scope Trust anchor Version Serial number Signature algorithm Issuer name = vasa_http-vc1-cacert-1 = CA = VASA_HTTP = = no = 2 = 04:00:00:00:00 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 92
assign it to a new schedule. Manage task rules explains how to set up task rules. Manage snapshots explains how to create snapshots manually and manage existing snapshots. Each protection schedule is identified by an ID. The following table lists the attributes for protection schedules. Table 26 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 93
ID = LessProtectionID Name = Less Protection Type = System Rules = RULE_1, RULE2 Sync replicated = no 2: ID = DefaultProtectionID Name = Default Protection Type = System Rules = RULE_3 Sync replicated = no 3: ID = MySchedID Name = MySched1 Type = User Rules = RULE_4 Sync - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 94
Format /sys/task/sched [-id ] delete Object qualifier Qualifier -id Description Type the ID of the schedule to delete. Example The following command deletes schedule MySchedID: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/task/sched -id MySchedID delete Storage system address: - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 95
minutes within an hour. ● hourslist - Task executes everyday on the specified hours and, optionally, on a specific minute within the specified hour. Supports up to two specified hours. ● daysinterval - Task executes on an interval of the specified number of days and, optionally, on a specific hour - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 96
the minutes within the specified hour. Value range is 0:00 - 23:59. Default value is 0:00. If the value of -type is weekdayslist or monthdayslist, yes ● no NOTE: If a synchronous remote connection is established, the default value is yes, otherwise it is no. Example 1 The following command creates - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 97
HTTPS connection ID = RULE_1 Schedule ID = MyScheduleID Operation completed successfully. Example 2 The following command creates a task rule with these settings: ● Assigns the rule to the existing protection schedule MySchedID. ● Takes a snapshot everyday at 8:30 a.m., and 8:30 p.m.: uemcli -d 10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 98
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/task/rule create -schedId MySchedID -type monthdayslist -days 1 Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = RULE_5 Operation completed successfully. Example 6 The following command creates a task rule with - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 99
Keep for = 10h Allow auto-delete = no Access = 2: ID = RULE_2 Type = HoursList Frequency = Every day at 0:20, 8:20, 20:20 Keep for = 1h Allow auto-delete = no Access = ckpt 3: ID = RULE_3 Type = DaysInterval Frequency = Every 2d at 13:20 Keep for = 7d Allow auto-delete = no - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 100
Marengo, New York, Vincennes) Keep for = 1h Allow auto-delete = no Access = 5: ID = RULE_5 Type = MonthDaysList Frequency = Every 1st, 2nd, 3rd day of month at 0:00 ((UTC-05:00) Detroit, Iqaluit, Marengo, New York, Vincennes) Keep for = 1h Allow auto-delete = no Access = Example 3 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 101
- Type the number of minutes after the hour within the range 0 - 59. Default is 0. ● daysinterval, weekdayslist, or monthdayslist - Type the time of a day in minutes within the specified hour. Value range is 0:00 - 23:59. Default value is 0:00. If the value of -type is weekdayslist or monthdayslist - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 102
Example 2 The following command changes the original rule SchedRule_37 with mismatched parameters: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/task/rule -id SchedRule_37 -set -frequency -hours "8,20" -at 30 Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 103
object Description ● Snapshot ● Snapshot schedule Job title. Job state. Value is one of the following: ● Queued ● Running ● Suspended ● Completed ● Completed with problems ● Failed ● Rolling back Describes the result of the step. Current step. User who started the job. Time when the job was started - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 104
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/task/job show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = N-26 Type = Provisioning Title = Create or modify storage resource State = Completed Step = 2 of 2 (Apply iSCSI hosts) Percent complete - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 105
failed -completed Description Identifies the job. Identifies jobs that have failed. Identifies jobs that have completed successfully or completed with problems. Example The following command deletes an existing job. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/task/job -id N-23654 delete - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 106
Manage job step Manage the steps of the specified job. The following table lists the attributes for job step. Table 29. Job step attributes Attribute Title Status Execution result code Execution result description Rollback result code Rollback result description Details Associated object - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 107
Details = ID: "local_pool_8"; Name: "SASx6_2" 2: Title = Create application Status = Completed Execution result code = 0 Execution result description = Rollback result code = 0 Rollback result description = Details = ID: "local_pool_8"; Name: "SASx6_2" 3: Title = Create file system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 108
SMB or NFS protocols. You must configure at least one NAS server before you can create network share storage. You can configure a NAS server to support Windows network shares (SMB), Linux/UNIX network shares, or both. NAS servers run on each SP and communicate with network hosts through SP ports - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 109
of the server. CIFS enabled Multiprotocol sharing enabled Unix directory service Indicates whether SMB file systems are enabled on the NAS server. Value is yes or no. Default is no. SMB file systems provide support for SMB network shares. Indicates whether multiprotocol sharing is enabled - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 110
of the UID and the primary GID, respectively. When using this ID, the user does not need to be defined in the UDS. Default Windows username Default Windows user name that grants file access in the multiprotocol sharing mode. This user name is used for Unix users when the corresponding Windows - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 111
after data reduction savings for this NAS server. Create a NAS server Create a NAS server. NOTE: The NFSv3 protocol is enabled by default when creating a NAS server. Format /net/nas/server create -name -sp {-pool | -poolName } [-tenant ] [-mpSharingEnabled {no - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 112
network namespace. -mpSharingEnabled Indicates whether multiprotocol sharing mode is enabled. Value is yes or no (default). -unixDirectoryService Directory Service used for querying identity information for Unix (such as UIDs, GIDs, net groups). Valid values are: ● nis ● ldap ● local ● none - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 113
servers, including their name, ID, and whether they have enabled support for CIFS (SMB) file systems or NFS file systems. You Interface NFS enabled NFSv4 enabled CIFS enabled Multiprotocol sharing enabled Unix directory service Health state 2: ID Name NetBIOS name = nas_1 = MyFS1 = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 114
= no CIFS enabled = no Workgroup = Windows domain = Multiprotocol sharing enabled = no Unix directory service = none Auto user mapping enabled = Default Unix username = Default Windows username = Extended Unix credentials enabled = no Credentials cache retention = 15m Username - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 115
a NAS server once a file system is created on that NAS server. Directory Service used for querying identity information for Unix (such as UIDs, GIDs, net groups Windows. ● no (default). The Windows authentication fails unless there is a default Unix username configured. Default Unix user name or - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 116
Qualifier Description -defaultWindowsUser Default Windows user name that grants file access in the multiprotocol nas_1 with these settings: ● Enables multiprotocol sharing. ● Uses LDAP as the Unix Directory Service. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/nas/server -id nas_1 set - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 117
, and v4.1) and SMB3+CA. The NDMP jobs must be restarted after the SP modification is completed. Are you sure you want to modify the default SP? yes / no:yes ID = nas_1 Operation completed successfully. NOTE: ● When the SP is being modified, the NAS server health attribute is updated to INFO - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 118
still has SMB (CIFS) servers joined to it, specify the SMB domain user to unjoin from AD before deleting the NAS server. -cifsDomPwd Domain user password. NOTE: Specify the user password when you want to unjoin the CIFS server from the AD domain before deleting it. -cifsDomPwdSecure Domain user - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 119
a user mapping report. A new UID/GID will be obtained from a Unix Directory Service for the user name of the object owner. The user name will be resolved from session, its configuration snapshot is updated every 15 minutes by default. Example 1 The following command generates a user mapping report - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 120
a Unix or Windows user name. You can also have the FTP service to accept anonymous user authentication. Table 31. FTP and SFTP attributes for yes (default) ● no Anonymous user enabled Indicates whether the FTP server supports anonymous user authentication. Valid values are: ● yes (default) ● no - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 121
Table 31. FTP and SFTP attributes for a NAS server (continued) Attribute Description Audit enabled Indicates whether the FTP or SFTP server has audit file collection enabled. Valid values are: ● yes ● no Audit files directory Specifies the directory where the audit files for the FTP or SFTP - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 122
= yes SFTP enabled = no CIFS users enabled = yes Unix users enabled = yes Anonymous user enabled = no Homedir limitation enabled = no Default home directory = /home/public Allowed hosts = 1.2.3.10,1.2.3.11,192.168.0.0/16,2001:db8::/48 Allowed users = Allowed groups = Denied hosts - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 123
are: ● yes ● no -anonymousUserEnabled Indicates whether the FTP server supports anonymous user authentication. Valid values are: ● yes ● no - home directories. Valid values are: ● yes ● no -defaultHomedir Type the default home directory for the FTP or SFTP users with no defined or accessible - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 124
Qualifier -auditDir -auditMaxSize -allowHost -appendAllowHost -removeAllowHost -denyHost -appendDenyHost -removeDenyHost -allowUser -appendAllowUser -removeAllowUser -denyUser Description ● yes ● no Type the directory where the audit files should be saved. Type the maximum size for the audit log - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 125
Qualifier -appendDenyUser -removeDenyUser -allowGroup -appendAllowGroup -removeAllowGroup -denyGroup -appendDenyGroup -removeDenyGroup Description NOTE: If this option is specified, FTP/SFTP connections are denied only for the specified users. Any users not specified in this list are denied access. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 126
can configure a NAS server to use LDAP or NIS as a Unix Directory Service to map users, retrieve netgroups, and build a Unix credential. When an schema (IDMU), IPLANET schema, or an RFC 2307 (open LDAP) schema. By default, the RFC 2307 schema is generated. Once the schema is identified, it is saved - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 127
(DN) used when binding. Bind password (applies to Simple authentication) Specifies the associated password used when binding. Base DN Specifies on the destination. ● Overridden - LDAP list has been manually modified or overridden on the replication destination. Modifications or deletions of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 128
-principal [-realm ] [{-password | -passwordSecure }]} | simple [- . If you want the NAS server to use DNS service discovery to obtain LDAP server IP addresses automatically, do . If LDAPS is used, the default is 363. If LDAP is used, the default port is 389. For a secure - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 129
prompted to enter the password separately. -useCifsAccount (valid only Specify whether you want to use CIFS (SMB) authentication. For Kerberos authentication when kerberos authentication only. Commonly used to configure NAS servers to use IDMU as a UNIX Directory Service. is used) (Choose simple - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 130
Example uemcli -upload -f "LDAP_nas_1.conf" -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/nas/ ldap -server nas_1 -type config Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Download an LDAP schema When an initial LDAP configuration is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 131
belong to a tenant. NOTE: If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about the destination. ● Overridden - indicates that such interface is manually modified / overridden on the destination side. When a replication - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 132
Table 33. Interface attributes (continued) Attribute Description interface is deleted on the source, overridden interfaces stop responding and health state values of such interfaces become degraded/warning. This is because the SMB/ CIFS shares are tightly set to the production IP interfaces, and - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 133
uses the ID to accept packets that have VLAN tags. The value range is 1-4095. NOTE: If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about VLANs. Type the IP address for the interface. The prefix length - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 134
Qualifier -port -server -serverName Description Type the port the interface is associated with. Type the NAS server the interface is associated with. Type the name of the NAS server the interface is associated with. Example 1 The following command displays all NAS interfaces on the system: uemcli - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 135
range is 1-4095. NOTE: If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details on is optional for both IPv4 and IPv6. This qualifier configures the default gateway for the specified port's SP. -preferred Specify this qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 136
Qualifier Description NOTE: This attribute applies to file interfaces only. -replSync Applicable only to NAS server acting as replication destination. Any modification to network address information automatically switches the interface into overridden mode. Valid values are: ● auto ● overridden - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 137
on the value of -type. Value is one of the following: ● For a default route, the system will use the IP address specified for -gateway. ● For a host this attribute is empty. Health state Health details Use for external services access Numerical value indicating the health of the system. Valid - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 138
associated with the route. Each interface has its own routing table for use in responding to inbound service requests. Specify the type of route. Valid values are (case-insensitive): ● default - System uses the default route/gateway when a more specific host or network route is not available. One - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 139
the target network node based on the value of -type. Valid values are: ● For a default route, do not specify a value. The system will use the IP address specified for -gateway to display only the routes that are used for external services. -if Indicate whether you want the system to display only - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 140
= "The component is operating normally. action is required." Replication sync = Use for external services access = no 2: ID = route_2 NAS server = nas_1 Type = default Target = Netmask = Gateway = 10.0.0.2 Interface = if_2 Health state = OK (5) Health details = "The component - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 141
verify users and services. You can configure a secure NFS environment for a multiprotocol NAS server or one that supports Unix-only Kerberos Key Distribution Center (KDC) servers. Port KDC servers TCP port. Default: 88. Configure Kerberos settings Set Kerberos settings for a NAS server. Format - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 142
Qualifier -port -realm Description NOTE: Setting addresses via IP and overriding them is not supported in this release. A fully qualified DNS name is expected. Specifies the TCP port of the KDC server. Value is any TCP port. Identifies the Kerberos - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 143
be displayed. Valid values are 1 to 4095. If omitted, the default value is 1. -count Specifies the number of items to be displayed. Valid values are 1 to 4095. If omitted, the default value is 10. -inUse Valid values are: ● yes - Shows only those VLANs - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 144
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/vlan show -from 100 -inUse yes Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: VLAN = 1 Tenant = if_10 Interface = MTU Size = spa_iom_0_eth1(1300), spb_iom_0_eth1(1300) 2: VLAN = 2 Tenant = Interface = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 145
Action qualifiers Qualifier Description -name Specify the tenant name. -uuid Specify the Universally Unique Identifier of a tenant. -vlan Specify the comma-separated list of VLAN IDs that the tenant can use. NOTE: Valid values are 1 to 4095; however, each specific VLAN ID can be assigned to a - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 146
Change tenant settings Change the settings for a tenant. Format /net/tenant -id set [ -name ] { [-vlan ] | [-addVlan ] | [-removeVlan ] } Object qualifier Qualifier -id Description Identifies the tenant. Action qualifiers Qualifier -name -vlan Description - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 147
CIFS server. NetBIOS name Windows domain Server NetBIOS name. Windows server domain name. User name Password Windows domain user name. Windows domain user password. Last used organization unit Last used Active Directory organizational unit. Workgroup Workgroup name. Workgroup administrator - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 148
-netbiosName Specifies the CIFS server NetBIOS name. By default it is generated automatically based on the CIFS server password. -passwdSecure (valid only when joining the CIFS server to AD) Specifies the password in secure mode. The user will be prompted to input the password and the password - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 149
of the domain to which the CIFS server was previously joined in order to perform the unjoin. You must also specify the user name and password of the new domain to which it will be joined. Format /net/nas/cifs {-id | -name } set [-name ] [-description ] [-netbiosName - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 150
. NOTE: When you delete an existing CIFS server or convert it to a stand-alone configuration, you must specify the current credentials (username and password) to properly unjoin it from the domain and remove the computer account from Active Directory. You can use the -skipUnjoin option to delete the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 151
AD. (This will require the administrator to manually remove the account from AD.) The -skipUnjoin option can also be used when AD is not operational or cannot be reached. If you ran this command without the username and password, you will not be able to join the CIFS server with the same name - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 152
If you configure secure NFS using this method, SMB support cannot be deleted from the NAS server while secure information. Comma-separated list of service principal names to used to authenticate 16 Unix groups. Value is yes or no (default). Credentials cache refreshing timeout, in minutes. Create an - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 153
NAS server. If you configure secure NFS using this method, SMB support cannot be deleted from the NAS server while secure NFS is enabled and password and the password confirmation. -extendedUnixCredEnabled Specifies whether there are more than 16 Unix groups. Valid value is yes or no (default - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 154
NFS server. The FDQN or short name formats are supported. Example uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456 = yes Kerberos KDC type = Windows Service principal name = nfs/SATURN.domain.lab.emc can specify this name when mounting exports. By default, the hostname is the same as the SMB - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 155
server. If you configure secure NFS using this method, SMB support cannot be deleted from the NAS server while secure NFS is service principal in the AD domain. -password (Applies when the -kdcType is Windows.) Specifies the AD domain administrator password. -passwdSecure Specifies the password - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 156
name with administrative rights to unregister the service principal from the AD domain. Specifies the AD domain administrator password. Specifies the password in secure mode. The user will be prompted to input the password and the password confirmation. Deletes the NFS server without automatically - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 157
Object qualifier Qualifier -server Description Identifies the associated NAS server. Example The following command displays the CAVA settings: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/nas/cava show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: NAS - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 158
is enabled. HTTP port HTTP port number for connectivity to the CEPA server. The default value is 12228. The HTTP protocol is used to connect to CEPA servers. It is not protected by a username or password. HTTP enabled Identifies whether connecting to CEPA servers by using the HTTP protocol is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 159
. Timeout Time in ms to determine whether a CEPA server is offline. The default is 1,000 ms. The range is from 50 ms through 5,000 ms. Health server cannot be reached. ● Minor failure (15) - the Events Publishing service is not functional. ● Major failure (20) - all CEPA servers configured for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 160
enabled. -httpPort HTTP port number used for connectivity to the CEPA server. The default value is 12228. The HTTP protocol is used to connect to CEPA servers. It is not protected by a username or password. -httpEnabled Specifies whether connecting to CEPA servers by using the HTTP protocol is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 161
delete operations on the source are automatically reflected on the destination. ● Overridden - indicates that the Events Publishing pool servers list is manually modified or overridden on the destination side. When an Events Publishing pool servers list is created on the source of a replication, it - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 162
Table 43. Event descriptions Value Definition Protocol OpenFileNoAccess Sends a notification when a file is opened for a change other than read or write access (for example, read or write attributes on the file). ● SMB/CIFS ● NFS (v4) OpenFileRead Sends a notification when a file is opened - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 163
Format /net/nas/event/pool create -server -name -addr [-preEvents ] [-postEvents ] [-postErrEvents ] Action qualifiers Qualifier Description -server Identifies the associated NAS server. -name Specifies a CEPA pool name. The name must be unique for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 164
overridden - indicates that the Events Publishing pool servers list is manually changed or overridden on the destination side. When a replicated from the Events Publishing pool servers list on a source Events Publishing service have no effect on an overridden Events Publishing pool servers list on - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 165
requires at least one CEPA pool. If you delete the last CEPA pool, the Events Publishing service becomes disabled. Format /net/nas/event/pool [{-id | -name }] delete Object qualifiers Qualifier -id -name Description Identifies the Events Publishing pool. Identifies the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 166
to be used by the VMware NAS protocol endpoint server. NOTE: Only one VMware protocol endpoint server per NAS server is supported. Create protocol endpoint servers Create VMware protocol endpoints servers for File vVols. Format /net/nas/vmwarepe create [-async] {-server | -serverName - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 167
Qualifier -server -serverName Description Type the identifier of the associated NAS server. Type the name of the associated NAS server. Example The following example shows the details for all of the VMware protocol endpoint servers on the system. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456!/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 168
iSCSI CHAP accounts for one-way CHAP authentication explains the commands for configuring one-way CHAP authentication. NOTE: For reverse CHAP, the secret password you specify applies to all iSCSI nodes on the system. Also, the CHAP secret specified for any host configuration must be different from - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 169
View reverse CHAP secret settings View whether a reverse CHAP secret password has been configured for iSCSI nodes. NOTE: The show action ) allows centralized management of iSCSI devices. An iSNS server can provide services such as remote discovery and configuration for iSCSI nodes and hosts. When - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 170
Action qualifiers Qualifier -server Description Type the name or IP address of the iSNS server. Example The following command creates an iSNS server record for server IP address 10.5.2.128. The server record receives the ID iSNS_10.5.2.128: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 171
Example The following command deletes the iSNS server record isns_0: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/iscsi/isns -id isns_0 delete Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Change iSNS server record settings - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 172
Table 47. ISCSI configuration attributes Attribute Description ● no View iSCSI configuration View details about the iSCSI configuration. Format /net/iscsi/config show Example The following command shows details for the iSCSI configuration: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 173
Manage iSCSI nodes (servers) iSCSI nodes, or iSCSI Servers, are software components on the system that are dedicated to managing operations for data transferred through the iSCSI protocol. iSCSI nodes run on each Ethernet port and communicate with network hosts through the SP ports. iSCSI nodes - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 174
Object qualifier Qualifier -id Description Type the ID of an iSCSI node. Example The following command lists all iSCSI nodes on the system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/iscsi/node show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 175
which the port resides. Value is SPA or SPB. Protocols Types of protocols the port supports. Value is one of the following: ● mgmt - Management interface. ● file - unit (MTU) packet size (in bytes) that the port can transmit. Default is 1500 bytes per packet. Requested MTU size MTU size set by - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 176
identifier assigned to a network device for communications on a network segment. SFP supported speeds List of supported speed values of the inserted Small Form-factor Pluggable. SFP supported protocols List of supported protocols of the inserted Small Form-factor Pluggable. Valid values are - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 177
and 9000. Specific I/O modules may also restrict allowed range for MTU size value. The MTU size values of 1500 bytes (default) and 9000 bytes (jumbo frame) are supported by all interfaces and I/O modules. -speed Type the port speed. Available speed attribute contains the list of valid values. NOTE - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 178
HTTPS connection ID = spa_eth0 ID = spb_eth0 Operation completed successfully. Manage SAS ports (physical deployments only) View the settings for the SAS ports on each SP. The following table describes the port attributes. Table 50. SAS port attributes Attribute Description ID ID of the port. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 179
values are: ● unknown ● RJ45 ● LC ● MiniSAS_HD ● CopperPigtail ● NoSeparableConnector SFP supported speeds List of supported speed values of the inserted Small Form-factor Pluggable. SFP supported protocols List of supported protocols of the inserted Small Form-factor Pluggable. Valid values are - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 180
auto Health state = OK (5) Health details = "The port is operating normally." SFP supported speeds = 4 Gbps, 8 Gbps, 16 Gbps SFP supported protocols = FibreChannel Replication capability = Sync replication SFP supported mode = Multimode Change port settings Change the speed for an FC port - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 181
Object qualifier Qualifier -id Description Type the ID of the FC port. Action qualifier Qualifier Description -speed Type the port speed. Available speed attribute contains the list of valid values. NOTE: The port will be link down temporarily during change of speed. Example The following command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 182
port has been removed. Since the port is not in use, no action is required." Connector type = LC SFP supported speeds = SFP supported protocols = 2: ID = spa_unc5 Name = SP A Uncommitted Port 5 SP = spa Health state = OK (5) Health details = "The Uncommitted port is uninitialized - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 183
SFP supported speeds = SFP supported protocols = Manage Management network interfaces Configure management automatically by DHCP or SLAAC (IPv6 only). ● static- Indicates the IP attributes are set manually. IP address Subnet mask IPv4 or IPv6 address. IPv4 subnet mask. Gateway IPv4 or - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 184
addresses are possible ● static - Indicates the IP attributes are set manually. Specifies the IPv4 or IPv6 address of the interface. Optionally, you length in the following format: /. NOTE: The default prefix length for IPv6 is 64. -netmask Specifies the IPv4 subnet mask - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 185
uses the ID to accept packets that have VLAN tags. The value range is 1-4095. NOTE: If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about VLANs. IP address Subnet mask Gateway MAC address SP Health state - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 186
uses the ID to accept packets that have VLAN tags. The value range is 1-4095. NOTE: If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about VLANs. -addr Specify the IP address for the interface. The prefix - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 187
Object qualifier Qualifier -id -port -type Description Type the ID of an interface. Type the port the interface is associated with. Specify the type of the interface. Valid values are: ● iscsi ● replication Example The following command displays the details of all interfaces on the system. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 188
is 1-4095. NOTE: If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details on is optional for both IPv4 and IPv6. This qualifier configures the default gateway for the specified port's SP. Example The following command changes - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 189
-local subnet so it can reach its destination, whether that destination is a network or host. A static IP route is a host, network, or default route that is configured manually. The system selects a route in order from most specific to least specific, as follows: 1. Host (most specific) 2. Network - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 190
network node based on the specified route type. Valid values are: ● For default, there is no value, as the system will use the specified gateway IP based on the value of -type. Value is one of the following: ● For default, the system will use the IP address specified for -gateway. ● For host, - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 191
HTTPS connection 1: ID = RT_1 Type = net Target = 10.64.74.10 Netmask = 255.255.255.0 Gateway = 10.0.0.1 Interface = IF_1 Health state = OK (5) 2: ID = RT_2 Type = default Target = Netmask = Gateway = 10.64.74.2 Interface = IF_2 Configure Network Communication 191 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 192
= IF_3 Health state = OK (5) Change IP routes Modify an existing IP route. Format /net/route set route -id set [-type {default | host | net}] [-target [netmask ]] [-gateway ] Object qualifier Qualifier -id Description Identifies the route object. Action qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 193
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/route -id RT_1 set -target 10.64.200.11 ‑netmask 255.255.255.0 -gateway 10.64.74.2 Storage system address: 10.64.75.201 Storage system port: 443 HTTPS connection ID = RT_1 Operation completed successfully. Delete IP routes Delete an IP route. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 194
the SP on which the ports are linked. Valid values are: ● SPA ● SPB Maximum transmission unit (MTU) packet size (in bytes) for the linked ports. Default is 1500 bytes per packet. Linux network device name. ID of the FSN port to which the link aggregation belongs, if it is part of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 195
a custom value between 1280 and 9216. Specific I/O modules may restrict allowed range for MTU size value. The MTU size values of 1500 bytes (default) and 9000 bytes (jumbo frame) are supported by all interfaces and I/O modules. Example The following command links port 0 and port 1 on SPA with the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 196
1280 and 9216. Specific I/O modules may restrict allowed range for MTU size value. The MTU size values of 1500 bytes (default) and 9000 bytes (jumbo frame) are supported by all interfaces and I/O modules. Example The following command changes the MTU size for link aggregation la0_SPA to 9000 bytes - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 197
switch, thus extending link failover out into the network. When replicating from one Unity system to another, configure the FSN the same way on both systems as a best practice. You will need to manually configure the FSN on the destination before setting up replication. Otherwise, if you set - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 198
1280 and 9216. Specific I/O modules may restrict allowed range for MTU size value. The MTU size values of 1500 bytes (default) and 9000 bytes (jumbo frame) are supported by all interfaces and I/O modules. Example The following example creates an FSN where the primary port is a single ethernet port - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 199
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/fsn create -primaryPort spa_eth0 -secondaryPorts "spa_la_2,spa_eth3" Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = spa_fsn_0 ID = spb_fsn_0 Operation completed successfully. View FSN settings Review the list - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 200
1280 and 9216. Specific I/O modules may restrict allowed range for MTU size value. The MTU size values of 1500 bytes (default) and 9000 bytes (jumbo frame) are supported by all interfaces and I/O modules. Example 1 The following example changes the MTU size of the FSN "spa_fsn_0". uemcli -d 10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 201
corresponding IP addresses. The system uses DNS services to resolve network names and IP addresses for the network services it needs (for example, for NTP and domain and IP address of the DNS servers for the system to use. By default, the system uses the top entry in the list as the current DNS. The - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 202
on the destination. ● Overridden - DNS list has been manually modified or overridden on the replication destination. Modifications or deletions Description -nameServer Type a list of DNS server addresses to designate as default addresses. Separate the addresses with a comma. The system uses the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 203
DNS addresses View the DNS server addresses designated as a default. Format /net/dns/config show Example The following command displays the DNS server addresses: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/dns/config show Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 204
systems within approximately one millisecond of each other. A Windows Active Directory domain controller can operate as a time server if the Windows Time Service is running on it. Some applications will not operate correctly if the clock on the system is not synchronized with the clock on connected - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 205
. Create an NTP server record Create an NTP server to specify an IP address of each NTP server the system will use. NOTE: By default, the first NTP server address you specify will become the primary. Format /net/ntp/server create -server [-force {noReboot | allowReboot | allowDU}] Action - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 206
Object qualifier Qualifier -id Description Type the ID of the NTP server. Example The following command displays the NTP server record, which contains two NTP server addresses: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/ntp/server show Storage system address: 10.0.0.1 Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 207
NIS server domains The Network Information Service (NIS) consists of a directory service protocol for maintaining and distributing be reflected on the destination. ● Overridden - NIS list has been manually modified or overridden on the replication destination. Modifications or deletions of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 208
View NIS server domains View details about NIS server domains. Format /net/nas/nis [-server ] show Object qualifier Qualifier -server Description Type the ID of the associated NAS server Example The following command displays details about the NIS server domain: uemcli -d 10.0.0.1 -u - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 209
system uses the Simple Mail Transport Protocol (SMTP) to e-mail alerts, based on alert severity, of system events to specified e-mail addresses and to EMC support. Once you provide the IP address of the SMTP server to use, you can enable the following features on the system: ● E-mail alerts - The - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 210
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/smtp show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = default Address = 192.168.0.15 Port = 25 Encryption level = SSL Authentication type = Plain User name = test Bypass proxy = no Configure - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 211
will be prompted to input the password. -bypassproxy Specifies whether the global proxy settings are bypassed when accessing the SMTP server. Valid values are: ● yes: Ignores the global proxy server settings to access the SMTP server directly. ● no (default): Uses the global proxy server settings - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 212
= nas_1 Enabled = no Configure NDMP server settings Configure NDMP server settings, which includes enabling or disabling NDMP and changing the password for accessing the NDMP server. Format /net/nas/ndmp -server set -enabled {yes {-passwd | -passwdSecure} | no} Object qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 213
server password. -passwd Type the password for the NDMP server. You must specify the password when enabling NDMP. -passwdSecure Specify the password in upload -f /tmp/myldapservercertificate.cer /sys/cert -type CA -service Mgmt_LDAP Table 63. LDAP server attributes Attribute ID Auto discovery - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 214
binding to the LDAP server. This is the password for the user specified in the Bind DN attribute. Path to search for users on the directory server. For example: ou=People,dc=lss,dc=emc,dc=com. NOTE: On an Active Directory server, a default search path is used. Path to search for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 215
-upload -f /tmp/myldapservercertificate.cer /sys/cert -type CA -service Mgmt_LDAP Format /net/ldap create [{-name | -autoDiscoveryEnabled}] bindDn Type the port number used by the directory server for LDAP communications. By default, LDAP uses port 389, and LDAP over an SSL uses port 636. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 216
password. Type the path to search for users on the directory server. For example: ou=People,dc=lss,dc=emc,dc=com NOTE: On an Active Directory server, a default LDAP attribute whose value contains names of group members within a group. Default value is member. Type the timeout for the LDAP server in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 217
ID = LDAP_1 Operation completed successfully Example 3: Creating an LDAP configuration using auto discovery through DNS to configure the server addresses uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/ldap create -autoDiscoveryEnabled -domain domain.example.com -port 389 -protocol ldap - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 218
-p MyPwd -upload -f /tmp/myldapservercertificate.cer /sys/cert -type CA -service Mgmt_LDAP Format /net/ldap -id set [{-name | server. Type the port number used by the directory server for LDAP communications. By default, LDAP uses port 389, and LDAP over an SSL uses port 636. For - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 219
password. Type the path to search for users on the directory server. For example: ou=People,dc=lss,dc=emc,dc=com. NOTE: On an Active Directory server, a default LDAP attribute whose value contains names of group members within a group. Default value is member. Type the timeout for the LDAP server in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 220
Example The following command verifies the connection to the LDAP server: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/ldap -id LDAP_1 verify Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Refresh the automatically-discovered - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 221
Example The following command deletes the LDAP_1 setting: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/ldap -id LDAP_1 delete Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Utility commands Ping allows you to check connectivity - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 222
the DHSM service. Valid values are: ● disabled ● enabled Username The DHSM user name. Password The DHSM user password. HTTPS enabled Specifies whether SSL (HTTPS) is required for DHSM requests to this DHSM server. Valid values are: ● yes (default - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 223
-state -username -passwd Description Specifies whether the DHSM service is enabled. Possible values include: ● Disabled - DHSM service is disabled. ● Enabled - DHSM service is enabled. Specifies the DHSM user name. Specifies the DHSM user password. NOTE: This attribute is mandatory if the current - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 224
changes the DHSM password: uemcli -d 10 the NAS server can be read and written to. ● Enabled (default) - allows both the creation of stub files and data migration through a read or write request from the secondary file system to Unity. Read policy Read policy when the NAS server recalls data from - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 225
is required by the secondary storage HTTP server. -secondaryPassword Specifies the password associated with the username required by the secondary storage server. -timeout Specifies the timeout value in seconds. By default, the Unity HTTP client waits 30 seconds for a reply from the HTTP server - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 226
Format /net/nas/dhsmconn [{-id | -fs }] show Action qualifiers Qualifier -id -fs Description DHSM connection identifier. Specifies the file system storage resource ID. Example 1 The following command shows all DHSM connections for file system "fs_1". uemcli /net/nas/dhsmconn -fs - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 227
] Action qualifiers Qualifier Description -id DHSM connection identifier. -mode Sets the mode of Unity DHSM operations on the specified file system. Valid values are: ● enabled (default) - allows both the creation of stub files and data migration through reads and writes ● disabled - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 228
if digest authentication is required by the secondary storage HTTP server. Specifies the password associated with the username required by the secondary storage server. Specifies the timeout value in seconds. By default, the Unity HTTP client waits 30 seconds for a reply from the HTTP server and - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 229
● yes - migrates the files back to Unity before the connection is deleted. Example The following the TBN cannot be determined. ● OK (5)-TBN is operating normally. ● Degraded/Warning (10)-TBN service is working, but one or more of the following may have occurred: ○ TBN can communicate with SPA - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 230
(continued) Attribute Health details Active Description Additional health information. See Appendix A, Reference, for health information details. Indicates whether the TBN service is active. Valid values are: ● yes ● no View basic tie breaker node information Display basic Tie Breaker Node (TBN - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 231
Example The following command shows details for the TBN configuration: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/tbn/config show Storage system address: 10.64.75.201 Storage system port: 443 HTTPS connection 1: Enabled Active TBN = yes = 42389FCA-01D1-4491-7D77-8060373D67B8 Change - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 232
Example 3: Change the active TBN uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/tbn/config set -activeTbn 42389FCA-01D1-4491-7D77-8060373D67B8 Storage system address: 10.64.75.201 Storage system port: 443 HTTPS connection Operation completed successfully 232 Configure Network Communication - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 233
4 Manage Hosts Topics: • Manage host configurations • Manage host LUNs • Manage host groups • Manage host initiators • Manage host initiator paths • Manage iSCSI CHAP accounts for one-way CHAP authentication • Manage iSCSI connections • Manage iSCSI connection paths • Manage remote storage systems - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 234
: ● undefined - OS is not specified (default) or unknown. ● other - Other. ● BUT (7) - Working correctly, but there could be a problem. ● Degraded/Warning (10) - Working and performing services. ● Other - The host is automatically created on the storage system. ● Manual - The host is created manually - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 235
. Specifies the identifier of the tenant with which the host is to be associated. NOTE: If not specified, the host is created in the default network namespace and the tenant attribute will be blank. Specifies the hostnames or IP addresses associated with the host, IP addresses of the subnet, or - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 236
Qualifier Description ● win2003srv - Windows Server 2003. ● winxp - Windows XP. ● win2008srv - Windows Server 2008. ● winvista - Windows Vista. ● win2012srv - Windows Server 2012. ● esx - VMware ESX. ● redhat - Red Hat Enterprise Linux. ● sles - SUSE Linux Enterprise. ● win7 - Windows 7. ● hyperv - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 237
● Description is "V6_HE_Subnet". ● IPv6 address is 2001:db8:c25: ● Prefix length is 48. The host configuration receives ID NetGroup_1023: uemcli -d 10.0.0.1 /remote/host create -name IPv6Subnet -descr "V6_HE_Subnet" -type subnet -addr 2001:db8:c25::/48 Storage system address: 10.0.0.1 Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 238
For subnet type, specifies the new IP address of the subnet. ● For netgroup, specifies the new netgroup's name. ● Format: /[]. ● Default prefix length for IPv4 addresses is 24 and for IPv6 addresses is 64. NOTE: This information is required when connecting hosts to network - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 239
associated with the configuration. Hosts that use the configuration for NFS-based storage connections, such as NFS shares, revert to the default access privileges for any storage resources that they can access. Format /remote/host {-id | -name } delete Object qualifier Qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 240
Example The following command deletes host configuration 1014: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/host -id 1014 delete Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Manage host LUNs Host LUNs are the storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 241
Object qualifier Qualifier -id -host -hostName -lun -lunName -type Description Specifies the host LUN ID. Specifies the host ID. Specifies the host name. Specifies the LUN ID. Specifies the LUN name. Specifies the LUN type. Example The following command lists all host LUNs on host Host_3: uemcli - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 242
Example The following command changes the ID Host_3_sv_2_prod to LUN 0: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/host/hlu -id Host_3_sv_2_prod set -lunid 0 Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Manage host - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 243
host group will have access to LUN 4. Valid values are: ● yes ● no (default) -addLuns Type a comma-separated list of the IDs for any additional LUNs that you Specify the type of host group. Valid values are: ● General (default): Host groups that have access to LUNs. This can include both standard - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 244
ID = HostGroup_1 Operation completed successfully. View a host group View the details of one or more host groups. Format /remote/hostgroup {-id | -name } [-async] show [-detail] Object qualifier Qualifier -id -name Description Specify the ID of the host group. Specify the name of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 245
how host access to LUNs should be merged for new hosts when they are added to the pre-existing host group. Valid values are: ● fromHostGroup (default)-LUNs accessible by all hosts in the existing host group will also be accessible by the newly added hosts. ● toHostGroup-LUNs accessible by all hosts - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 246
Qualifier Description the comma-separated list for the -addVmfsDataStores and -vmfsHlus option must match. Each item in the list must be a numeric value. The specified Host LUN IDs will be applied to all hosts within the host group. If this option is not specified, the system will automatically - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 247
the corresponding hosts use to access the LUN. Inaccessible hosts A comma-separated list of hosts in the host group that cannot access the LUN. Default Host LUN ID The default host LUN ID to be used when adding new hosts to the host group. If no value is displayed, there is no - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 248
LUN = sv_1 LUN name = testLuns-1 LUN type = Production Accessible hosts = Host_1,Host_2 Host LUN IDs = 1,1 Inaccessible hosts = Host_3 Default Host LUN ID 2: ID = HostGroup_1_sv_2_prod Host group = HostGroup_1 Host group name = testhg LUN = sv_2 LUN name = testLuns-2 LUN type - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 249
, and optionally the CHAP authentication password associated with the host. Manage . ● OK BUT (7) - Working correctly, but there could be a problem. ● Degraded/Warning (10) - Working and performing all functions, but - HP with Auto-trespass ● OpenNative (default) - Open native (such as CLARiiON Open - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 250
the LUN. LUNZ enabled Specifies whether LUNZ is enabled. Values are: ● yes (default) ● no Unit serial number Indicates the unity serial number. Values are: ● Array (default) ● LUN For SCSI-3 interfaces, the Unity Serial Number page (Vital Product Data page 0x80) reports the serial number for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 251
Qualifier Description ● no -unitSerialNumber Specify the Unit Serial Number. Valid values are: ● Array (default) ● LUN For SCSI-3 interfaces, the Unity Serial Number page (Vital Product Data page 0x80) reports the serial number for the array or LUN. Example 1 The following command creates an FC - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 252
Format /remote/initiator [{-id | -host | -unregistered}] show Object qualifier Qualifier -id -host -unregistered Description Identifies the initiator. Type the ID of a host configuration to view the initiators assigned to the host configuration. Specifies unregistered initiators. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 253
be enabled. Valid values are: ● yes ● no -unitSerialNumber Specify the Unit Serial Number. Valid values are: ● Array ● LUN For SCSI-3 interfaces, the Unity Serial Number page (Vital Product Data page 0x80) reports the serial number for the array or LUN. -force Specify to bypass the validation of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 254
. Value is one of the following: ● Unknown (0) - Status is unknown. ● OK (5) - Working correctly. ● OK BUT (7) - Working correctly, but there could be a problem. ● Degraded/Warning (10) - Working and performing all functions, but the performance may not be optimum. ● Minor failure (15) - Working and - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 255
other. Compared to one-way CHAP, enabling reverse CHAP provides an extra level of security. To set reverse CHAP, specify a reverse secret password. Manage reverse CHAP for mutual CHAP authentication explains how to configure reverse CHAP authentication. Each CHAP account is identified by an ID. The - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 256
. -secretSecure Specifies the CHAP secret in secure mode - the user will be prompted to input the password. -secretFormat Specifies the CHAP input format. Valid values are: ● ascii(default) - ASCII format ● hex - Hexadecimal format Example The following command creates an iSCSI CHAP account for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 257
Username = globalChapUserName Change iSCSI CHAP account settings Change the settings for an iSCSI CHAP account, such as the secret password. Format /remote/iscsi/chap -id set [-username ]{-secret | -secretSecure} [ secretFormat { ascii | hex } ] Object qualifier Qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 258
format. Value is one of the following: ● ascii - ASCII format ● hex - Hexadecimal format Example The following command updates the secret password for iSCSI CHAP account CHAP_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/iscsi/chap -id CHAP_1 set -secret abcdef123456 Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 259
Table 75. iSCSI connection Attributes Attribute ID Name Description Description ID of the iSCSI connection. Name of the iSCSI connection. Description of the iSCSI connection. Create an iSCSI connection Create an iSCSI connection. NOTE: Only one iSCSI connection can be created at a time. Therefore, - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 260
Qualifier -name Description Type the unique name of the iSCSI connection. Example This example shows all iSCSI connections. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/iscsi/connection show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 261
Delete an iSCSI connection Deletes an existing iSCSI connection. NOTE: When you delete an iSCSI connection, any iSCSI connection paths associated with the iSCSI connection are also deleted. Format /remote/iscsi/connection {-id | -name } delete [-async] Object qualifiers Qualifier - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 262
not specify an iSCSI portal address which only redirects the connection to another address. Unity does not support iSCSI redirection. -port -if The default TCP port is 3260. If the port number is different from the default, type the TCP port of the remote system iSCSI destination. Specify a comma - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 263
an iSCSI connection, any iSCSI connection paths associated with that iSCSI connection are also deleted. You do not need to manually the delete the paths. Format /remote/iscsi/connection/path {-connection | -connectionName } -index delete [-async] Object qualifiers Qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 264
Action qualifier Qualifier -async Description Run the operation in asynchronous mode. Example The following command deletes the "1" path from the "iscsi_conn_1" iSCSI connection. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/iscsi/connection/path -connection iscsi_conn_1 -index 1 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 265
to access the system. Source user password For storage systems that are the source in a replication session, the user password that is used to access the replication sessions with source role having data transfer due to RPO or manual sync on this remote system. NOTE: This attribute is used for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 266
username that is used to access the system. -srcPassword For systems that are the source in a replication, type the user password that is used to access the system. -srcPasswordSecure Specify the password in secure mode. Once you run the command with this qualifier, you will be asked to type the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 267
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys create -addr 10.60.10.10 -srcUsername LocalAdmin ‑srcPassword LocalAdminPassword -dstUsername RemAdmin -dstPassword RemAdminPassword -connectionType async -bandwidthSchedules MonTueWedThuFri7-18/2000,/8000 Storage system address: 10.0.0.1 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 268
Name = FNM00151702100 Address = 10.244.205.127 Model = Unity 300 Serial number = FNM00151702100 Connection type = sync Source interfaces ensure that you have the appropriate interface types configured to support both asynchronous replication (eth2, eth3) and synchronous replication (sync - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 269
is used to access the remote system. -dstPassword Type the user password that is used to access the remote system. -dstPasswordSecure Specify the password in secure mode. The user is prompted to specify the password. -connectionType Specify this qualifier to indicate the type of replication - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 270
network connection is healthy. No values are allowed. Example The following command executes a cabinet level unplanned failover replication operation issued for a Unity system: uemcli /remote/sys -id RS_1 failover Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = RS_1 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 271
not specified, the connection type of the remote system is used by default. Valid values (case insensitive) are: ● sync ● async ● both Example The following command executes a pause replication session for a Unity system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys -id RS_1 pause - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 272
default. Valid values (case insensitive) are: ● sync ● async ● both Example The following command executes a resume replication session for a Unity account on the VMware vCenter. Password of the administrator account on the Not supported NOTE: Automatic VASA registration is not supported on vSphere - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 273
as a VASA provider. NOTE: It is recommended that you create a new user with the /user/account command and set the role to vmadmin. The password of the local account that vSphere will use to register the system as a VASA provider. Create VMware vCenter Adds the vCenter credentials and discovers any - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 274
of the VMware vCenter server. Specifies the VMware administrator username. Specifies the VMware administrator password. Specifies the password in secure mode - the user will be prompted to input the password. Specifies the new description of the VMware vCenter server. Example The following command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 275
vCenter server Removes an existing VMware vCenter server and its associated ESXi hosts. NOTE: If the Unity system is registered as a VASA provider in vCenter and you delete the vCenter from Unity, the Unity system will be unregistered as a VASA provider from vCenter. Format /virt/vmw/vc -id - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 276
VMware ESXi hosts. The following table lists the attributes for ESXi hosts. Table 79. ESXi host attributes Attribute ID Name Address Virtual center Username Password Description ID of the ESXi host. Name of the ESXi host. Domain name or IP address of ESXi host. Identifier of the VMware VCenter - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 277
ESXi host. Indicates if the NFSv4 protocol is supported for the host. Valid values are: ● yes password. -descr Specifies the description of the VMware ESXi host. -resolveConflicts Specifies the option to resolve IP address or initiator conflicts interactively. Valid values are yes or no (default - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 278
the username used to access the VMware ESXi host. -passwd Specifies the password used to access the VMware ESXi host. -passwdSecure Specifies the new password in secure mode - the user will be prompted to input the password. -addr Specifies the domain name or IP address of the ESXi host - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 279
Example uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /virt/vmw/esx -id ESX_1 set -descr "Changing ESXi host description" Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = ESX_1 Operation completed successfully. Delete ESXi host credentials Deletes ESXi host - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 280
.aa.bb.com vCenter = VC_1 Address = 10.10.10.100 Description = NFSv4 supported = yes NFS username = root 2: ID = ESX_2 Name = nlpc12241.xx.yy.com Specifies the password of the VMware vCenter Specifies the password in secure mode - the user will be prompted to input the password. Adds - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 281
Operation completed successfully Refresh an ESXi host Rescans details of a VMware ESXi host. Format /virt/vmw/esx [-id ] refresh [-scanHardware] Object qualifier Qualifier -id Description Identifies the ESXi host. If an ID is not specified, all virtualization objects are rescanned. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 282
= LinVM3 vCenter = VC_1 ESX server = ESX_1 State = Suspended VM hard disk Manage hard disk properties for VMware virtual machines stored on the Unity system. The following table lists the attributes for VM hard disks. Table 81. VM hard disk attributes Attribute Name Description Name of the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 283
View all hard disks Displays hard disk properties for a specified virtual machine stored on the Unity system. Format /virt/vmw/vmdevice -vm show Object qualifier Qualifier -vmId Description Identifies the virtual machine. Example uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /virt/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 284
● The health of the component cannot be determined. 10 Degraded/Warning ● A user has placed the SP into the Service mode. 20 Major failure ● The system software on this SP has encountered a problem. ● The CPU in the SP has faulted. ● IO module 0 in the SP has faulted. ● IO module 1 in the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 285
Table 83. Storage processor health state values (Service/Rescue mode) (continued) Code Health state Reason(s) ● Memory DIMMs in the SP have faulted. ● The SP has faulted. ● The SSD in the SP has faulted. ● - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 286
2: ID = spb DPE = dpe Slot = 1 Name = SP B Mode = Normal Health state = OK (5) Health details = "The component is operating normally. No action is required." Model = BC SP 57840B1 8009C1 12GB 4C Part number = 110-223-000C-02 Serial number = FCNBC130100104 Memory size = 25769803776 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 287
Table 85. Virtual disk health state values (continued) Code Health state Reason(s) 7 OK_BUT ● The virtual disk was originally configured for a different storage system. ● The virtual disk was originally configured for a different storage pool. 20 Major failure ● The virtual disk is not - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 288
Current speed = 6 Gbps Maximum speed = 6 Gbps Manufacturer = SEAGATE Model = ST990080 CLAR900 Vendor capacity = 966367641600 (900.0G) Part number = 005049206PWR Serial number = 6XS3A9CG Firmware revision = CS19 WWN = 06:00:00:00:05:00:00:00:01:00:00:00:00:00:00:03 Days remaining to - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 289
Example 4 The following command displays the details of all drives on a dual-SP virtual deployment. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/disk show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = vdisk_1 SCSI ID SPA = 0:3 SCSI ID - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 290
Format /env/disk -id set [-async] [-name ] [-tier ] Object qualifier Qualifier -id Description Disk identifier. Action qualifier Qualifier Description -async Run the operation in asynchronous mode. -name Specify the new name for the disk. -tier Specify the new tier. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 291
Format /env/bat [-id ] show Object qualifier Qualifier -id Description ID of the battery. Example The following command displays a list of system batteries: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/bat show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 292
Object qualifier Qualifier -id Description ID of the power supply. Example The following command displays a list of system power supplies: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/ps show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = Pow_0 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 293
Example The following command displays a list of system LCCs: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/lcc show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = LCC_0 DAE = DAE_0 Slot = 0 Health state = OK (5) 2: ID = LCC_1 DAE = DAE_0 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 294
1: ID = spa_ssd_0 SP = spa Slot = 0 Name = SP A Internal Disk 0 Type = SATA Health state = OK (5) Health details = "The component is operating normally. No action is required." Manufacturer = Model = Intel DC 3500 Series SSDs M.2 Part number = INTEL SSDSCKHB080G4M 118000039 Serial - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 295
Example The following command displays a list of system DAEs: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/dae show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = dae_0_1 Name = DAE 0 1 Health state = OK (5) Health details = "The - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 296
View disk processor enclosure View details of the system DPE. Format /env/dpe [-id ] show Object qualifier Qualifier -id Description ID of the DPE. Example 1 (physical deployments only) The following command displays the system DPE information: uemcli -d 10.0.0.1 -u Local/joe -p - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 297
Table 92. Memory module health state values Code Health state 0 Unknown 5 OK 20 Major failure Reason(s) ● The health of the component cannot be determined. ● The memory module is operating normally. ● The memory module has faulted. ● The memory module has been removed. View memory module - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 298
Table 93. SSC health state values (continued) Code Health state Reason(s) 5 OK ● The SSC is operating normally. 20 Major failure ● The SSC has faulted. ● The SSD is missing. View SSC View a list of System Status Cards (SSC). Format /env/ssc [-id ] show Object qualifier Qualifier - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 299
View fan module View a list of system fan modules. Format /env/fan [-id ] show Object qualifier Qualifier -id Description Identifies the fan module. Example The following command displays a list of system cache cards: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/fan show - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 300
and the host, or between the SPs and the disk-array enclosure. NOTE: Embedded modules and 4-port cards are only available on Unity 480/480F, Unity 680/680F, and Unity 880/880F systems. You can view details about each I/O module, embedded module, and 4-port card installed in the system, such as the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 301
Commit I/O modules, embedded modules, and 4-port cards When you add a new I/O module, embedded module, or 4-port card to the system, you must first commit it before the system can use it. The system automatically commits unconfigured I/O modules, embedded modules, or 4-port cards. Format /env/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 302
Example 2 The following command displays details about an embedded module and 4-port card in a Unity 680 system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /env/iomodule show 1: ID = spb_iopm_0 SP = spb Slot = 0 Name = SP B Embedded Module 0 Health state = OK (5) Health details = " - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 303
automatically • Configure custom pools • Manage pool tiers • View pool resources • Manage FAST VP general settings • Manage FAST Cache (supported physical deployments only) • Manage FAST Cache storage objects (physical deployments only) • View storage profiles (physical deployments only) • Manage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 304
Table 96. Automatic pool configuration attributes Attribute Description Target Type of drive configuration. Value is one of the following: ● pool - Drives configured in a pool. ● spares - Drives assigned to pools as spares. The number of spares assigned to a pool is dependent on the drive type - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 305
Example The following command initiates automatic pool configuration: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/auto set Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection All disks in the system will be used to configure pools. Do you want to proceed? - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 306
on usage. Because thin provisioned storage resources can subscribe to more storage than is actually allocated to them, pools can be over provisioned to support more storage capacity than they actually possess. NOTE: The system automatically generates an alert when the total pool usage reaches 85% of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 307
Table 97. Custom pool attributes (continued) Attribute Description Rebalancing Indicates whether a pool rebalancing is in progress. Valid values are: ● yes ● no Rebalancing progress Indicates the progress of the pool rebalancing as a percentage. System defined pool Indication of whether the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 308
models running OE version 4.2.x or later, and for Unity hybrid models running OE version 5.2.x or later. The default pool type is dynamic. ● Traditional pools are supported in all Unity hybrid and virtual models. They are also supported in Unity All-Flash models running OE version 4.1.x or earlier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 309
elements. Type a name for the pool. (Available only for systems that support dynamic pools) Specify the type of pool to create. Value is one of , the operation may fail when the -drivesNumber value does not match the default RAID configuration for each drive type in the selected drive group. NOTE: - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 310
on the pool. Value is one of the following: ● yes ● no Default value is yes. Indicate whether the system should check the pool full high only) The following command creates a traditional pool in models that support dynamic pools. This example uses storage profiles tprofile_1 and tprofile_2, five - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 311
ID = pool_6 Operation completed successfully. Example 3 (physical deployments only) The following command creates a traditional pool in models that do not support dynamic pools. This example uses storage profiles profile_19 and profile_20, five drives from drive group dg_15, and nine drives from - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 312
the following: ● yes ● no Specify the pool full high watermark for the pool. Valid values are 1-99. Default value is 95. Specify the pool full low watermark for the pool. Valid values are 0-98. Default value is 85. Indicate whether the system should check the snapshot space used high water mark for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 313
value is 95. Specify the snapshot space used low watermark to trigger auto-delete on the pool. Valid values are 0-98. Default value is 20. Specify whether to pause snapshot auto-delete. Typing no resumes the autodelete operation. Example The following command sets the subscription alert threshold - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 314
HDD system drives. Type the IDs of the storage profiles, separated by commas, to apply to the pool. If this option is not specified, a default RAID configuration is selected for each particular drive type in the selected drive group: ● NL-SAS (RAID 6 with a stripe length of 8) ● SAS (RAID 5 with - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 315
Format /stor/config/pool {-id | -name }] show Object qualifiers Qualifier -id -name Description Type the ID of a pool. Type the name of a pool. Example 1 (physical deployments only) The following command shows details about all pools on a hybrid system: uemcli -d 10.0.0.1 -u - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 316
Reduction Ratio = 1.0:1 All flash pool = no Example 2 (physical deployments only) The following example shows all pools for a model that supports dynamic pools. uemcli -d 10.0.0.2 -u Local/joe -p MyPassword456! /stor/config/pool show -detail [Response] Storage system address: 10.0.0.2 Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 317
Auto-delete snapshot space used low water mark Data Reduction space saved Data Reduction percent Data Reduction ratio All flash pool = 20% = 0 = 0% = 1:1 = yes 2: ID = pool_4 Type = Dynamic Name = dynamicPool Description = Total space = 1544309178368 (1.4T) Current allocation = 0 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 318
Auto-delete pool full high water mark = 95% Auto-delete pool full low water mark = 85% Auto-delete snapshot space used threshold enabled = yes Auto-delete snapshot space used high water mark = 25% Auto-delete snapshot space used low water mark = 20% Delete pools Delete a pool. Format /stor/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 319
Type of data relocation. Value is one of the following: ● Manual - Data relocation was initiated by the user. ● Scheduled or rebalancing - Moderate impact on system performance. ● High - Most impact on system performance. Default value is medium. NOTE: This field is blank if data relocation is not in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 320
Table 98. FAST VP pool attributes (continued) Attribute Description Estimated relocation time :[value] where: ● tier_name - Identifies the storage tier. ● value - Identifies the amount of data in that tier to be rebalanced. Identifies the estimated time required to perform the next - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 321
/joe -p MyPassword456! /stor/config/pool/fastvp -show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: Pool = pool_1 Relocation type = manual Status = Active Schedule enabled = no Start time = 2013-09-20 12:55:32 End time = 2013-09-20 21:10:17 Data - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 322
Type the ID of the pool. -endTime Specify the time to stop the data relocation. The format is: [HH:MM] where: ● HH - Hour. ● MM - Minute. Default value is eight hours from the current time. -rate Specify the transfer rate for the data relocation. Value is one of the following: ● Low - Least - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 323
Example The following command stops data relocation on pool pool_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool/fastvp -pool pool_1 stop Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Manage pool tiers Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 324
Example 1 (physical deployments only) The following command shows tier details about the specified pool: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool/tier -pool pool_1 show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: Name = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 325
Table 100. Pool resources Attribute ID Name Resource type Pool Total pool space used Total pool space preallocated Total pool non-base space used Health state Health details Description Storage resource identifier. Name of the storage resource. Type of the resource. Valid values are: ● LUN ● File - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 326
Pool = pool_1 Total pool space used = 53024473088 (49.3G) Total pool preallocated = 15695003648 (14.6G) Total pool snapshot space used = 7179124736 (6.6G) Total pool non-base space used = 7179124736 (6.6G) Health state = OK (5) Health details = "The component is operating normally. No - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 327
. Value is one of the following: ● Low - Least impact on system performance. ● Medium - Moderate impact on system performance. ● High - Most impact on system performance. Default value is medium. NOTE: This field is blank if data relocation is not in progress. Data to move up Data to move down Data - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 328
● HH - Hour ● MM - Minute Valid values are between 00:00 and 23:59. Default value is 00:00. Specify the time to stop the data relocation. The format is: Hour ● MM - Minute Valid values are between 00:00 and 23:59. Default value is eight hours after the time specified with the -at parameter. Specify - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 329
Data to move down = 4947802324992 (1.5T) Data to move within = 4947802324992 (1.5T) Estimated scheduled relocation time = 7h 30m Manage FAST Cache (supported physical deployments only) FAST Cache is a storage efficiency technology that uses drives to expand the cache capability of the storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 330
Qualifier Description ● no Example The following command configures FAST Cache with six drives from drive group dg_2, and enables FAST Cache on existing pools: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache create -diskGroup dg_2 -drivesNumber 6 -enableOnExistingPools yes - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 331
Qualifier -diskGroup -drivesNumber Description Specify the comma-separated list of SAS Flash drives to add to the FAST Cache. Any added drives must have the same drive type and drive size as the existing drives. Specify the number of drives for each corresponding drive group to be added to the FAST - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 332
Format /stor/config/fastcache delete [-async] Action qualifier Qualifier -async Description Run the operation in asynchronous mode. Example The following command deletes the FAST Cache configuration: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache delete Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 333
storage profiles. Table 104. Storage profile attributes Attribute Description ID ID of the storage profile. Type (Available only for systems that support dynamic pools) Type of pool the profile can create. Value is one of the following: ● Dynamic ● Traditional Description Drive type Brief - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 334
a storage profile. -driveType Specify the type of drive. -raidLevel Specify the RAID type of the profile. -traditional (Available only for systems that support dynamic pools) Specify this option to view the profiles that you can use for creating traditional pools. To view the profiles you can - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 335
2 The following command shows details for storage profiles that can be used to create traditional pools in models that support dynamic pools: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -traditional -configurable show Storage system address: 10.0.0.1 Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 336
Maximum drives to configure = 10, 10 Maximum capacity to configure = 1247522127872 (1.1T), 2954304921600 (2.6T) 3: ID = tprofile_31 Type = Traditional Description = SAS Flash 3 RAID10 (2+2) Drive type = SAS Flsh 3 RAID level = 10 Maximum capacity = 9749818597376 (8.8T) Stripe length = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 337
days) Example 2 The following command shows details about all drive groups that can be used to configure traditional pools in models that support dynamic pools: NOTE: For dynamic pools, the Unconfigured drives value does not include HDD system drives. For traditional pools, the Unconfigured drives - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 338
Drive size = 1181778411520 (1.0T) Vendor size = 1.2T Rotational speed = 10000 rpm Number of drives = 44 Unconfigured drives = 44 Capacity = 51998250106880 (47.2T) Recommended number of spares = 2 2: ID = dg_40 Drive type = SAS Flash 4 FAST Cache = no Drive size = 1881195675648 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 339
using data reduction. NOTE: Data reduction is available for thin LUNs and thin file systems. The thin file systems must be created on Unity systems running version 4.2.x or later. Data Reduction percent Specifies the storage percentage saved on the entire system when using data reduction. NOTE - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 340
shares on the file system, which connected hosts map or mount to access the file system storage. When creating a file system, you can enable support for the following network shares: ● SMB shares (previously named CIFS shares), which provide storage access to Windows hosts. 340 Manage Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 341
● Network file system (NFS) shares, which provide storage access to Linux/UNIX hosts. An ID identifies each file system. The following table lists the attributes for file systems: Table 108. File system attributes Attribute Description ID ID of the file system. Name Name of the file system. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 342
is enabled. Value is yes or no. Default is no. All storage pools support both standard and thin provisioned storage resources. For by using data reduction. NOTE: The thin file systems must be created on Unity systems running version 4.2.x or later. Data Reduction percent Total file system storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 343
has been enabled. An empty value indicates that advanced deduplication is not supported on the file system. Valid values are: ● yes ● no (default) NOTE: The thin file systems must be created on a Unity system running version 4.2.x or later. Advanced deduplication is available only on: ● Dynamic - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 344
the system over the network. ● This feature is enabled by default for Windows (SMB) file systems. Unless your application handles critical subdirectory depth permitted for file notifications. Value range is 1-512. Default is 512. Identifies what type of asynchronous replication this file system is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 345
) ● infinite Any non-infinite values plus the current date must be less than the maximum retention period of 2106-Feb-07. FLR default retention period Indicates the default retention period that is used in an FLR-enabled file system when a file is locked and a retention period is not specified at - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 346
Warning Threshold Info Threshold Specifies the threshold of used space in the file system as a percentage. When exceeded, error alert messages will be generated. The default value is 95%. If the threshold value is set to 0, this alert is disabled. This option must be set to a value greater than the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 347
680, and 880 systems (Option available on a Unity system running OE version 4.1.) Specify the minimum size to allocate for the thin file system. Automatic and manual file shrink operations cannot decrease the file system size lower than this value. The default value is 3G, which is the minimum thin - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 348
the initial tier placement and the ongoing automated tiering of data during data relocation operations. Valid values (case insensitive): ● startHighThenAuto (default) - Sets the initial data placement to the highest-performing drives with available space, and then relocates portions of the storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 349
the maximum date and time that has been set on any locked file in an FLR-enabled file system. Values are: ● d: days ● m: months ● y: years ● infinite (default) The value should be greater than 1 day. Any non-infinite values plus the current date must be less than the maximum retention period of 2106 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 350
● Uses the capacity storage pool. ● Uses NAS server nas_2 as the parent NAS server. ● Primary storage size is 3 GB. ● Supports multiprotocol network shares. ● Has a native access policy. ● Is a replication destination. The file system receives the ID res_28: uemcli -d 10.0.0.1 -u Local/joe -p - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 351
Locking policy Size Size used Maximum size Protection size used = advisory = 1099511627776 (1T) = 128849018880 (120G) = 281474976710656 (256.0T) = 1099511627776 (1T) Example 2 The following command lists details about all file systems on the storage system: uemcli -d 10.0.0.1 -u Local/joe -p - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 352
file system. -minSizeAllocated (Option available on a Unity system running OE version 4.1.) Specify the minimum size to allocate for the thin file system. Automatic and manual file shrink operations cannot decrease the file system size lower than this value. The default value is 3G, which is the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 353
, and 650F systems ● All-Flash pools and Hybrid Flash pools in Unity Hybrid 380, 480, 680, and 880 systems -cifsSyncWrites Enable synchronous write subdirectory depth to which the notifications will apply. Value range is 1-512. Default is 512. -sched Type the ID of the schedule to apply to the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 354
the maximum date and time that has been set on any locked file in an FLR-enabled file system. Values are: ● d: days ● m: months ● y: years ● infinite (default) The value should be greater than 1 day. Any non-infinite values plus the current date must be less than the maximum retention period of 2106 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 355
Specifies that snapshots of the file system can be deleted along with the file system itself. Valid values are: ● yes ● no (default) -async Run the operation in asynchronous mode. Example The following command deletes file system FS_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 356
that an individual user consumes on that file system. When you create or modify a user quota on a file system, you have the option to use default hard and soft limits that are set at the file-system level. ● Create a user quota on a quota tree to limit or track the amount of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 357
the following command: /quota/config -fs -path show If a soft limit or hard limit has not been specified for the user, the default limit is applied. -softLimit Specify the preferred limit on storage usage by the user. A value of 0 means no limitation. If the hard limit is specified - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 358
Because there can be a large amount of user quotas on a file system or quota tree, to reduce the impact on system performance, the system only updates user quota data every 24 hours. You can use the refresh action to update the data more often. Use the /quota/config show command to see the time - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 359
| -unixName | winName } set [-async] {-default | [-softLimit ] [-hardLimit ]} Object qualifiers Qualifier Description a soft or hard limit has not been specified for the user, the default limit is applied. -softLimit Specify the preferred limit on storage usage by - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 360
the total storage space consumed that directory. The hard limit, soft limit, and grace period settings you define for a quota tree are used as defaults for the quota tree's user quotas. You can override the hard and soft limit settings by explicitly specifying these settings when you create or - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 361
and soft limits to 0 (zero). Format /quota/tree create [-async] { -fs | -fsName } -path [-descr ] {-default | [-softLimit ] [-hardLimit ]} Action qualifiers Qualifier Description -async Run the operation in asynchronous mode. -fs Specify the ID of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 362
Qualifier Description -hardLimit Specify the absolute limit for storage space consumed on the quota tree. A value of 0 means no limitation. If the soft limit is specified and the hard limit is not specified, there will be no hard limitation. NOTE: The hard limit should be larger than the soft - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 363
exceeded Set quota limits for a specific quota tree You can specify that a specific quota tree inherit the associated file system's default quota limit settings, or you can manually set soft and hard limits on the quota tree. Format /quota/tree {-fs | -fsName } -path set - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 364
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /quota/tree -fs res_1 -path /qtree_1 set -softLimit 50G -hardLimit 100G Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Refresh all quota trees on a file system Because there can be a - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 365
than the file size, but that uses fewer blocks on the drive. Optionally, use this policy for NFS-only and multiprotocol file systems. ● filesize (default). Calculates space usage in terms of logical file sizes and ignores the size of directories and symbolic links. Use the File policy in the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 366
in the file system, and user quotas on the quota trees in the file system. The system issues a warning when the soft limit is reached. Default hard limit for on storage usage for user quotas on the file system, quota trees in the file system, and user quotas on the quota - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 367
or quota tree, the individual user cannot write to the file system or quota tree until more space becomes available for that user. The default grace period is 7 days. The format is: where: ● value - An integer value, depending on the associated qualifier: ○ If the qualifier is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 368
system, and user quotas on the quota trees in the file system. The system issues a warning when the soft limit is reached. -defaultHard Specify the default hard limit for on storage usage for user quotas on the file system, quota trees in the file system, and user quotas on the file - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 369
share. Brief description of the share. Name of the path relative to the file system of the directory that the share will provide access to. Default is /root of the file system. A local path must point to an existing directory within the file system. Manage Storage 369 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 370
Read/write hosts Read-only root hosts Root hosts No access hosts Allow SUID ID of the parent file system associated with the NFS share. Default share access settings for host configurations and for unconfigured hosts that can reach the share. Value is one of the following: ● ro-Hosts have read - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 371
account is mapped to client requests that arrive with a user ID of 0 (zero), which is typically associated with the user name root. The default value is 4294967294 (-2), which is typically associated with the nobody user (root squash). Anonymous GID (Applies when the host does not have allow root - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 372
setting the access for a specific host configuration to Read/Write will result in an effective host access of Read/Write. ● Example 2: If the default access setting for the share is Read-Only, setting the access permission for a particular host configuration to No Access will take effect and prevent - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 373
the share and set access permissions accordingly. -defAccess Specify the default share access settings for host configurations and for unconfigured hosts that from lower to higher security level. All higher security levels are supported, and can be enforced by the client at negotiations for secure - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 374
Qualifier -anonUid -anonGid Description ● yes (default) - Users can set the setuid and setgid Unix permission bits. This allows users to run the executable with privileges of the file owner. ● no - Users - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 375
ID = NFSShare_1 Name = MyNFSshare1 Description = My nfs share File system = res_26 Local path = /mypath Export path = SATURN.domain.emc.com:/MyNFSshare1 Default access = na Advanced host mgmt. = yes Read-only hosts = 1014, 1015 Read/write hosts = 1016 Read-only root hosts = Root - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 376
in the hosts lists are defined using /remote/host objects, i.e. with their identifier (advanced host management). Values are (case insensitive): ● yes (default)-Hosts lists contain the IDs of registered hosts. ● no-Host lists contain comma-separated strings, with each string defining a hostsname, IP - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 377
, from lower to higher security level. All higher security levels are supported, and can be enforced by the client at negotiations for secure NFS access setgid Unix permission bits. Values are (case insensitive): ● yes (default)-Users can set the setuid and setgid-Unix permission bits. This allows - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 378
Object qualifiers Qualifier Description -id Type the ID of an NFS share to change. View NFS share settings explains how to view the IDs of the NFS network shares on the system. -name Type the name of an NFS share to change. Action qualifier Qualifier -async Description Run the operation in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 379
only those that the requesting user has access to. ● no (default) DFS enabled Indicates whether Distributed File System (DFS) is enabled. Valid open from offline cache, even when connected to the network. ● manual - Only specified files will be available offline. Create CIFS network shares - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 380
directory/folder name within the share that was created from the host-side. The default path is the root of the file system. Local paths must point to open from offline cache, even when connected to the network. ● manual - Allows only specified files to be available offline. Example The following - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 381
NOTE: It is not necessary to specify the full path if the path where you would like to create the share is already root. In those cases, enter "/" for the -path. ● Continuous availability is enabled. ● CIFS encryption is enabled. The share receives ID CIFSShare_1: uemcli -d 10.0.0.1 -u Local/joe -p - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 382
Specifies whether CIFS encryption is enabled. -umask Type the default Unix umask for new files created on the share. - and files will open from offline cache, even when connected to the network. ● manual - Allows only specified files to be available offline. Example The following command sets the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 383
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/fs/cifs -id SMBShare_1 set -descr "My share" Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = SMBShare_1 Operation completed successfully. Delete CIFS network shares Delete a CIFS (SMB) share. Format /stor/ - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 384
size of the LUN. Maximum size of the LUN. Identifies whether thin provisioning is enabled. Valid values are: ● yes ● no (default) All storage pools support both standard and thin provisioned storage resources. For standard storage resources, the entire requested size is allocated from the pool when - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 385
data reduction has been enabled. An empty value indicates that advanced deduplication is not supported on the LUN. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 386
initial tier placement and the ongoing automated tiering of data during data relocation operations. Valid values (case-insensitive): ● startHighThenAuto (default)-Sets the initial data placement to the highestperforming drives with available space, and then relocates portions of the storage resource - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 387
of storage to allocate for the LUN. (Not applicable when creating a thin clone) Enable thin provisioning on the LUN. Valid values are: ● yes ● no (default) Type the ID of a protection schedule to apply to the storage resource. View protection schedules explains how to view the IDs of the schedules - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 388
indicates that advanced deduplication is not supported on the LUN. Valid values are: ● yes ● no (default) When advanced deduplication is enabled for only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in Unity All-Flash 450F, 550F, and 650F systems ● - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 389
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/luns/lun create -name "MyLUN" -descr "My LUN" -type primary -group group_1 -pool pool_1 -size 100M Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = lun_1 Operation completed successfully. Example 2 The - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 390
Qualifier Description -originalParentName Applies to thin clones only) Type the name of a parent LUN by which to filter thin clones. -source (Applies to thin clones only) Type the ID of a source snapshot by which to filter thin clones. -sourceName (Applies to thin clones only) Type the name of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 391
specified for the -sched qualifier. Valid values are: ● yes ● no Removes the protection schedule from the LUN. (Not applicable to thin clones) Specify the default owner of the LUN. Valid values are: ● spa ● spb (Not applicable to thin clones) Specify the FAST VP tiering policy for the LUN. This - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 392
data reduction has been enabled. An empty value indicates that advanced deduplication is not supported on the LUN. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 393
Example 1 The following command updates LUN lun_1 with these settings: ● Name is NewName. ● Description is "My new description." ● Primary storage size is 150 MB. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/luns/lun -id lun_1 set -name NewName -descr "My new description" -size 150M - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 394
-async Description Specify that snapshots of the LUN can be deleted along with the LUN itself. Valid values are: ● yes ● no (default) Run the operation in asynchronous mode. Example The following command deletes LUN lun_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/luns - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 395
Example The following command refreshes the thin clone called lun_5_tc with data from snapshot SNAP_2. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/luns/lun -id lun_5_tc refresh -source SNAP_2 -copyName Backup1 [Response] Storage system address: 10.64.75.201 Storage system port: 443 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 396
enabled. An empty value indicates that advanced deduplication is not supported for the LUN in the consistency group. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 397
ongoing automated tiering of data during data relocation operations for each LUN in the consistency group. Valid values (case-insensitive): ● startHighThenAuto (default)-Sets the initial data placement to the highest- performing drives with available space, and then relocates portions of the storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 398
-descr Type a brief description of the consistency group. -type Specify the type of consistency group. Valid values are (case insensitive): ● primary (default) ● tc -source (Applies to thin clones only) Specify the ID of the source snapshot to use for thin clone creation. -sourceName (Applies - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 399
ID = res_2 Operation completed successfully. View consistency groups Display the list of existing consistency groups. Format /stor/prov/luns/group [{-id | -name | -type {primary | tc [{-originalParent | -originalParentName | -source | -sourceName | - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 400
Total pool space preallocated Total Pool Space Used Total protection size used Snapshot count Family snapshot count Family thin clone count Data Reduction enabled Advanced deduplication enabled Total current allocation Protection schedule Protection schedule paused LUNs access hosts Snapshots access - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 401
is an incremental change to the existing host access. -replDest Specify whether the resource is a replication destination. Valid values are: ● yes ● no (default) NOTE: This value must be no for a thin clone. -fastvpPolicy (Cannot be changed for thin clones) Specify the FAST VP tiering policy for - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 402
enabled. An empty value indicates that advanced deduplication is not supported for LUNs in this consistency group. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 403
-async Description Specify that snapshots of the LUN can be deleted along with the LUN itself. Valid values are: ● yes ● no (default) Run the operation in asynchronous mode. Example The following command deletes LUN consistency group res_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 404
Action qualifiers Qualifier Description -async Run the operation in asynchronous mode. -source Specify the ID of the snapshot to be used for thin clone refresh. The snapshot must be part of the base consistency group family. -sourceName Specify the name of the snapshot to be used for thin - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 405
● SharePoint (32K) ● SAP (8K) Thin provisioning enabled Identifies whether thin provisioning is enabled. Value is yes or no. Default is no. All storage pools support both standard and thin provisioned storage resources. For standard storage resources, the entire requested size is allocated from the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 406
reduction has been enabled. An empty value indicates that advanced deduplication is not supported on the resource. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 407
● is the percentage of storage in that tier. Local path Local path to be exported. Export path Export path to datastore. Default access Default share access settings for host configurations and for unconfigured hosts that can reach the NFS datastore. Value is one of the following: ● ro - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 408
yes ● no Error Threshold Identifies the threshold of used space in the storage resource as a percentage. When exceeded, error alert messages will be generated. The default value is 95%. If the threshold value is set to 0, this alert is disabled. This option must be set to a value greater than the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 409
setting the access for a specific host configuration to Read/Write will result in an effective host access of Read/Write. ● Example 2: If the default access setting for the share is Read-Only, setting the access permission for a particular host configuration to No Access will take effect and prevent - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 410
880 systems -minSizeAllocated (Option available on a Unity system running OE version 4.1.) Specify the minimum size to allocate for the thin NFS datastore. Automatic and manual file shrink operations cannot decrease the file system size lower than this value. The default value is 3G, which is the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 411
passed to the host access list are manually managed. If the passed hosts are all ESXi hosts, this value will be automatically configured to the NFS user configured on the ESXi host. NOTE: For NFSv3 or NFSv4 protocols configured without Kerberos, the default owner is root. Type the minimum security - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 412
" storage pool. ● Primary storage size is 100 GB. ● Read-write access to host1 ● Minimum security level of krb5. ● An NFS owner "John" ● Default host access as N/A The file system receives the ID NFSDS_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/vmware/nfs create -name Accounting - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 413
File system = fs_1 Server = SFServer00 Storage pool ID = pool_1 Storage pool = capacity Size = 536870912000 (500G) Size used = 128849018880 (120G) Protection size used = 0 Local path = / Export path = 10.64.75.10/MyVMware Minimum size = Reclaimable size = Example 2 The following - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 414
for the NFS datastore. (Option available on a Unity system running OE version 4.1.) Specify the minimum size to allocate for the thin NFS datastore. Automatic and manual file shrink operations cannot decrease the file system size lower than this value. The default value is 3G, which is the minimum - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 415
VMware NFS datastore. It is an incremental change to the existing no-access hosts. Specifies the comma-separated list of hosts to be restored with default access to the VMware NFS datastore. It is an incremental change to the existing host access. Type which NFS protocol version will be used to - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 416
greater than the -warningThreshold. Specifies the threshold percentage that, when exceeded, warning alert messages will be generated. The range is from 0 to 99, and the default value is 75%. If the threshold value is set to 0, this alert is disabled. This option must be set to a value less than the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 417
Qualifier -deleteSnapshots -async Description Specifies that the resource's snapshots should also be deleted. Valid values are: ● yes ● no (default) Run the operation in asynchronous mode. Example The following command deletes NFS datastore NFSDS_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 418
are: ●8 ● 16 ● 32 ● 64 Thin provisioning enabled Identifies whether thin provisioning is enabled. Valid values are: ● yes ● no (default) All storage pools support both standard and thin provisioned storage resources. For standard storage resources, the entire requested size is allocated from the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 419
has been enabled. An empty value indicates that advanced deduplication is not supported on the storage resource. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 420
initial tier placement and the ongoing automated tiering of data during data relocation operations. Valid values (case-insensitive): ● startHighThenAuto (default)-Sets the initial data placement to the highestperforming drives with available space, and then relocates portions of the storage resource - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 421
for the VMFS datastore. (Not applicable when creating a thin clone) Enable thin provisioning on the VMFS datastore. Valid values are: ● yes ● no (default) Type the ID of a protection schedule to apply to the storage resource. Specify whether to pause the protection schedule specified for the -sched - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 422
only after data reduction has been enabled. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in Unity All-Flash 450F, 550F, and 650F systems ● All-Flash pools in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 423
Example The following command creates a VMFS datastore with these settings: ● Name is Accounting3. ● Description is Accounting Group 3. ● Uses the capacity storage pool. ● Provides host access permissions to the VMFS datastore (presented as a LUN) to two of the IQNs for host configuration 1014 and - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 424
Example 1 The following command displays details about VMFS datastores and their thin clones : uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/vmware/vmfs show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = res_6 LUN = sv_25 Name = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 425
the protection schedule. Specify whether to pause the protection schedule specified for -sched. Valid values are: ● yes ● no (Not applicable to thin clones) Specify the default SP that owns the datastore. Valid values are: ● spa ● spb Manage Storage 425 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 426
advanced deduplication for the VMFS datastore. Valid values are: ● yes ● no (default) NOTE: Advanced deduplication is available only on: ● Dynamic or Traditional pools in Unity 380F, 480F, 680F, and 880F systems ● Dynamic pools in Unity All-Flash 450F, 550F, and 650F systems ● All-Flash pools and - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 427
Qualifier -noIoLimit Description Specifies that an existing I/O limit applied to the VMFS datastore will be removed. Example 1 The following command updates VMFS datastore VMFS_1 with these settings: ● Name is Accounting4. ● Description is "Accounting Group 4." uemcli -d 10.0.0.1 -u Local/joe -p - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 428
Run the operation in asynchronous mode. Specify whether the datastore can be deleted along with snapshots. Value is Yes or No (default). Example The following command deletes VMFS datastore VMFS_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/vmware/vmfs -id VMFS_1 delete Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 429
only) Export path to the PE. IP address IP address of the NAS server for File PEs. WWN The World Wide Name for Block PEs. Default SP Identifier for the preferred SP. Valid values are: ● SPA ● SPB Current SP Identifier for the current SP. Valid values are: ● SPA ● SPB NAS server - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 430
-ca30-3c00-962b-87806445241a Export path = IP address = WWN = 60:06:01:60:CA:30:3C:00:96:2B:87:80:64:45:24:1A Default SP = SPA Current SP = SPA NAS Server = VMware NAS PE server = VVol datastore = Host = Host_1 LUN ID = Health state = OK (5) Health details = "The protocol - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 431
datastores (from one or more storage systems) when the vVol is being created based on these profiles. Only vVol datastores that support the storage policy profile are considered compatible storage containers for deploying the vVol. Table 119. vVol datastore attributes Attribute Description ID - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 432
storage pools. Health details Detailed health state for the vVol datastore. Capability profile Comma-separated list of identifiers of capability profiles supported by the vVol datastore. Each identifier with a "(Not used)" suffix indicates that this profile can be removed from the vVol datastore - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 433
cannot consist only of digits. -descr Type a brief description for the vVol datastore. -cp Specify the list of identifiers of capability profiles supported by the vVol datastore. -size Specify the list of allocation sizes. Specify one allocation for the amount of total space available for vVol - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 434
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/vmware/vvolds show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = res_1 Name = Performance Description = VMware UUID = 550e8400-e29b-41d4-a716-446655440000 Type = Block Health state - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 435
description for the vVol datastore. Type the list of identifiers of new capability profiles the vVol datastore will support. Type the list of identifiers of capability profiles already supported by the vVol datastore and specify the new allocated sizes for each. Specify the list of allocation sizes - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 436
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/vmware/vvolds -id res_1 set -hosts Host_2, Host_3, Host_11, Host_14 Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = res_1 Operation completed successfully. Delete vVol datastores Deletes specified vVol - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 437
Table 120. vVol datastore allocation attributes (continued) Attribute Description VVol datastore vVol datastore identifier. Capability profile Identifier of the associated capability profile. Storage pool Comma-separated list of identifiers of storage pools associated with the capability - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 438
Current allocation = 12884901888 (12G) Size used = 1073741824 (1G) Health state = OK (5) Health details = "The component is operating normally. No action is required." Manage vVol objects Virtual volumes are encapsulations of virtual machine files, virtual disks, and their derivatives. There - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 439
Table 122. vVol attributes (continued) Attribute Description Current allocation Total current allocation of the virtual volume. Bound to Comma-separated list of protocol endpoint identifiers to which the virtual volume is bound. An empty value indicates an unbound virtual volume. Binding - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 440
: Virtual volume deletion will also unbind and delete associated snapshots and fastclones. Do you want to delete the virtual volume? yes / no: The default in silent mode is yes. Format /stor/prov/vmware/vvol -id delete [-async] Object qualifier Qualifier -id -name Description Type the ID - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 441
VASAconnected vSphere can be restored with either Unity or vSphere. NOTE: Data vVol snapshots created on Unity are not visible to vSphere. Some vSphere If not provided, the system will assign a name with the default naming convention UTC_date_time. Specify to run the operation in asynchronous mode - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 442
cannot be restored with vSphere, but a vVol snapshot created with VASAconnected vSphere can be restored with either Unity or vSphere. Format /stor/prov/vmware/vvol {-id | -name } restore {-snap | -snapName } [-async] Object qualifier Qualifier -id -name Description - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 443
and NL-SAS ○ Single-tiered pool with NL-SAS Service level-based provisioning (virtual deployments) Expected service level for a virtual pool: ● Gold ○ Multitiered pool datastore may be tagged for vVols and VMs that support a particular application. The virtualization administrator and storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 444
Capability profile identifier. Capability profile name. Capability profile description. VMware UUID of the capability profile. Associated storage pool identifier. Service level of the underlying storage pool. Valid values are: ● Platinum ● Gold ● Silver ● Bronze Comma-separated list of user-defined - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 445
Table 124. Capability profile attributes (continued) Attribute Description Space efficiency Comma-separated list of available space efficiency policies for the underlying storage pool. Valid values are: ● Thick ● Thin Health state Health state. Health details Additional health information. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 446
port: 443 HTTPS connection ID = cp_1 Name = CapabilityProfile1 Description = VMware UUID = 550e8400-e29b-41d4-a716-446655440000 Storage pool = pool_1 Service level = Gold Usage tag = Exchange, OLTP Drive type = ExtremeMultiTier RAID level = Mixed FAST Cache = Off FAST VP policy - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 447
Action qualifier Qualifier -async -name Description Run the operation in asynchronous mode. Type a name for the capability profile. NOTE: The name may contain alphanumeric values, a hyphen, an underscore, and a period. It cannot start with hyphen or period, and cannot consist only of digits. - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 448
the sum of all the storage resources that have this policy or on each individual storage resource. Values are one of the following: ● yes ● no (default) Paused Whether the defined I/O limit policy is paused. Values are one of the following: ● yes ● no Type Whether the I/O limit is absolute or - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 449
-type Specify whether an absolute or density-based policy will be created. Values are one of the following: ● absolute (default) ● density -maxIOPS Specify the maximum IOPS. Cannot be specified when -type is density. -maxKBPS Specify the maximum KBPS. Cannot be specified when -type is density - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 450
Qualifier Description -burstTime Specify the time interval during which the burst rate is in effect, in minutes. Requires the use of -burstRate and -burstFrequency. Use the following format: m, where: ● -Number of minutes within the range 1 - 60. ● m-Qualifier to identify minutes. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 451
ID = IOL_2 Operation completed successfully. Example 3 The following command failed because -type was set to absolute, but options only applicable to a -type of density were specified. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/iolimit create -name "HR2" -type absolute - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 452
I/O limit. Type a brief description of the I/O limit. Indicates whether the defined I/O limit policy is paused or resumed. Values are one of the following: ● yes ● no (default) Specify whether and absolute or density-based policy will be created. Values are one of the following: ● absolute - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 453
Qualifier Description -noMaxKBPS Specify to clear the -maxKBPS setting. -maxIOPSDensity Specify the maximum IOPS per GB size of the attached object. -maxKBPSDensity Specify the maximum KBPS per GB size of the attached object. -nomaxIOPSDensity Specify to clear the -maxIOPSDensity setting. - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 454
View I/O limit policies Display the settings for the specified I/O limit policy or for all existing I/O limit policies. Format /stor/config/iolimit [-id ] show Object qualifier Qualifier -id Description Type the name of the I/O limit policy to display. Example The following command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 455
Manage I/O limit configuration An I/O policy allows you to limit throughput and bandwidth, providing for more predictable performance in system workloads, that is, between hosts and applications and storage resources. An I/O limit policy can be applied to an individual LUN or to a group of LUNs. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 456
Action qualifier Qualifier -paused Description Specify whether the I/O limit policies defined on the system are enforced. Value is yes or no. Example The following command enforces the use of I/O limits on the system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/iolimit/config - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 457
• Manage replication sessions • Manage virtual RecoverPoint appliance CHAP accounts • Manage Data at Rest Encryption (physical deployments only) • Manage KMIP support (physical deployments only) Manage snapshots A snapshot is a virtual point-in-time image of the data within a storage resource that - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 458
the snapshot will expire and be deleted from the system. Default is 7 days. Last time the snapshot or its that created the snapshot. Valid values are: ● For manual snapshots created by a user, the user account name. by using the Microsoft Volume Snapshot Service (VSS), also called Shadow Copy or - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 459
from each destination. Remote allow autodelete Indicates whether this snapshot participates in auto-delete on the destination. Valid values are: ● yes ● no Default value is no. Clone count Indicates the number of thin clones associated with the snapshot. Replication Origin Array from which the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 460
details about schedule rules. -allowAutoDelete Specify whether the system can automatically delete the snapshot or snapshot set. Valid values are: ● yes (default) ● no -access Specify whether the snapshot is a read-only checkpoint, or read/write for CIFS (SMB) shares or NFS exports. Valid - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 461
which the user snapshot is replicated. You must specify this qualifier when there are multiple replication sessions of a source resource that supports asynchronous replication. ● If there is only one asynchronous session is available for snapshot replication, this qualifier is optional. ● If there - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 462
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/snap show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = 38654705680 Name = Snapshot1 State = Ready Attached = no Resource = app_1 Resource type = LUN group Source = app_1 Source type - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 463
If this switch is not specified, no copy is created. -type -roHosts -rwHosts -force Attachment type. Valid values are (case insensitive): ● default (default)-Allows promoting only one snapshot of the parent storage resource at a time. ● dynamic-Allows promoting several snapshots of the same parent - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 464
HTTPS connection Operation completed successfully. Refresh snapshots NOTE: The refresh snapshots command is valid for both block and file snapshots. Format /prot/snap {-id | -name } refresh [-async] [-copyName ] Object qualifier Qualifier -id -name Description ID of the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 465
the user snap will be replicated to. This qulifier must be specified when there are multiple replication sessions of the source resource that supports Async Snap Replication. -keepSameAsSource Indicates whether or not to use the same retention policy (expiration time and auto-delete) of the source - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 466
NOTE: Before a host can access an attached snapshot, it must have snapshot permissions to the appropriate storage resource. Manage LUNs explains how to configure host access permissions for LUN storage. Format /prot/snap {-id | -name } detach [-async] Object qualifier Qualifier - - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 467
Format /prot/snap {-id | -name } restore [-backupName ][-async] Object qualifier Qualifier -id -name Description Type the ID of the snapshot to which you want to restore the associated storage resource. Type the name of the snapshot to which you want to restore the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 468
Qualifier Description -overrideLock Override the restriction preventing the deletion of a snapshot that is locked by an application. Attempting to delete a locked snapshot without this option specified will return an error message containing the details of the application that has the snapshot - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 469
The snapshot receives ID SNAP_1: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/snap -id SNAP_1 copy -copyName SNAP_Copy Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = SNAP_1 Operation completed successfully. Modify snapshots Change the settings of a - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 470
NFS share. Snapshot Parent snapshot (see Manage snapshots.) Local path Local path to be exported. Export path Export path to the share. Default access Specifies the default access level. Valid values are: ● ro-Read-only access ● rw-Read/write access ● roroot-Read-only Root access ● root-Root - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 471
specified in the hosts lists are defined using /remote/host objects, such as with their identifier. Valid values (case insensitive) are: ● yes (default) ● no Read-only hosts Comma-separated list of identifiers of hosts allowed reading data. Read/write hosts Comma-separated list of identifiers of - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 472
the share. -snap Type the snapshot to associate the share with. -path Type the path at which to mount the file system. Default value is /. -defAccess Specifies the default access level of the share. Valid values are: ● ro-Read-only access ● rw-Read/Write access ● roroot-Read-only Root access - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 473
24 16:05_00 Description = Snapshot = app_1_sg_1 Local path = /fs_1_wckpapp/group.app_1_sg_1.fs.fs_1_wckp Export path = 10.0.0.1:/Share_2012-08-24 16:05_00 Default access = na Advanced host mgmt. = yes No access hosts = Read-only hosts = Host_1, Host_2 Read/write hosts = Host_3 Read - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 474
Format /prot/snap/nfs {-id | -name } set [-async] [-descr ] [-defAccess { ro | rw | roroot | root | na }] [-advHostMgmtEnabled { yes | no }] [{[-roHosts ] [-rwHosts ] [-roRootHosts ] [-rootHosts ] [-naHosts ] | [addRoHosts ] [- - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 475
there is no server-side authentication. When secure NFS is not configured on a NAS server, this is the default value. ● krb5-Kerberos v5 authentication. This is the default value when secure NFS is configured on the NAS server. ● krb5i-Kerberos v5 authentication and integrity. ● krb5p-Kerberos - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 476
- Filters the list of available files and folders on a share to include only those that the requesting user has access to. ● no (default) DFS enabled Indicates whether Distributed File System (DFS) is enabled. Valid values include: ● yes - Allows administrators to group shared folders located on - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 477
- Prevents clients from storing documents and programs in offline cache (default) ● documents - All files that clients open will be available preferably open from offline cache, even when connected to the network. ● manual - Only specified files will be available offline. Create a CIFS snapshot - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 478
-08-24 16:05_00 Description = Snapshot = app_1_sg_1 Local path = /group.app_1_sg_1.fs.fs_1_wckp Export path = 10.64.76.120:/Share_2012-08-24 16:05_00 Default access = na No access hosts = Read-only hosts = 1014[10.192.168.5,10.192.168.6], 1015[10.192.168.9] Read/write hosts = 1016[10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 479
Specify whether CIFS encryption is enabled. -umask Type the default Unix umask for new files created on the share. Programs and files will open from offline cache, even when connected to the network. ● manual-Allows only specified files to be available offline. Example uemcli /prot/snap/cifs -id - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 480
a later OE version (for example, OE 4.1.x) to a Unity system running an earlier version (for example, OE 4.0.x), you cannot have new OE version features enabled on the source. NOTE: At any given point in time, only one command is supported on a replication session. Before running a new command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 481
and may negatively impact performance. The default RPO is one hour. RPO Resource while the session is in an Idle state. ○ manual-User initiated syncing. ○ auto syncing-System initiated of the source and check your network connections for any problems. Once the source is back online, you can fail - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 482
pausing, and then resuming the replication session. If the problem persists, delete and then create the replication session again Lost Communication (0xd) ● Failed Over with Sync (0x8400) ● Failed Over (0x8401) ● Manual Syncing (0x8402) ● Paused (0x8403) ● Idle (0x8404) ● Auto Sync Configured (0x8405 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 483
Table 130. Replication session attributes (continued) Attribute Description between the systems. A change in the network configuration on either side could also interrupt communication. ● Failed over-The replication session has failed over to the destination site. In a failed over state, the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 484
Table 130. Replication session attributes (continued) Attribute Description NOTE: For synchronous replication, the percentage is reported when the replication is in the Syncing state. Sync transfer rate Synchronization transfer rate when the session is in the syncing state. For multi-LUN - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 485
Table 130. Replication session attributes (continued) Attribute Description ● Blank when scheduled snapshots are not replicated. ● Same as source-Keep the destination retention policy the same as the source retention policy ● yes-When -allowAutoDelete is set ● no-When -keepFor is set NOTE: This - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 486
and destination synchronize. Valid values are: ● auto-Data is replicated automatically in order to maintain the wanted Recovery Point Objective (RPO). ● manual-Data is only be replicated when manually initiated. NOTE: This qualifier is used for asynchronous replications only. 486 Protect Data - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 487
that point forward for newly created scheduled snapshots, old snapshots are left as is). No values are allowed. This option is enabled by default if -keepFor or -allowAutoDelete are not set. NOTE: This qualifier is used for asynchronous replications only. Specifies the retention time after which the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 488
snap signature check when using the user snapshot as the common base for Unity systems running OE version 5.1. This qualifier is valid only when specifying the source session. The valid values are as follows: ● yes ● no (default) Indicate whether to overwrite dirty data on the destination; it takes - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 489
Storage system port: 443 HTTPS connection 1: ID = 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 Name = MyRep1 Session type = block Synchronization type = manual RPO = Sync State = idle Health state = OK (5) Operational status = Idle (0x8404) Time of last sync - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 490
system port: 443 HTTPS connection 1: ID = 42949672965_FCNCH0972DDD67_0000_42949672967_FCNCH0972DDD67_0000 Name = rep_sess_sv_1_sv_2_local Session type = lun Synchronization type = manual RPO = Resource type = LUN Sync State = idle Health state = OK (5) Health details = "This - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 491
the wanted Recovery Point Objective (RPO). ● manual-Data only is replicated when manually initiated. NOTE: This qualifier is used for asynchronous but also increases network traffic and may negatively impact performance. The default RPO is one hour. For automatic synchronization, type the time - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 492
session. This qualifier can only be modified when the session is active. Valid values are: ● yes ● no (default) Example The following command changes the source interface and destination interface for replication session 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000: uemcli /prot - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 493
Pause replication sessions Pause a replication session. Format /prot/rep/session {-id | -name } pause [-async] Object qualifiers Qualifier -id -name Description Type the ID of the replication session to be paused. Type the name of the replication session to be paused. Action - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 494
base snapshots, those snapshots trigger a full synchronization. Beginning with Unity 5.1.2, common base snapshots have signatures that allow delta synchronization to occur. NOTE: This qualifier does not support synchronous block replications. -forceFullCopy This qualifier specifies that a full - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 495
the session from the source system automatically removes the destination and source replication sessions. This ensures that you do not have to manually delete the associated storage resources or NAS servers from the destination system. NOTE: Once you delete a replication session, data from the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 496
Object qualifiers Qualifier -id -name Description Type the ID of the replication session to delete. Type the name of the replication session to delete. Action qualifiers Qualifier -async Description Run an action in asynchronous mode. Example The following command deletes replication session - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 497
where role=source. ● no-For an unplanned failover. Can only be issued from the destination system. Where -sync is not specified, this is the default value for a remote replication session or session where role=destination. NOTE: If the Network status=OK, the source system is probably OK. The command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 498
base snapshots, those snapshots trigger a full synchronization. Beginning with Unity 5.1.2, common base snapshots have signatures that allow delta synchronizations to occur. NOTE: This qualifier does not support synchronous block replications. -forceFullCopy This qualifier specifies that a full - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 499
Operation completed successfully. Preserve asynchronous replication sessions Initiates a preserve asynchronous replication sessions operation on a NAS server synchronous replication session. After a NAS server synchronous replication session fails over or fails back with its file system synchronous - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 500
Objective (RPO). ● manual-Data is replicated when manually initiated. NOTE: This network traffic and may negatively impact performance. The default RPO is one hour. Type the time interval Designate the user snapshot as the common base for Unity systems running OE version 5.1. If this qualifier is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 501
as the common base on the destination resource for Unity systems running OE version 5.1. NOTE: This qualifier (CHAP). Two type of CHAP are supported: ● Incoming Forward CHAP - This is password). The outgoing CHAP secret input format. Valid values are: ● ascii - Secret in the ASCII format (default - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 502
[-outSecretFormat {ascii|hex}]] Action qualifier Qualifier Description -outUsername Type the outgoing CHAP user name. -outSecret Type the outgoing CHAP secret (password). By default, the CHAP secret is an ASCII string that is 12 to 16 characters. Hexadecimal secrets are 12 to 16 pairs of data - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 503
● Locking Enabled-Self encrypting drive is activated. ● Locking Disabled-Self encrypting drive is not activated. ● Unsupported-Self encrypting drive is not supported by the storage system. NOTE: Once enabled, this option allows the storage system to interact with external key management servers that - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 504
port: 443 HTTPS connection Operation completed successfully. Manage KMIP support (physical deployments only) KMIP server configuration of the storage system. Table 133. KMIP attributes Attribute ID Username Password Port Timeout Address Description KMIP server identifier. Username for accessing - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 505
View KMIP settings (physical deployments only) View settings for KMIP support. Format /prot/encrypt/kmip show Example The following command lists input the password and the password confirmation. -port Specify the port number used by the KMIP server for KMIP communications. Default value is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 506
Qualifier -addr Description Specify a list of KMIP server addresses to designate as default addresses. Separate the addresses with a comma. Both IP addresses and FQDN host names are supported. The system uses the addresses in the order in which they are typed. NOTE: Each Key Manager server vendor - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 507
to import data from a VNX1 or VNX2 storage system (source) to a remote Unity storage system (target). Two types of VNX imports are available: ● Virtual Data import. NOTE: At any given point in time, only one command is supported on an import session. Before running a new command, ensure that you - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 508
Cutting over ● Incremental copy ● Ready to commit ● Committing ● Completed ● Cancelling ● Cancelled ● Pending ● Syncing Progress Import session progress. Only supported for NAS import. Source system Remote system identifier for source system. Source resource Source resource identifier. Target - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 509
Table 135. Reasons for import session Minor failures (continued) Reasons Session syncing failed. Session syncing failed due to copy file from source to destination. Session failed to cutover. Session has configuration failure. Session failed due to data failure. Session failed due to connection - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 510
are imported from a VNX1/VNX2 storage system (source) to a remote Unity storage system (target). Block VNX import makes use of the SANCopy feature which storage. NOTE: At any given point in time, only one command is supported on a block import session. Before running a new command, ensure that you - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 511
to be transferred for the current import stage. bytes Only supported for block import. Percent remaining for import Specifies the percentage both source and target for data transfer. ● Create an import connection to a Unity-based target system. ● Create a block import target (LUN or LUN Group) - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 512
Qualifier Description NOTE: Default is to throttle the import transfer, which means that it is throttled at less than the full speed. -srcSys -srcRes -lunPoolPairs Specifies the source system. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 513
and target storage systems. Valid values are: ● yes ● no NOTE: Default is to throttle the import transfer, which means that it is throttled at is recommended that the cutover threshold be set to a value smaller than the default value of 5 percent. Lastly, cut over an import session only when the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 514
Action qualifier Qualifier -async Description Run the action in asynchronous mode. Example The following command cuts the import session, import_1, over to the target system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/block -id import_1 cutover Storage system address: 10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 515
VDM on a VNX1 or VNX2 storage system (source) is imported to a remote Unity storage system (target). The file systems (common log or split log) associated with . NOTE: At any given point in time, only one command is supported on a file import session. Before running a new command, ensure that you - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 516
Table 137. File import session attributes (continued) Attribute Description ● OK (5)-Session is operating normally. ● OK BUT (7)-Session is in one of the following states: ○ Session is initialized but paused. ○ Session is paused to migrate data in initial copy. ○ Session is paused to sync data in - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 517
default production port Target production port identifier. The default domain password Password for the source VNX to the current Unity-based target system. ● Create a Unity system matches the code page being used on the VNX system. With Unity OE 4.3 and later, the code page of the Unity - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 518
remote) system. Specifies the source resource. Specifies the default storage pool to store target NAS server configuration information sourceFsId2~sourceFsId3:destination_pool_friendlyId (sourceFsId2 and sourceFsId3 must be existing supported source file system IDs, the other file system IDs between - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 519
password for authentication to the DHSM service on the source Data Mover. Specifies the password for authentication to the DHSM service on ,sourceFsId2~sourceFsId3. sourceFsId1, sourceFsId2, and sourceFsId3 must be existing supported source file system IDs. The source file systems with IDs between - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 520
sourceFsId2, and sourceFsId3 must be existing supported source file system IDs. The source creation compares server parameters between VNX and Unity. When import session creation fails with is spa_iom_0_eth0. ● Migrate the direct match UNIX Directory Service. ● File systems 13, 20 through 25, and - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 521
interfaces will be created is spa_iom_0_eth0. ● Migrate the direct match UNIX Directory Service. ● File systems 13, 20 through 25, and 30 are to be imported to the CIFS server on the source VDM is cifsadmin1 ● The password for authentication to the CIFS server on the source VDM is cifspassword1 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 522
is Initialized or the target production interface creation fails. Specifies the user name for authentication to the CIFS server on the source VDM. Specifies the password for authentication to the CIFS server on the source VDM. Specifies the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 523
Qualifier Description NOTE: The user is prompted to input the password and the password confirmation. -srcFsImportedAsVMWareDatastore Specifies what source file systems are imported as VMware datastore file systems. Only applies to file import when the session is initialized. NOTE: - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 524
) server name must be unique on the network. NOTE: If not specified, the default name for renaming the source CIFS server is the original CIFS server name that is password. -domainPasswdSecure Specifies the password in secure mode. NOTE: The user is prompted to input the password and the password - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 525
import session import_1 being cut over to the target system while specifying the AD organizational unit tree: uemcli -u admin -p -sslPolicy accept /import/session/nas -id import_1 cutover -netbiosName -cifsServerName -domainUsername -domainPasswd -ou - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 526
in secure mode (not necessary for standalone CIFS server). NOTE: The user is prompted to input the password and the password confirmation. -ou Specifies the complete AD organizational unit tree for the source CIFS server. NOTE: This is an optional parameter,if provided the ldap search - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 527
system to pool mapping = res_10~res_11:pool_1 Target file system access policy mapping = Target import interface = if_5 Target default production port = spa_iom_0_eth0 Target production interface to port mapping = if_6:spa_iom_0_eth0 Target production interface to vlan mapping = if_6 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 528
= res_12~res 13:pool_1 Target file system access policy mapping = 1400:UNIX; 174:WINDOWS Target import interface = if_5 Target default production port = spa_iom_0_eth0 Target production interface to port mapping = if_7:spa_iom_0_eth0 Target production interface to vlan mapping = if_7 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 529
Example The following command displays import status for each element in the specified import session: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/element -importId import_2 show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: Source - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 530
● Pending ● Running ● Paused ● Failed ● Completed ● Cancelled SP owner Default destination LUN SP owner. Valid values are: ● SPA ● SPB Source system rejects the WWN as non-recognizable, you can convert the WWN manually to the Dell EMC Unity system form, such as 60:00:01:6F.. Target resource - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 531
the longer the import will take. Valid values are: ● Low ● Medium ● High (default) Create a generic import session Create an import session for third-party systems. Format /import/ , you can convert the WWN manually to the Dell EMC Unity system form, such as 60:00:01:6F.. Data Mobility 531 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 532
targetResName Name of the destination storage resource. -throttle Specifies the import session throttle value. Valid values are: ● Low ● Medium ● High (default) NOTE: You can change the Throttle setting when a session is running or paused. Only the / import/session/generic show -detail CLI command - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 533
Qualifier -cancelled Description Show only cancelled sessions. Example The following command displays all import sessions on the system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 534
Object qualifiers Qualifier -id -name Description Type the ID of the import session. Type the unique name for the import session. Action qualifiers Qualifier Description -newName Specifies the new name of the import session. -descr Specifies the import session description. -srcSystemName - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 535
Action qualifier Qualifier -async Description Run the operation in asynchronous mode. Example The following command pauses the "gen_import_1" import session: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic -id gen_import_1 pause Storage system address: 10.0.0.1 Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 536
Cancel a generic import session Cancels an existing active or failed third-party system import session. NOTE: Once an import session has been cancelled, it cannot be restarted. Format /import/session/generic {-id | -name } cancel [-async] Object qualifiers Qualifier -id -name - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 537
Action qualifier Qualifier -async Description Run the operation in asynchronous mode. Example The following command restarts the "gen_import_1" import session: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /import/session/generic -id gen_import_1 restart Storage system address: 10.0.0.1 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 538
to the source system. Common base snapshots can be snapshots that were created according to an established schedule. Common base snapshots can also be manually created snapshots of both the source and destination systems. NOTE: The precheck can only be performed with the CLI. It cannot be performed - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 539
. Please remove the move session, address the issue, and recreate the move session. ○ The move session encountered an internal error. Please contact your service provider. Health details Additional health information. See Appendix A, Reference, for health information details. Data Mobility 539 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 540
critical than the average or normal move session. ● Normal-Designated for move sessions that are appropriate for most use cases. This is the default value. ● Above normal-Designated for move sessions that are slightly more critical than the average or normal move session. ● High-Designated for move - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 541
have advanced deduplication applied to it. This option only applies when data reduction is enabled. Valid values are: ● yes ● no (default) -async Run the operation in asynchronous mode. Example 1 The following command creates a move session. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 542
over other move sessions. ● below-Designated for move sessions that are slightly less critical than the average or normal move session. ● normal (default)-Designated for move sessions that are appropriate for most use cases. ● above-Designated for move sessions that are slightly more critical than - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 543
Example The following command modifies the settings of a move session. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session -id MoveSession_1 set -priority below Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = MoveSession_1 Operation completed successfully. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 544
Object qualifier Qualifier -id Description Type the ID of the move session. Action qualifier Qualifier -async Description Run the operation in asynchronous mode. Example The following command cancels a move session. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /move/session -id - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 545
for each event. Some log entries generate alerts. Alerts are usually events that require attention from the system administrator and typically indicate a system problem. For example, you might receive an alert telling you that a drive has faulted, or that the system is low on storage capacity. In - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 546
service personnel. Table 142. Alert attributes Attribute ID Time Message ID Message Description Severity Acknowledged State Duplications Description ID of the alert. Date and time (in GMT) when the alert occurred. Alert message ID. Alert message. Description of a problem be manually cleared using - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 547
this qualifier, the value is the current system time. -limit -severity Type the maximum number of records to display. The value cannot exceed the default number 100. Type the minimum severity level of the events to display. For example, if you type critical, records for the alert and emergency - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 548
Type the maximum number of records to display. The value cannot exceed the default number 100. -acknowledged Type to specify a list of alerts that have or = error Acknowledged = no State = Active_Manual(unsolved and need manually marked as inactive after been solved) Duplications = 0 2: ID - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 549
/alert/hist -id alert_3 delete Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Deactivate alerts Manually deactive an alert that is in the Active_Manual state after it has been resolved. Format /event/alert/hist -id deactivate - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 550
settings Specify how the system handles alerts, which are notifications of system and user events. You can have the alerts sent directly to your service provider and e-mailed to specific addresses. You can also have the system send alerts as traps to an SNMP destination. Configure SNMP destinations - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 551
Table 143. Alert attributes (continued) Attribute Description ● no NOTE: Regardless of whether this is enabled, alerts will always be sent for thinly provision pools that are over-subscribed. Call home suppression start time Call home suppression end time Date and time when the call home - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 552
increments between 1 and 48 hours. NOTE: Use this option to temporarily suppress call home alerts when you are intentionally performing service actions on your system. -stopCallHomeSuppression Specify to disable call home suppression. Example 1 The following command changes these alert settings - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 553
address to send alerts to. Specify the minimum severity of alerts that will trigger emails. Valid values are: ● critical ● error ● warning ● notice (default) ● info Example This example shows the configuration of the "to" email address of "[email protected]" and a severity of "info". uemcli -d 10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 554
Format /event/alert/conf/emailto { -id | -addr } set [ -newAddr ] [ severity { info | notice | warning | error | critical } ] Object qualifier Qualifier -id -addr Description Type the ID of the alert configuration you want to modify. Type the address of the "email to" - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 555
Example This example shows the configuration of all of the alert emails on the system. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /event/alert/conf/emailto show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID Address Severity threshold = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 556
● Warnings - Indicate that a problem has occurred or may occur. ● Errors - Report system problems that occurred or are occurring. You -Digest algorithm 5 ● sha - Secure Hash Algorithm Auth password Authentication password for accessing the SNMP destination. Privacy protocol Protocol that is - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 557
aes - Advanced Encryption Standard ● des - Data Encryption Standard -privPassword Type the privacy password. -privPasswordSecure Specify the password in secure mode. The user will be prompted to input the password. -v2c Specify that an SNMP v2c destination will be created. -community Specify - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 558
ID = Host1_333 Operation completed successfully. View SNMP destinations View details about SNMP destinations. You can filter on the SNMP destination ID. NOTE: The show action command explains how to change the output format. Format /event/alert/snmp [-id ] show Object qualifier Qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 559
SNMP v2c destination community string. Example The following command changes the authorization protocol, privacy protocol, authorization password, and privacy password for SNMP destination Host1_323: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /event/alert/snmp -id Host1_323 set -authProto - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 560
Format /event/alert/snmp -id delete Object qualifier Qualifier -id Description Type the ID of an SNMP destination to delete. Example The following command deletes SNMP destination Host1_323: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /event/alert/snmp -id Host1_323 delete Storage - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 561
System Topics: • Change the service password • Service the system • Manage core dump files • Manage Service Information • Manage SSH access • Service the storage processor (SP) Change the service password The system ships with a default service password for performing service actions on the system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 562
connection Operation completed successfully. Shut down the system Shuts down the system. NOTE: This command can be executed in normal mode only. Format /service/system shutdown Example The following command shuts down the system (in normal mode only): uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 563
the system. -type Specify the type of service information to collect. Valid values are: ● full(default)-Collect the full set of service information. ● perfAssessment-Collect service information for doing a performance assessment. ● perfTrace-Collect service information for doing a trace. ● minimum - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 564
! /service/system collect -serviceInfo -type perfAssessment Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. Manage core dump files Manage the list of core dump files, which contain system information used by support for troubleshooting - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 565
dump file to be deleted. Example The following command deletes a core dump by specifying its name. uemcli -d 10.0.0.1 -u local/serviceuser -p Password /service/system/dump -id mspa:CP_:2016-06-22_15_13_20_19151_ECOM delete Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 566
credentials. Set SSH access Manage SSH access to the system. Format /service/ssh set -enabled {yes | no} Action qualifiers Qualifier Description -enabled Flag indicating whether the SSH access is enabled. The following are the password requirements. Value is one of the following: ● yes ● no Example - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 567
qualifier Qualifier -id Description Identifies the storage processor. Example The following command enters the service mode: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/sp -id spa service Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 568
-id reimage Object qualifier Qualifier -id Description Identifies the storage processor. Example uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/sp -id spa reimage Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Operation completed successfully. 568 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 569
system displays not available instead of a timestamp. NOTE: By default, the timestamps are UTC time. If you specify a timezone offset with -gmtoff, the timestamps adjust accordingly. View metrics service settings View the current metrics service settings. NOTE: Use the show action command to change - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 570
sec), 2012-9-14 12:00:00 (300 sec), not available (3600 sec), not available (14400 sec) Configure metrics service Enable historical metrics collection. Format /metrics/service set -historyEnabled { yes | no } NOTE: Only administrators are allowed to run this command. Action qualifiers Qualifier - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 571
and real-time collection. This attribute does not apply to family, set, and compound metrics. View metrics settings View information about supported metrics. NOTE: Use the show action command to change the output format. Format /metrics/metric [-path ] [-availability { historical | real - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 572
64 KB page size Type = fact Unit = Count Availability = real-time Example 3 The following command displays all available real-time metric service settings for the system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/metric -availability real-time show Storage system address: 10 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 573
446: Path = sp.*.storage.summary.readsRate 447: Path = sp.*.storage.summary.totalBytesRate Example 4 The following command displays the metrics service settings for the metrics with the specified paths: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/metric -path sp.*.storage.lun - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 574
of metric paths. NOTE: When typing metric paths, replace . with \., , with \, and \ with \\ in the object names. -interval Specify an interval for the metric values. Default interval is seconds. -from Specify the start of the query period. The format is: YYYY-MM-DD HH:MM:SS or YYYY-MM-DDTHH:MM - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 575
Qualifier -count -flat -summary Description Specify the number of samples to display. A sample is a set of metric values related to a single timestamp. Valid values are numbers greater than or equal to one. Displays the member values for grouped metrics. Displays the maximum, minimum, and average - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 576
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.spa.storage.lun.sv_1.readsRate show -interval 60 -from "2014-06-24 02:12:00" -to "2014-06-24 02:1 4 :00" Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection Timestamp |SP |LUN |Read | | | - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 577
|spb |sv_2 | 0.467 Example 4 The following command displays the specified metric, associated with three object types, SPs, pools, and LUNs, every 60 seconds during the query period: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.storage.pool.*.lun.*. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 578
Example 6 The following command displays the member values for specified metrics every 60 seconds during the query period: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /metrics/value/hist -path sp.*.cpu.summary.utilization show -interval 60 -from "2014-06-24 03:14:00" -to "2014-06-24 03:16:00" - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 579
- Hour ● MM - Minute ● SS - Second Identifies the object name or metric value. View real-time metrics settings View real-time metrics settings. The default output appears in a tabular format. NOTE: Use the show action command to change the output format. Format /metrics/value/rt -path show - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 580
Qualifier Description -summary Displays the maximum, minimum, and average value for each metric. NOTE: Objects can come and go at any time, mostly due to object creation and deletion. In flat format, every time a new object is included, the title in tabular or CSV format or the attributes in NVP - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 581
Client = sv_1 CIFS Read = 0.200 3: Timestamp = 2014-06-24 03:26:20 SP = spb Client = sv_2 CIFS Read = 0.100 4: Timestamp = 2014-06-24 03:26:30 SP = spb Client = sv_2 CIFS Read = 0.200 Manage Metrics 581 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 582
not installed. ● No other pools have been created. ● For virtual deployments, all virtual disks have been assigned a tier type. Retrieve default pools configuration uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /store/config/auto show Storage system address: 10.0.0.1 Storage system port: 443 - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 583
RAID level = Stripe length = Initiate auto configuration uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/auto set Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection All disks in the system will be used to configure pools. Do you want to proceed? yes / no: - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 584
Estimated relocation time = Create a pool using drives with specific characteristics This example applies to hybrid Flash arrays, which only support traditional pools. Retrieve the list of storage profiles uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/profile -configurable show - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 585
successfully. Configure a dynamic pool You can configure dynamic pools for all-Flash models of Unity running OE version 4.2.x or later. New pools created for these models are dynamic pools by default. Dynamic pools implement advanced RAID technology. In dynamic pools, a RAID group is spread across - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 586
= pool_13 Operation completed successfully. Configure a traditional pool for an all-Flash model You can configure traditional pools for all-Flash models of Unity running OE version 4.2.x and later by explicitly setting the Type attribute to traditional. If you do not set Type to traditional when - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 587
Step 2: Configure the traditional pool Configure a traditional pool with the specified profile. Make sure you set -type to traditional and that the -drivesNumber is a multiple of the RAID group width. uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool create -name test -diskGroup - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 588
CIFS enabled = no Workgroup = Windows domain = Organization unit = Multiprotocol sharing enabled = yes Unix directory service = ldap Default Unix username = fred2 Default Windows username = fred2 Extended Unix credentials enabled = no Credentials cache retention = 15 Health state - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 589
operate normally - additional configuration steps are required. Please ensure configuration of Unix directory service. Please ensure configuration of CIFS server." Configure LDAP and upload the Certificate Authority certificate Configure LDAP uemcli /net/nas/ldap -server nas_1 set -ip 10.0.0.1, - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 590
pool = pool_24 Tenant = Interface = if_24 CIFS enabled = yes Multiprotocol sharing enabled = no Unix directory service = none Default Unix username = Default Windows username = Username translation = Health state = OK (5) Health details = "The component is operating normally - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 591
different storage resources. Identify pool capacity and configure a resource Identify the SP where the server to be used is located by default uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/nas/server -id nas_1 show Storage system address: 10.0.0.1 Storage system port: 443 HTTPS - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 592
Check the maximum capacity of the appropriate pool on the identified SP uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/pool show -detail Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection 1: ID = pool_1 Name = TestPool Description = Total space = - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 593
Configure a resource uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/prov/fs create -name FileSystem01 -descr "NFS shares" -pool capacity -server nas_1 -size 1TB -type nfs Storage system address: 10.0.0.1 Storage system port: 443 HTTPS connection ID = res_1 Operation completed successfully. - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 594
choose to remove the associated replication sessions manually. 4. Create a remote replication session For more information, see the Unisphere CLI User Guide. 2. Zone the Synchronous Replication FC ports between you want: ● For synchronous replication support (Synchronous connection mode), use the - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 595
SPB on the target Unity system. Once the mobility interface is configured, you can create the import connection between the Unity system and the VNX the VLAN ID only when you have configured the network switch port to support VLAN tagging of multiple VLAN IDs. About this task Ensure that you create - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 596
: ● For remote replication, the IP address and associated user authentication credentials to connect to the remote system. ● For local replication, the password associated with your user account. ● The connection mode you want to use for the replication: Asynchronous, Synchronous, or Both. NOTE: If - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 597
ID = RS_1 Name = MyTargetSystem Address = 10.1.1.1 Model = Unity 300 Serial number = FCNCH01234567A90 Connection type = async Source interfaces specify asynchronous (async), synchronous (sync), or manual synchronization (manual). ● For asynchronous replication, determine the Recovery - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 598
NOTE: If you are configuring asynchronous replication in a coexisting synchronous and asynchronous replication with one source resource topology, create the asynchronous replication destination NAS server with both the -replDest and the -backupOnly attributes set to yes. These attributes must be set - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 599
2. Run the following command to create a synchronous replication session between file systems on the source system and the remote system: uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session create -name MyFSRep1 -srcRes res_1 -dstType remote -dstSys RS_1 -dstRes res_1 Storage system - Dell Unity 300 | Unity™ Family Unisphere® Command L - Page 600
of the health status of the component. When applicable, it also includes a URL to the online help or support page that provides steps to resolve a problem. A component may have multiple description strings indicating the health of the relevant subcomponents. For example: Health details = "The
Dell Unity™ Family Unisphere® Command
Line Interface User Guide
Version 5.x
Part Number: 302-002-578
April 2022
Rev. 10