Tag Archives: emc

Dell EMC Unity Unisphere CLI Command Reference Guide (UEMCLI)

This is a list of syntax examples for using uemcli on a Unity array.  It covers system management, networking, host management, hardware,  storage management, data protection and mobility, events and alerts, andsystem maintenance.  Install the UEMCLI on your client machine or open an ssh session to the unity array as uemcli is already accessible there.

This post is designed to help quickly find the general syntax of uemcli commands and be short enough to print out a copy.  For details on all of the specific options for each of these commands I recommend downloading the (612 page long) Dell EMC CLI Reference Guide.

System Management
Displays the general settings for a physical system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/general show -detail
Displays the general settings for a virtual system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/general show
Disable automatic failback uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/general set –autoFailback off
Fail back all NAS servers that have failed over uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/general failback
Perform a health check of the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/general healthcheck
Displays the general setting information for the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/info show
Change System Information uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/info set -contactFirstName Zach -contactLastName Arnold -contactEmail x@mail.com -contactPhone 5559999 -location here -contactMobilePhone 987654321
Create a session to upgrade the system software uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/upgrade create –type software
creates a session to upgrade the storage processor uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/upgrade create –type sp –newSPModel SP500
Display details about the hardware upgrade session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/upgrade show
Displays details about the software upgrade session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/upgrade show
Resume upgrade uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/upgrade resume
Cancel upgrade session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/upgrade cancel
Display security settings for the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/security show
Changes system security settings uemcli /sys/security set -fips140Enabled yes
Display system time uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/time show
System reboot uemcli /sys/time set -utc “2018-01-17 12:16:30” -force allowreboot
Display support configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/config show
Display detailed support configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/config show -detail
Specifies the support services proxy server parameters uemcli /sys/support/config set -supportProxyAddr 10.1.55.1 -supportProxyPort 8080 -supportProxyUser user1 -supportProxyPasswd password123 –supportProxyProtocol http
Displays support contracts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/contract show
Refresh support conracts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/contract refresh
Display Centralized ESRS configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsc show -detail
Check network connectivity from Centralized ESRS to EMC uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsc checkNetwork -address 10.10.96.97
Displays the Integrated ESRS configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsi show -detail
Specifies the Integrated ESRS parameters uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsi set -acceptEula yes
Displays network connectivity for Integrated ESRS uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsi checkNetwork
Display Integrated ESRS policy Manager server config uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsi/policymgr show -detail
Change the Policy Manager and proxy server attributes uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/esrsi/policymgr set -enable no
Show configuration details for Connect Home uemcli -d 10.1.55.1 -u admin -p Password /sys/support/connecthome show -detail
Enable Connect Home and specify SMTP server uemcli -d 10.1.55.1 -u local/username -p Password /sys/support/connecthome set –enable yes –smtpServer 10.10.99.99
Test email alert uemcli -d 10.1.55.1 -u local/username -p Password /sys/support/connecthome test
Displays a list of user roles on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /user/role show -detail
Create user account with operator role uemcli -d 10.1.55.1 -u Local/username -p passwd123 /user/account create –name user1 –type local –passwd Password –role operator
Displays a list of all user accounts on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /user/account show
Change password for user account user_user1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /user/account –id user_user1 set –passwd NewPassword –oldpasswd OldPassword
Delete user account user_user1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /user/account -id user_user1 delete
Display support credentials uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/support/account show
Display list of all feature licenses on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/limit show -detail
Display list of all feature licenses on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/lic show
This command accepts the EULA uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/eula set -agree yes
Create remote manager configuration uemcli /sys/ur create -addr 10.10.0.1 -certificate 2fd4e1c67a2d28fced849ee1bb76e7391b93eb12 -passphrase password
Display Unisphere Central manager configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/ur show
Display settings for remote system logging uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/rlog show
Configure remote system logging with these settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/rlog set –enabled yes –host 10.64.74.12 –port 500 –protocol UDP -facility chicago
Delete X509 certificate uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/cert -id vasa_http-vc1-servercert-1 delete
Display details about all schedules uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/task/sched show
Delete schedule MySchedID uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/task/sched -id MySchedID delete
List details for all task rules assigned to protection schedule uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/task/rule –sched SCHD_3 show
Delete a task rule uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/task/rule –id RULE_1 delete
Display list of all jobs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/task/job show {-detail}
Resume an existing job uemcli -d 10.1.55.1 -u Local/username -p passwd123 /sys/task/job -id N-23564 resume
Display list of steps of the specified job uemcli /sys/task/job/step -jobId N-23654 show {-detail}
Network
Create a NAS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server create -name NasSanguy_1 -sp spa -pool pool_0 -enablePacketReflect yes
Displayl details for a list of all configured NAS servers uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server show -detail
Uses LDAP as the Unix Directory Service uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server -id nas_1 set -mpSharingEnabled yes -unixDirectoryService ldap
Change replication settings for NAS server nas_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server -id nas_1 set -replDest yes
Change storage processor to SPB for NAS server nas_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server -id nas_1 set -sp spb
Delete NAS server nas_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server –id nas_1 delete
Create user mapping report for NAS server nas_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/server -id nas_1 update -async -userMapping
View FTP or SFTP server settings for a NAS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/ftp show
View LDAP settings of a NAS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/ldap -server nas_1 show -detail
Create a new NAS interface uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/if create -server nas_1 -port eth0_SPA -addr 10.1.55.1 -netmask 255.255.255.0
Display all NAS interfaces on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/if show
Change the gateway address for interface IF_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123/net/nas/if –id IF_1 set -gateway 2001:db8:0:170:a:0:2:70
Delete interface IF_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/if –id IF_1 delete
Create a network route for interface if_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/route create -if if_1 -type net -target 10.64.200.10 ‑netmask 255.255.255.0 -gateway 10.64.74.1
Display all NAS routes on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/route show -detail
Delete route ‘route_1’ uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/route -id route_1 delete
Configure a custom Kerberos realm for NAS server nas_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/kerberos -server nas_1 set -addr master.thesanguy.com,slave.thesanguy.com -realm domain.thesanguy.com
Show Kerberos settings for all NAS Servers uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/kerberos show
Display information for VLANs that are in use uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/vlan show -from 100 -inUse yes
Create a CIFS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/cifs create -server nas_0 -name CIFSserver1 -description “CIFS description” -domain domain.thesanguy.com -username user1 -passwd password1
Displays CIFS server settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/cifs show
Delete a CIFS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/cifs -id CIFS_0 delete
Create an NFS server on NAS server nas_1 with ID nfs_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/nfs create -server nas_1 -v4 yes -secure yes
Display NFS server settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/nfs show -detail
Change credit cache retention period for an NFS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/nfs -id nfs_1 set -credCacheRetention 20
Delete an existing NFS server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/nfs -id nfs_1 delete
View details about CAVA settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/cava show
Modify CAVA settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/cava -server nas_1 set -enabled yes
View details about CEPA configuration settings uemcli /net/nas/event/config -server nas_1 show -detail
Enable Event Publishing and set the post-event policy uemcli /net/nas/event/config -server nas_1 set -enabled yes -postEventPolicy accumulate
Create a CEPA pool and a list of post events to be notified on uemcli /net/nas/event/pool create -server nas_1 -name mypool1 -addr 10.1.2.100 -postEvents CreateFile,DeleteFile
View details about a CEPA pool uemcli /net/nas/event/pool -server nas_1 show
Change the name for a CEPA pool uemcli /net/nas/event/pool -id cepa_pool_1 set -name TestCepaPool
Delete a CEPA pool uemcli /net/nas/event/pool –id cepa_pool_1 delete
Create VMware protocol endpoints servers for File Vvols uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/vmwarepe create -server nas_1 -if if_ 1
View VMware protocol endpoints servers for File Vvols uemcli -d 10.1.55.1 -u Local/username -p passwd123/net/nas/vmwarepe show -detail
Delete a VMware protocol endpoints server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/vmwarepe –id PES_0 delete
View details about the iSCSI configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/iscsi/config show
List all iSCSI nodes on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/iscsi/node show
Change the network interface alias assigned to the node uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/iscsi/node -id ISCSIN_1 set -alias “Sample iSCSI node”
View details about the network ports uemcli /net/port/eth show
sets the MTU size for Ethernet port 0 (eth0) on SP A to 9000b uemcli /net/port/eth –id spa_eth0 set –mtuSize 9000
View details about the FC ports uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/port/fc show -detail
Change the speed for FC port fc1 on SP A to 1 Gbps uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/port/fc –id spa_fc1 set –speed 1Gbps
View details about uncommited ports uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/port/unc show -detail
View a list of interfaces on the system uemcli /net/if/mgmt show
Change the settings for an interface uemcli /net/if/mgmt set -ipv4 static -addr 192.168.1.199 -netmask 255.255.255.0 -gateway 192.168.1.254
Create a replication interface uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/if create -type replication -port eth1_spb -addr 10.1.55.1 -netmask 255.255.255.0 -gateway 10.1.55.1
View a list of interfaces on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/if show -detail
Change the gateway address for interface IF_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123/net/if –id IF_1 set -gateway 2001:ac8:0:253:c:0:2:50
Delete an interface uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/if –id IF_1 delete
Create an IP route uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/route create –if IF_1 –type net –target 10.55.99.10 netmask 255.255.255.0 –gateway 10.55.99.254
View details about IP routes uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/route show -detail
Modify an existing IP route uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/route -id RT_1 set -target 10.55.99.99 ‑netmask 255.255.255.0 -gateway 10.55.99.254
Delete an IP route uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/route –id RT_1 delete
Create a link aggregation uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/la create -ports “eth0_SPA,eth1_SPA”
Show the link aggregations on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/la show
Change the settings of a link aggregation uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/la –id la0_SPA set –mtuSize 9000
Delete a link aggregation uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/la –id la0_SPA delete
Configure the DNS settings for the storage system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/dns/config set -nameServer “10.55.13.9,10.55.13.10”
View the DNS server addresses designated as a default uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/dns/config show
View details about configured DNS server domains uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/dns -server nas_1 show -detail
Configure a DNS server domain uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/dns –server nas_1 set -name “storage.thesanguy.com”
Create an NTP server to specify an IP address of each NTP server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ntp/server create –server ntp.thesanguy.com
View details about the NTP server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ntp/server show
Configure the NTP server setting uemcli -d 10.1.55.1 -u Local/username -p 12345 /net/ntp/server set –addr “10.55.9.1,10.55.9.2”
Delete an NTP server record to remove the NTP settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ntp/server –id NTP_10.5.1.207 delete
View details about NIS server domains uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/nis show -detail
Add NIS server addresses to an NIS server domain uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/nis –id nis.thesanguy.com set –ip “10.55.1.38″
View the IP addresses of the SMTP servers uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/smtp show
Specify the IP addresses for the SMTP server setting uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/smtp -id default set -addr 10.55.1.36
View whether NDMP is enabled or disabled uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/ndmp show
Enable NDMP uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/ndmp -server nas_0 set –enabled yes –passwd “passwd123”
View details for configured LDAP settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ldap show
Update a configured LDAP setting uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ldap -id lDAP_1 set –server webhost.thesanguy.com –port 389
Verify the connection to the LDAP server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ldap –id LDAP_1 verify
Delete an LDAP setting uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/ldap –id LDAP_1 delete
Ping a remote host from the specified NAS server interface uemcli /net/util ping -srcIf if_0 -addr 10.1.55.1
Display the route from the specified interface to a remote host uemcli /net/util/traceroute -srcIf if_0 -addr 10.1.55.1
Displays DHSM settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/dhsm show
Modify Distributed Hierarchical Storage Management settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /net/nas/dhsm –server nas_0 set –state Enabled –username newname –passwd newpassword
Create an HTTP connection uemcli /net/nas/dhsmconn create -filesystem fs_1 -secondaryUrl http://10.1.0.115/export/dhsm1
View details for DHSM connections uemcli /net/nas/dhsmconn –fs fs_1 show
Modify settings for an existing DHSM connection uemcli /net/nas/dhsmconn –id dhsmconn_1 modify -mode recallOnly
Deletes an existing HTTP connection uemcli /net/nas/dhsmconn –id dhsmconn_1 delete -recallPolicy no
Host Management
Create a host configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/host create –name MyHost –descr “accounting” -type host –addr 10.64.74.10 -osType winxp
View details about a host configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/host show -brief
Change the settings for a host configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/host –id 1014 set -descr “Storage Team” –osType winxp
Delete a host configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/host –id 999 delete
Lists all host LUNs on host Host_3 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/host/hlu -host Host_3 show -detail
Change the host LUN ID uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/host/hlu -id Host_3_sv_2_prod set –lunid 0
Create an FC or iSCSI initiator and assign it to a host configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/initiator create -host 1014 -uid “20:00:00:00:A9:19:0A:CD:10:00:00:00:A9:19:CD:FD” -type fc
View a list of all initiators uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/initiator show
Modify an already created initiator uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/initiator -id 1058 set -host 1099
List all initiator paths on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/initiator/path show
Configures a remote system configuration for local access uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/sys create –addr 10.55.1.98 –type VNX -dstUsername admin1 -dstPassword password12134
Verify the configuration settings for a remote system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/sys –id RS_1 verify
View the configuration for a remote system on the local system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/sys show -detail
Changes the configuration settings for a remote system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/sys –id RS_1 set –addr “10.55.2.98” -dstUsername Local/username -dstPassword password1234
Deletes the configuration for a remote system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/sys –id RS_1 delete
Add virtual center credentials uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/vc create -addr 10.55.11.109 -username administrator@vsphere.local -passwd xxx -descr “Add vCenter”
Specify a new description for the VMware vCenter server uemcli /virt/vmw/vc -id VC_1 set -descr “This vCenter manages 5 Executive hosts”
Remove an existing VMware vCenter server and its ESXi hosts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/vc -id VC_1 delete
Displays a list of configured VMware vCenter servers uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/vc show
Rescan details of all configured VMware vCenter servers. uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/vc refresh -scanHardware
Adds a VMware ESXi host uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/esx create -addr 10.1.1.1 -username root -passwd xxx -descr “Prod ESX”
Change ESXi host credentials and/or description. uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/esx -id ESX_1 set -descr “New Description”
Delete ESXi host credentials uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/esx -id ESX_1 delete
Display a list of all configured VMware ESXi hosts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/esx -vc VC_1 show
List all VMware ESXi hosts on the specified VMware vCenter server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/esx discover -vc VC_1
Rescan details of a VMware ESXi host uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/esx refresh -scanHardware
Display a list of all existing virtual machines on existing ESXi hosts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/vm -esx ESX_1 show
Manage hard disk properties for VMware virtual machines uemcli -d 10.1.55.1 -u Local/username -p passwd123 /virt/vmw/vmdevice -vm VM_1 show
Hardware
View existing Storage Processors (SPs) uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/sp show
View existing drives uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/disk show
Display the details of all drives on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/disk show -detail
Rescan the system for available virtual disks uemcli -d 10.0.0.2 -u Local/username -p passwd123 /env/disk rescan
Change settings of an existing disk uemcli -d 10.0.0.2 -u Local/username -p passwd123 /env/disk -id vdisk_1 set -name “extreme perf storage”
Display a list of system batteries uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/bat show
View a list of system power supplies uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/ps show
View a list of LCCs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/lcc show
View a list of system SSDs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/ssd show
View a list of system DAEs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/dae show
View details of the system DPE uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/dpe show
View a list of system memory modules uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/mm show
View a list of System Status Cards (SSC) uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/ssc show -detail
View a list of system fan modules uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/fan show
View details about I/O modules in the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /env/iomodule show
Storage Management
Create a dynamic pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 uemcli /stor/config/pool create -name MyPool -descr “dynamic pool” -diskGroup dg_2,dg_28 -drivesNumber 6,10 -storProfile profile_1,profile_2
Create a traditional pool in a model that support dynamic pools uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool create -name MyPool -descr “traditional pool” -diskGroup dg_3,dg_28 -drivesNumber 5,9 -storProfile tprofile_1,tprofile_2 -type traditional
Create a traditional pool that does not support dynamic pools uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool create -name MyPool -descr “my large pool” -storProfile profile_19,profile_20 -diskGroup dg_15,dg_16 -drivesNumber 5,9 -FASTCacheEnabled yes
Create a traditional pool with two virtual disks uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool create -name vPool -descr “my virtual pool” -disk vdisk_0,vdisk_2
Set the subscription alert threshold for pool_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool -id pool_1 -set -alertThreshold 70 -FASTCacheEnabled no
Add new drives to a pool to increase its storage capacity uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool –id pool_1 extend –diskGroup dg_1 –drivesNumber 7 -storProfile profile_99
View a list of pools uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool show -detail
Show all pools for a model that supports dynamic pools uemcli -d 10.0.0.2 -u Local/username -p passwd123 /stor/config/pool show -detail
Shows details for all pools on a virtual system uemcli -d 10.0.0.2 -u Local/username -p passwd123 /stor/config/pool show -detail
Delete a pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool –id pool_1 delete
Modify FAST VP settings on an existing pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool/fastvp -pool pool_1 set -schedEnabled yes
View FAST VP settings on a pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool/fastvp –show -detail
Start data relocation on a pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool/fastvp -pool pool_1 start -endTime 09:00
Stop data relocation on a pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool/fastvp –pool pool_1 stop
Show tier details about the specified pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool/tier -pool pool_1 show -detail
shows details for all storage resources associated with the pool uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/pool/sr -pool pool_1 show -detail
Change FAST VP general settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastvp set -schedEnabled yes -days “Mon,Fri” -at 23:00 -until 09:00
View the FAST VP general settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastvp show -detail
Configure FAST Cache uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastcache create -diskGroup dg9 -drivesNumber 6 -enableOnExistingPools
View the FAST Cache parameters uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastcache show -detail
Extend the FAST Cache by adding more drives uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastcache extend -diskGroup dg9 -drivesNumber 6
Shrink the FAST Cache by removing storage objects uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastcache shrink –so rg_1
Delete the FAST Cache configuration uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastcache delete
View a list of all storage objects, including RAID groups and drives uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/fastcache/so show
Show details for storage profiles uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/profile -configurable show
View details about drive groups on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/dg show -detail
View the current storage system capacity settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/general/system show
View the current system tier capacity settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/general/tier show
View details about a file system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs -id res_99 show
Specify Event Publishing protocols uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs -id res_99 set -eventProtocols nfs,cifs
Delete a file system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs -id res_99 delete
creates a user quota (for user 201 on file system res_1) uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/user create -fs res_1 -path /qtree_1 -userId 201 -softLimit 20G -hardLimit 50G
Change the user quota uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/user -fs res_1 -path /qtree_1 unixName nasadmin show -detail
Create quota tree /qtree_1 on file system res_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/tree create -fs res_1 -path /qtree_1 -softLimit 500G -hardLimit 999G
Display space usage information for all quota trees (on res_1) uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/tree -fs res_1 show -detail
Refresh quota information for all quota trees on res_1 fs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/tree -fs res_1 refresh /
Delete quota tree /qtree_1 on file system res_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/tree -fs res_1 -path /qtree_1 delete
List config info for quota tree /quota/config on res_1 fs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /quota/config -fs res_1 show -detail
Create an NFS share to export a file system through NFS uemcli -u admin -p Password123! /stor/prov/fs/nfs create -name testnfs112 -fs res_26 -path “mypath”
View details of an NFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs/nfs show -detail
Delete an NFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs/nfs –id NFSShare_1 delete
Creates a CIFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs/cifs create –name CIFSshare -descr “a share” –fs fs1 -path ”/cifsshare” -enableContinuousAvailability yes -enableCIFSEncryption yes
List details for all CIFS network shares uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs/cifs show
Set the description of CIFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs/cifs –id SMBShare_1 set -descr “a share”
Delete a CIFS (SMB) share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/fs/cifs –id CIFSShare_1 delete
Create a LUN uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/lun create -name “TheLUN” -descr “The LUN” -type primary -group group1 -pool pool_1 -size 999M
Display the list of existing LUNs uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/lun show
Change the settings of a LUN uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/lun -id lun_1 set -name NewName -descr “My new description” -size 150M
Delete a LUN uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/lun -id lun_1 delete
Refresh a LUN’s thin clone uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/lun -id lun_5_tc refresh -source SNAP_2 -copyName Backup1
Create a consistency group uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/group create -name GenericStorage01 -descr “MyStorage” -sched SCHD_1
Display the list of existing consistency groups uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/group show -detail
Change the settings for a consistency group uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/group -id group_1 set -name NewName -descr “New Descr” -sched SCHD_2 -schedPaused yes -fastvpPolicy startHighThenAuto
Delete a consistency group uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/luns/group -id group_1 delete
Create an NFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/nfs create –name Executive –descr “Executive VMs” –server nas_1 –pool capacity –size 100G -rwHosts host1 -esxMountProtocol NFSv4 -minSecurity krb5 -nfsOwner john -defAccess na
View details about an NFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/nfs show
Change the settings for an NFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/nfs –id NFSDS_1 set –roHosts “HOST_1,HOST_2” -naHosts “HOST_3”
Delete an NFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/nfs -id NFSDS_1 delete
Create a VMFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vmfs create –name “Banking 3” –descr “Banking Grp 3” –pool capacity -size 100G –thin yes –vdiskHosts “1166,1167”
Display the list of existing VMFS datastores uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vmfs show
Change the settings for a VMFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vmfs –id VMFS1 set –name engineering2 –descr “Eng Grp 2”
Delete a VMFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vmfs –id VMFS_1 delete
Refresh the thin clone of a VMFS datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vmfs -id vmware_2_tc refresh -source snapshot2 -copyName Backup1
Display a list of existing protocol endpoints and their characteristics uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/pe show detail
Changes the settings for a VMware protocol endpoint (iSCSI) uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/pe set –id rfc9999.e53a24f1-3324-9999-80a3-c2cabb322a1c set –lunid 5
Create a datastore for VMware Vvols uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vvolds create –name “HR” –cp cp_1,cp_2 –size 10G, 12G –type file –hosts “HostA,HostB”
Display a list of existing VVol datastores and their characteristics uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vvolds show -detail
Modify an existing VVol datastore uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vvolds -id res_1 set -name MyNewName -descr “Descr” -addCp cp_1 -size 10G
Delete VVol datastores and their associated virtual volumes uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vvolds -id res_1 delete -force yes
Display existing VVol datastore allocations uemcli /stor/prov/vmware/vvolds/alloc -vvolds vvolds_1 -pool pool_1 show -detail
Display a list of existing VVol datastores and their characteristics uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vvol –vm VM_1 show -detail
Deletes the specified existing VVol objects uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/prov/vmware/vvol –id naa.6006016005603c009370093e194fca3f delete
Create a capability profile for VVol datastores uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/cp create -name “CapabilityProfile1” -pool pool_1 -usageTag “Prod”
Display a list of existing capability profiles and their characteristics uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/cp show -detail
Modify an existing capability profile uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/cp -id cp_1 set -name “CapabilityProfile2”
Deletes specified capability profiles uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/cp -id cp_1 delete
Create an I/O limit policy uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/iolimit create -name “SALES” -descr “for Sales Dept” -shared yes -type absolute -maxIOPS 500 -maxKBPS 1000
Delete an I/O limit policy uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/iolimit -id IOL_1 delete
Change the settings of an existing I/O limit policy uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/iolimit -id IOL_1 set -name “HR” -maxIOPS 1000 -noKBPS
Display the settings for the specified I/O limit policy uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/iolimit show -detail
Display the settings for the existing I/O limit configuration setting uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/iolimit/config show
Enforces the use of I/O limits on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /stor/config/iolimit/config set -paused no
Data Protection
Create a snapshot of a storage resource uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap create –name accounting –source FS_1 -keepFor 1d
View details about snapshots on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap show -detail
Attach snapshot SNAP_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap –id SNAP1 attach –type dynamic –roHosts HostA,HostB –rwHosts HostC,HostD
Refresh a block snapshot uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap –id 38654705680 refresh –copyName copy1
Replicate snapshots after they have been created uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap –id 38654705680 replicate -keepRemotelyFor 1d
Detaches snapshot SNAP_1 uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap –id SNAP_1 detach
Restore Snapshot uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap –id SNAP_1 restore
Delete Snapshot uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap –id SNAP_1 delete
Copy a snapshot uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap -id SNAP_1 copy –copyName SNAP_Copy
Change the settings of a snapshot uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap -id SNAP_1 set -newName MySnap
Create a snapshot NFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap/nfs create –name NFSshare -descr “SHARENAME” –snap SNAP1 -path / -roHosts “HostA, HostB” -rwHosts “HostC”
Lists the existing snapshot NFS shares uemcli /prot/snap/nfs show -detail
Modifies an existing snapshot NFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap/nfs -id nfs_1 set -descr “SHARENAME”
Delete (destroy) a snapshot NFS share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap/nfs –id nfs_1 delete
Create a snapshot CIFS (SMB) share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap/cifs create –name CIFSshare -descr “SHARENAME” -path /
Lists the existing snapshot CIFS (SMB) shares uemcli /prot/snap/cifs show
Modifies an existing snapshot CIFS (SMB) share uemcli /prot/snap/cifs -id cifs_1 set -descr “My share”
Delete (destroy) a snapshot CIFS (SMB) share uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/snap/cifs –id smb_1 delete
Create a replication session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/rep/session create -name REP1 -srcRes RS_1 –dstType remote -dstSys RS_2 –dstRes LUN_2 –syncType auto –rpo 02h30m
View details about replication sessions uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/rep/session show {-detail}
Change the settings for a replication session uemcli /prot/rep/session –id 64518754321_AFCDEF34234A3B_0000_35674324567_ADCDF154321341_0000 set –srcSPAInterface if_1 –srcSPBInterface if_2 –dstSPAInterface if_3 –dstSPBInterface if_4
Manually synchronize a replication session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/rep/session –id REPS_1 sync
Delete a replication session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/rep/session –id 64518754321_AFCDEF34234A3B_0000_35674324567_ADCDF154321341_0000 delete
Fail over of a replication session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/rep/session –id 64518754321_AFCDEF34234A3B_0000_35674324567_ADCDF154321341_0000 failover
Fail back of a replication session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/rep/session –id 64518754321_AFCDEF34234A3B_0000_35674324567_ADCDF154321341_0000 failback
View the RPA CHAP account uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/rpa/chap show
Modify the RPA CHAP account uemcli -d 10.1.55.1 -u Local/username -p passwd123 /remote/rpa/chap set -outUsername admin -outSecret abcdef123456
View Data at Rest Encryption settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/encrypt show -detail
Enable encryption setting for KMIP support uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/encrypt set -kmipEnabled yes
View settings for KMIP support uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/encrypt/kmip show
Change key management server parameters for KMIP support uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/encrypt/kmip set -username skoobee -passwd doobee -port 5696 -timeout 20 -addr 10.1.1.1
Verify the current connection to the KMIP server uemcli -d 10.1.55.1 -u Local/username -p passwd123 /prot/encrypt/kmip verify
Data Mobility
Displays all existing import sessions on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session show -detail
Create a block import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 import/session/block create -name lun_17_import -srcSys RS_65596 -srcRes 17 -lunPoolPairs 17:pool_1 -importAsVMwareDatastore yes
Change the settings for a block import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/block –id import_1 set -name newName -throttle no -cutoverThreshold 5
Cut over block import session to the target system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/block -id import_1 cutover
Cancel an existing block import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/block -id import_1 cancel
View details about import sessions for block uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/block show -detail
Create a NAS import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 import/session/nas create -name MyName1 -srcSys RS_1 -srcRes src_vdm_to_migrate -targetResPool pool_1 -targetImportIf if_3 -productionIfPortPairs fsPoolPairs 100~200:pool_2,255:pool_3 -srcFsImportedAsVMWareDatastore 13,20~25,30 -skipServerParamCheckdefaultProductionPort spa_iom_0_eth0 -flrImport yes -unixDirectoryService directMatch -source_interface_1:spa_iom_0_eth1,source_interface_2:spa_iom_0_eth0 –
Change the settings for a NAS import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/nas –id import_1 set -name newName -targetResPool pool_2 -targetImportIf if_3 -productionIfPortPairs source_interface_1:spa_iom_0_eth1,source_interface_2:spa_iom_0_eth0 -fsPoolPairs 100~200:pool_2,255:pool_3 -srcFsImportedAsVMWareDatastore 17~20 – srcFsImportedWithCompressionEnabled 31,40~45
Cut over a NAS import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/nas -id import_1 cutover
Commit an existing NAS import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/nas -id import_1 commit
Cancel an existing NAS import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/nas -id import_1 cancel
View details about import sessions for NAS uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/nas show -detail
Display import status for the specified import session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /import/session/element -importId import_2 show -detail
Create a LUN move session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /move/session create -srcRes sv_1 –targetPool pool_1 -priority above –thin yes –compressed no
Display details for a LUN move session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /move/session show -detail
Modify the settings of a move session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /move/session –id MoveSession_1 set -priority below
Delete a LUN move session uemcli -d 10.1.55.1 -u Local/username -p passwd123 /move/session –id movesession_1 delete
Cancel a LUN move session that is in progress uemcli -d 10.1.55.1 -u Local/username -p passwd123 /move/session –id movesession_1 cancel
Events and Alerts
View a detailed log of system events uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/log show -fromTime “2017-01-05 00:00:00.000” –to “2017-01-05 23:59:59.999”
View a detailed list of all system alerts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/hist show
Acknowledge specific alerts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/hist -id alert_2 ack
Delete specific alerts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/hist -id alert_3 delete
View the settings for how the system handles alerts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/conf show
Configure the settings for how the system handles alerts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/conf set -emailFromAddr “from@mail.com” -emailToAddrs “x@mail.com,z@mail.com” –emailSeverity info -snmpSeverity error
Create an SNMP trap destination for system alerts uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/snmp create –host 10.64.75.1 –port 333 –userName user1 authProto md5 -authPassword authpassword1234 –privProto des –privPassword passwd123
View details about SNMP destinations uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/snmp show
Change the settings for an SNMP destination uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/snmp –id Host1_323 set -authProto md5 -authPassword newauthpassword –privProto des –privPassword newpasswd
Delete an SNMP destination uemcli -d 10.1.55.1 -u Local/username -p passwd123 /event/alert/snmp -id Host1_323 delete
System Maintenance
Changes the service password uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/user set –passwd NewPassword456! –oldpasswd OldPassword456!
Restarts management software on the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/system restart
Shuts down the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/system shutdown
Reinitialize the storage system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/system reinit
Collect service information uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/system collect -serviceInfo {-type perfAssessment}
Show a list of the system core dumps uemcli -d 10.1.55.1 -u local/serviceuser -p Password /service/system/dump –id “mspb:logDaemon_:2017-12-25_01_33_22_473_logDaemon.x” show
Delete a core dump uemcli -d 10.1.55.1 -u local/serviceuser -p Password /service/system/dump -id mspa:CP_:2018-01-22_15_11_39_13422_ECOM delete
Enable SSH access to the system uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/ssh set -enabled yes
Display SSH settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/ssh show
Switch the storage processor to the service mode uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/sp -id spa service
Reboot the storage processor uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/sp -id spa reboot
Reimage the storage processor uemcli -d 10.1.55.1 -u Local/username -p passwd123 /service/sp -id spa reimage
Manage Metrics
View the current metrics service settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /metrics/service show
Enable historical metrics collection uemcli -d 10.1.55.1 -u Local/username -p passwd123 /metrics/service set -historyEnabled yes
View information about supported metrics uemcli -d 10.1.55.1 -u Local/username -p passwd123 /metrics/metric show {-detail}
Displays all available real-time metric service settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /metrics/metric -availability real-time show
Displays metrics service settings for a specific path uemcli -d 10.1.55.1 -u Local/username -p passwd123 /metrics/metric -path sp.*.storage.lun.*.avgReadSize,sp.*.storage.filesystem.*.writesRate,sp.*.cifs.smb2.basic.readsRate show -detail
View historical metrics settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 /metrics/value/hist -path sp.spa.storage.lun.sv_1.readsRate show -interval 60 -from 2017-01-24 01:42:00 -to “2017-01-24 04:1 4 :00”
View real-time metrics settings uemcli -d 10.1.55.1 -u Local/username -p passwd123 uemcli /metrics/value/rt -path sp.*.storage.lun.*.readsRate show -interval 10
Advertisements

