EMC VNXe – Troubleshooting NFS Connectivity

Step1 Check the Health status of the Link Aggregation:

uemcli -d -u Local/admin -p Password123# /net/la show -detail

1: ID = la0_SPA
Ports = eth2_SPA,eth3_SPA
Health state = OK (5)

2: ID = la0_SPB
Ports = eth2_SPB,eth3_SPB
Health state = OK (5)

Step2 Ensure the Network Interface for NFS is correctly configured:
uemcli -d -u Local/admin -p Password123# /net/if show -detail

ID = if_2
Port = eth2_SPA
IPv4 mode = static
IPv4 address =
IPv4 subnet mask =
IPv4 gateway =
MAC address = 08:00:00:00:00:00

Step3 Check the Health Status and MTU Value set on the Ports:
uemcli -d -u Local/admin -p Password123# /net/port show

ID = eth2_SPA
Role = frontend
Supported types = iscsi, net
MTU size = 9000
Speed = 1 Gbps
Health state = OK (5)
Aggregated port ID = la0_SPA

ID = eth3_SPA
Role = frontend
Supported types = iscsi, net
MTU size = 9000
Speed = 1 Gbps
Health state = OK (5)
Aggregated port ID = la0_SPA

ID = eth2_SPB
Role = frontend
Supported types = iscsi, net
MTU size = 9000
Speed = 1 Gbps
Health state = OK (5)
Aggregated port ID = la0_SPB

ID = eth3_SPB
Role = frontend
Supported types = iscsi, net
MTU size = 9000
Speed = 1 Gbps
Health state = OK (5)
Aggregated port ID = la0_SPB

For a more detailed analysis of Frontend|Backend:
uemcli -d -u Local/admin -p Password123# /net/port -role frontend show -detail

Step4 Check if Jumbo MTU is set correctly on Cisco SW’s:
SwitchA#show system mtu
If change required then issue command: system mtu jumbo 9198
Save and then reload

Step5 Check Shared folder for enabled NFS and Interface ID
uemcli -d -u Local/admin -p Password123# /net/nas/server show

ID = file_server_2
Name = NFS_01
Health state = OK (5)
CIFS enabled = no
NFS enabled = yes
Interface = if_2

Step6 Run a PING Test from the VNXe NFS Interface if_2 to ESXi NFS IP & VMKPing from ESXi NFS vmk to VNXe Server
Gather ESXi Host details:
uemcli -d -u Local/admin -p Password#123 /remote/host show -detail

ID = 1003
Name = ESXi_01
Type = host
Address =
OS type = esx

Ping the vmkernel of the ESXi host to ensure proper connectivity:
uemcli -d -u Local/admin -p Password123# /net/util ping -srcIf if_2 -addr
Operation completed successfully.
Ping the NFS Server from the vmkernel of the ESXi host:
vmkping -s 8972 -d

Failure here will normally imply a networking configuration issue – Verify subnets, vlan’s and any firewall configs are correct.

Step7 Check the status and details of the NFS Datastore
uemcli -d -u Local/admin -p Password123# /stor/prov/vmware/nfs show -detail
ID = app_1
Name = NFS-01
Health state = OK (5)
Health details = "The component is operating normally. No action is required."
Server = file_server_2
Storage pool = NFS-01
Size = 858993459200 (800.0G)
Size used = 241740808192 (225.1G)
Maximum size = 4417404272640 (4.0T)
Thin provisioning enabled = no
Cached = no
Current allocation = 858993459200 (800.0G)
Protection size = 42949672960 (40.0G)
Protection size used = 0
Maximum protection size = 17592184995840 (16.0T)
Protection current allocation = 0
Auto-adjust protection size = yes
Local path = /NFS_01
Export path = /NFS_01
Default access = na
Root hosts = 1003[]
Replication destination = no
Deduplication enabled = no
Creation time = 2014-06-11 09:55:00
Last modified time = 2014-06-11 09:55:00

Step8 For any Firewall in-place ensure the following port is open:
2049 – TCP/UDP – NFS – Required for NFS

