Identifying Symmetrix devices using the esxcfg-mpath and symdev commands
search cancel

Identifying Symmetrix devices using the esxcfg-mpath and symdev commands

book

Article ID: 306509

calendar_today

Updated On:

Products

VMware vSphere ESXi

Issue/Introduction

This article provides steps for System and Storage Administrators to identify the mapping of a LUN being presented from an EMC Symmetrix to an ESX/ESXi host. The process combines information available from the ESX/ESXi host with information from the EMC Symmetrix. This may be necessary when attempting to locate a device or ensuring correct presentation.

Note: Information is obtained from the EMC Symmetrix using the symdev command-line utility. This command is part of EMC Solutions Enabler, a suite of command-line tools released by EMC for managing storage environments. Licensing and configuration of EMC Solutions Enabler are outside the scope of this article.

Environment

  • VMware ESXi 3.5.x Installable
  • VMware ESX Server 3.5.x
  • VMware ESX 4.0.x
  • VMware ESXi 4.1.x Installable
  • VMware ESXi 3.5.x Embedded
  • VMware vSphere ESXi 5.0
  • VMware ESXi 4.0.x Embedded
  • VMware ESXi 4.1.x Embedded
  • VMware ESX 4.1.x
  • VMware ESX Server 3.0.x
  • VMware ESXi 4.0.x Installable

Resolution

A full list of devices can be obtained from both an ESX/ESXi host and from a Symmetrix. The devices in each list are correlated based on key Network Addressing Authority (NAA) identifiers used for each device.

  1. Connect to the ESX/ESXi host and obtain a list of all devices by their Network Addressing Authority (NAA) identifier.
  2. Connect to the EMC Symmetrix using the symdev command and obtain a list of all devices by their WWN identifier and Disk IDs.
  3. Search the output of step 2 for each device from step 1, matching the ESX/ESXi host NAA against the Symmetrix WWN.

Device identifiers on ESX/ESXi

VMware ESX/ESXi 3.x and 4.x represent a unique device using a vml identifier, plus a naa or mpx identifier. Local and remote management tools expose these device identifiers. For more information on working with these identifiers, see Identifying disks when working with VMware ESX (1014953).

Before beginning, open a console session where the command-line utility will be used. For more information on opening a console session to use the local console on an ESX or ESXi host, see Unable to connect to an ESX host using Secure Shell (SSH) (1003807) or Using ESXi Shell in ESXi 5.0 and 5.1 (2004746).

  • For ESX/ESXi 3.x, obtain a list of devices using the console command esxcfg-mpath --list or the rCLI command vicfg-mpath --list. The device's Network Addressing Authority (NAA) identifier is embedded within the VML identifier. Remove the first 10 and last 12 digits to produce the NAA. For example:

    vicfg-mpath --server esxhostname --username root --list

    Disk vmhba1:4:5 vml.0200050000 ######################## /dev/sd N ( 249271MB) ...


  • For ESX/ESXi 4.x, obtain a list of devices using the command esxcfg-scsidevs --compact-list, or the vCLI command vicfg-scsidevs --compact-list. The device's Network Addressing Authority (NAA) identifier is listed as the Device UID. For example:

    vicfg-scsidevs --server esxhostname --username root --compact-list

    Device UID Console Device Size Plugin Display Name
    naa. #################### /dev/sd N
    249271MB NMP ...

  • For ESXi 5.x, obtain a list of devices using the command esxcli storage core device list . The device's Network Addressing Authority (NAA) identifier is listed as the Device UID and is also embedded within the VML identifier (remove the first 10 and last 12 digits to produce the NAA). For example:

    esxcli storage core device list

    naa. ################

    Display Name: EMC Fibre Channel Disk (naa. ################
    )
    Has Settable Display Name: true
    Size:
    249271
    Device Type: Direct-Access
    Multipath Plugin: NMP
    Devfs Path: /vmfs/devices/disks/naa. ################

    Vendor: EMC
    Model: SYMMETRIX
    Revision: 5772
    SCSI Level: 4
    Is Pseudo: true
    Status: on
    Is RDM Capable: true
    Is Local: false
    Is Removable: false
    Is SSD: false
    Is Offline: false
    Is Perennially Reserved: false
    Thin Provisioning Status: unknown
    Attached Filters:
    VAAI Status: unsupported
    Other UIDs: vml.0200000000 
    ############## #################

Note: The identifiers are also accessible via the CanonicalName property of a ScsiLun in PowerCLI. 

Device identifiers on a Symmetrix

EMC Symmetrix devices can be managed using the symdev command supplied with EMC Solutions Enabler.

To obtain a list of storage devices:

  1. Discover the Symmetrix arrays using the command:

    symcfg discover

  2. List all the connected Symmetrix arrays by their SymmID using the command:

    symcfg list

    For example:

    SymmID Attachment Model Version Cache(MB) PhyDevs SymDevs
    1234 Local ABCD-1 5874 229376 152 19924
    5678 Remote ABCD-1 5874 229376 0 21153
  3. List all devices in the Symmetrix using the symdev command, specifying the SymmID from step 2:

    symdev list -wwn -sid <SymmID>

    For example:

    symdev list -wwn -sid 1234

    Num WWN
    4E0F Not Visible
    #########################
    4E10 Not Visible ########################1
    4E11 Not Visible ########################2
    4E12 Not Visible ########################3


  4. The Network Addressing Authority (NAA) for the device is listed in the WWN column.

    Note: When presented to an ESXi/ESX host, the Symmetrix devices will be shown in the format: sym.xxxxxxxxx.

Device identifiers on a Clariion

EMC Clariion devices can be managed using the symdev command supplied with EMC Solutions Enabler. To identify the Device WWN on a Clariion:
 
  1. To determine the NAA identifier on the ESX/ESXi, run this command:

    esxcfg-scsidevs -m

    The output will look similar to this:

    naa.#########################:1 /vmfs/devices/disks/naa.6################################:1 4e84a079-84e764df-#####-############### 0 cx4-120

  2. To determine which device naa.######################### relates to on a Clariion, run this command:

    symdev list -wwn -clariion

    Clariion ID: CKM00100900477

    Num Physical Name Config Cap(MB) WWN

    00000 Not Visible RAID-5 20480 ##############################
    00001 Not Visible RAID-5 10240 #############################1
    00002 Not Visible RAID-5 10240 #############################2
    00003 Not Visible RAID-5 10240 #############################3
  3. The Network Addressing Authority (NAA) for the device is listed in the WWN column.

Additional Information

The output of these commands can be redirected to a file for later reference or searching. For example:
 
vicfg-scsidevs --compact-list > vicfg-scsidevs-output.txt