Data Domain CLI Command Reference Guide

Other CLI Reference Guides:
Isilon CLI  |  EMC ECS CLI  |  VNX NAS CLI | ViPR Controller CLINetApp Clustered ONTAP CLI  |  Brocade FOS CLI | EMC XTremIO CLI

This is a Data Domain CLI Command Reference Guide for the commands that are more commonly used.

If you’re looking to automate reports for your Data Domain, see my post Easy Reporting on Data Domain using the Autosupport Log.

Alerting
# alerts notify-list create <group-name> Creates a notification list and subscribes to events belonging to the specified list of classes and severity levels.
# alerts notify-list add <group-name> Adds to a notification list and subscribes to events belonging to the specified list of classes and severity levels.
# alerts notify-list del <group-name> Deletes members from a notification list, a list of classes, a list of email addresses.
# alerts notify-list destroy <group-name> Destroys a notification list
# alerts notify-list reset Resets all notification lists to factory default
# alerts notify-list show Shows notification lists’ configuration
# alerts notify-list test Sends a test notification to alerts notify-list
CIFS and NFS
# cifs share create share path {max-connections max connections | clients clients | users users | comment comment}
# cifs status Check CIFS Status
# cifs disable Disable CIFS Service
# cifs enable Enable CIFS Service
NFS
# nfs add path client-list [(option-list)] Add NFS clients to an Export
# nfs show active List clients active in the past 15 minutes and the mount path for each
# nfs show clients list NFS clients allowed to access the Data Domain system and the mount path and NFS options for each
# nfs show detailed-stats display NFS cache entries and status to facilitate troubleshooting
# NFS Status Display NFS Status
# NFS Enable Enable NFS Service
# NFS disable Disable NFS Service
DD Boost
# ddboost enable Enable DDBoost
# ddboost status show DDBoost status
# ddboost set user-name <user-name> Set DD Boost user
# ddboost access add clients <client-list> Add clients to DD Boost access list
# ddboost storage-unit create <storage-unit-name> Create storage-unit, setting quota limits
# ddboost storage-unit delete <storage-unit-name> Delete storage-unit
# ddboost storage-unit show [compression] [<storage-unit-name>] List the storage-units and images in a storage-unit:
# ddboost storage-unit create <storage-unit> user <user-name> Create a storage unit, assign tenant, and set quota and stream limits
# ddboost storage-unit delete <storage-unit> Delete a specified storage unit, its contents, and any DD Boost assocaitions
# ddboost storage-unit rename <storage-unit> <new-storage-unit> Rename a storage-unit
# ddboost storage-unit undelete <storage-unit> Recover a deleted storage unit
# ddboost option reset Reset DD Boost options
# ddboost option set distributed-segment-processing {enabled|disabled} Enable or disable distributed-segment-processing for DD Boost
# ddboost option set virtual-synthetics {enabled | disabled} Enable or disable virtual-synthetics for DD Boost
# ddboost option show Show DD Boost options
# ddboost option set fc {enabled | disabled} Enable or disable fibre-channel for DD Boost
# ddboost fc dfc-server-name set DDBoost Fibre-Channel set Server Name
# ddboost fc dfc-server-name show Show DDBoost Fibre-Channel Server Name
# ddboost fc status DDBoost Fibre Channel Status
# ddboost fc group show list [<group-spec>] [initiator<initiator-spec>] List configured DDBoost FC groups
# ddboost fc group create <group-name> Create a DDBoost FC group
# ddboost fc group add <group-name> initiator <initiator-spec> Add initiators to a DDBoost FC group
# ddboost fc group add <group-name> device-set Add DDBoost devices to a DDBoost FC group
Encryption and File system Locking
# filesys enable Enables the file system
# filesys disable Disables the file system
# filesys encryption enable Enables encryption. Enter a passphrase when prompted
# filesys encryption disable Disables encryption.
# filesys encryption show Checks the status of the encryption feature
# filesys encryption lock Locks the system by creating a new passphrase and destroying the cached copy of existing passphrase
# filesys encryption passphrase change Changes the passphrase for system encryption keys
# filesys encryption unlock Prepares the encrypted file system for use after it has arrived at its destination
Licensing
# license add <license-code> [<license-code> …] Adds one or more licenses for features and storage capacity.
# license show [local] Displays license codes currently installed.
# license del <license-code> Deletes one or more licenses.
# license reset Removes all licenses and requires confirmation before deletion.
Network
# net show settings Displays the interface’s network settings
# net show hardware Displays the interface’s hardware configuration
# net show config Displays the active network configuration
# net show domainname Displays the domain name associated with this device
# net show searchdomain Lists the domains that will be searched when only the host name is provided for a r command
# net show dns Lists the domain name servers used by this device.
# net show stats Provides a number of different networking statistics
# net show all Combines the output of several other net show CLI commands
Replication, Throttling, LBO, Encryption
# replication enable {<destination> | all} Enables replication
# replication disable {<destination> | all} Disables replication
# replication add source <source> destination <destination> Creates a replication pair
# replication break {<destination> | all} Removes the source or destination DD system from a replication pair
# replication initialize <destination> Initialize replication on the source (configure both source and destination first)
# replication modify <destination> {source-host | destination-host} <new-host-name> Modifies connection host, hostname
# replication modify <destination> connection-host <new-host-name> [port <port>] Modifies port
# replication add … low-bw-optim enabled Adds LBO
# replication modify … low-bw-optim enabled Modify LBO
# replication modify … low-bw-optim disabled Disable
# replication add … encryption enabled Add encryption over wire
# replication modify … encryption enabled Enable encryption over wire
# replication modify … encryption disabled Disable encryption over wire
# replication option set listen-port <port> Modify listening port  [context must be disabled before the connection port can be modified]
# replication option reset listen-port Reset listening port  [context must be disabled before the connection port can be modified]
# replication throttle add <sched-spec> <rate> Add a throttle schedule
# replication throttle add destination <host> <sched-spec> <rate> Add a destination specific throttle
# replication throttle del <sched-spec> Delete a throttle schedule
# replication throttle reset {current | override | schedule | all} Reset throttle configuration
# replication throttle set current <rate> Set a current override
# replication throttle set override <rate> Set a permanent override
# replication throttle show [KiB] Show throttle onfiguration
Retention Lock
# mtree retention-lock enable mtree_name Enables the retention-lock feature for the specified MTree
# mtree retention-lock disable mtree_name Disables the retention-lock feature for the specified MTree
# mtree retention-lock reset Resets the value of the retention period for the specified MTree to its default
# mtree retention-lock revert Reverts the retention lock for all files on a specified path
# mtree retention-lock set Sets the minimum or maximum retention period for the specified MTree
# mtree retention-lock show Shows the minimum or maximum retention period for the specified MTree
#mtree retention-lock status mtree_name Shows the retention-lock status for the specified MTree
Sanitization
#system sanitize abort Aborts the sanitization process
#system sanitize start Starts sanitization process immediately
#system sanitize status Shows current sanitization status
#system sanitize watch Monitors sanitization progress
SMT MTree stats
# mtree list List List the Mtrees on a Data Domain system
# mtree show stats Collect MTree real-time performance statistics
# mtree show performance Collect performance statistics for MTrees associated with a tenant-unit
# mtree show compression Collect compression statistics for MTrees associated with a tenant-unit
# quota capacity show List capacity quotas for MTrees and storage-units
# ddboost storage-unit modify Adjust or modify the quotas after the initial configuration
System Performance
# system show stats interval [interval in seconds] Shows system stats (Disk, IOs,…etc)
# system show performance [ {hr | min | sec} [ {hr | min | sec} ]] Show System Performance
NDMP
# ndmpd enable Enable the NDMP daemon
# ndmpd show devicenames Verify that the NDMP daemon sees the devices created in the TapeServer access group
# ndmpd user add ndmp Add an NDMP user
# ndmpd option show all Check the options for the ndmpd daemon
# ndmpd option set authentication md5 Set the ndmpd service authentication to MD5
# ndmpd option show all Verify the serivce authentication