Step9 Add the NFS file system manually to the ESXi host:
Log on to vCenter or the ESX host click on the ESXi host, from the Configuration tab choose Storage and Add storage:
1. Enter the IP address of the NFS server –
2. Enter the Folder name which is the mount point from VNXe – /NFS-01
3. Enter the datastore name that vCenter/ESXi will use to present as – NFS-01

EMC VNXe – Configuring E-Mail Alerts Via SMTP

The VNXe can send E-mail alerts of system events to a specified IP address when it
encounters alerts or error conditions.

View and Configure SMTP Server Settings

In order to View the IP addresses of the SMTP servers issue the following command:

uemcli -d VNXe_IP -u Local/admin -p password /net/smtp show

As you can see no IP address has been configured at present.

The following command sets the IP address for the default SMTP server that the system will use:

uemcli -d VNXe_IP -u Local/admin -p password /net/smtp -id default set -addr
Note: The system uses the first IP address you specify.

View Alert Settings

View the settings for how the system handles alerts:
uemcli -d VNXe_IP -u Local/admin -p password /event/alert/conf show

As you can see no Alerts have been configured at present.

Configure E-Mail Alert Settings

Configure the settings for how the system handles alerts.

-emailFromAddr Type the e-mail address the system will use as the FROM address. The addresses will appear in the FROM field of the recipient’s e-mail application.
-emailToAddrs Type a comma-separated list of e-mail addresses the system will send alerts.
-emailSeverity Specify the minimal severity of alerts the system will send as e-mails. Value is critical, error, warning, or info.

The following command configures the alert settings:
uemcli -d VNXe_IP -u Local/admin -p password /event/alert/conf set -emailToAddrs USER1@Domain.com,USER2@Domain.com -emailSeverity warning

uemcli -d VNXe_IP -u Local/admin -p password /event/alert/conf showVNXE_SMTP5


EMC VNXe Configuration Using Unisphere CLI (Part 2)

This is the second part in the series on configuring the VNXe via command line. Here I will detail the Steps involved in creating both NFS and iSCSI datastores. The configuration steps outlined in Part2 will be the following:

  • LACP Configuration
  • Create the Network Interface for NFS
  • NFS Shared Folder Server Configuration
  • Create NFS datastores
  • Creating iSCSI Interfaces/Nodes/Datastores

LACP Configuration

Link aggregation lets you link physical ports on a SP to a single logical port. It is possible to use up to 4 ports on an SP. If your system has two SPs, and you link two physical ports, the same ports on both SPs are linked for redundancy. In this example, we will link port 2 and port 3, the system creates a link aggregation for these ports on SP A and a link aggregation on SP B. Each link aggregation is identified by an ID. Link aggregation has the following advantages:

  • Increased throughput since two physical ports are linked into one logical port.
  • Load balancing across linked ports
  • Redundant ports

The following command shows the existing port settings:

uemcli -d -u Local/admin -p Password#123 /net/port show

Configure LACP for Ethernet Ports 2 and 3:

uemcli -d -u Local/admin -p Password#123 /net/la create -ports eth2_SPA,eth3_SPA” -mtuSize 9000

The following command shows the link aggregations on the system:

uemcli -d -u Local/admin -p Password#123 /net/la show

Create the Network Interface for NFS.

This will create the Network interface for controlling access to the NFS file storage. You assign the interface to a Shared Folder Server (Next Step Below). iSCSI interfaces are used for controlling access to iSCSI storage and get assigned to the iSCSI nodes (Shown Below).

The system configures each interface on an SP port. You have the option of indicating which SP the interface will use, either a physical port or a link aggregation port. You also have the option of specifying a virtual LAN (VLAN) ID, for communicating with VLAN networks. Each interface is identified by an ID.

Create a network interface on the LACP we have created above that uses VLAN ID 100. The interface receives the ID if_0:

uemcli -d -u Local/admin -p Password#123 /net/if create -port eth2_SPA -ipv4 static -addr -netmask -gateway

The following command displays all interfaces on the system:

uemcli -d -u Local/admin -p Password#123 /net/if show

NFS Shared Folder Server Configuration