Using the InsightIQ iiq_data_export Utility

InsightIQ includes a very useful data export tool:  iiq_data_export. It can be used with any version of OneFS beginning with 7.x.  While the tool is compatible with older versions of the operating system, if you’re running OneFS v8.0 or higher it offers a much needed performance improvement.  The improvements allow this to be a much more functional tool that can be used daily, and for quick reports it’s much faster than relying on the web interface.

Applications of this tool could include daily reports for application teams to monitor their data consumption, charge-back reporting processes,  or administrative trending reports. The output is in csv format, so there are plenty of options for data manipulation and reporting in your favorite spreadsheet application.

The utility is a command line tool, so you will need to log in to the CLI with an ssh session to the Linux InsightIQ server.  I generally use putty for that purpose.  The utility works with either root or non-root users, so you won’t need elevated privileges – I log in with the standard administrator user account. The utility can be used to export both performance stats and file system analytics [fsa] data, but I’ll review some uses of iiq_data_export for file system analytics first, more specifically the directory data-module export option.

The default command line option for file system analytics include list, describe, and export:

iiq_data_export fsa [-h] {list,describe,export} ...

Options:
 -h, --help Show this help message and exit.

Sub-Commands:
 {list,describe,export}
 FSA Sub-Commands
 list List valid arguments for the different options.
 describe Describes the specified option.
 export Export FSA data to a specified .csv file.

Listing FSA results for a specific Cluster

First we’ll need to review the reports that are available on the server. Below is the command to list the available FSA results for the cluster:

iiq_data_export fsa list --reports IsilonCluster1

Here are the results of running that command on my InsightIQ Server:

[administrator@corporate_iq1 ~]$ iiq_data_export fsa list --reports IsilonCluster1

Available Reports for: IsilonCluster1 Time Zone: PST
 ====================================================================
 | ID    | FSA Job Start         | FSA Job End           | Size     |
 ====================================================================
 | 57430 | Jan 01 2018, 10:01 PM | Jan 01 2018, 10:03 PM | 115.49M  |
 --------------------------------------------------------------------
 | 57435 | Jan 02 2018, 10:01 PM | Jan 02 2018, 10:03 PM | 115.53M  |
 --------------------------------------------------------------------
 | 57440 | Jan 03 2018, 10:01 PM | Jan 03 2018, 10:03 PM | 114.99M  |
 --------------------------------------------------------------------
 | 57445 | Jan 04 2018, 10:01 PM | Jan 04 2018, 10:03 PM | 116.38M  |
 --------------------------------------------------------------------
 | 57450 | Jan 05 2018, 10:00 PM | Jan 05 2018, 10:03 PM | 115.74M  |
 --------------------------------------------------------------------
 | 57456 | Jan 06 2018, 10:00 PM | Jan 06 2018, 10:03 PM | 114.98M  |
 --------------------------------------------------------------------
 | 57462 | Jan 07 2018, 10:01 PM | Jan 07 2018, 10:03 PM | 113.34M  |
 --------------------------------------------------------------------
 | 57467 | Jan 08 2018, 10:00 PM | Jan 08 2018, 10:03 PM | 114.81M  |
 ====================================================================