Now we will create an NFS shared folder. Once we create the shared folder, we can create the NFS network shares and use the ID of the shared folder to associate it with a share.

The following command creates a Shared Folder Server with these settings:

  • Name is NFS-SF
  • Associated to interface if_0
  • The server receives the ID file_server_0

uemcli -d -u Local/admin -p Password#123 /net/nas/server create -name ” NFS-SF ” -enableNFS yes -if if_0

Show details:

uemcli -d -u Local/admin -p Password#123 /net/nas/server show

Create NFS datastores

Create an NFS Datastore and Assign to NFS Shared Server with these settings:

  • Named NFS-01
  • Use  Shared Folder Server file_server_0
  • Uses the VMWARE-NFS storage pool
  • NFS datastore size is 200 GB
  • Host Access is root (Read/write root access to primary storage)
  • 40G is the amount of protection storage to allocate for the NFS datastore
  • The protection size, entered for the -protSize qualifier, is automatically adjusted in proportion with changes to the size of the primary storage

uemcli -d -u Local/admin -p Password#123 /stor/prov/vmware/nfs create -name ” NFS-01″ -server file_server_0 -pool VMWARE-NFS -cached no -size 200G -defAccess root -protSize 40G -autoProtAdjust yes

View details:

uemcli -d -u Local/admin -p Password#123 /stor/prov/vmware/nfs show

Creating iSCSI Interfaces/Nodes/Datastores

The following commands create the network interfaces used by the iSCSI nodes and uses VLAN ID 200. The interfaces receive the IDs if_2 and if_3 on both SPA and SPB respectfully:

uemcli -d -u Local/admin -p Password#123 /net/if create -port eth10_SPA -vlanId 200 -ipv4 static -addr -netmask -gateway

uemcli -d -u Local/admin -p Password#123 /net/if create -port eth10_SPB -vlanId 200 -ipv4 static -addr -netmask -gateway

The following commands creates the first iSCSI node with these settings:

  • Alias is ISCSIA-21
  • Network interface if_2 assigned

The iSCSI node receives ID iSCSI_node_0:

uemcli -d -u Local/admin -p Password#123 /net/iscsi/node create -alias ISCSIA-21 -if if_2

Create the second iSCSI node with these settings:

  • Alias is ISCSIB-22
  • Network interface if_3 assigned

The iSCSI node receives ID iSCSI_node_1:

uemcli -d -u Local/admin -p Password#123 /net/iscsi/node create -alias ISCSIB-22 -if if_3

Lists all iSCSI nodes on the system:
uemcli -d -u Local/admin -p Password#123 /net/iscsi/node show

 Creating iSCSI Datastores

Check ESXi Host vdiskhost ID’s to use in assigning the datastores:

uemcli -d -u Local/admin -p Password#123 /remote/host show -detail

We can now create the iSCSI datastores:

Create iSCSI Datastores from the Performance Pool and assign to ESXi Hosts with ID’s 1001,1002:

uemcli -d -u local/admin -p Password#123 /stor/prov/vmware/vmfs create -name “iSCSI-LUN01” -node iscsi_node_0 -pool performance -size 200G -thin yes -vdiskHosts “1001,1002”

Create iSCSI Datastores from the Capacity Pool and assign to ESXi Hosts with ID’s 1003,1004:

uemcli -d -u local/admin -p Password#123 /stor/prov/vmware/vmfs create -name “iSCSI-LUN02” -node iscsi_node_1 -pool capacity -size 200G -thin yes -vdiskHosts “1003,1004 “

EMC VNXe Configuration Using Unisphere CLI (Part 1)

This is the first in a series of blog posts on configuring VNXe using the command line. All the configurations here will be performed using “uemcli” which can be downloaded here . If you prefer to use the GUI interface then Henri has a very good series of blog posts here. The following scripts defined here are very useful if like me you need to configure VNXe systems on a weekly basis. VNXe is the base storage for the Vblock VB100 series and also used as the shared storage for management hosts in the VB300 and VB700 series.