The ID column is the job number that is associated with that particular FS Analyze job engine job.  We’ll use that ID number when we run the iiq_data_export to extract the capacity information.

Using iiq_data_export

Below is the command to export the first-level directories under /ifs from a specified cluster for a specific FSA job:

iiq_data_export fsa export -c <cluster_name> --data-module directories -o <jobID>

If I want to view the /ifs subdirectores from job 57467, here’s the command syntax and it’s output:

[administrator@corporate_iq1 ~]$ iiq_data_export fsa export -c IsilonCluster1 --data-module directories -o 57467

Successfully exported data to: directories_IsilonCluster1_57467_1515522398.csv

Below is the resulting file. The output shows the directory count, file counts, logical, and capacity consumption.

[administrator@corporate_iq1 ~]$ cat directories_IsilonCluster1_57467_1515522398.csv

path[directory:/ifs/],dir_cnt (count),file_cnt (count),ads_cnt,other_cnt (count),log_size_sum (bytes),phys_size_sum (bytes),log_size_sum_overflow,report_date: 1515470445
 /ifs/NFS_exports,138420,16067265,0,1659,335841902399477,383999799732224,0
 /ifs/data,95,2189,0,0,13303199652,15264802304,0
 /ifs/.isilon,3,22,0,0,647236,2284544,0
 /ifs/netlog,2,5,0,0,37615,208384,0
 /ifs/home,9,31,0,0,30070,950784,0
 /ifs/SITE,10,0,0,0,244,53248,0
 /ifs/PRODUCTION-CIFS,2,0,0,0,23,4096,0
 /ifs/WAREHOUSE,1,0,0,0,0,2048,0
 /ifs/upgrade_error_logs,1,0,0,0,0,2048,0

While that is a useful top level report, we may want to dive a bit deeper and report on 2nd or 3rd level directories as well. To gather that info, use the directory filter option, which is “-r”:

iiq_data_export fsa export -c <cluster_name> --data-module directories -o <jobID> -r directory:<directory_path_in_ifs>

As an example, if we wanted more detail on the subfolders under the /NFS_exports/warehouse/ directory, we’d run the following command:

[administrator@corporate_iq1 ~]$ iiq_data_export fsa export -c IsilonCluster1 --data-module directories -o 57467 -r directory:/NFS_exports/warehouse/warehouse_dec2017

Successfully exported data to: directories_IsilonCluster1_57467_1515524307.csv

Below is the output from the csv file that I generated:

[administrator@corporate_iq1 ~]$ cat directories_IsilonCluster1_57467_1515524307.csv

path[directory:/ifs/NFS_exports/warehouse/warehouse_dec2017/],dir_cnt (count),file_cnt (count),ads_cnt,other_cnt (count),log_size_sum (bytes),phys_size_sum (bytes),log_size_sum_overflow,report_date: 1515470445
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_t01,44,458283,0,0,27298994838926,31275791237632,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_cat,45,106854,0,0,14222018137340,16285929507840,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_set,24,261564,0,0,11221057700000,12847989286912,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_auth,17,96099,0,0,7402828037356,8471138941440,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_mds,41,457984,0,0,5718188746729,6576121923584,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_hsh,17,101969,0,0,4396244719797,5035400875520,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_hop,17,115257,0,0,3148118026139,3608613813760,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_brm,24,3434,0,0,2964319382819,3381774883840,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_exe,9,22851,0,0,2917582971428,3317971597824,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_com,21,33286,0,0,2548672643701,2907729505280,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_mig,2,30,0,0,2255138307994,2586591986688,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_cls,7,4994,0,0,1795466785597,2035911001088,0
 /ifs/NFS_exports/warehouse/warehouse_dec2017/dir_enc,45,106713,0,0,1768636398516,2032634691072,0
 <...truncated>

Diving Deeper into subdirectories

Note that how deep you can go down the /ifs subdirectory tree depends on the FSA configuration in InsightIQ. By default InsightIQ will configure the “directory filter maximum depth” option to 5, allowing directory information as low as
/ifs/dir1/dir2/dir3/dir4/dir5. If you need to dive deeper the FSA config will need to be updated. To do so, go to the Configuration Page, FSA Configuration, then the “Directory Filter path_squash) maximum depth setting. Note that the larger the maximum depth the more storage space an individual FSA result will use.

Scripting Reports

For specific subdirectory reports it’s fairly easy to script the output.

First, let’s create a text file with a list of the subdirectories under /ifs that we want to report on. I’ll create a file named “directories.txt” in the /home/administrator folder on the InsightIQ server. You can use vi to create and save the file.

[administrator@corporate_iq1 ~]$ vi directories.txt

[add the following in the vi editor...]

NFS_exports/warehouse/warehouse_dec2017/dir_t01
 NFS_exports/warehouse/warehouse_dec2017/dir_cat
 NFS_exports/warehouse/warehouse_dec2017/dir_set

I’ll then use vi again to create the script itself.   You will need to substitute the cluster name and the job ID to match your environment.

[administrator@corporate_iq1 ~]$ vi direxport.sh

[add the following in the vi editor...]

for i in `cat directories.txt`
 do
 echo "Processing Directory $i..."
 j=`basename $i`;
 echo "Base Folder Name is $j"
 date_time="`date +%Y_%m_%d_%H%M%S_`";
 iiq_data_export fsa export -c IsilonCluster1 --data-module directories -o 57467 -r directory:$i -n direxport_$date_time$j.csv
 done

We can now change the permissions and set the file to executable, then run the script.  An output example is below.

[administrator@corporate_iq1 ~]$ chmod 777 direxport.sh
 [administrator@corporate_iq1 ~]$ chmod +X direxport.sh
 [administrator@corporate_iq1 ~]$ ./direxport.sh

Processing NFS_exports/warehouse/warehouse_dec2017/dir_t01...
 Base Folder Name is dir_t01

Successfully exported data to: direxport_2017_01_19_085528_dir_t01.csv

Processing NFS_exports/warehouse/warehouse_dec2017/dir_cat...
 Base Folder Name is dir_cat

Successfully exported data to: direxport_2017_01_19_0855430_dir_cat.csv

Processing NFS_exports/warehouse/warehouse_dec2017/dir_set...
 Base Folder Name is dir_set

Successfully exported data to: direxport_2017_01_19_085532_dir_set.csv

Performance Reporting

As I mentioned at the beginning of this post, this command can also provide performance related information. Below are the default command line options.

usage: iiq_data_export perf list [-h] [--breakouts] [--clusters] [--data-modules]

Options:
 -h, --help Show this help message and exit.

Mutually Exclusive Options:
 --breakouts Displays the names of all breakouts that InsightIQ supports for
 performance data modules. Each data module supports a subset of
 breakouts.
 --clusters Displays the names of all clusters that InsightIQ is monitoring.
 --data-modules Displays the names of all available performance data modules.
 iiq_data_export perf list: error: One of the mutually exclusive arguments are
 required.

Here are the data modules you can export:

 iiq_data_export perf list --data-modules
 ====================================================================
 | Data Module Label                       | Key 
 ====================================================================
 | Active Clients                          | client_active 
 --------------------------------------------------------------------
 | Average Cached Data Age                 | cache_oldest_page_age 
 --------------------------------------------------------------------
 | Average Disk Hardware Latency           | disk_adv_access_latency 
 --------------------------------------------------------------------
 | Average Disk Operation Size             | disk_adv_op_size 
 --------------------------------------------------------------------
 | Average Pending Disk Operations Count   | disk_adv_io_queue 
 --------------------------------------------------------------------
 | Blocking File System Events Rate        | ifs_blocked
 --------------------------------------------------------------------
 | CPU % Use                               | cpu_use 
 --------------------------------------------------------------------
 | CPU Usage Rate                          | cpu_usage_rate 
 --------------------------------------------------------------------
 | Cache Hits                              | cache_hits 
 --------------------------------------------------------------------
 | Cluster Capacity                        | ifs_cluster_capacity 
 --------------------------------------------------------------------
 | Connected Clients                       | client_connected 
 --------------------------------------------------------------------
 | Contended File System Events Rate       | ifs_contended 
 --------------------------------------------------------------------
 | Deadlocked File System Events Rate      | ifs_deadlocked 
 --------------------------------------------------------------------
 | Deduplication Summary (Logical)         | dedupe_logical 
 --------------------------------------------------------------------
 | Deduplication Summary (Physical)        | dedupe_physical 
 --------------------------------------------------------------------
 | Disk Activity                           | disk_adv_busy 
 --------------------------------------------------------------------
 | Disk IOPS                               | disk_iops 
 --------------------------------------------------------------------
 | Disk Operations Rate                    | disk_adv_op_rate 
 --------------------------------------------------------------------
 | Disk Throughput Rate                    | disk_adv_bytes 
 --------------------------------------------------------------------
 | External Network Errors                 | ext_error 
 --------------------------------------------------------------------
 | External Network Packets Rate           | ext_packet 
 --------------------------------------------------------------------
 | External Network Throughput Rate        | ext_net_bytes 
 --------------------------------------------------------------------
 | File System Events Rate                 | ifs_heat 
 --------------------------------------------------------------------
 | File System Throughput Rate             | ifs_total_rate 
 --------------------------------------------------------------------
 | Job Workers                             | worker 
 --------------------------------------------------------------------
 | Jobs                                    | job 
 --------------------------------------------------------------------
 | L1 Cache Throughput Rate                | cache_l1_read 
 --------------------------------------------------------------------
 | L1 and L2 Cache Prefetch Throughput Rate| cache_all_prefetch 
 --------------------------------------------------------------------
 | L2 Cache Throughput Rate                | cache_l2_read 
 --------------------------------------------------------------------
 | L3 Cache Throughput Rate                | cache_l3_read 
 --------------------------------------------------------------------
 | Locked File System Events Rate          | ifs_lock 
 --------------------------------------------------------------------
 | Overall Cache Hit Rate                  | cache_all_read_hitrate 
 --------------------------------------------------------------------
 | Overall Cache Throughput Rate           | cache_all_read 
 --------------------------------------------------------------------
 | Pending Disk Operations Latency         | disk_adv_io_latency
 --------------------------------------------------------------------
 | Protocol Operations Average Latency     | proto_latency 
 --------------------------------------------------------------------
 | Protocol Operations Rate                | proto_op_rate 
 --------------------------------------------------------------------
 | Slow Disk Access Rate                   | disk_adv_access_slow 
 ====================================================================

As an example, if I want to review the CPU utilization for the cluster, I’d type in the command below.   It will show all of the CPU performance information for the specified cluster name.  Once I’ve had more time to dive in to the performance reporting aspect of InsightIQ I’ll revisit and add to this post.

[administrator@corporate_iq1~]$ iiq_data_export perf export -c IsilonCluster1 -d cpu_use

Successfully exported data to: cpu_IsilonCluster1_1515527709.csv

Below is what the output looks like:

[administrator@corporate_iq1 ~]$ cat cpu_STL-Isi0091_1515527709.csv
 Time (Unix) (America/Chicago),cpu (percent)
 1515524100.0,3.77435898780823
 1515524130.0,4.13846158981323
 1515524160.0,3.27435898780823
 1515524190.0,2.34871792793274
 1515524220.0,2.68974351882935
 1515524250.0,3.33333349227905
 1515524280.0,3.02051281929016
 1515524310.0,2.78974366188049
 1515524340.0,2.98717951774597
 <...truncated>

ProSphere 1.6 Updates

ProSphere 1.6 was released this week, and it looks like EMC was listening!  Several of the updates are features that I specifically requested when I gave my feedback to EMC at EMC World.  I’m sure it’s just a coincidence, but it’s good to finally see some valuable improvements that make this product that much closer to being useful in my company’s environment.  The most important items I wanted to see was the ability to export performance data to a csv file and improved documentation on the REST API.  Both of those things were included with this release.  I haven’t looked yet to see if the performance exports can be run from a command line (a requirement for it to be useful to me for scripting).  The REST API documentation was created in the form of a help file.  It can be downloaded an run from an internal web server as well, which is what I did.

Here are the new features in v1.6:

Alerting

ProSphere can now receive Brocade alerts for monitoring and analysis. These alerts can be forwarded through SNMP traps.

Consolidation of alerts from external sources is now extended to include:

• Brocade alerts (BNA and CMCNE element managers)

• The following additional Symmetrix Management Console (SMC) alerts:
– Device Status
– Device Pool Status
– Thin Device Allocation
– Director Status
– Port Status
– Disk Status
– SMC Environmental Alert

Capacity

– Support for Federated Tiered Storage (FTS) has been added, allowing ProSphere to identify LUNs that have been presented from external storage logically, positioned behind the Unisphere for VMAX 10K, 20K and 40K.

– Service Levels are now based on the Fully Automated Storage Tier (FAST) policies defined in Symmetrix arrays. ProSphere reports on how much capacity is available for each Service Level, and how much is being consumed by each host in the environment.

Serviceability

– Users can now export ProSphere reports for performance and capacity statistics in CSV format.

Unisphere for VMAX 1.0 compatibility

– ProSphere now supports the new Unisphere for VMAX as well as Single Sign On and Launch-in-Context to the management console of the Unisphere for VMAX element manager. ProSphere, in conjunction with Unisphere for VMAX, will have the same capabilities as Symmetrix Management Console and Symmetrix Performance Analyzer.

Unisphere support

– In this release, you can launch Unisphere (CLARiiON, VNX, and Celerra) from ProSphere, but without the benefits of Single Sign On and Launch-in-Context.

Performance Data Collection/Discovery issues in ProSphere 1.5.0