The configuration steps outlined in Part 1 will be the following:
• Accept License Agreement
• Change Admin Password
• Create a New User
• Change the Service Password
• Commit IO Modules
• Perform a Healthcheck
• Code Upgrade
• Create a Storage Pool
• Add Hot Spare
• DNS Configuration
• NTP Configuration

Accept License Agreement
uemcli -d -u Local/admin -p Password123# /sys/eula set -agree yes

Change Admin Password
First run the show command to get the –id of the user account to change. In this case we are changing the Admin password which will have an ID of user_admin:
uemcli -d -u Local/admin -p Password123# /user/account show
uemcli -d -u Local/admin -p Password123# /user/account -id user_admin set -passwd NewPassword -oldpasswd Password123#

Create a New User
uemcli -d -u Local/admin -p Password123# /user/account create -name newUser -type local -passwd Password -role administrator
The role for the account can be:
• administrator — Administrator
• storageadmin — Storage Administrator
• operator — Operator (view only)

Change the Service Password
The Service password is used for performing service actions on the VNXe.
uemcli -d -u Local/admin -p Password123# /service/user set -passwd newPassword -oldpasswd Password123#

Commit IO Modules
The following commits all uncommitted IO modules:
uemcli -d -u Local/admin -p Password123# /env/iomodule commit
The following command displays a list of system IO modules:
uemcli -d -u Local/admin -p Password123# /env/iomodule show

Perform a Healthcheck
uemcli -d -u Local/admin -p Password123# /sys/general healthcheck

Code Upgrade
In a dual SP VNXe this will be an NDU. Services will failover between SP’s during upgrade.
Perform a Healthcheck of the system prior to upgrade and resolve any issues first.
Firstly we upload the new code to the VNXe using the -upload switch before creating the upgrade session:
uemcli -d -u Local/admin -p Password123# -upload -f PathToSoftware\VNXe-MR4-upgrade- upgrade
The following command displays details about the installed system software and details about the uploaded upgrade candidate.We also need to run this command to get the -candId of the uploaded upgrade candidate:
uemcli -d -u Local/admin -p Password123# /sys/soft/ver show
Now we create a session to upgrade the system software using candidate CAND_1:
uemcli -d -u Local/admin -p Password123# /sys/soft/upgrade create -candId CAND_1
Status of Upgrade:
uemcli -d -u Local/admin -p Password123# /sys/soft/upgrade show
Confirm software version:
uemcli -d -u Local/admin -p Password123# /sys/soft/ver show

Create a Storage Pool
View the Storage profile. Storage profiles are preconfigured settings for configuring storage pools based on Raid type, capacity and stripe length. We will choose a storage profile that best suits the server workload:
uemcli -d -u Local/admin -p Password123# /stor/config/profile show
Next view details about disk groups on the system. We will need the disk group ID to create the pool from:
uemcli -d -u Local/admin -p Password123# /stor/config/dg show
Here we create the “VMWARE-NFS” pool for vmware using 5 disks from the disk group disk_group_1 and using storage_cap_0 profile:
uemcli -d -u Local/admin -p Password123# /stor/config/pool create -name VMWARE-NFS -descr “VMware NFS Pool” -storProfile storage_cap_0 -diskGroup disk_group_1 -drivesNumber 5 -resType vmware -usage datastore
View the Pool configuration:
uemcli -d -u Local/admin -p Password123# /stor/config/pool show -detail

Add Hot Spare to the pool
uemcli -d -u Local/admin -p Password123# /stor/config/dg -id disk_group_1 set -spares 1

DNS Configuration
The following command adds two DNS servers to the domain dcr.com. The servers are grouped by domain under the ID dcr.com:
uemcli -d -u Local/admin -p Password123# /net/dns/domain create -name “dcr.com” -nameServer “,”
List all DNS server domains:
uemcli -d -u Local/admin -p Password123# /net/dns/domain show

NTP Configuration
The following creates an NTP server record
uemcli -d -u Local/admin -p Password123# /net/ntp/server create -server
uemcli -d -u Local/admin -p Password123# /net/ntp/server show

In the next post (part 2) I will show how to script the iSCSI and NFS server configurations and creation of datastores for each.