I was an early adopter of ProSphere 1.0, it was deployed at all of our data centers globally within a few weeks of it’s release.  I gave up on 1.0.3, as the syncing between instances didn’t work and EMC told me that it wouldn’t be fixed until the next major release.  Well, that next major release was 1.5 so I jumped back in when it was released in early March 2012.

My biggest frustration initially was that I performance data didn’t seem to be collecting for any of the arrays.  I was able to discover all of the arrays but there wasn’t any detailed information available for any of them.  No LUN detail, no performance data.  Why?  Well, it seems ProSphere data collection is extremely dependant on a full path discovery, from host to switch to array.  Simply discovering the arrays by themselves isn’t sufficient.  Unless at least one host is seeing the complete path the performance collection on the array is not triggered.

With that said, my next step was to get everything properly discovered.  Below is an overview of what I did to get everything discovered and performance data collection working.

1 – Switch Discovery.

Because an SMI-S agent is required to discover arrays and switches, you’ll need a separate server to run the SMI-S agents. I’m using a Windows 2008 server.  If you want to keep data collection separated between geographical locations, you’ll need to install separate instances of ProSphere at each site and have separate SMI-S agent servers at each site.  The instances can then be synchronized together in a federated configuration (in Admin | System | Synchronize ProSphere Applications).

We use brocade switches so I initially downloaded and installed the brocade SMI-S agent.  It can be downloaded directly from Brocade here:  http://www.brocade.com/services-support/drivers-downloads/smi-agent/index.page.  I installed 120.9.0 and had some issues with discoveries.  EMC later told me that I needed to use 120.11.0 or later, which didn’t seem to be available on Brocade’s website. After speaking to an EMC rep regarding the Brocade SMI-S agent version issue, it was recommended to me that I use EMC’s software instead. Either should work, however.  You can use the SMI-S agent that’s included with Connectrix Manager Converged Network Edition (CMCNE).  The product itself requires a license, but you do not need to use a license to use only the SMI-S agent.  After installation, launch “C:\CMCNE 11.1.4\bin\smc.bat” and click on the Configure SMI Agent button to add the IP’s of your switches.  The one issue I ran in to with this was user security.  Only one userid and password can be used across all switches, so you may need to create a new id/password across all of your switches.  I had to do that and spent about a half of a day finishing that up. Once you add the switches in, use the IP of the host that the agent is installed on as your target for switch discovery in ProSphere. The default userid and password is administrator / password.

Make sure that port 5988 is open on the server you’re running this agent on. If it is Windows 2K8, disable the windows firewall or add an exception for ports 5988 and 5989 as well as the SMI-S processes ECOM and SLPD.exe.

2 – EMC Array Discovery

I had initially downloaded and installed the Solutions Enabler vApp thinking that it would work for my Clariion & VNX discoveries.  I was told later (after opening an SR) that it does provide SMI-S services.  EMC has their own SMI-S agent that will need to be installed a on a separate server, as it will use the same ports (5988/5989) as the Brocade agent (or CMCNE).  It can be downloaded here:  http://powerlink.emc.com/km/appmanager/km/secureDesktop?_nfpb=true&_pageLabel=servicesDownloadsTemplatePg&internalId=0b014066800251b8&_irrt=true, or by navigating in Powerlink to Home > Support > Software Downloads and Licensing > Downloads S > SMI-S Provider.

Once EMC’s SMI-S agent is installed you’ll need to add your arrays to it.  Open a command prompt and navigate to C:\Program Files\EMC\ECIM\ECOM\bin, and launch testsmiprovider.   When it prompts, choose “localhost”, “port 5988”, and use admin / #1Password as the login credentials.  Once logged in, you can use the “addsys” command to add the IP’s of your arrays.

Just like before, make sure that port 5988 is open on the server you’re running this agent on and disable the windows firewall or add an exception for ports 5988 and 5989.  You’ll again use the IP of the host that the agent is installed on as your target for array discovery.

3 – Host Discoveries

Host discoveries can be done directly without an agent.  You can use the root password for UNIX or ESX and any AD account in windows that has local administrator rights on each server.  Of course you can also set up specialized service accounts with the appropriate rights based on your company’s security regulations.

4 – Enable Path Data Collection

In order to see specific information about LUNs on the array, you will need to enable Path Performance Collection for each host.  If the host isn’t discovered and performance collection isn’t enabled, you won’t see any LUN information when looking at arrays.  To enable it, go to Discovery | Objects list | Hosts from the ProSphere console and click on the “On | Off” slider button to turn it on for each host.

5 – Verify Full path connectivity

Once all of the discoveries are complete, you can verify full path connectivity for an array by going to Discovery | Objects list | Arrays, click on any array, and look at the map.  If there is a cloud representing a switch with a red line to the array, you’re seeing the path.  You can use the same method for a host, if you go to Discovery | Objects list | Hosts and click on a host, you should see the host, the switch fabric, and the array on the map.  If you don’t see that full path you won’t get any data collected.

Comments and Thoughts

You can go directly to EMC’s community forum for general support and information here:   https://community.emc.com/community/support/prosphere.

After using ProSphere 1.5.0  for a little while now, I must say it’s definitely NOT Control Center.  It isn’t quite as advanced or full featured, but I don’t think it’s supposed to be.  It’s supposed to be an easy to deploy tool to get basic, useful information quickly.

I use the pmcli.exe command line tool in ECC extensively for custom data exports and reporting, and ProSphere does not provide a similar tool.  EMC does have an API built in to ProSphere that can be used to pull information over http (for example, to get a host list, type https://<prosphere_app_server>/srm/hosts).  I haven’t done too much research into that feature yet.  Version 1.5 added API support for array capacity, performance, and topology data.  You can read about it more in the white paper titled “ProSphere Integration: An overview of the REST API’s and information model” (h8893), which should be available on powerlink.

My initial upgrade from 1.0.3  to 1.5.0 did not go smoothly, I had about a 50% success rate across all of my installations.  My issues related to upgrades that would work but services wouldn’t start afterwards, and in one case the update web page simply stayed blank and would not let me run the upgrade to begin with.  Beware of upgrades if you want to preserve existing historical data, I ended up deleting the vApp and starting over for most of my deployments.

I’ve only recently been able to get all of my discoveries completed. I feel that the ProSphere documentation is somewhat lacking, I found myself wanting/needing more detail in many areas.  Most of my time has been spent doing trial and error testing with a little help from EMC support after I opened an SR.  I’ll give a more detailed post in the future about actually using ProSphere in the real world once I’ve had more time to use it.

Other items to note:

-ProSphere does not provide the same level of detail for historical data that you get in StorageScope, nor does it give the same amount of detail as Performance Manager.  It’s meant more for a quick “at a glance” view.

-ProSphere does not include the root password in the documentation, customers aren’t necessarily supposed to log in to the console.  I’m sure with a call to support you could obtain it.  Having the ability to at least start and stop services would be useful, as I had an issue with one of my upgrades where services wouldn’t start.  You can view the status of the services on any ProSphere server by navigating to https://prosphere_app_server/cgi-bin/mon.cgi?command=query_opstatus_full.

-ProSphere doesn’t gather the same level of detail about hosts and storage as ECC, but that’s the price you pay for agentless discovery.  Agents are needed for more detailed information.

How to troubleshoot EMC Control Center WLA Archive issues

We’re running EMC Control Center 6.1 UB12, and we use it primarly for it’s robust performance data collection and reporting capabilities.  Performance Manager is a great tool and I use it frequently.

Over the years I’ve had occasional issues with the WLA Archives not collecting performance data and I’ve had to open service requests to get it fixed.  Now that I’ve been doing this for a while, I’ve collected enough info to troubleshoot this issue and correct it without EMC’s assistance in most cases.

Check your ..\WLAArchives\Archives directory and look under the Clariion (or Celerra) folder, then the folder with your array’s serial number, then the interval folder.  This is where the “*.ttp” (text) and “*.btp” (binary) performance data files are stored for Performance Manager.  Sort by date.  If there isn’t a new file that’s been written in the last few hours data is not being collected.

Here are the basic items I generally review when data isn’t being collected for an array:

  1. Log in to every array in Unisphere, go to system properties, and on the ‘General’ tab make sure statistics logging is enabled.  I’ve found that if you don’t have an analyzer license on your array and start the 7 day data collection for a “naz” file, after the 7 days is up the stats logging option will be disabled.  You’ll have to go back in and re-enable it after the 7 day collection is complete.  If stats logging isn’t enabled on the array the WLA data collection will fail.
  2. If you recently changed the password on your clarion domain account, Make sure that naviseccli is updated properly for security access to all of your arrays (use the “addusersecurity” CLI option) and perform a rediscovery of all your arrays as well from within the ECC console.  There is no way from within the ECC console to update the password on an array, you must go through the discovery process again for all of them.
  3.  Verify the agents are running.  In the ECC console, click on the gears icon in the lower right hand corner.  It will create a window that shows the status of all the agents, including the WLA Archiver.  If WLA isn’t started, you can start it by right clicking on any array, choosing Agents, then start.  Check the WLAArchives  directories again (after waiting about an hour) and see if it’s collecting data again.

If those basic steps don’t work, checking the logs may point you in the right direction:

  1.  Review the Clariion agent logs for errors.  You’re not looking for anything specific here, just do a search for “error”, “unreachable” or for the specific IP’s of your arrays and see if there is anything obvious wrong. 
            %ECC_INSTALL_ROOT%\exec\MGL610\MGL.log
            %ECC_INSTALL_ROOT%\exec\MGL610\MGL_Bx.log.gz
            %ECC_INSTALL_ROOT%\exec\MGL610\MGL.ini
            %ECC_INSTALL_ROOT%\exec\MGL610\MGL_Err.log
            %ECC_INSTALL_ROOT%\exec\MGL610\MGL_Bx_Err.log
            %ECC_INSTALL_ROOT%\exec\MGL610\MGL_Discovery.log.gz
 

Here’s an example of an error I found in one case:

            MGL 14:10:18 C P I 2536   (29.94 MB) [MGLAgent::ProcessAlert] => Processing SP
            Unreachable alert. MO = APM00100600999, Context = Clariion, Category = SP
            Element = Unreachable
 

      2.   Review the WLA Agent logs.  Again, just search for errors and see if there is anything obvious that’s wrong. 

            %ECC_INSTALL_ROOT%\exec\ENW610\ENW.log
            %ECC_INSTALL_ROOT%\exec\ENW610\ENW_Bx.log.gz
            %ECC_INSTALL_ROOT%\exec\ENW610\ENW.ini
            %ECC_INSTALL_ROOT%\exec\ENW610\ENW_Err.log
            %ECC_INSTALL_ROOT%\exec\ENW610\ENW_Bx_Err.log
 

If the logs don’t show anything obvious, here are the steps I take to restart everything.  This has worked on several occasions for me.

  1. From the Control Center console, stop all agents on the ECC Agent server.  Do this by right clicking on the agent server (in the left pane), choose agents and stop.  Follow the prompts from there.
  2. Log in to the ECC Agent server console and stop the master agent.  You can do this in Computer Management | Services, stop the service titled “EMC ControlCenter Master Agent”.
  3. From the Control Center console, stop all agents on the Infrastructure server.  Do this by right clicking on the agent server (in the left pane), choose agents and stop.  Follow the prompts from there.
  4. Verify that all services have stopped properly.
  5. From the ECC Agent server console, go to C:\Windows\ECC\ and delete all .comfile and .lck files.
  6. Restart all agents on the Infrastructure server.
  7. Restart the Master Agent on the Agent server.
  8. Restart all other services on the Agent server.
  9. Verify that all services have restarted properly.
  10. Wait at least an hour and check to see if the WLA Archive files are being written.

If none of these steps resolve your problem and you don’t see any errors in the logs, it’s time to open an SR with EMC.  I’ve found the EMC staff  that supports ECC to be very knowledgeable and helpful.

 

 

Errors when creating new replication jobs

I was attempting to create a new replication job on one of our VNX5500’s and was receiving several errors when selecting our DR NS-960 as the ‘destination celerra network server’.

It was displaying the following errors at the top of the window:

– “Query VDMs All.  Cannot access any Data Mover on the remote system, <celerra_name>”. The error details directed me to check that all the Data Moverss are accessible, that the time difference between the source and destination doesn’t exceed 10 min, and that the passphrase matches.  I confirmed that all of those were fine.

– “Query Storage Pools All.  Remote command failed:\nremote celerra – <celerra_name>\nremote exit status =0\nremote error = 0\nremote message = HTTP Error 500: Internal Server Error”.  The error details on this message say to search powerlink, not a very useful description.

– “There are no destination pools available”.  The details on this error say to check available space on the destination storage pool.  There is 3.5TB available in the pool I want to use on the destination side, so that wasn’t the issue either.

All existing replication jobs were still running fine so I knew there was not a network connectivity problem.  I reviewed the following items as well:

– I was able to validate all of the interconnects successfully, that wasn’t the issue.

– I ran nas_cel -update on the interconnects on both sides and received no errors, but it made no difference.

– I checked the server logs and didn’t see any errors relating to replication.

Not knowing where to look next, I opened an SR with EMC.  As it turns out, it was a security issue.

About a month ago an EMC CE accidently deleted our global security accounts during a service call.  I had recreated all of the deleted accounts and didn’t think there would be any further issues.  Logging in with the re-created nasadmin account after the accidental deletion was the root cause of the problem.  Here’s why:

The clariion global user account is tied to a local user account on the control station in /etc/passwd. When nasadmin was recreated on the domain, it attempted to create the nasadmin account on the control station as well.  Because the account already existed as a local account on the control station, it created a local account named ‘nasadmin1‘ instead, which is what caused the problem.  The two nasadmin accounts were no longer synchronized between the Celerra and the Clariion domain, so when logging in with the global nasadmin account you were no longer tied to the local nasadmin account on the control station.  Deleting all nasadmin accounts from the global domain and from the local /etc/passwd on the Celerra, and then recreating nasadmin in the domain solves the problem.  Because the issue was related only to the nasadmin account in this case, I could have also solved the problem by simply creating a new global account (with administrator priviliges) and using that to create the replication job.  I tested that as well and it worked fine.

Problem with soft media errors on SSD drives and FastCache

4/25/2012 Update:  EMC has released a fix for this issue.  Call your account service representative and say you need to upgrade your NS-960 dart to 6.0.55.300 and flare to 4.30.000.5.524 plus drive firmware upgrade on all SSD drives to TC3Q.

Do you have FastCache enabled on your array?  Keep a close eye on your SP event logs for soft media errors on your SSD drives.  I just noticed over 2000 soft media errors on one of my FastCache enabled arrays, and found a technical advisory from EMC (emc282741) that desribes this as a potentially critical problem.  I just opened a case with EMC for my array to be reviewed for a possible disk replacement.  In the event a second disk drive in the same FastCache RAID group encounters soft media errors before the system automatically retires the first drive a dual faulted RAID Group could occur.  This can result in storage pools going offline and becoming completely inaccessible to the attached hosts.  That’s basically a total SAN outage, not good.

Look for errors like the following in your SP event logs:

“Date Stamp”  “Time Stamp” Bus1 Enc1 Dsk0  820 Soft Media Error [Bad block]

EMC states in emc282741 that enhancements are targeted for Q1 2012 to address SSD media errors and dual hardware faults, but in the meantime, make sure you review the SP logs if you have CLARiiON or VNX arrays that are configured with SSD disk drives or are using FAST Cache.  If any instance of the “Soft Media Error” listed above is associated with any one of the solid state disk drives in your arrays, the array should be upgraded to at least FLARE Release 04.30.000.5.522 (for CX4 Series arrays) or Release 05.31.000.5.509 (for VNX Series arrays) and then start a Proactive Copy (PACO) to a hot spare and replace the drive as soon as possible.

In order to quickly review this on each of my arrays, I wrote the following script to update my intranet site with a report every morning:

naviseccli -h clariion1a getlog >clariion1a.txt
naviseccli -h clariion1b getlog >clariion1b.txt  
cat clariion1a.txt | grep -i ‘soft media’ >clariion1_softmedia_errors.csv
cat clariion1b.txt | grep -i ‘soft media’ >>clariion1_softmedia_errors.csv
./csv2htm.pl -e -T -i /home/scripts/clariion1_softmedia_errors.csv -o /<intranet_web_server>/clariion1_softmedia_errors.html
 

The script dumps the entire SP log from each SP into a text file, greps for only soft media errors in each file, then converts the output to HTML and writes it to my intranet web server.

 

Critical Celerra FCO for Mac OS X 10.7

Here’s the description of this issue from EMC:

EMC has become aware of a compatibility issue with the new version of MacOS 10.7 (Lion). If you install this new MacOS 10.7 (Lion) release, it will cause the data movers in your Celerra to reboot which may result in data unavailability. Please note that your Celerra may encounter this issue when internal or external users operating the MacOS 10.7 (Lion) release access your Celerra system.  In order to protect against this occurrence, EMC has issued the earlier ETAs and we are proactively upgrading the NAS code operating on your affected Celerra system. EMC strongly recommends that you allow for this important upgrade as soon as possible.

Wow.  A single Mac user running 10.7 can cause a kernel panic and a reboot of your data mover.  According to our rep, Apple changed the implementation of SMB in 10.7 and added a few commands that the Celerra doesn’t recognize.  This is a big deal folks, call your Account rep for a DART upgrade if you haven’t already.

Filesystem Alignment

You’re likely to have seen the filesystem alignment check fail on most, if not all, of the EMC HEAT reports that you run on your windows 2003 servers.  The starting offset for partition 1 should optimally be a multiple of 128 sectors.  So, how do you fix this problem, and what does it mean?

If you align the partition to 128 blocks (or 64KB as each block is 512bytes) then you don’t cross a track boundary and thereby issue the minimum number of IOs.   Issuing the minimum number of IOs sounds good, right? 🙂

Because NTFS reserves 31.5 KB of signature space, if a LUN has an element size of 64 KB with the default alignment offset of 0 (both are default Navisphere settings), a 64 KB write to that LUN would result in a disk crossing even though it would seem to fit perfectly on
the disk.  A disk crossing can also be referred to as a split IO because the read or write must be split into two or more segments. In this case, 32.5 KB would be written to the first disk and 31.5 KB would be written to the following disk, because the beginning of the stripe is offset by 31.5 KB of signature space. This problem can be avoided by providing the correct alignment offset.  Each alignment offset value represents one block.  Therefore, EMC recommends setting the alignment offset value to 63, because 63 times 512 bytes is 31.5 KB.

Checking your offset:

1. Launch System Information in windows (msinfo32.exe)

2. Select Components -> Storage -> Disks.

3. Scroll to the bottom and you will see the partition starting offset information.  This number needs to be perfectly divisible by 4096, if it’s not then your partition is not properly aligned.

Correcting your starting offset:

Launch diskpart:

C:\>diskpart

DISKPART> list disk

Two disks should be listed

DISKPART> select disk 1

This selects the second disk drive

DISKPART> list partitions

This step should give a message “There are no partitions on this disk to show”.  This confirms a blank disk.

DISKPART> create partition primary align=64

That’s it.  You now have a perfectly aligned disk.