iSCSI SAN Configuration Guide

ESX 4.1 ESXi 4.1 vCenter Server 4.1

This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.

EN-000288-01

iSCSI SAN Configuration Guide

You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected]

Copyright 2009, 2010 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com

VMware, Inc.

Contents

Updated Information 5 About This Book 7

1 Using ESX/ESXi with an iSCSI Storage Area Network 9

Understanding Virtualization 9 iSCSI SAN Concepts 11 Overview of Using ESX/ESXi with a SAN 16 Specifics of Using SAN Storage with ESX/ESXi 17 Understanding VMFS Datastores 18 Making LUN Decisions 19 How Virtual Machines Access Data on a SAN 21 Understanding Multipathing and Failover 22 Choosing Virtual Machine Locations 27 Designing for Server Failure 27 LUN Display and Rescan 28

2 Configuring iSCSI Initiators and Storage 29

ESX/ESXi iSCSI SAN Requirements 29 ESX/ESXi iSCSI SAN Restrictions 30 Setting LUN Allocations 30 Network Configuration and Authentication 30 Setting Up Independent Hardware iSCSI Adapters 31 Setting Up and Configuring Dependent Hardware iSCSI Adapters 32 Setting Up and Configuring Software iSCSI Adapter 34 Networking Configuration for Software iSCSI and Dependent Hardware iSCSI 36 Bind iSCSI Ports to iSCSI Adapters 40 Using Jumbo Frames with iSCSI 41 Enabling Jumbo Frames for Software and Dependent Hardware iSCSI 42 Configuring Discovery Addresses for iSCSI Initiators 43 Configuring CHAP Parameters for iSCSI Adapters 44 Configuring Additional Parameters for iSCSI 48 iSCSI Session Management 49 Add iSCSI Storage 51

3 Modifying SAN Storage Systems for ESX/ESXi 53

Testing ESX/ESXi SAN Configurations 53 General Considerations for iSCSI SAN Storage Systems 54 EMC CLARiiON Storage Systems 54 EMC Symmetrix Storage Systems 55 Enable HP StorageWorks MSA1510i to Communicate with ESX/ESXi 55 HP StorageWorks EVA Storage Systems 56

VMware, Inc.

iSCSI SAN Configuration Guide

NetApp Storage Systems 57 EqualLogic Storage Systems 59 LeftHand Networks SAN/iQ Storage Systems 59 Dell PowerVault MD3000i Storage Systems 59 iSCSI Targets in vApps 59

4 Booting from iSCSI SAN 61

General Boot from iSCSI SAN Recommendations 62 Prepare the iSCSI SAN 62 Configure ESX Hosts to Boot from iSCSI SAN 63 iBFT iSCSI Boot Overview 64 Collecting Diagnostic Information for ESXi Hosts 69

5 Managing ESX/ESXi Systems That Use SAN Storage 71

Viewing Storage Adapter Information 71 Viewing Storage Device Information 72 Viewing Datastore Information 74 Resolving Storage Display Issues 75 Path Scanning and Claiming 79 Sharing Diagnostic Partitions 84 Avoiding and Resolving SAN Problems 84 Optimizing SAN Storage Performance 85 Resolving Performance Issues 88 SAN Storage Backup Considerations 91 Managing Duplicate VMFS Datastores 93 Storage Hardware Acceleration 96

A iSCSI SAN Configuration Checklist 99 B VMware vSphere Command-Line Interface 101

resxtop Command 101 vicfg-iscsi Command 101 vicfg-mpath Command 101 esxcli corestorage claimrule Command 102 vmkping Command 102

C Managing Multipathing Modules and Hardware Acceleration Plug-Ins 103

Managing Storage Paths and Multipathing Plug-Ins 103 Managing Hardware Acceleration Filter and Plug-Ins 110 esxcli corestorage claimrule Options 113

Index 115

VMware, Inc.

Updated Information

This iSCSI SAN Configuration Guide is updated with each release of the product or when necessary. This table provides the update history of the iSCSI SAN Configuration Guide.
Revision EN-000288-01 EN-000288-00 Description ESX/ESXi iSCSI SAN Restrictions, on page 30 has been updated to clarify multipathing support for different types of iSCSI adapters. Initial release.

VMware, Inc.

iSCSI SAN Configuration Guide

VMware, Inc.

About This Book

The iSCSI SAN Configuration Guide explains how to use VMware ESX and VMware ESXi systems with an iSCSI storage area network (SAN). The manual includes conceptual background information and installation requirements for ESX, ESXi, and VMware vCenter Server.

Intended Audience
This manual is written for experienced Windows or Linux system administrators who are familiar with virtual machine technology datacenter operations.

VMware Technical Publications Glossary

VMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation, go to http://www.vmware.com/support/pubs.

Document Feedback
VMware welcomes your suggestions for improving our documentation. If you have comments, send your feedback to [email protected].

VMware vSphere Documentation

The VMware vSphere documentation consists of the combined VMware vCenter Server and ESX/ESXi documentation set.

VMware, Inc.

iSCSI SAN Configuration Guide

Technical Support and Education Resources

The following technical support resources are available to you. To access the current version of this book and other books, go to http://www.vmware.com/support/pubs. Online and Telephone Support To use online support to submit technical support requests, view your product and contract information, and register your products, go to http://www.vmware.com/support. Customers with appropriate support contracts should use telephone support for the fastest response on priority 1 issues. Go to http://www.vmware.com/support/phone_support.html. Support Offerings VMware Professional Services To find out how VMware support offerings can help meet your business needs, go to http://www.vmware.com/support/services. VMware Education Services courses offer extensive hands-on labs, case study examples, and course materials designed to be used as on-the-job reference tools. Courses are available onsite, in the classroom, and live online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides offerings to help you assess, plan, build, and manage your virtual environment. To access information about education classes, certification programs, and consulting services, go to http://www.vmware.com/services.

VMware, Inc.

Using ESX/ESXi with an iSCSI Storage Area Network

You can use ESX/ESXi in conjunction with a storage area network (SAN), a specialized high-speed network that connects computer systems to high-performance storage subsystems. Using ESX/ESXi together with a SAN provides storage consolidation, improves reliability, and helps with disaster recovery. To use ESX/ESXi effectively with a SAN, you must have a working knowledge of ESX/ESXi systems and SAN concepts. Also, when you set up ESX/ESXi hosts to use Internet SCSI (iSCSI) SAN storage systems, you must be aware of certain special considerations that exist. This chapter includes the following topics:
n n n n n n n n n n n

Understanding Virtualization, on page 9 iSCSI SAN Concepts, on page 11 Overview of Using ESX/ESXi with a SAN, on page 16 Specifics of Using SAN Storage with ESX/ESXi, on page 17 Understanding VMFS Datastores, on page 18 Making LUN Decisions, on page 19 How Virtual Machines Access Data on a SAN, on page 21 Understanding Multipathing and Failover, on page 22 Choosing Virtual Machine Locations, on page 27 Designing for Server Failure, on page 27 LUN Display and Rescan, on page 28

Understanding Virtualization
The VMware virtualization layer is common across VMware desktop products (such as VMware Workstation) and server products (such as VMware ESX/ESXi). This layer provides a consistent platform for development, testing, delivery, and support of application workloads. The virtualization layer is organized as follows:
n n

Each virtual machine runs its own operating system (the guest operating system) and applications. The virtualization layer provides the virtual devices that map to shares of specific physical devices. These devices include virtualized CPU, memory, I/O buses, network interfaces, storage adapters and devices, human interface devices, and BIOS.

VMware, Inc.

iSCSI SAN Configuration Guide

Network Virtualization
The virtualization layer guarantees that each virtual machine is isolated from other virtual machines. Virtual machines can talk to each other only through networking mechanisms similar to those used to connect separate physical machines. The isolation allows administrators to build internal firewalls or other network isolation environments so that some virtual machines can connect to the outside, while others are connected only through virtual networks to other virtual machines.

Storage Virtualization
ESX/ESXi provides host-level storage virtualization, which logically abstracts the physical storage layer from virtual machines. An ESX/ESXi virtual machine uses a virtual disk to store its operating system, program files, and other data associated with its activities. A virtual disk is a large physical file, or a set of files, that can be copied, moved, archived, and backed up as easily as any other file. You can configure virtual machines with multiple virtual disks. To access virtual disks, a virtual machine uses virtual SCSI controllers. These virtual controllers include BusLogic Parallel, LSI Logic Parallel, LSI Logic SAS, and VMware Paravirtual. These controllers are the only types of SCSI controllers that a virtual machine can see and access. Each virtual disk that a virtual machine can access through one of the virtual SCSI controllers resides on a VMware Virtual Machine File System (VMFS) datastore, an NFS-based datastore, or on a raw disk. From the standpoint of the virtual machine, each virtual disk appears as if it were a SCSI drive connected to a SCSI controller. Whether the actual physical disk device is being accessed through parallel SCSI, iSCSI, network, or Fibre Channel adapters on the host is transparent to the guest operating system and to applications running on the virtual machine. Figure 1-1 gives an overview of storage virtualization. The diagram illustrates storage that uses VMFS and storage that uses raw device mapping. The diagram also shows how iSCSI storage is accessed through either iSCSI HBAs or by using a general-purpose NIC that uses iSCSI initiator software.

10

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Figure 1-1. iSCSI SAN Storage Virtualization

ESX/ESXi virtual machine virtual machine

SCSI controller

SCSI controller

virtual disk

virtual disk

VMware virtualization layer software iSCSI initiator ethernet NIC LAN

hardware iSCSI initiator (HBA) LAN VMFS LUN1 .vmdk

LUN2 RDM

LUN5

iSCSI SAN Concepts

If you are an ESX/ESXi administrator who plans to set up ESX/ESXi hosts to work with SANs, you must have a working knowledge of SAN concepts. You can find information about SAN in print and on the Internet. iSCSI SANs use Ethernet connections between computer systems, or host servers, and high performance storage subsystems. The SAN components include iSCSI host bus adapters (HBAs) or Network Interface Cards (NICs) in the host servers, switches and routers that transport the storage traffic, cables, storage processors (SPs), and storage disk systems. iSCSI SAN uses a client-server architecture. The client, called iSCSI initiator, operates on your host. It initiates iSCSI sessions by issuing SCSI commands and transmitting them, encapsulated into iSCSI protocol, to a server. The server is known as an iSCSI target. The iSCSI target represents a physical storage system on the network. It can also be provided by a virtual iSCSI SAN, for example, an iSCSI target emulator running in a virtual machine. The iSCSI target responds to the initiator's commands by transmitting required iSCSI data.

VMware, Inc.

11

iSCSI SAN Configuration Guide

Ports in the iSCSI SAN

A single discoverable entity on the iSCSI SAN, such as an initiator or a target, represents an iSCSI node. Each node has one or more ports that connect it to the SAN. iSCSI ports are end-points of an iSCSI session. Each node can be identified in a number of ways. IP Address Each iSCSI node can have an IP address associated with it so that routing and switching equipment on your network can establish the connection between the server and storage. This address is just like the IP address that you assign to your computer to get access to your company's network or the Internet. A worldwide unique name for identifying the node. iSCSI uses the iSCSI Qualified Name (IQN), Extended Unique Identifier (EUI), and Network Address Authority (NAA) formats. By default, ESX/ESXi generates unique iSCSI names for your iSCSI initiators, for example, iqn.1998-01.com.vmware:iscsitestox-68158ef2. Usually, you do not have to change the default value, but if you do, make sure that the new iSCSI name you enter is worldwide unique. iSCSI Alias A more manageable name for an iSCSI device or port used instead of the iSCSI name. iSCSI aliases are not unique and are intended to be just a friendly name to associate with a port.

iSCSI Name

iSCSI Naming Conventions

iSCSI uses a special unique name to identify an iSCSI node, either target or initiator. This name is similar to the WorldWide Name (WWN) associated with Fibre Channel devices and is used as a way to universally identify the node. iSCSI names are formatted in two different ways. The most common is the IQN format. For more details on iSCSI naming requirements and string profiles, see RFC 3721, RFC 3722, and RFC 3980 on the IETF Web site.

iSCSI Qualified Name (IQN) Format

The IQN format takes the form iqn.yyyy-mm.naming-authority:unique name, where:
n n

yyyy-mm is the year and month when the naming authority was established. naming-authority is usually reverse syntax of the Internet domain name of the naming authority. For example, the iscsi.vmware.com naming authority could have the iSCSI qualified name form of iqn. 1998-01.com.vmware.iscsi. The name indicates that the vmware.com domain name was registered in January of 1998, and iscsi is a subdomain, maintained by vmware.com. unique name is any name you want to use, for example, the name of your host. The naming authority must make sure that any names assigned following the colon are unique, such as:
n n n

iqn.1998-01.com.vmware.iscsi:name1 iqn.1998-01.com.vmware.iscsi:name2 iqn.1998-01.com.vmware.iscsi:name999

Enterprise Unique Identifier (EUI) Format

The EUI format takes the form eui.16 hex digits. For example, eui.0123456789ABCDEF.

12

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

The 16-hexadecimal digits are text representations of a 64-bit number of an IEEE EUI (extended unique identifier) format. The top 24 bits are a company ID that IEEE registers with a particular company. The lower 40 bits are assigned by the entity holding that company ID and must be unique.

iSCSI Initiators
To access iSCSI targets, your host uses iSCSI initiators. The initiators transport SCSI requests and responses, encapsulated into the iSCSI protocol, between the host and the iSCSI target. VMware supports different types of initiators.

Software iSCSI Adapter

A software iSCSI adapter is a VMware code built into the VMkernel. It allows your host to connect to the iSCSI storage device through standard network adapters. The software iSCSI adapter handles iSCSI processing while communicating with the network adapter. With the software iSCSI adapter, you can use iSCSI technology without purchasing specialized hardware.

Hardware iSCSI Adapter

A hardware iSCSI adapter is a third-party adapter that offloads iSCSI and network processing from your host. Hardware iSCSI adapters are divided into categories. Dependent Hardware iSCSI Adapter Depends on VMware networking, and iSCSI configuration and management interfaces provided by VMware. This type of adapter can be a card that presents a standard network adapter and iSCSI offload functionality for the same port. The iSCSI offload functionality depends on the host's network configuration to obtain the IP, MAC, and other parameters used for iSCSI sessions. An example of a dependent adapter is the iSCSI licensed Broadcom 5709 NIC. Independent Hardware iSCSI Adapter Implements its own networking and iSCSI configuration and management interfaces. An example of an independent hardware iSCSI adapter is a card that either presents only iSCSI offload functionality or iSCSI offload functionality and standard NIC functionality. The iSCSI offload functionality has independent configuration management that assigns the IP, MAC, and other parameters used for the iSCSI sessions. An example of a independent adapter is the QLogic QLA4052 adapter. Hardware iSCSI adapters might need to be licensed. Otherwise, they will not appear in the vSphere Client or vSphere CLI. Contact your vendor for licensing information.

Target Compared to LUN Representations

In the ESX/ESXi context, the term target identifies a single storage unit that your host can access. The terms storage device and LUN describe a logical volume that represents storage space on a target. Typically, the terms device and LUN, in the ESX/ESXi context, mean a SCSI volume presented to your host from a storage target and available for formatting. Different iSCSI storage vendors present storage to servers in different ways. Some vendors present multiple LUNs on a single target, while others present multiple targets with one LUN each. While the way the storage is used by an ESX/ESXi is similar, the way the information is presented through administrative tools is different.

VMware, Inc.

13

iSCSI SAN Configuration Guide

Figure 1-2. Target Compared to LUN Representations

target LUN LUN LUN target LUN target LUN target LUN

storage array

storage array

Three LUNs are available in each of these configurations. In the first case, ESX/ESXi detects one target but that target has three LUNs that can be used. Each of the LUNs represents individual storage volume. In the second case, the ESX/ESXi detects three different targets, each having one LUN. ESX/ESXi-based iSCSI initiators establish connections to each target. Storage systems with a single target containing multiple LUNs have traffic to all the LUNs on a single connection. With a system that has three targets with one LUN each, a host uses separate connections to the three LUNs. This information is useful when you are trying to aggregate storage traffic on multiple connections from the ESX/ESXi host with multiple iSCSI HBAs, where traffic for one target can be set to a particular HBA, while traffic for another target can use a different HBA.

Multipathing and Path Failover

When transferring data between the host server and storage, the SAN uses a technique known as multipathing. Multipathing allows you to have more than one physical path from the ESX/ESXi host to a LUN on a storage system. Generally, a single path from a host to a LUN consists of an iSCSI adapter or NIC, switch ports, connecting cables, and the storage controller port. If any component of the path fails, the host selects another available path for I/O. The process of detecting a failed path and switching to another is called path failover.

Storage System Types

ESX/ESXi supports different storage systems and arrays. The types of storage that your host supports include active-active, active-passive, and ALUA-compliant. Active-active storage system Active-passive storage system Allows access to the LUNs simultaneously through all the storage ports that are available without significant performance degradation. All the paths are active at all times, unless a path fails. A system in which one storage processor is actively providing access to a given LUN. The other processors act as backup for the LUN and can be actively providing access to other LUN I/O. I/O can be successfully sent only to an active port for a given LUN. If access through the active storage port fails, one of the passive storage processors can be activated by the servers accessing it. Supports Asymmetric Logical Unit Access (ALUA). ALUA-complaint storage systems provide different levels of access per port. ALUA allows hosts to determine the states of target ports and prioritize paths. The host uses some of the active paths as primary while others as secondary. Allows access to all available LUNs through a single virtual port. These are active-active storage devices, but hide their multiple connections though a single port. The ESX/ESXi multipathing cannot detect the multiple connections to the storage. These storage systems handle port failover and connection balancing transparently. This is often referred to as transparent failover.

Asymmetrical storage system

Virtual port storage system

14

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Discovery, Authentication, and Access Control

You can use several mechanisms to discover your storage and to limit access to it. You must configure your host and the iSCSI storage system to support your storage access control policy.

Discovery
A discovery session is part of the iSCSI protocol, and it returns the set of targets you can access on an iSCSI storage system. The two types of discovery available on ESX/ESXi are dynamic and static. Dynamic discovery obtains a list of accessible targets from the iSCSI storage system, while static discovery can only try to access one particular target by target name.

Authentication
iSCSI storage systems authenticate an initiator by a name and key pair. ESX/ESXi supports the CHAP protocol, which VMware recommends for your SAN implementation. To use CHAP authentication, the ESX/ESXi host and the iSCSI storage system must have CHAP enabled and have common credentials.

Access Control
Access control is a policy set up on the iSCSI storage system. Most implementations support one or more of three types of access control:
n n n

By initiator name By IP address By the CHAP protocol

Only initiators that meet all rules can access the iSCSI volume.

Error Correction
To protect the integrity of iSCSI headers and data, the iSCSI protocol defines error correction methods known as header digests and data digests. Both parameters are disabled by default, but you can enable them. These digests pertain to, respectively, the header and SCSI data being transferred between iSCSI initiators and targets, in both directions. Header and data digests check the end-to-end, noncryptographic data integrity beyond the integrity checks that other networking layers provide, such as TCP and Ethernet. They check the entire communication path, including all elements that can change the network-level traffic, such as routers, switches, and proxies. The existence and type of the digests are negotiated when an iSCSI connection is established. When the initiator and target agree on a digest configuration, this digest must be used for all traffic between them. Enabling header and data digests does require additional processing for both the initiator and the target and can affect throughput and CPU use performance. NOTE Systems that use Intel Nehalem processors offload the iSCSI digest calculations, thus reducing the impact on performance.

VMware, Inc.

15

iSCSI SAN Configuration Guide

Overview of Using ESX/ESXi with a SAN

Using ESX/ESXi with a SAN improves flexibility, efficiency, and reliability. Using ESX/ESXi with a SAN also supports centralized management, failover, and load balancing technologies. The following are benefits of using ESX/ESXi with a SAN:
n

You can store data securely and configure multiple paths to your storage, eliminating a single point of failure. Using a SAN with ESX/ESXi systems extends failure resistance to the server. When you use SAN storage, all applications can instantly be restarted on another host after the failure of the original host. You can perform live migration of virtual machines using VMware vMotion. Use VMware High Availability (HA) in conjunction with a SAN to restart virtual machines in their last known state on a different server if their host fails. Use VMware Fault Tolerance (FT) to replicate protected virtual machines on two different hosts. Virtual machines continue to function without interruption on the secondary host if the primary one fails. Use VMware Distributed Resource Scheduler (DRS) to migrate virtual machines from one host to another for load balancing. Because storage is on a shared SAN array, applications continue running seamlessly. If you use VMware DRS clusters, put an ESX/ESXi host into maintenance mode to have the system migrate all running virtual machines to other ESX/ESXi hosts. You can then perform upgrades or other maintenance operations on the original host.

n n

The portability and encapsulation of VMware virtual machines complements the shared nature of this storage. When virtual machines are located on SAN-based storage, you can quickly shut down a virtual machine on one server and power it up on another server, or suspend it on one server and resume operation on another server on the same network. This ability allows you to migrate computing resources while maintaining consistent shared access.

ESX/ESXi and SAN Use Cases

You can perform a number of tasks when using ESX/ESXi with a SAN. Using ESX/ESXi in conjunction with a SAN is effective for the following tasks: Maintenance with zero downtime When performing ESX/ESXi host or infrastructure maintenance, use VMware DRS or vMotion to migrate virtual machines to other servers. If shared storage is on the SAN, you can perform maintenance without interruptions to the users of the virtual machines. Use vMotion or VMware DRS to migrate virtual machines to other hosts for load balancing. If shared storage is on a SAN, you can perform load balancing without interruption to the users of the virtual machines. If you are working with multiple hosts, and each host is running multiple virtual machines, the storage on the hosts is no longer sufficient and external storage is required. Choosing a SAN for external storage results in a simpler system architecture along with other benefits. Start by reserving a large volume and then allocate portions to virtual machines as needed. Volume allocation and creation from the storage device needs to happen only once.

Load balancing

Storage consolidation and simplification of storage layout

16

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Disaster recovery

Having all data stored on a SAN facilitates the remote storage of data backups. You can restart virtual machines on remote ESX/ESXi hosts for recovery if one site is compromised. When you purchase new storage systems or arrays, use storage vMotion to perform live automated migration of virtual machine disk files from existing storage to their new destination without interruptions to the users of the virtual machines.

Simplified array migrations and storage upgrades

Finding Further Information

In addition to this document, a number of other resources can help you configure your ESX/ESXi system in conjunction with a SAN.
n

Use your storage array vendor's documentation for most setup questions. Your storage array vendor might also offer documentation on using the storage array in an ESX/ESXi environment. The VMware Documentation Web site. The Fibre Channel SAN Configuration Guide discusses the use of ESX/ESXi with Fibre Channel storage area networks. The VMware I/O Compatibility Guide lists the currently approved HBAs, HBA drivers, and driver versions. The VMware Storage/SAN Compatibility Guide lists currently approved storage arrays. The VMware Release Notes give information about known issues and workarounds. The VMware Knowledge Bases have information on common issues and workarounds.

n n

n n n n

Specifics of Using SAN Storage with ESX/ESXi

Using a SAN in conjunction with an ESX/ESXi host differs from traditional SAN usage in a variety of ways. When you use SAN storage with ESX/ESXi, keep in mind the following considerations:
n

You cannot directly access the virtual machine operating system that uses the storage. With traditional tools, you can monitor only the VMware ESX/ESXi operating system. You use the vSphere Client to monitor virtual machines. The HBA visible to the SAN administration tools is part of the ESX/ESXi system, not part of the virtual machine. Your ESX/ESXi system performs multipathing for you.

Third-Party Management Applications

You can use third-party management applications in conjunction with your ESX/ESXi host. Most iSCSI storage hardware is packaged with storage management software. In many cases, this software is a web application that can be used with any web browser connected to your network. In other cases, this software typically runs on the storage system or on a single server, independent of the servers that use the SAN for storage. Use this third-party management software for the following tasks:
n

Storage array management, including LUN creation, array cache management, LUN mapping, and LUN security. Setting up replication, check points, snapshots, or mirroring.

VMware, Inc.

17

iSCSI SAN Configuration Guide

If you decide to run the SAN management software on a virtual machine, you gain the benefits of running a virtual machine, including failover using vMotion and VMware HA. Because of the additional level of indirection, however, the management software might not be able to see the SAN. In this case, you can use an RDM. NOTE Whether a virtual machine can run management software successfully depends on the particular storage system.

Understanding VMFS Datastores

To store virtual disks, ESX/ESXi uses datastores, which are logical containers that hide specifics of storage from virtual machines and provide a uniform model for storing virtual machine files. Datastores that you deploy on storage devices typically use the VMware Virtual Machine File System (VMFS) format, a special highperformance file system format that is optimized for storing virtual machines. A VMFS datastore can run multiple virtual machines. VMFS provides distributed locking for your virtual machine files, so that your virtual machines can operate safely in a SAN environment where multiple ESX/ESXi hosts share the same VMFS datastore. Use the vSphere Client to set up a VMFS datastore in advance on a block-based storage device that your ESX/ESXi host discovers. A VMFS datastore can be extended to span several physical storage extents, including SAN LUNs and local storage. This feature allows you to pool storage and gives you flexibility in creating the datastore necessary for your virtual machine. You can increase the capacity of a datastore while virtual machines are running on the datastore. This ability lets you add new space to your VMFS datastores as your virtual machine requires it. VMFS is designed for concurrent access from multiple physical machines and enforces the appropriate access controls on virtual machine files.

Sharing a VMFS Datastore Across ESX/ESXi Hosts

As a cluster file system, VMFS lets multiple ESX/ESXi hosts access the same VMFS datastore concurrently. To ensure that multiple servers do not access the same virtual machine at the same time, VMFS provides ondisk locking. Figure 1-3 shows several ESX/ESXi systems sharing the same VMFS volume. Figure 1-3. Sharing a VMFS Datastore Across ESX/ESXi Hosts
ESX/ESXi A ESX/ESXi B ESX/ESXi C

VM1

VM2

VM3

VMFS volume disk1 disk2 disk3 virtual disk files

18

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Because virtual machines share a common VMFS datastore, it might be difficult to characterize peak-access periods or to optimize performance. You must plan virtual machine storage access for peak periods, but different applications might have different peak-access periods. VMware recommends that you load balance virtual machines over servers, CPU, and storage. Run a mix of virtual machines on each server so that not all experience high demand in the same area at the same time.

Metadata Updates
A VMFS datastore holds virtual machine files, directories, symbolic links, RDM descriptor files, and so on. The datastore also maintains a consistent view of all the mapping information for these objects. This mapping information is called metadata. Metadata is updated each time the attributes of a virtual machine file are accessed or modified when, for example, you perform one of the following operations:
n n n

Creating, growing, or locking a virtual machine file Changing a file's attributes Powering a virtual machine on or off

Making LUN Decisions

You must plan how to set up storage for your ESX/ESXi systems before you format LUNs with VMFS datastores. When you make your LUN decision, keep in mind the following considerations:
n

Each LUN should have the correct RAID level and storage characteristic for the applications running in virtual machines that use the LUN. One LUN must contain only one VMFS datastore. If multiple virtual machines access the same VMFS, use disk shares to prioritize virtual machines.

n n

You might want fewer, larger LUNs for the following reasons:
n n n

More flexibility to create virtual machines without asking the storage administrator for more space. More flexibility for resizing virtual disks, doing snapshots, and so on. Fewer VMFS datastores to manage.

You might want more, smaller LUNs for the following reasons:
n n n n n

Less wasted storage space. Different applications might need different RAID characteristics. More flexibility, as the multipathing policy and disk shares are set per LUN. Use of Microsoft Cluster Service requires that each cluster disk resource is in its own LUN. Better performance because there is less contention for a single volume.

When the storage characterization for a virtual machine is not available, there is often no simple method to determine the number and size of LUNs to provision. You can experiment using either a predictive or adaptive scheme.

VMware, Inc.

19

iSCSI SAN Configuration Guide

Use the Predictive Scheme to Make LUN Decisions

When setting up storage for ESX/ESXi systems, before creating VMFS datastores, you must decide on the size and number of LUNs to provision. You can experiment using the predictive scheme. Procedure 1 2 3 4 Provision several LUNs with different storage characteristics. Create a VMFS datastore on each LUN, labeling each datastore according to its characteristics. Create virtual disks to contain the data for virtual machine applications in the VMFS datastores created on LUNs with the appropriate RAID level for the applications' requirements. Use disk shares to distinguish high-priority from low-priority virtual machines. NOTE Disk shares are relevant only within a given host. The shares assigned to virtual machines on one host have no effect on virtual machines on other hosts. 5 Run the applications to determine whether virtual machine performance is acceptable.

Use the Adaptive Scheme to Make LUN Decisions

When setting up storage for ESX/ESXi hosts, before creating VMFS datastores, you must decide on the number and size of LUNS to provision. You can experiment using the adaptive scheme. Procedure 1 2 3 4 Provision a large LUN (RAID 1+0 or RAID 5), with write caching enabled. Create a VMFS on that LUN. Create four or five virtual disks on the VMFS. Run the applications to determine whether disk performance is acceptable.

If performance is acceptable, you can place additional virtual disks on the VMFS. If performance is not acceptable, create a new, large LUN, possibly with a different RAID level, and repeat the process. Use migration so that you do not lose virtual machines data when you recreate the LUN.

Use Disk Shares to Prioritize Virtual Machines

If multiple virtual machines access the same VMFS datastore (and therefore the same LUN), use disk shares to prioritize the disk accesses from the virtual machines. Disk shares distinguish high-priority from lowpriority virtual machines. Procedure 1 2 3 Start a vSphere Client and connect to vCenter Server. Select the virtual machine in the inventory panel and click Edit virtual machine settings from the menu. Click the Resources tab and click Disk.

20

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Double-click the Shares column for the disk to modify and select the required value from the drop-down menu. Shares is a value that represents the relative metric for controlling disk bandwidth to all virtual machines. The values Low, Normal, High, and Custom are compared to the sum of all shares of all virtual machines on the server and, on an ESX host, the service console. Share allocation symbolic values can be used to configure their conversion into numeric values.

Click OK to save your selection.

NOTE Disk shares are relevant only within a given ESX/ESXi host. The shares assigned to virtual machines on one host have no effect on virtual machines on other hosts.

How Virtual Machines Access Data on a SAN

ESX/ESXi stores a virtual machine's disk files within a VMFS datastore that resides on a SAN storage device. When virtual machine guest operating systems issue SCSI commands to their virtual disks, the SCSI virtualization layer translates these commands to VMFS file operations. When a virtual machine interacts with its virtual disk stored on a SAN, the following process takes place: 1 2 3 4 When the guest operating system in a virtual machine reads or writes to SCSI disk, it issues SCSI commands to the virtual disk. Device drivers in the virtual machines operating system communicate with the virtual SCSI controllers. The virtual SCSI Controller forwards the command to the VMkernel. The VMkernel performs the following tasks.
n n n

Locates the file in the VMFS volume that corresponds to the guest virtual machine disk. Maps the requests for the blocks on the virtual disk to blocks on the appropriate physical device. Sends the modified I/O request from the device driver in the VMkernel to the iSCSI initiator (hardware or software).

If the iSCSI initiator is a hardware iSCSI adapter (both independent or dependent), the adapter performs the following tasks.
n n n

Encapsulates I/O requests into iSCSI Protocol Data Units (PDUs). Encapsulates iSCSI PDUs into TCP/IP packets. Sends IP packets over Ethernet to the iSCSI storage system.

If the iSCSI initiator is a software iSCSI adapter, the following takes place.
n n n n

The iSCSI initiator encapsulates I/O requests into iSCSI PDUs. The initiator sends iSCSI PDUs through TCP/IP connections. The VMkernel TCP/IP stack relays TCP/IP packets to a physical NIC. The physical NIC sends IP packets over Ethernet to the iSCSI storage system.

Depending on which port the iSCSI initiator uses to connect to the network, Ethernet switches and routers carry the request to the storage device that the host wants to access.

VMware, Inc.

21

iSCSI SAN Configuration Guide

Understanding Multipathing and Failover

To maintain a constant connection between an ESX/ESXi host and its storage, ESX/ESXi supports multipathing. Multipathing is a technique that lets you use more than one physical path that transfers data between the host and an external storage device. In case of a failure of any element in the SAN network, such as an adapter, switch, or cable, ESX/ESXi can switch to another physical path, which does not use the failed component. This process of path switching to avoid failed components is known as path failover. In addition to path failover, multipathing provides load balancing. Load balancing is the process of distributing I/O loads across multiple physical paths. Load balancing reduces or removes potential bottlenecks. NOTE Virtual machine I/O might be delayed for up to sixty seconds while path failover takes place. These delays allow the SAN to stabilize its configuration after topology changes. In general, the I/O delays might be longer on active-passive arrays and shorter on activate-active arrays.

Managing Multiple Paths

To manage storage multipathing, ESX/ESXi uses a special VMkernel layer, the Pluggable Storage Architecture (PSA). The PSA is an open, modular framework that coordinates the simultaneous operation of multiple multipathing plug-ins (MPPs). The VMkernel multipathing plug-in that ESX/ESXi provides by default is the VMware Native Multipathing Plug-In (NMP). The NMP is an extensible module that manages sub plug-ins. There are two types of NMP sub plug-ins, Storage Array Type Plug-Ins (SATPs), and Path Selection Plug-Ins (PSPs). SATPs and PSPs can be built-in and provided by VMware, or can be provided by a third party. If more multipathing functionality is required, a third party can also provide an MPP to run in addition to, or as a replacement for, the default NMP. When coordinating the VMware NMP and any installed third-party MPPs, the PSA performs the following tasks:
n n n n n n n n

Loads and unloads multipathing plug-ins. Hides virtual machine specifics from a particular plug-in. Routes I/O requests for a specific logical device to the MPP managing that device. Handles I/O queuing to the logical devices. Implements logical device bandwidth sharing between virtual machines. Handles I/O queueing to the physical storage HBAs. Handles physical path discovery and removal. Provides logical device and physical path I/O statistics.

As Figure 1-4 illustrates, multiple third-party MPPs can run in parallel with the VMware NMP. When installed, the third-party MPPs replace the behavior of the NMP and take complete control of the path failover and the load-balancing operations for specified storage devices.

22

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Figure 1-4. Pluggable Storage Architecture

VMkernel pluggable storage architecture
third-party MPP third-party MPP VMware NMP VMware SATP VMware SATP VMware SATP third-party SATP third-party PSP VMware PSP VMware PSP

The multipathing modules perform the following operations:

n n n n n

Manage physical path claiming and unclaiming. Manage creation, registration, and deregistration of logical devices. Associate physical paths with logical devices. Support path failure detection and remediation. Process I/O requests to logical devices:
n n

Select an optimal physical path for the request. Depending on a storage device, perform specific actions necessary to handle path failures and I/O command retries.

Support management tasks, such as abort or reset of logical devices.

VMware Multipathing Module

By default, ESX/ESXi provides an extensible multipathing module called the Native Multipathing Plug-In (NMP). Generally, the VMware NMP supports all storage arrays listed on the VMware storage HCL and provides a default path selection algorithm based on the array type. The NMP associates a set of physical paths with a specific storage device, or LUN. The specific details of handling path failover for a given storage array are delegated to a Storage Array Type Plug-In (SATP). The specific details for determining which physical path is used to issue an I/O request to a storage device are handled by a Path Selection Plug-In (PSP). SATPs and PSPs are sub plug-ins within the NMP module. Upon installation of ESX/ESXi, the appropriate SATP for an array you use will be installed automatically. You do not need to obtain or download any SATPs. VMware SATPs Storage Array Type Plug-Ins (SATPs) run in conjunction with the VMware NMP and are responsible for arrayspecific operations. ESX/ESXi offers a SATP for every type of array that VMware supports. It also provides default SATPs that support non-specific active-active and ALUA storage arrays, and the local SATP for direct-attached devices. Each SATP accommodates special characteristics of a certain class of storage arrays and can perform the arrayspecific operations required to detect path state and to activate an inactive path. As a result, the NMP module itself can work with multiple storage arrays without having to be aware of the storage device specifics.

VMware, Inc.

23

iSCSI SAN Configuration Guide

After the NMP determines which SATP to use for a specific storage device and associates the SATP with the physical paths for that storage device, the SATP implements the tasks that include the following:
n n n

Monitors the health of each physical path. Reports changes in the state of each physical path. Performs array-specific actions necessary for storage fail-over. For example, for active-passive devices, it can activate passive paths.

VMware PSPs Path Selection Plug-Ins (PSPs) run with the VMware NMP and are responsible for choosing a physical path for I/O requests. The VMware NMP assigns a default PSP for each logical device based on the SATP associated with the physical paths for that device. You can override the default PSP. By default, the VMware NMP supports the following PSPs: Most Recently Used (VMW_PSP_MRU) Selects the path the ESX/ESXi host used most recently to access the given device. If this path becomes unavailable, the host switches to an alternative path and continues to use the new path while it is available. MRU is the default path policy for active-passive arrays. Uses the designated preferred path, if it has been configured. Otherwise, it uses the first working path discovered at system boot time. If the host cannot use the preferred path, it selects a random alternative available path. The host reverts back to the preferred path as soon as that path becomes available. Fixed is the default path policy for active-active arrays. CAUTION If used with active-passive arrays, the Fixed path policy might cause path thrashing. VMW_PSP_FIXED_AP Round Robin (VMW_PSP_RR) VMware NMP Flow of I/O When a virtual machine issues an I/O request to a storage device managed by the NMP, the following process takes place. 1 2 3 4 5 6 7 The NMP calls the PSP assigned to this storage device. The PSP selects an appropriate physical path on which to issue the I/O. The NMP issues the I/O request on the path selected by the PSP. If the I/O operation is successful, the NMP reports its completion. If the I/O operation reports an error, the NMP calls the appropriate SATP. The SATP interprets the I/O command errors and, when appropriate, activates the inactive paths. The PSP is called to select a new path on which to issue the I/O. Extends the Fixed functionality to active-passive and ALUA mode arrays. Uses a path selection algorithm that rotates through all available active paths enabling load balancing across the paths.

Fixed (VMW_PSP_FIXED)

Host-Based Path Failover

When setting up your ESX/ESXi host for multipathing and failover, you can use multiple iSCSI HBAs or multiple NICs depending on the type of iSCSI initiators on your host. Figure 1-5 shows multipathing setups possible with different types of iSCSI initiators.

24

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Figure 1-5. Host-Based Path Failover

hardware iSCSI host 1 software adapter HBA2 HBA1 NIC2 NIC1 software iSCSI host 2

IP network

SP

iSCSI storage

Failover with Hardware iSCSI

With the hardware iSCSI, the host typically has two or more hardware iSCSI adapters available, from which the storage system can be reached using one or more switches. Alternatively, the setup might include one adapter and two storage processors so that the adapter can use a different path to reach the storage system. On the Figure 1-5 illustration, Host1 has two hardware iSCSI adapters, HBA1 and HBA2, that provide two physical paths to the storage system. Multipathing plug-ins on your host, whether the VMkernel NMP or any third-party MPPs, have access to the paths by default and can monitor health of each physical path. If, for example, HBA1 or the link between HBA1 and the network fails, the multipathing plug-ins can switch the path over to HBA2.

Failover with Software iSCSI

With the software iSCSI, as shown on Host 2 of Figure 1-5, you can use multiple NICs that provide failover and load balancing capabilities for iSCSI connections between your host and storage systems. For this setup, because multipathing plug-ins do not have direct access to physical NICs on your host, you first need to connect each physical NIC to a separate VMkernel port. You then associate all VMkernel ports with the software iSCSI initiator using a port binding technique. As a result, each VMkernel port connected to a separate NIC becomes a different path that the iSCSI storage stack and its storage-aware multipathing plugins can use. For information on how to configure multipathing for the software iSCSI, see Networking Configuration for Software iSCSI and Dependent Hardware iSCSI, on page 36.

Array-Based Failover
Some iSCSI storage systems manage path use of their ports automatically and transparently to ESX/ESXi. When using one of these storage systems, ESX/ESXi does not see multiple ports on the storage and cannot choose the storage port it connects to. These systems have a single virtual port address that ESX/ESXi uses to initially communicate. During this initial communication, the storage system can redirect ESX/ESXi to communicate with another port on the storage system. The iSCSI initiators in ESX/ESXi obey this reconnection request and connect with a different port on the system. The storage system uses this technique to spread the load across available ports.

VMware, Inc.

25

iSCSI SAN Configuration Guide

If ESX/ESXi loses connection to one of these ports, it automatically attempts to reconnect with the virtual port of the storage system, and should be redirected to an active, usable port. This reconnection and redirection happens quickly and generally does not disrupt running virtual machines. These storage systems can also request that iSCSI initiators reconnect to the system, to change which storage port they are connected to. This allows the most effective use of the multiple ports. Figure 1-6 shows an example of port redirection. ESX/ESXi attempts to connect to the 10.0.0.1 virtual port. The storage system redirects this request to 10.0.0.2. ESX/ESXi connects with 10.0.0.2 and uses this port for I/O communication. NOTE The storage system does not always redirect connections. The port at 10.0.0.1 could be used for traffic, also. Figure 1-6. Port Redirection
ESX/ESXi Connect to storage at 10.0.0.1 10.0.0.1 Reconnect to 10.0.0.2 10.0.0.2 storage

ESX/ESXi

iSCSI storage traffic 10.0.0.1 10.0.0.2 storage

If the port on the storage system that is acting as the virtual port becomes unavailable, the storage system reassigns the address of the virtual port to another port on the system. Figure 1-7 shows an example of this type of port reassignment. In this case, the virtual port 10.0.0.1 becomes unavailable and the storage system reassigns the virtual port IP address to a different port. The second port responds to both addresses. Figure 1-7. Port Reassignment
10.0.0.1 10.0.0.2 storage

10.0.0.1 10.0.0.1 10.0.0.2 storage

With array-based failover, you can have multiple paths to the storage only if you use multiple ports on the ESX/ESXi host. These paths are active-active. For additional information, see iSCSI Session Management, on page 49.

26

VMware, Inc.

Chapter 1 Using ESX/ESXi with an iSCSI Storage Area Network

Choosing Virtual Machine Locations

When youre working on optimizing performance for your virtual machines, storage location is an important factor. A trade-off always exists between expensive storage that offers high performance and high availability and storage with lower cost and lower performance. Storage can be divided into different tiers depending on a number of factors:
n

High Tier. Offers high performance and high availability. Might offer built-in snapshots to facilitate backups and point-in-time (PiT) restorations. Supports replication, full SP redundancy, and SAS drives. Uses high-cost spindles. Mid Tier. Offers mid-range performance, lower availability, some SP redundancy, and SCSI or SAS drives. May offer snapshots. Uses medium-cost spindles. Lower Tier. Offers low performance, little internal storage redundancy. Uses low end SCSI drives or SATA (serial low-cost spindles).

Not all applications need to be on the highest-performance, most-available storageat least not throughout their entire life cycle. NOTE If you need some of the functionality of the high tier, such as snapshots, but do not want to pay for it, you might be able to achieve some of the high-performance characteristics in software. For example, you can create snapshots in software. When you decide where to place a virtual machine, ask yourself these questions:
n n n n n

How critical is the virtual machine? What are its performance and availability requirements? What are its PiT restoration requirements? What are its backup requirements? What are its replication requirements?

A virtual machine might change tiers throughout its life cycle because of changes in criticality or changes in technology that push higher-tier features to a lower tier. Criticality is relative and might change for a variety of reasons, including changes in the organization, operational processes, regulatory requirements, disaster planning, and so on.

Designing for Server Failure

The RAID architecture of SAN storage inherently protects you from failure at the physical disk level. A SAN provides multiple paths between servers and storage, which protects against network or port failures. The final step in making your whole environment failure resistant is to protect against server failure.

Using VMware HA
One of the failover options ESX/ESXi provides is VMware High Availability (HA). VMware HA allows you to organize virtual machines into failover groups. When a host fails, all its virtual machines are immediately started on different hosts. When a virtual machine is restored on a different host, it loses its memory state, but its disk state is exactly as it was when the host failed (crash-consistent failover). Shared storage (such as a SAN) is required for HA. NOTE You must be licensed to use VMware HA.

VMware, Inc.

27

iSCSI SAN Configuration Guide

Server Failover and Storage Considerations

When you are configuring your ESX/ESXi host to work in conjunction with SAN, you must make your whole environment failure resistant and protect it against host failures. For each type of server failover, you must follow these practices:
n

Approaches to server failover work only if each server has access to the same storage. Because multiple servers require a lot of disk space, and because failover for the storage system complements failover for the server, SANs are usually employed in conjunction with server failover. When you design a SAN to work in conjunction with server failover, all ESX/ESXi hosts must see all datastores that the clustered virtual machines use. Although a datastore is accessible to a host, all virtual machines on that host do not necessarily have access to all data on that datastore. A virtual machine can access only the virtual disks for which it was configured. In case of a configuration error, virtual disks are locked when the virtual machine boots so no corruption occurs.

NOTE As a rule, when you boot from a SAN, each boot volume should be seen only by the host that is booting from that volume. An exception is when you try to recover from a failure by pointing a second host to the same volume. In this case, the SAN volume in question is not really for booting from a SAN. No host is booting from it because it is corrupted. The SAN volume is a regular non-boot volume that is made visible to a host.

LUN Display and Rescan

A SAN is dynamic, and which LUNs are available to a certain host can change based on a number of factors. The VMkernel discovers LUNs when it boots, and those LUNs are then visible in the vSphere Client. If changes are made to the LUNs, you must rescan to see those changes.
n n n

New LUNs created on the iSCSI storage Changes to LUN access control Changes in connectivity

28

VMware, Inc.

Configuring iSCSI Initiators and Storage

Before ESX/ESXi can work with a SAN, you must set up your iSCSI initiators and storage. To do this, you must first observe certain basic requirements and then follow best practices for installing and setting up hardware or software iSCSI initiators to access the SAN. This chapter includes the following topics:
n n n n n n n n n n n n n n n n

ESX/ESXi iSCSI SAN Requirements, on page 29 ESX/ESXi iSCSI SAN Restrictions, on page 30 Setting LUN Allocations, on page 30 Network Configuration and Authentication, on page 30 Setting Up Independent Hardware iSCSI Adapters, on page 31 Setting Up and Configuring Dependent Hardware iSCSI Adapters, on page 32 Setting Up and Configuring Software iSCSI Adapter, on page 34 Networking Configuration for Software iSCSI and Dependent Hardware iSCSI, on page 36 Bind iSCSI Ports to iSCSI Adapters, on page 40 Using Jumbo Frames with iSCSI, on page 41 Enabling Jumbo Frames for Software and Dependent Hardware iSCSI, on page 42 Configuring Discovery Addresses for iSCSI Initiators, on page 43 Configuring CHAP Parameters for iSCSI Adapters, on page 44 Configuring Additional Parameters for iSCSI, on page 48 iSCSI Session Management, on page 49 Add iSCSI Storage, on page 51

ESX/ESXi iSCSI SAN Requirements

You must meet several requirements for your ESX/ESXi host to work properly with a SAN.
n

Verify that your SAN storage hardware and firmware combinations are supported in conjunction with ESX/ESXi systems. For an up-to-date list, see the Storage/SAN section of the online Hardware Compatibility Guide. Configure your system to have only one VMFS datastore for each LUN. In VMFS-3, you do not need to set accessibility.

VMware, Inc.

29

iSCSI SAN Configuration Guide

Unless you are using diskless servers (booting from a SAN), do not set up the diagnostic partition on a SAN LUN. In the case of diskless servers that boot from a SAN, a shared diagnostic partition is appropriate. Use RDMs for access to any raw disk. Set the SCSI controller driver in the guest operating system to a large enough queue. You can set the queue depth for the physical HBA during system setup. On virtual machines running Microsoft Windows, increase the value of the SCSI TimeoutValue parameter to allow Windows to better tolerate delayed I/O resulting from path failover.

n n

ESX/ESXi iSCSI SAN Restrictions

Specific restrictions apply when you use ESX/ESXi with an iSCSI SAN.
n n

ESX/ESXi does not support iSCSI-connected tape devices. You cannot use virtual-machine multipathing software to perform I/O load balancing to a single physical LUN. ESX/ESXi does not support multipathing when you combine an independent hardware adapter with either software iSCSI adapter or dependent hardware iSCSI adapter.

Setting LUN Allocations

When preparing your ESX/ESXi system to use iSCSI SAN storage you need to set LUN allocations. Note the following points:
n

Storage Provisioning. To ensure that the ESX/ESXi host recognizes LUNs at startup time, configure all iSCSI storage targets so that your host can access them and use them. Also, configure your host so that it can discover all available iSCSI targets. vMotion and VMware DRS. When you use vCenter Server and vMotion or DRS, make sure that the LUNs for the virtual machines are provisioned to all ESX/ESXi hosts. This configuration provides the greatest freedom in moving virtual machines. Active-active versus active-passive arrays. When you use vMotion or DRS with an active-passive SAN storage device, make sure that all ESX/ESXi systems have consistent paths to all storage processors. Not doing so can cause path thrashing when a vMotion migration occurs. For active-passive storage arrays not listed in the Storage/SAN section of the online VMware Compatibility Guide, VMware does not support storage-port failover. You must connect the server to the active port on the storage system. This configuration ensures that the LUNs are presented to the ESX/ESXi host.

Network Configuration and Authentication

Before your ESX/ESXi can discover iSCSI storage, the iSCSI initiators must be configured and authentication might have to be set up.
n

For software iSCSI and dependent hardware iSCSI, networking for the VMkernel must be configured. You can verify the network configuration by using the vmkping utility. For hardware iSCSI, network parameters, such as IP address, subnet mask, and default gateway must be configured on the HBA. Check and change the default initiator name if necessary.

30

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

n n

The discovery address of the storage system must be set and should be pingable using vmkping. For CHAP authentication, enable it on the initiator and the storage system side. After authentication is enabled, it applies for all of the targets that are not yet discovered, but does not apply to targets that are already discovered. After the discovery address is set, the new targets discovered are exposed and can be used at that point.

For details on how to use the vmkping command, search the VMware Knowledge Base.

Setting Up Independent Hardware iSCSI Adapters

An independent hardware iSCSI adapter is a specialized third-party adapter capable of accessing iSCSI storage over TCP/IP. This iSCSI adapter handles all iSCSI and network processing and management for your ESX/ESXi system. The setup and configuration process for the independent hardware iSCSI adapters involves these steps: 1 Check whether the adapter needs to be licensed. See your vendor documentation. 2 Install the adapter. For installation information, see vendor documentation. 3 Verity that the adapter is installed correctly. See View Independent Hardware iSCSI Adapters, on page 31. 4 Configure discovery addresses. See Configuring Discovery Addresses for iSCSI Initiators, on page 43. 5 Configure CHAP parameters. See Configuring CHAP Parameters for iSCSI Adapters, on page 44. For your host to be able to access iSCSI storage, you must first install the hardware iSCSI adapter and configure discovery address and CHAP parameters.

View Independent Hardware iSCSI Adapters

View a hardware iSCSI adapter to verify that it is correctly installed and ready for configuration. Prerequisites After you install a hardware iSCSI adapter, it appears on the list of storage adapters available for configuration. You can view its properties. Required privilege: Host.Configuration.Storage Partition Configuration Procedure 1 2 Log in to the vSphere Client, and select a host from the inventory panel. Click the Configuration tab and click Storage Adapters in the Hardware panel. If installed, the hardware iSCSI initiator should appear on the list of storage adapters.

VMware, Inc.

31

iSCSI SAN Configuration Guide

Select the initiator to view. The default details for the initiator appear, including the model, iSCSI name, iSCSI alias, IP address, and target and paths information.

Click Properties. The iSCSI Initiator Properties dialog box appears. The General tab displays additional characteristics of the initiator.

You can now configure your hardware initiator or change its default characteristics.

Change Name and IP Address for Independent Hardware Initiators

When you configure your independent hardware iSCSI initiators, make sure that their names and IP addresses are formatted properly. Procedure 1 2 3 Access the iSCSI Initiator Properties dialog box. Click Configure. To change the default iSCSI name for your initiator, enter the new name. Make sure the name you enter is worldwide unique and properly formatted or some storage devices might not recognize the hardware iSCSI initiator. 4 (Optional) Enter the iSCSI alias. The alias is a name that you use to identify the hardware iSCSI initiator. 5 Change the default IP settings. You must change the default IP settings so that they are configured properly for the IP SAN. Work with your network administrator to determine the IP setting for the HBA. 6 Click OK to save your changes.

If you change the iSCSI name, it is used for new iSCSI sessions. For existing sessions, new settings are not used until logout and re-login.

Setting Up and Configuring Dependent Hardware iSCSI Adapters

A dependent hardware iSCSI adapter is a third-party adapter that depends on VMware networking, and iSCSI configuration and management interfaces provided by VMware. This type of adapter can be a card, such as a Broadcom 5709 NIC, that presents a standard network adapter and iSCSI offload functionality for the same port. The iSCSI offload functionality appears on the list of storage adapters as an iSCSI adapter. Although the iSCSI adapter is enabled by default, to make it functional, you must set up networking for the iSCSI traffic and bind the adapter and an appropriate VMkernel iSCSI port. You can then configure the adapter.

32

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

The entire setup and configuration process for the dependent hardware iSCSI adapters involves these steps: 1 View the dependent hardware adapters. See View Dependent Hardware iSCSI Adapters, on page 33. If your dependent hardware adapters do not appear on the list of storage adapters, check whether they need to be licensed. See your vendor documentation. 2 Determine the association between the dependent hardware adapters and physical NICs. See Determine Association Between Dependent Hardware iSCSI and Physical Network Adapters, on page 34 Make sure to note the names of the corresponding physical NICs. For example, the vmhba33 adapter corresponds to vmnic1 and vmhba34 corresponds to vmnic2. 3 Configure the iSCSI networking by creating ports for the iSCSI traffic. See Networking Configuration for Software iSCSI and Dependent Hardware iSCSI, on page 36. Open a port for each NIC. For example, create the vmk1 port for the vmnic1 NIC and the vmk2 port for vmnic2. 4 Bind the iSCSI ports to corresponding dependent hardware iSCSI adapters. This step is necessary no matter whether you have multiple adapters or just one. See Bind iSCSI Ports to iSCSI Adapters, on page 40. In this example, you bind port vmk1 to vmhba33 and port vmk2 to vmhba34. 5 Configure discovery addresses. See Configuring Discovery Addresses for iSCSI Initiators, on page 43. 6 Configure CHAP parameters. See Configuring CHAP Parameters for iSCSI Adapters, on page 44.

Dependent Hardware iSCSI Considerations

When you use dependent hardware iSCSI adapters with ESX/ESXi, certain considerations apply.
n

When you use any dependent hardware iSCSI adapter, performance reporting for a NIC associated with the adapter might show little or no activity, even when iSCSI traffic is heavy. This behavior occurs because the iSCSI traffic bypasses the regular networking stack. The Broadcom iSCSI adapter performs data reassembly in hardware, which has a limited buffer space. When you use the Broadcom iSCSI adapter in a congested network or under load, enable flow control to avoid performance degradation. Flow control manages the rate of data transmission between two nodes to prevent a fast sender from overrunning a slow receiver. For best results, enable flow control at the end points of the I/O path, at the hosts and iSCSI storage systems.

Broadcom iSCSI adapters do not support IPv6 and Jumbo Frames.

View Dependent Hardware iSCSI Adapters

View a dependent hardware iSCSI adapter to verify that it is correctly loaded. If the dependent hardware adapter does not appear on the list of storage adapters, check whether it needs to be licensed. See your vendor documentation.

VMware, Inc.

33

iSCSI SAN Configuration Guide

Procedure 1 2 Log in to the vSphere Client, and select a host from the Inventory panel. Click the Configuration tab and click Storage Adapters in the Hardware panel. If installed, the dependent hardware iSCSI adapter should appear on the list of storage adapters. 3 Select the adapter to view and click Properties. The iSCSI Initiator Properties dialog box displays the default details for the adapter, including the iSCSI name and iSCSI alias.

Determine Association Between Dependent Hardware iSCSI and Physical Network Adapters
You need to determine the name of the physical NIC with which the dependent hardware iSCSI adapter is associated. You need to know the association to be able to perform the port binding correctly. Procedure 1 Use the vSphere CLI command to determine the name of the physical NIC, with which the iSCSI adapter is associated.
esxcli swiscsi vmnic list -d vmhba#

vmhba# is the name of the iSCSI adapter. 2 In the output, find the vmnic name: vmnic# line. vmnic# is the name of the network adapter that corresponds to the iSCSI adapter. What to do next After you determined the name of the NIC, create an iSCSI port on a vSwitch connected to the NIC. You then bind this port to the dependent hardware iSCSI adapter, so that your host can direct the iSCSI traffic through the NIC.

Setting Up and Configuring Software iSCSI Adapter

With the software-based iSCSI implementation, you can use standard NICs to connect your host to a remote iSCSI target on the IP network. The software iSCSI adapter that is built into ESX/ESXi facilitates this connection by communicating with the physical NICs through the network stack. When you connect to a vCenter Server or a host with the vSphere Client, you can see the software iSCSI adapter on the list of your storage adapters. Only one software iSCSI adapter appears. Before you can use the software iSCSI adapter, you must set up networking, enable the adapter, and configure parameters such as discovery addresses and CHAP. The software iSCSI adapter configuration workflow includes these steps: 1 Configure the iSCSI networking by creating ports for iSCSI traffic. See Networking Configuration for Software iSCSI and Dependent Hardware iSCSI, on page 36. 2 Enable the software iSCSI adapter. See Enable the Software iSCSI Adapter, on page 35. 3 If you use multiple NICs for the software iSCSI multipathing, perform the port binding by connecting all iSCSI ports to the software iSCSI adapter. See Bind iSCSI Ports to iSCSI Adapters, on page 40. 4 If needed, enable Jumbo Frames. Jumbo Frames must be enabled for each vSwitch through the vSphere CLI.

34

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Configure discovery addresses. See Configuring Discovery Addresses for iSCSI Initiators, on page 43.

Configure CHAP parameters. See Configuring CHAP Parameters for iSCSI Adapters, on page 44.

Enable the Software iSCSI Adapter

You must enable your software iSCSI adapter so that your host can use it to access iSCSI storage. Prerequisites Before enabling the software iSCSI adapter, set up networking for iSCSI. NOTE If you boot from iSCSI using the software iSCSI adapter, the adapter is enabled and the network configuration is created automatically at the first boot. If you disable the adapter, it is re-enabled each time you boot the host. Procedure 1 2 Log in to the vSphere Client, and select a server from the inventory panel. Click the Configuration tab and click Storage Adapters in the Hardware panel. The list of available storage adapters appears. 3 4 5 Select the iSCSI initiator to configure and click Properties. Click Configure. To enable the initiator, select Enabled and click OK.

After you enable the initiator, the host assigns the default iSCSI name to it. You can change the default name if needed.

VMware, Inc.

35

iSCSI SAN Configuration Guide

Networking Configuration for Software iSCSI and Dependent Hardware iSCSI

If you use the software iSCSI adapter or dependent hardware iSCSI adapters, you must set up the networking for iSCSI before you can enable and configure your iSCSI adapters. Networking configuration for iSCSI involves opening a VMkernel iSCSI port for the traffic between the iSCSI adapter and the physical NIC. Depending on the number of physical NICs you use for iSCSI traffic, the networking setup can be different.
n

If you have a single physical NIC, create one iSCSI port on a vSwitch connected to the NIC. VMware recommends that you designate a separate network adapter for iSCSI. Do not use iSCSI on 100Mbps or slower adapters. If you have two or more physical NICs for iSCSI, create a separate iSCSI port for each physical NIC and use the NICs for iSCSI multipathing. See Figure 2-1. Figure 2-1. Networking with iSCSI
Two physical NICs connected to the software iSCSI adapter Two physical NICs with iSCSI offload capabilities

software iSCSI adapter vmhba# vmk1 vSwitch Host1 Host1 vmnic1 vmnic2 vmk2 iSCSI ports

dependent hardware iSCSI adapters vmhba33 vmk1 vSwitch Host2 vmnic1 vmnic2 virtual vmhba34 vmk2

Host2 physical

physical NICs

physical NICs with iSCSI offload capabilities IP network

iSCSI storage

iSCSI storage

NOTE When you use a dependent hardware iSCSI adapter, performance reporting for a NIC associated with the adapter might show little or no activity, even when iSCSI traffic is heavy. This behavior occurs because the iSCSI traffic bypasses the regular networking stack.
n

Create iSCSI Port for a Single NIC on page 37 Use this task to connect the VMkernel, which runs services for iSCSI storage, to a physical NIC. If you have just one physical network adapter to be used for iSCSI traffic, this is the only procedure you must perform to set up your iSCSI networking.

36

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Using Multiple NICs for Software and Dependent Hardware iSCSI on page 37 If your host has more than one physical NIC for iSCSI, for each physical NIC, create a separate iSCSI port using 1:1 mapping.

Create Additional iSCSI Ports for Multiple NICs on page 38 Use this task if you have two or more NICs you can designate for iSCSI and you want to connect all of your iSCSI NICs to a single vSwitch. In this task, you associate VMkernel iSCSI ports with the network adapters using 1:1 mapping.

Create iSCSI Port for a Single NIC

Use this task to connect the VMkernel, which runs services for iSCSI storage, to a physical NIC. If you have just one physical network adapter to be used for iSCSI traffic, this is the only procedure you must perform to set up your iSCSI networking. Procedure 1 2 3 4 5 6 Log in to the vSphere Client and select the host from the inventory panel. Click the Configuration tab and click Networking. In the Virtual Switch view, click Add Networking. Select VMkernel and click Next. Select Create a virtual switch to create a new vSwitch. Select a NIC you want to use for iSCSI traffic. IMPORTANT If you are creating a port for the dependent hardware iSCSI adapter, make sure to select the NIC that corresponds to the iSCSI component. See Determine Association Between Dependent Hardware iSCSI and Physical Network Adapters, on page 34. 7 8 Click Next. Enter a network label. Network label is a friendly name that identifies the VMkernel port that you are creating, for example, iSCSI. 9 10 11 Click Next. Specify the IP settings and click Next. Review the information and click Finish.

Using Multiple NICs for Software and Dependent Hardware iSCSI

If your host has more than one physical NIC for iSCSI, for each physical NIC, create a separate iSCSI port using 1:1 mapping. To achieve the 1:1 mapping, designate a separate vSwitch for each network adapter and iSCSI port pair. See Figure 2-2.

VMware, Inc.

37

iSCSI SAN Configuration Guide

Figure 2-2. iSCSI Ports and NICs on Separate vSwitches

An alternative is to add all NIC and iSCSI port pairs to a single vSwitch. See Figure 2-3. You must override the default setup and make sure that each port maps to only one corresponding active NIC. Figure 2-3. iSCSI Ports and NICs on a Single vSwitch

For information about adding the NIC and VMkernel port pairs to a vSwitch, see Create Additional iSCSI Ports for Multiple NICs, on page 38. After you map iSCSI ports to network adapters, use the esxcli command to bind the ports to the iSCSI adapters. With dependent hardware iSCSI adapters, perform port binding, whether you use one NIC or multiple NICs. For information, see Bind iSCSI Ports to iSCSI Adapters, on page 40.

Create Additional iSCSI Ports for Multiple NICs

Use this task if you have two or more NICs you can designate for iSCSI and you want to connect all of your iSCSI NICs to a single vSwitch. In this task, you associate VMkernel iSCSI ports with the network adapters using 1:1 mapping. You now need to connect additional NICs to the existing vSwitch and map them to corresponding iSCSI ports. NOTE If you use a vNetwork Distributed Switch with multiple dvUplinks, for port binding, create a separate dvPort group per each physical NIC. Then set the team policy so that each dvPort group has only one active dvUplink. For detailed information on vNetwork Distributed Switches, see the Networking section of the ESX/ESXi Configuration Guide. Prerequisites You must create a vSwitch that maps an iSCSI port to a physical NIC designated for iSCSI traffic. Procedure 1 2 Log in to the vSphere Client and select the host from the inventory panel. Click the Configuration tab and click Networking.

38

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

3 4

Select the vSwitch that you use for iSCSI and click Properties. Connect additional network adapters to the vSwitch. a b In the vSwitch Properties dialog box, click the Network Adapters tab and click Add. Select one or more NICs from the list and click Next. With dependent hardware iSCSI adapters, make sure to select only those NICs that have a corresponding iSCSI component. c Review the information on the Adapter Summary page, and click Finish. The list of network adapters reappears, showing the network adapters that the vSwitch now claims.

Create iSCSI ports for all NICs that you connected. The number of iSCSI ports must correspond to the number of NICs on the vSwitch. a b c d In the vSwitch Properties dialog box, click the Ports tab and click Add. Select VMkernel and click Next. Under Port Group Properties, enter a network label, for example iSCSI, and click Next. Specify the IP settings and click Next. When you enter subnet mask, make sure that the NIC is set to the subnet of the storage system it connects to. e Review the information and click Finish.

CAUTION If the NIC you use with your iSCSI adapter, either software or dependent hardware, is not in the same subnet as your iSCSI target, your host is not able to establish sessions from this network adapter to the target. 6 Map each iSCSI port to just one active NIC. By default, for each iSCSI port on the vSwitch, all network adapters appear as active. You must override this setup, so that each port maps to only one corresponding active NIC. For example, iSCSI port vmk1 maps to vmnic1, port vmk2 maps to vmnic2, and so on. a b c 7 On the Ports tab, select an iSCSI port and click Edit. Click the NIC Teaming tab and select Override vSwitch failover order. Designate only one adapter as active and move all remaining adapters to the Unused Adapters category.

Repeat the last step for each iSCSI port on the vSwitch.

What to do next After performing this task, use the esxcli command to bind the iSCSI ports to the software iSCSI or dependent hardware iSCSI adapters.

VMware, Inc.

39

iSCSI SAN Configuration Guide

Bind iSCSI Ports to iSCSI Adapters

Bind an iSCSI port that you created for a NIC to an iSCSI adapter. With the software iSCSI adapter, perform this task only if you set up two or more NICs for the iSCSI multipathing. If you use dependent hardware iSCSI adapters, the task is required regardless of whether you have multiple adapters or one adapter. Prerequisites Complete the following tasks:
n

For dependent hardware iSCSI adapters, have the correct association between the physical NICs and iSCSI adapters. See View Dependent Hardware iSCSI Adapters, on page 33. Set up networking for the iSCSI traffic. See Networking Configuration for Software iSCSI and Dependent Hardware iSCSI, on page 36. To use the software iSCSI adapter, enable it. See Enable the Software iSCSI Adapter, on page 35.

Procedure 1 Identify the name of the iSCSI port assigned to the physical NIC. The vSphere Client displays the port's name below the network label. In the following graphic, the ports' names are vmk1 and vmk2.

Use the vSphere CLI command to bind the iSCSI port to the iSCSI adapter.
esxcli swiscsi nic add -n port_name -d vmhba

IMPORTANT For software iSCSI, repeat this command for each iSCSI port connecting all ports with the software iSCSI adapter. With dependent hardware iSCSI, make sure to bind each port to an appropriate corresponding adapter. 3 Verify that the port was added to the iSCSI adapter.
esxcli swiscsi nic list -d vmhba

Use the vSphere Client to rescan the iSCSI adapter.

40

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Binding iSCSI Ports to iSCSI Adapters

Review examples about how to bind multiple ports that you created for physical NICs to the software iSCSI adapter or multiple dependent hardware iSCSI adapters.

Example: Connecting iSCSI Ports to the Software iSCSI Adapter

This example shows how to connect the iSCSI ports vmk1 and vmk2 to the software iSCSI adapter vmhba33. 1 2 3 Connect vmk1 to vmhba33: esxcli swiscsi nic add -n vmk1 -d vmhba33. Connect vmk2 to vmhba33: esxcli swiscsi nic add -n vmk2 -d vmhba33. Verify vmhba33 configuration: esxcli swiscsi nic list -d vmhba33. Both vmk1 and vmk2 should be listed. If you display the Paths view for the vmhba33 adapter through the vSphere Client, you see that the adapter uses two paths to access the same target. The runtime names of the paths are vmhba33:C1:T1:L0 and vmhba33:C2:T1:L0. C1 and C2 in this example indicate the two network adapters that are used for multipathing.

Example: Connecting iSCSI Ports to Dependent Hardware iSCSI Adapters

This example shows how to connect the iSCSI ports vmk1 and vmk2 to corresponding hardware iSCSI adapters vmhba33 and vmhba34. 1 2 3 4 Connect vmk1 to vmhba33: esxcli swiscsi nic add -n vmk1 -d vmhba33. Connect vmk2 to vmhba34: esxcli swiscsi nic add -n vmk2 -d vmhba34. Verify vmhba33 configuration: esxcli swiscsi nic list -d vmhba33. Verify vmhba34 configuration: esxcli swiscsi nic list -d vmhba34.

Disconnect iSCSI Ports from iSCSI Adapters

If you need to make changes in the networking configuration that you use for iSCSI traffic, for example, remove a NIC or an iSCSI port, make sure to disconnect the iSCSI port from the iSCSI adapter. IMPORTANT If active iSCSI sessions exist between your host and targets, you cannot disconnect the iSCSI port. Procedure 1 Use the vSphere CLI to disconnect the iSCSI port from the iSCSI adapter.
esxcli swiscsi nic remove -n port_name -d vmhba

Verify that the port was disconnected from the iSCSI adapter.
esxcli swiscsi nic list -d vmhba

Use the vSphere Client to rescan the iSCSI adapter.

Using Jumbo Frames with iSCSI

Jumbo Frames allow ESX/ESXi to send larger frames out onto the physical network. The network must support Jumbo Frames end-to-end for Jumbo Frames to be effective. Jumbo Frames up to 9kB (9000 Bytes) are supported. Table 2-1 explains the level of support ESX/ESXi provides to Jumbo Frames.

VMware, Inc.

41

iSCSI SAN Configuration Guide

Table 2-1. Support of Jumbo Frames

Type of iSCSI Adapters Software iSCSI Dependent Hardware iSCSI Independent Hardware iSCSI Jumbo Frames Support Supported Supported Not Supported Comment Check with your vendors to ensure your physical network adapter and iSCSI storage support Jumbo Frames. Broadcom dependent iSCSI adapters do not support Jumbo Frames.

Enabling Jumbo Frames for Software and Dependent Hardware iSCSI

Use the vSphere CLI to enable Jumbo Frames for each vSwitch designated for iSCSI traffic. Also, you must create a VMkernel network interface enabled with Jumbo Frames. 1 2 Enable Jumbo Frames on a vSwitch on page 42 To enable Jumbo Frames on a vSwitch, change the MTU configuration for that vSwitch. Create a Jumbo Frames-Enabled VMkernel Interface on page 42 Use the vSphere CLI to create a VMkernel network interface that is enabled with Jumbo Frames.

Enable Jumbo Frames on a vSwitch

To enable Jumbo Frames on a vSwitch, change the MTU configuration for that vSwitch. Procedure 1 On the vSphere CLI, run the vicfg-vswitch -m MTU vSwitch command. This command sets the MTU for all physical NICs on that vSwitch. The MTU size should be set to the largest MTU size among all NICs connected to the vSwitch. 2 Run the vicfg-vswitch -l command to display a list of vSwitches on the host, and check that the configuration of the vSwitch is correct.

Create a Jumbo Frames-Enabled VMkernel Interface

Use the vSphere CLI to create a VMkernel network interface that is enabled with Jumbo Frames. Procedure 1 On the vSphere CLI, run the vicfg-vmknic command to create a VMkernel connection with Jumbo Frame support.
vicfg-vmknic -a -I ip address -n netmask -m MTU port group name

2 3 4

Run the vicfg-vmknic -l command to display a list of VMkernel interfaces and check that the configuration of the Jumbo Frame-enabled interface is correct. Check that the VMkernel interface is connected to a vSwitch with Jumbo Frames enabled. Configure all physical switches and any physical or virtual machines to which this VMkernel interface connects to support Jumbo Frames.

42

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Configuring Discovery Addresses for iSCSI Initiators

Set up target discovery addresses so that the iSCSI initiator can determine which storage resource on the network is available for access. The ESX/ESXi system supports these discovery methods: Dynamic Discovery Also known as SendTargets discovery. Each time the initiator contacts a specified iSCSI server, the initiator sends the SendTargets request to the server. The server responds by supplying a list of available targets to the initiator. The names and IP addresses of these targets appear on the Static Discovery tab. If you remove a static target added by dynamic discovery, the target might be returned to the list the next time a rescan happens, the HBA is reset, or the host is rebooted. The initiator does not have to perform any discovery. The initiator has a list of targets it can contact and uses their IP addresses and target names to communicate with them.

Static Discovery

Set Up Dynamic Discovery

With Dynamic Discovery, each time the initiator contacts a specified iSCSI server, it sends the SendTargets request to the server. The server responds by supplying a list of available targets to the initiator. When you set up Dynamic Discovery, you can only add a new iSCSI server. You cannot change the IP address, DNS name, or port number of an existing iSCSI server. To make changes, delete the existing server and add a new one. Procedure 1 2 Log in to the vSphere Client and select a server from the inventory panel. Click the Configuration tab and click Storage Adapters in the Hardware panel. The list of available storage adapters appears. 3 4 5 Select the iSCSI initiator to configure and click Properties. In the iSCSI Initiator Properties dialog box, click the Dynamic Discovery tab. To add an address for the SendTargets discovery, click Add. The Add SendTargets Server dialog box appears. 6 Enter the IP address or DNS name of the storage system and click OK. After your host establishes the SendTargets session with this system, any newly discovered targets appear in the Static Discovery list. 7 To delete a specific SendTargets server, select it and click Remove. After you remove a SendTargets server, it might still appear in the Inheritance field as the parent of static targets. This entry indicates where the static targets were discovered and does not affect the functionality. What to do next After configuring Dynamic Discovery for your iSCSI adapter, rescan the adapter.

VMware, Inc.

43

iSCSI SAN Configuration Guide

Set Up Static Discovery

With iSCSI initiators, in addition to the dynamic discovery method, you can use static discovery and manually enter information for the targets. When you set up Static Discovery, you can only add iSCSI targets. You cannot change the IP address, DNS name, iSCSI target name, or port number of an existing target. To make changes, remove the existing target and add a new one. Procedure 1 2 Log in to the vSphere Client and select a server from the inventory panel. Click the Configuration tab and click Storage Adapters in the Hardware panel. The list of available storage adapters appears. 3 4 Select the iSCSI initiator to configure and click Properties. In the iSCSI Initiator Properties dialog box, click the Static Discovery tab. The tab displays all dynamically discovered targets and any static targets already entered. 5 6 To add a target, click Add and enter the targets information. To delete a specific target, select the target and click Remove.

What to do next After configuring Static Discovery for your iSCSI adapter, rescan the adapter.

Configuring CHAP Parameters for iSCSI Adapters

Because the IP networks that the iSCSI technology uses to connect to remote targets do not protect the data they transport, you must ensure security of the connection. One of the protocols that iSCSI implements is the Challenge Handshake Authentication Protocol (CHAP), which verifies the legitimacy of initiators that access targets on the network. CHAP uses a three-way handshake algorithm to verify the identity of your host and, if applicable, of the iSCSI target when the host and target establish a connection. The verification is based on a predefined private value, or CHAP secret, that the initiator and target share. ESX/ESXi supports CHAP authentication at the adapter level. In this case, all targets receive the same CHAP name and secret from the iSCSI initiator. For software and dependent hardware iSCSI adapters, ESX/ESXi also supports per-target CHAP authentication, which allows you to configure different credentials for each target to achieve greater level of security.

Choosing CHAP Authentication Method

ESX/ESXi supports one-way CHAP for all types of iSCSI initiators, and mutual CHAP for software and dependent hardware iSCSI. Before configuring CHAP, check whether CHAP is enabled at the iSCSI storage system and check the CHAP authentication method the system supports. If CHAP is enabled, enable it for your initiators, making sure that the CHAP authentication credentials match the credentials on the iSCSI storage.

44

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

ESX/ESXi supports the following CHAP authentication methods: One-way CHAP In one-way CHAP authentication, also called unidirectional, the target authenticates the initiator, but the initiator does not authenticate the target. In mutual CHAP authentication, also called bidirectional, an additional level of security enables the initiator to authenticate the target. VMware supports this method for software and dependent hardware iSCSI adapters only.

Mutual CHAP

For software and dependent hardware iSCSI adapters, you can set one-way CHAP and mutual CHAP for each initiator or at the target level. Hardware iSCSI supports CHAP only at the initiator level. When you set the CHAP parameters, specify a security level for CHAP. NOTE When you specify the CHAP security level, how the storage array responds depends on the arrays CHAP implementation and is vendor specific. For example, when you select Use CHAP unless prohibited by target, some storage arrays use CHAP in response, while others do not. For information on CHAP authentication behavior in different initiator and target configurations, consult the array documentation. Table 2-2. CHAP Security Level
CHAP Security Level Do not use CHAP Description The host does not use CHAP authentication. Select this option to disable authentication if it is currently enabled. Supported Software iSCSI Dependent hardware iSCSI Independent hardware iSCSI Software iSCSI Dependent hardware iSCSI Software iSCSI Dependent hardware iSCSI Independent hardware iSCSI Software iSCSI Dependent hardware iSCSI

Do not use CHAP unless required by target Use CHAP unless prohibited by target

The host prefers a non-CHAP connection, but can use a CHAP connection if required by the target. The host prefers CHAP, but can use non-CHAP connections if the target does not support CHAP.

Use CHAP

The host requires successful CHAP authentication. The connection fails if CHAP negotiation fails.

Set Up CHAP Credentials for an iSCSI Initiator

You can set up all targets to receive the same CHAP name and secret from the iSCSI initiator at the initiator level. By default, all discovery addresses or static targets inherit CHAP parameters that you set up at the initiator level. Prerequisites Before setting up CHAP parameters for software or dependent hardware iSCSI, determine whether to configure one-way or mutual CHAP. Independent hardware iSCSI adapters do not support mutual CHAP.
n n

In one-way CHAP, the target authenticates the initiator. In mutual CHAP, both the target and initiator authenticate each other. Make sure to use different secrets for CHAP and mutual CHAP.

When configuring CHAP parameters, make sure that they match the parameters on the storage side. The CHAP name should not exceed 511 and the CHAP secret 255 alphanumeric characters. Some adapters, for example the QLogic adapter, might have lower limits, 255 for the CHAP name and 100 for the CHAP secret.

VMware, Inc.

45

iSCSI SAN Configuration Guide

Procedure 1 2 3 Access the iSCSI Initiator Properties dialog box. On the General tab, click CHAP. To configure one-way CHAP, under CHAP specify the following: a Select the CHAP security level.
n n n

Do not use CHAP unless required by target (software and dependent hardware iSCSI only) Use CHAP unless prohibited by target Use CHAP (software and dependent hardware iSCSI only). To be able to configure mutual CHAP, you must select this option.

Specify the CHAP name. Make sure that the name you specify matches the name configured on the storage side.
n n

To set the CHAP name to the iSCSI initiator name, select Use initiator name. To set the CHAP name to anything other than the iSCSI initiator name, deselect Use initiator name and enter a name in the Name field.

c 4

Enter a one-way CHAP secret to be used as part of authentication. Make sure to use the same secret that you enter on the storage side.

To configure mutual CHAP, first configure one-way CHAP by following directions in Step 3. Make sure to select Use CHAP as an option for one-way CHAP. Then, specify the following under Mutual CHAP: a b c Select Use CHAP. Specify the mutual CHAP name. Enter the mutual CHAP secret. Make sure to use different secrets for the one-way CHAP and mutual CHAP.

5 6

Click OK. Rescan the initiator.

If you change the CHAP or mutual CHAP parameters, they are used for new iSCSI sessions. For existing sessions, new settings are not used until you log out and login again.

Set Up CHAP Credentials for a Target

For software dependent hardware iSCSI adapters, you can configure different CHAP credentials for each discovery address or static target. When configuring CHAP parameters, make sure that they match the parameters on the storage side. The CHAP name should not exceed 511 and the CHAP secret 255 alphanumeric characters. Prerequisites Before setting up CHAP parameters for software and dependent hardware iSCSI, determine whether to configure one-way or mutual CHAP.
n n

In one-way CHAP, the target authenticates the initiator. In mutual CHAP, both the target and initiator authenticate each other. Make sure to use different secrets for CHAP and mutual CHAP.

46

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Procedure 1 2 3 4 Access the iSCSI Initiator Properties dialog box. Select either Dynamic Discovery tab or Static Discovery tab. From the list of available targets, select a target you want to configure and click Settings > CHAP. Configure one-way CHAP in the CHAP area. a b Deselect Inherit from parent. Select one of the following options:
n n n

Do not use CHAP unless required by target Use CHAP unless prohibited by target Use CHAP. To be able to configure mutual CHAP, you must select this option.

Specify the CHAP name. Make sure that the name you specify matches the name configured on the storage side.
n n

To set the CHAP name to the iSCSI initiator name, select Use initiator name. To set the CHAP name to anything other than the iSCSI initiator name, deselect Use initiator name and enter a name in the Name field.

d 5

Enter a one-way CHAP secret to be used as part of authentication. Make sure to use the same secret that you enter on the storage side.

To configure mutual CHAP, first configure one-way CHAP by following directions in Step 4. Make sure to select Use CHAP as an option for one-way CHAP. Then, specify the following in the Mutual CHAP area: a b c d Deselect Inherit from parent. Select Use CHAP. Specify the mutual CHAP name. Enter the mutual CHAP secret. Make sure to use different secrets for the one-way CHAP and mutual CHAP.

6 7

Click OK. Rescan the initiator.

If you change the CHAP or mutual CHAP parameters, they are used for new iSCSI sessions. For existing sessions, new settings are not used until you log out and login again.

Disable CHAP
You can disable CHAP if your storage system does not require it. If you disable CHAP on a system that requires CHAP authentication, existing iSCSI sessions remain active until you reboot your ESX/ESXi host or the storage system forces a logout. After the session ends, you can no longer connect to targets that require CHAP. Procedure 1 2 Open the CHAP Credentials dialog box. For software and dependent hardware iSCSI adapters, to disable just the mutual CHAP and leave the oneway CHAP, select Do not use CHAP in the Mutual CHAP area.

VMware, Inc.

47

iSCSI SAN Configuration Guide

To disable one-way CHAP, select Do not use CHAP in the CHAP area. The mutual CHAP, if set up, automatically turns to Do not use CHAP when you disable the one-way CHAP.

Click OK.

Configuring Additional Parameters for iSCSI

You might need to configure additional parameters for your iSCSI initiators. For example, some iSCSI storage systems require ARP (Address Resolution Protocol) redirection to move iSCSI traffic dynamically from one port to another. In this case, you must activate ARP redirection on your host. Table 2-3 lists advanced iSCSI parameters that you can configure using the vSphere Client. In addition, you can use the vicfg-iscsi vSphere CLI command to configure some of the advanced parameters. For information, see the vSphere Command-Line Interface Installation and Scripting Guide and vSphere Command-Line Interface Reference. Do not make any changes to the advanced iSCSI settings unless you are working with the VMware support team or otherwise have thorough information about the values to provide for the settings. Table 2-3. Additional Parameters for iSCSI Initiators
Advanced Parameter Header Digest Description Increases data integrity. When header digest is enabled, the system performs a checksum over each iSCSI Protocol Data Units (PDUs) header part and verifies using the CRC32C algorithm. Increases data integrity. When data digest is enabled, the system performs a checksum over each PDU's data part and verifies using the CRC32C algorithm. NOTE Systems that use Intel Nehalem processors offload the iSCSI digest calculations for software iSCSI, thus reducing the impact on performance. Defines the R2T (Ready to Transfer) PDUs that can be in transition before an acknowledge PDU is received. Specifies the maximum amount of unsolicited data an iSCSI initiator can send to the target during the execution of a single SCSI command, in bytes. Maximum SCSI data payload in a Data-In or a solicited Data-Out iSCSI sequence, in bytes. Maximum data segment length, in bytes, that can be received in an iSCSI PDU. Specifies the amount of time, in seconds, that can lapse while a session recovery is performed. If the timeout exceeds its limit, the iSCSI initiator terminates the session. Specifies the time interval, in seconds, between NOP-Out requests sent from your iSCSI initiator to an iSCSI target. The NOP-Out requests serve as the ping mechanism to verify that a connection between the iSCSI initiator and the iSCSI target is active. Specifies the amount of time, in seconds, that can lapse before your host receives a NOP-In message. The message is sent by the iSCSI target in response to the NOP-Out request. When the no-op timeout limit is exceeded, the initiator terminates the current session and starts a new one. Configurable On Software iSCSI Dependent Hardware iSCSI Software iSCSI Dependent Hardware iSCSI

Data Digest

Maximum Outstanding R2T First Burst Length

Software iSCSI Dependent Hardware iSCSI Software iSCSI Dependent Hardware iSCSI Software iSCSI Dependent Hardware iSCSI Software iSCSI Independent Hardware iSCSI Software iSCSI Dependent Hardware iSCSI Software iSCSI Dependent Hardware iSCSI Software iSCSI Dependent Hardware iSCSI

Maximum Burst Length Maximum Receive Data Segment Length Session Recovery Timeout No-Op Interval

No-Op Timeout

48

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Table 2-3. Additional Parameters for iSCSI Initiators (Continued)

Advanced Parameter ARP Redirect Description Allows storage systems to move iSCSI traffic dynamically from one port to another. ARP is required by storage systems that do arraybased failover. Configurable On Software and Independent Hardware iSCSI (Configurable through vSphere CLI) Software iSCSI Dependent Hardware iSCSI

Delayed ACK

Allows systems to delay acknowledgment of received data packets.

Configure Advanced Parameters for iSCSI

The advanced iSCSI settings control such parameters as header and data digest, ARP redirection, delayed ACK, and so on. Generally, you do not need to change these settings because your ESX/ESXi host works with the assigned predefined values. CAUTION Do not make any changes to the advanced iSCSI settings unless you are working with the VMware support team or otherwise have thorough information about the values to provide for the settings. Procedure 1 2 3 Access the iSCSI Initiator Properties dialog box. To configure advanced parameters at the initiator level, on the General tab, click Advanced. Proceed to Step 4. Configure advanced parameters at the target level. At the target level, advanced parameters can be configured only for software and dependent hardware iSCSI adapters. a b 4 Select either the Dynamic Discovery tab or Static Discovery tab. From the list of available targets, select a target to configure and click Settings > Advanced.

Enter any required values for the advanced parameters you want to modify and click OK to save your changes.

iSCSI Session Management

To communicate with each other, iSCSI initiators and targets establish iSCSI sessions. You can review and manage iSCSI sessions using vSphere CLI. By default, software iSCSI and dependent hardware iSCSI initiators start one iSCSI session between each initiator port and each target port. If your iSCSI initiator or target have more than one port, your host can have multiple sessions established. The default number of sessions for each target equals the number of ports on the iSCSI adapter times the number of target ports. You can display all current sessions to analyze and debug them. To create more paths to storage systems, you can increase the default number of sessions by duplicating existing sessions between the iSCSI adapter and target ports.

VMware, Inc.

49

iSCSI SAN Configuration Guide

You can also establish a session to a specific target port. This can be useful if your host connects to a singleport storage system that, by default, presents only one target port to your initiator, but can redirect additional sessions to a different target port. Establishing a new session between your iSCSI initiator and another target port creates an additional path to the storage system. CAUTION Some storage systems do not support multiple sessions from the same initiator name or endpoint. Attempts to create multiple sessions to such targets can result in unpredictable behavior of your iSCSI environment.

Review iSCSI Sessions

Use the vSphere CLI to display iSCSI sessions between an iSCSI adapter and a storage system. Procedure 1 To list sessions for an adapter, use esxcli swiscsi session list -d vmhbaXX. vmhbaXX is the name of your iSCSI adapter. 2 To list sessions for a target, use esxcli swiscsi session list -t iqnXX -d vmhbaXX. iqnXX is the name of the target the iSCSI adapter connects to.

Example: Reviewing Sessions for a Specified Target

# esxcli swiscsi session list -t iqn.2001-05.com.equallogic:0-8a0906-cbcde0d02-6a445baadf44ab92vcli7 -d vmhba36

Add an iSCSI Session for a Specified Target

Use the vSphere CLI to add an iSCSI session for a target you specify. Procedure 1 To add a session at the iSCSI adapter level, use esxcli swiscsi session add -d vmhbaXX. vmhbaXX is the name of your iSCSI adapter. 2 To add a session at the target level, use esxcli swiscsi session add -t iqnXX -d vmhbaXX. iqnXX is the name of the target the iSCSI adapter connects to.

Example: Adding an iSCSI Session for a Specified Target

# esxcli swiscsi session add -t iqn.2001-05.com.equallogic:0-8a0906-42f9b0401-7d40d28af2a4ade1vcli7 -d vmhba36

What to do next Rescan the iSCSI adapter.

50

VMware, Inc.

Chapter 2 Configuring iSCSI Initiators and Storage

Duplicate iSCSI Sessions

Use the vSphere CLI to duplicate an iSCSI session between an iSCSI adapter and a target. By duplicating sessions, you increase the default number of sessions and create additional paths to storage systems. Procedure
u

To duplicate a session, use esxcli swiscsi session add -d vmhbaXX -t iqnXX -s session_isid.
n n n

d -- The name of your iSCSI adapter, such as vmhbaXX. t -- The name of the target to log in, such as iqnXX. s -- The ISID of a session to duplicate, such as session_isid. You can find it by listing all session.

Example: Duplicating iSCSI Session

# esxcli swiscsi session add -t iqn.2001-05.com.equallogic:0-8a0906-cbcde0d02-6a445baadf44ab92vcli7 -s '00:02:3d:00:00:01' -d vmhba36

What to do next Rescan the iSCSI adapter.

Remove iSCSI Sessions

Use the vSphere CLI to remove an iSCSI session between an iSCSI adapter and a target. Procedure
u

To remove a session, use esxcli swiscsi session remove. The command takes these options.
n n n

d -- The name of your iSCSI adapter, such as vmhbaXX. t -- The name of the target to log in, such as iqnXX. s -- The ISID of a session to duplicate, such as session_isid. You can find it by listing all session.

Example: Removing an iSCSI Session

# esxcli swiscsi session remove -t iqn.2001-05.com.equallogic:0-8a0906-cbcde0d02-6a445baadf44ab92vcli7 -s '00:02:3d:01:00:01'

What to do next Rescan the iSCSI adapter.

Add iSCSI Storage

When you create a datastore on an iSCSI storage device, the Add Storage wizard guides you through the configuration. Procedure 1 2 3 4 Log in to the vSphere Client and select a server from the inventory panel. Click the Configuration tab and click Storage. Click Add Storage. Select the Disk/LUN storage type and click Next. The Select Disk/LUN page appears. This can take a few seconds depending on the number of targets.

VMware, Inc.

51

iSCSI SAN Configuration Guide

5 6 7

Select the iSCSI device to use for your datastore and click Next. Review the current disk layout and click Next. Enter a datastore name and click Next. The datastore name appears in the vSphere Client, and the label must be unique within the current VMware vSphere instance.

If needed, adjust the file system values and capacity you use for the datastore. By default, the entire free space available on the storage device is offered to you.

Click Next. The Ready to Complete page appears.

10

Review the datastore configuration information and click Finish.

A datastore is now available on the iSCSI storage device.

52

VMware, Inc.

Modifying SAN Storage Systems for ESX/ESXi

After you configure your iSCSI initiators and storage, you might need to modify your storage system to ensure that it works properly with your ESX/ESXi implementation. This section discusses many of the iSCSI storage systems supported in conjunction with VMware ESX/ESXi. For each device, it lists major known potential issues, points to vendor-specific information (if available), or includes information from VMware knowledge base articles. NOTE Information in this section is updated only with each release. New information might already be available. Also, other iSCSI storage systems are supported but are not covered in this chapter. Consult the most recent Storage/SAN Compatibility Guide, check with your storage vendor, and explore the VMware knowledge base articles. This chapter includes the following topics:
n n n n n n n n n n n

Testing ESX/ESXi SAN Configurations, on page 53 General Considerations for iSCSI SAN Storage Systems, on page 54 EMC CLARiiON Storage Systems, on page 54 EMC Symmetrix Storage Systems, on page 55 Enable HP StorageWorks MSA1510i to Communicate with ESX/ESXi, on page 55 HP StorageWorks EVA Storage Systems, on page 56 NetApp Storage Systems, on page 57 EqualLogic Storage Systems, on page 59 LeftHand Networks SAN/iQ Storage Systems, on page 59 Dell PowerVault MD3000i Storage Systems, on page 59 iSCSI Targets in vApps, on page 59

Testing ESX/ESXi SAN Configurations

ESX/ESXi supports a variety of SAN storage systems in different configurations. Generally, VMware tests ESX/ESXi with supported storage systems for basic connectivity, HBA failover, and so on. Not all storage devices are certified for all features and capabilities of ESX/ESXi, and vendors might have specific positions of support with regard to ESX/ESXi.

VMware, Inc.

53

iSCSI SAN Configuration Guide

VMware tests ESX/ESXi with storage systems in the following configurations: Basic Connectivity iSCSI Failover Storage Port Failover Booting from a SAN (with ESX hosts only) Tests whether ESX/ESXi can recognize and operate with the storage system. This configuration does not allow for multipathing or any type of failover. The server is equipped with multiple iSCSI HBAs or NICs. The server is robust to HBA or NIC failure. The server is attached to multiple storage ports and is robust to storage port failures and switch failures. The ESX host boots from a LUN configured on the SAN rather than from the server itself.

General Considerations for iSCSI SAN Storage Systems

When you prepare your iSCSI SAN storage system to work with ESX/ESXi, you need to follow specific general requirements that apply to all storage systems. For all storage systems, the following general requirements exist:
n

LUNs must be presented to each HBA of each host with the same LUN ID number. If different numbers are used, the ESX/ESXi hosts do not recognize different paths to the same LUN. Because instructions on how to configure identical SAN LUN IDs are vendor-specific, consult your storage documentation for more information. Unless specified for individual storage systems discussed in this chapter, set the host type for LUNs presented to ESX/ESXi to Linux or Linux Cluster, if applicable to your storage system. The method ESX/ESXi uses to access the storage system is most compatible with Linux access, however, this can vary depending on the storage system you are using. If you are using vMotion, DRS, or HA, make sure that source and target hosts for virtual machines can see the same LUNs with identical LUN IDs. SAN administrators might find it counterintuitive to have multiple hosts see the same LUNs because they might be concerned about data corruption. However, VMFS prevents multiple virtual machines from writing to the same file at the same time, so provisioning the LUNs to all required ESX/ESXi system is appropriate. If you do not have CHAP authentication set up on the LUNs that are being accessed, you must also disable CHAP on the ESX/ESXi host. Otherwise, authentication of the storage system fails, although the LUNs have no CHAP requirement.

EMC CLARiiON Storage Systems

EMC CLARiiON storage systems work with ESX/ESXi hosts in iSCSI SAN configurations. Generally, you use the EMC software to perform configurations. For more information, see the EMC documentation. This is an active-passive disk array, so any related issues that apply to all active-passive disk arrays are relevant. In addition, keep in mind the following:
n

To avoid the possibility of path thrashing, the default multipathing policy is Most Recently Used, not Fixed. The ESX/ESXi system sets the default policy when it identifies the storage system. To boot from a SAN, choose the active storage processor for the boot LUNs target in the HBA BIOS. On EMC CLARiiON AX100i and AX150i systems, RDMs are supported only if you use the Navisphere Management Suite for SAN administration. Navisphere Express is not guaranteed to configure them properly. To use RDMs successfully, a given LUN must be presented with the same LUN ID to every ESX/ESXi host in the cluster. The AX100i and AX150i do not do this by default.

n n

54

VMware, Inc.

Chapter 3 Modifying SAN Storage Systems for ESX/ESXi

When you use an AX100i or AX150i storage system, no host agent periodically checks the host configuration and pushes changes to the storage system. The axnaviserverutil cli utility is used to update the changes. This is a manual operation that you should perform as needed. Port binding support on EMC CLARiiON storage systems requires initiators in different subnets. See vendor documentation for additional details. For ESX/ESXi to support EMC CLARiiON with ALUA, check the HCLs to make sure that you use the correct firmware version on the storage array. For additional information, contact your storage vendor.

EMC Symmetrix Storage Systems

To work with ESX/ESXi, EMC Symmetrix storage systems require certain specific settings. Use EMC software to configure the storage system. For information, see your EMC documentation. The following settings are required for ESX/ESXi operations on the Symmetrix networked storage system:
n n n n n

Common serial number (C) Auto negotiation (EAN) enabled SCSI 3 (SC3) set (enabled) Unique world wide name (UWN) SPC-2 (Decal) (SPC2) SPC-2 flag is required

NOTE The ESX/ESXi host considers any LUNs from a Symmetrix storage system that have a capacity of 50MB or less as management LUNs. These LUNs are also known as pseudo or gatekeeper LUNs. These LUNs appear in the EMC Symmetrix Management Interface and should not be used to hold data.

Enable HP StorageWorks MSA1510i to Communicate with ESX/ESXi

This section describes the setup and configuration steps needed to allow an HP StorageWorks MSA1510i storage system to communicate with ESX/ESXi hosts. Procedure 1 2 Install, connect, and power up the network devices as detailed in the vendor installation document. Obtain the IP address assigned to the MSA1510i controller management port. a b 3 4 Scroll through the messages on the LCD panel until the following message appears: 603 Port MA0 IP
address

Record the management port IP address that appears in Basic MSA1510i information.

From the server or a workstation on the MSA1510i LAN segment, open a Web browser and enter the address obtained in Step 2. When prompted, enter the default access permissions.
n n

User name: root Password: root

When prompted, set a unique user name and password.

VMware, Inc.

55

iSCSI SAN Configuration Guide

Using the wizard, complete the following actions.

Option Storage configuration iSCSI configuration (configure an iSCSI portal) Description a b a b c Set the Fault Tolerant mode (RAID mode). Assign a spare disk for appropriate RAID level.

Select a data port. Assign an IP address to the data port. VLANs are set up on the switch and are used as one method of controlling access to the storage. If you are using VLANs, enter the VLAN ID to use (0 = not used). d The wizard suggests a default iSCSI Target Name and iSCSI Target Alias. Accept the default or enter user-defined values. NOTE To configure the remaining data ports, complete the Initial System Configuration Wizard process, and then use tasks available on the Configuretab. Enter login settings. Enter management settings.

Login settings Management settings

Click Finish to apply the configuration settings.

NOTE Wizards are available for basic configuration tasks only. Use the Manage and Configure tabs to view and change your configuration. What to do next After initial setup, perform the following tasks to complete the configuration:
n n n n n n n n

Create an array. Create a logical drive. Create a target. Create a portal group. Associate or assign the portals created using the wizard with the portal group created. Map logical drives to the target. Add initiators (initiator IQN name and alias). Update the ACLs of the logical drives to provide access to initiators (select the list of initiators to access the logical drive).

HP StorageWorks EVA Storage Systems

The two types of HP StorageWorks EVA systems are EVA_GL, an active-passive system, and EVA_XL, an active-active system. For the systems to work with ESX/ESXi, certain specific settings are required. Set the connection type to Custom when you present a LUN to an ESX/ESXi host. The value is one of the following:
n n

For HP EVAgl 3000/5000 (active-passive), use the 000000002200282E host mode type. For HP EVAgl firmware 4.001 (active-active firmware for GL series) and above, use the VMware host mode type. For EVA4000/6000/8000 active-active arrays with firmware earlier than 5.031, use the 000000202200083E host mode type. For EVA4000/6000/8000 active-active arrays with firmware 5.031 and later, use the VMware host mode type.

Otherwise, EVA systems do not require special configuration changes to work with an ESX/ESXi system.

56

VMware, Inc.

Chapter 3 Modifying SAN Storage Systems for ESX/ESXi

NetApp Storage Systems

For NetApp storage systems to communicate within an ESX/ESXi environment, you must perform specific configuration steps. For additional documentation on NetApp and VMware best practices and SAN solutions, search the NetApp web page. Table 3-1. Configuration Steps
Configuration Step Disable ALUA. Set up multipathing. Description If any of your iSCSI initiators are a part of an initiator group (igroup), disable ALUA on the NetApp filter. When you set up multipathing between two iSCSI HBAs and multiple ports on a NetApp storage system, give the two HBAs different dynamic or static discovery addresses to connect to the storage. The NetApp storage system only permits one connection for each target and each initiator. Attempts to make additional connections cause the first connection to drop. Therefore, a single HBA should not attempt to connect to multiple IP addresses associated with the same NetApp target. Set LUN type and initiator group type. Provision storage. Set the appropriate LUN type and initiator group type for the storage system: n LUN type VMware (if VMware type is not available, use Linux). n Initiator group type VMware (if VMware type is not available, use Linux). Use either FilerView or CLI.

Provision Storage by Using FilerView Storage Management

You can use FilerView to provision storage on a NetApp storage system. Procedure 1 2 Log in to NetApp storage system management (FilerView). Create a volume. a b c d e f 3 Select Volumes and click Add. Click Next. Select Flexibility (Default) or Traditional, then click Next. Enter a Volume Name, select a Language, and click Next. Enter values for Containing Aggregate, Total Volume Size, and Space Guarantee and click Next. Click Commit to create the volume.

Create LUNs. a b Select LUNs and click Add. Enter the following:
n n n n

Path: Enter a path, for example, /vol/vol1/lun1. LUN Protocol Type: VMware. Description: A brief description. Size and Unit: Enter a size, for example, 10GB and select Space Reserved.

VMware, Inc.

57

iSCSI SAN Configuration Guide

Create an initiator group. a b Select LUNs > Initiator Group and click Add. Enter the following:
n n n n

Group Name: Enter a group name Type: Choose iSCSI. Operating System: Enter VMware. Initiators: Enter fully qualified initiator names. If there is more than one initiator, each initiator has to be separated with a return carriage.

c 5

Click Add.

Map the LUN to the initiator group. a Select LUNs and click Manage. A LUNs list appears. b c d e From this list, click the label on the Maps row for the specific LUNs. Click Add Groups to Map. Select the initiator group and click Add. When prompted, enter the LUN ID (any number from 0 to 255) and click Apply.

Provision Storage by Using Command-Line Interface

You can use command-line interface to provision storage on a NetApp storage system. Procedure 1 Use command-line interface to create an aggregate if required.
aggr create vmware-aggrnumber of disks

Create a flexible volume.

vol create aggregate namevolume size

Create a Qtree to store each LUN.

qtree create path

Create a LUN.
lun create -s size -t vmware path

Create an initiator group.

igroup create -f -t vmware igroup name

Map the LUN to the initiator group you created.

lun map (path) igroup nameLUN ID

58

VMware, Inc.

Chapter 3 Modifying SAN Storage Systems for ESX/ESXi

EqualLogic Storage Systems

When setting up your EqualLogic storage systems to work in an ESX/ESXi implementation, you must address certain specific issues. The following are specific requirements for EqualLogic storage systems to work with ESX/ESXi:
n

Multipathing. No special setup is needed because EqualLogic storage systems support storage-processor failover that is transparent to iSCSI. Multiple iSCSI HBAs or NICs can connect to the same target or LUN on the storage side. Creating iSCSI LUNs. From the EqualLogic web portal, right-click Volumes, and then select Create Volume. Enable ARP redirection for ESX/ESXi hardware iSCSI HBAs. EqualLogic storage systems impose a maximum limit of 512 iSCSI connections per storage pool and 2048 connections per storage group.

n n

For more information about configuring and using EqualLogic storage systems, see the vendors documentation.

LeftHand Networks SAN/iQ Storage Systems

SAN/iQ SANs support ESX/ESXi iSCSI connections from a software initiator and hardware initiator. When configuring SAN/iQ, enable automatic volume resignaturing for SAN/iQ storage devices to allow access to SAN/iQ snapshots and remote copies. For more information on configuring LeftHand Networks SANs for VMware vSphere, see the vendor documentation related to VMware. Basic configuration steps include several tasks. 1 2 3 4 5 Install SAN/iQ storage nodes. Create SAN/iQ management groups and clusters. Create volumes. Assign volumes to authentication groups and volume lists. Enable ARP redirection on hardware iSCSI HBAs.

As a best practice, configure virtual IP load balancing in SAN/iQ for all ESX/ESXi authentication groups.

Dell PowerVault MD3000i Storage Systems

When you configure mutual CHAP for the MD3000i iSCSI storage systems, special considerations that apply. When you configure mutual CHAP for the MD3000i iSCSI array, follow these guidelines:
n n

On the MD3000i storage system, mutual CHAP configuration requires only a CHAP secret. On the ESX/ESXi host, mutual CHAP configuration requires both the name and CHAP secret. When configuring mutual CHAP on the ESX/ESXi host, enter the IQN name of the target as the mutual CHAP name. Make sure the CHAP secret matches the one set on the array.

iSCSI Targets in vApps

If you use an iSCSI target in a virtual appliance, for example HP LeftHand P4000 VSA, the host should connect to the target through the software iSCSI adapter rather than a hardware iSCSI adapter.

VMware, Inc.

59

iSCSI SAN Configuration Guide

60

VMware, Inc.

Booting from iSCSI SAN

4
Software iSCSI and Dependent Hardware iSCSI Not supported. Supported. The network adapter must support the iBFT.

When you set up your host to boot from a SAN, your host's boot image is stored on one or more LUNs in the SAN storage system. When the host starts, it boots from the LUN on the SAN rather than from its local disk. You can use boot from the SAN if you do not want to handle maintenance of local storage or have diskless hardware configurations, such as blade systems. ESX and ESXi hosts support different methods of booting from the SAN. Table 4-1. Boot from iSCSI SAN support
Type of Host ESX Host ESXi Host Independent Hardware iSCSI Supported. An iSCSI HBA is required to boot from the SAN. Not supported.

Booting your host from a SAN provides numerous benefits.

n n n n

Cheaper servers. Servers can be more dense and run cooler without internal storage. Easier server replacement. You can replace servers and have the new server point to the old boot location. Less wasted space. Easier backup processes. The system boot images in the SAN can be backed up as part of the overall SAN backup procedures. Improved management. Creating and managing the operating system image is easier and more efficient.

This chapter includes the following topics:

n n n n n

General Boot from iSCSI SAN Recommendations, on page 62 Prepare the iSCSI SAN, on page 62 Configure ESX Hosts to Boot from iSCSI SAN, on page 63 iBFT iSCSI Boot Overview, on page 64 Collecting Diagnostic Information for ESXi Hosts, on page 69

VMware, Inc.

61

iSCSI SAN Configuration Guide

General Boot from iSCSI SAN Recommendations

If you plan to set up and use an iSCSI LUN as the boot device for your host, you need to follow certain general guidelines. These guidelines apply to booting from software and dependent iSCSI, and independent hardware iSCSI.
n n n n n

Review any vendor recommendations for the hardware you use in your boot configuration. For installation prerequisites and requirements, review an appropriate ESX/ESXi Installation Guide. Use static IP addresses to reduce the chances of DHCP conflicts. Use different LUNs for VMFS datastores and boot partitions. Configure proper ACLs on your storage system.
n

The boot LUN should be visible only to the host that uses the LUN. No other host on the SAN should be permitted to see that boot LUN. If a LUN is used for a VMFS datastore, it can be shared by multiple hosts. ACLs on the storage systems can allow you to do this.

Configure a diagnostic partition.

n

With independent hardware iSCSI only, you can place the diagnostic partition on the boot LUN. If you configure the diagnostic partition in the boot LUN, this LUN cannot be shared across multiple hosts. If a separate LUN is used for the diagnostic partition, it can be shared by multiple hosts. If you boot an ESXi host from SAN using iBFT, you cannot set up a diagnostic partition on a SAN LUN. Instead, you use the vSphere Management Assistant (vMA) to collect diagnostic information from your host and store it for analysis. See Collecting Diagnostic Information for ESXi Hosts, on page 69.

Prepare the iSCSI SAN

Before you configure your ESX/ESXi host to boot from an iSCSI LUN, prepare and configure your storage area network. CAUTION If you use scripted installation to install ESX when booting from a SAN, you must take special steps to avoid unintended data loss.

62

VMware, Inc.

Chapter 4 Booting from iSCSI SAN

Procedure 1 2 Connect network cables, referring to any cabling guide that applies to your setup. Ensure IP connectivity between your storage system and server. This includes proper configuration of any routers or switches on your storage network. Storage systems must be able to ping the iSCSI adapters in your hosts. 3 Configure the storage system. a b Create a volume (or LUN) on the storage system for your host to boot from. Configure the storage system so that your host has access to the assigned LUN. This could involve updating ACLs with the IP addresses, iSCSI names, and the CHAP authentication parameter you use on your host. On some storage systems, in addition to providing access information for the ESX/ESXi host, you must also explicitly associate the assigned LUN with the host. c d e Ensure that the LUN is presented to the host correctly. Ensure that no other system has access to the configured LUN. Record the iSCSI name and IP addresses of the targets assigned to the host. You must have this information to configure your iSCSI adapters.

Configure ESX Hosts to Boot from iSCSI SAN

With the ESX host, you can boot from the iSCSI SAN only if the host uses an independent hardware iSCSI adapter, such as QLogic HBA. You need to configure the independent hardware iSCSI adapter for booting from the SAN. This procedure discusses how to enable the QLogic iSCSI HBA to boot from the SAN. For more information and more up-to-date details about QLogic adapter configuration settings, see the QLogic web site. Prerequisites Because you first need to boot from the VMware installation media, set up your host to boot from DVD-ROM. To achieve this, change the system boot sequence in your system BIOS setup. Procedure 1 2 3 4 Insert the installation DVD in the DVD-ROM drive and reboot the host. Use the BIOS to set the host to boot from the DVD-ROM drive first. During server POST, press Crtl+q to enter the QLogic iSCSI HBA configuration menu. Select the I/O port to configure. By default, the Adapter Boot mode is set to Disable. 5 Configure the HBA. a b 6 From the Fast!UTIL Options menu, select Configuration Settings > Host Adapter Settings. Configure the following settings for your host adapter: initiator IP address, subnet mask, gateway, initiator iSCSI name, and CHAP (if required).

Configure iSCSI settings. See Configure iSCSI Boot Settings, on page 64.

Save your changes and restart the system.

VMware, Inc.

63

iSCSI SAN Configuration Guide

Configure iSCSI Boot Settings

When setting up your ESX host to boot from iSCSI, you need to configure iSCSI boot settings. Procedure 1 2 3 From the Fast!UTIL Options menu, select Configuration Settings > iSCSI Boot Settings. Before you can set SendTargets, set Adapter Boot mode to Manual. Select Primary Boot Device Settings. a b Enter the discovery Target IP and Target Port. You can leave the Boot LUN and iSCSI Name fields blank if only one iSCSI target and one LUN are at the specified address to boot from. Otherwise, you must specify these fields to ensure that you do not boot from a volume for some other system. After the target storage system is reached, these fields will be populated after a rescan. Save changes.

c 4 5

From the iSCSI Boot Settings menu, select the primary boot device. An auto rescan of the HBA is made to find new target LUNS. Select the iSCSI target. NOTE If more then one LUN exists within the target, you can choose a specific LUN ID by pressing Enter after you locate the iSCSI device.

Return to the Primary Boot Device Setting menu. After the rescan, the Boot LUNand iSCSI Name fields are populated. Change the value of Boot LUN to the desired LUN ID.

iBFT iSCSI Boot Overview

ESXi hosts can boot from an iSCSI SAN using the software or dependent hardware iSCSI adapters and network adapters. To deploy ESXi and boot from the iSCSI SAN, the host must have an iSCSI boot capable network adapter that supports the iSCSI Boot Firmware Table (iBFT) format. The iBFT is a method of communicating parameters about the iSCSI boot device to an operating system. Before installing ESXi and booting from the iSCSI SAN, configure the networking and iSCSI boot parameters on the network adapter and enable the adapter for the iSCSI boot. Because configuring the network adapter is vendor specific, review your vendor documentation for instructions. When you first boot from iSCSI, the iSCSI boot firmware on your system connects to an iSCSI target. If login is successful, the firmware saves the networking and iSCSI boot parameters in the iBFT and stores the table in the system's memory. The system uses this table to configure its own iSCSI connection and networking and to start up. The following list describes the iBFT iSCSI boot sequence. 1 2 3 When restarted, the system BIOS detects the iSCSI boot firmware on the network adapter. The iSCSI boot firmware uses the preconfigured boot parameters to connect with the specified iSCSI target. If the connection to the iSCSI target is successful, the iSCSI boot firmware writes the networking and iSCSI boot parameters in to the iBFT and stores the table in the system memory. NOTE The system uses this table to configure its own iSCSI connection and networking and to start up. 4 The BIOS boots the boot device.

64

VMware, Inc.

Chapter 4 Booting from iSCSI SAN

5 6 7

The VMkernel starts loading and takes over the boot operation. Using the boot parameters from the iBFT, the VMkernel connects to the iSCSI target. After the iSCSI connection is established, the system boots.

iBFT iSCSI Boot Considerations

When you boot an ESXi host from iSCSI using iBFT-enabled network adapters, certain considerations apply. The iBFT iSCSI boot does not support the following items:
n n

IPv6 Failover for the iBFT-enabled network adapters

NOTE Update your NIC's boot code and iBFT firmware using vendor supplied tools before trying to install and boot VMware ESXi 4.1 release. Consult vendor documentation and VMware HCL guide for supported boot code and iBFT firmware versions for VMware ESXi 4.1 iBFT boot. The boot code and iBFT firmware released by vendors prior to the ESXi 4.1 release might not work. After you set up your host to boot from iBFT iSCSI, the following restrictions apply:
n

You cannot disable the software iSCSI adapter. If the iBFT configuration is present in the BIOS, the host re-enables the software iSCSI adapter during each reboot. You cannot remove the iBFT iSCSI boot target using the vSphere Client. The target appears on the list of adapter static targets.

Setting Up ESXi Host to Boot from iSCSI

With ESXi hosts, you can boot from iSCSI using the software iSCSI adapter or a dependent hardware iSCSI adapter and a network adapter. When you set up your host to boot from iSCSI, you perform a number of tasks. 1 Configure iSCSI Boot Parameters on page 65 To begin an iSCSI boot process, a network adapter on your host must have a specially configured iSCSI boot firmware. When you configure the firmware, you specify the networking and iSCSI parameters and enable the adapter for the iSCSI boot. 2 Change Boot Sequence in BIOS on page 66 When setting up your host to boot from iBFT iSCSI, change the boot sequence to force your host to boot in an appropriate order. 3 4 Install ESXi to iSCSI Target on page 66 When setting up your host to boot from iSCSI, install the ESXi image to the target LUN. Boot ESXi from iSCSI Target on page 67 After preparing the host for an iSCSI boot and copying the ESXi image to the iSCSI target, perform the actual boot.

Configure iSCSI Boot Parameters

To begin an iSCSI boot process, a network adapter on your host must have a specially configured iSCSI boot firmware. When you configure the firmware, you specify the networking and iSCSI parameters and enable the adapter for the iSCSI boot. Configuration on the network adapter can be dynamic or static. If you use the dynamic configuration, you indicate that all target and initiator boot parameters are acquired using DHCP. For the static configuration, you manually enter data that includes your host's IP address and initiator IQN, and the target parameters.

VMware, Inc.

65

iSCSI SAN Configuration Guide

Procedure
u

On the network adapter that you use for the boot from iSCSI, specify networking and iSCSI parameters. Because configuring the network adapter is vendor specific, review your vendor documentation for instructions.

Change Boot Sequence in BIOS

When setting up your host to boot from iBFT iSCSI, change the boot sequence to force your host to boot in an appropriate order. For ESXi installation, change the BIOS boot sequence to the following sequence:
n n

iSCSI DVD-ROM

Because changing the boot sequence in the BIOS is vendor specific, refer to vendor documentation for instructions. The following sample procedure explains how to change the boot sequence on a Dell host with a Broadcom network adapter. Procedure 1 2 3 4 5 6 7 Turn on the host. During Power-On Self-Test (POST), press F2 to enter the BIOS Setup. In the BIOS Setup, select Boot Sequence and press Enter. In the Boot Sequence menu, arrange the bootable items so that iSCSI precedes the DVD-ROM. Press Esc to exit the Boot Sequence menu. Press Esc to exit the BIOS Setup. Select Save Changes and click Exit to exit the BIOS Setup menu.

Install ESXi to iSCSI Target

When setting up your host to boot from iSCSI, install the ESXi image to the target LUN. Prerequisites
n

Configure iSCSI boot firmware on your boot NIC to point to the target LUN that you want to use as the boot LUN. Change the boot sequence in the BIOS so that iSCSI precedes the DVD-ROM. If you use Broadcom adapters, set Boot to iSCSI target to Disabled.

n n

Procedure 1 2 3 Insert the installation media in the DVD-ROM drive and restart the host. When the installer starts, follow the typical installation procedure. When prompted, select the iSCSI LUN as the installation target. The installer copies the ESXi boot image to the iSCSI LUN. 4 After the system restarts, remove the installation DVD.

66

VMware, Inc.

Chapter 4 Booting from iSCSI SAN

Boot ESXi from iSCSI Target

After preparing the host for an iSCSI boot and copying the ESXi image to the iSCSI target, perform the actual boot. Prerequisites
n n n

Configure the iSCSI boot firmware on your boot NIC to point to the boot LUN. Change the boot sequence in the BIOS so that iSCSI precedes the boot device. If you use Broadcom adapters, set Boot to iSCSI target to Enabled

Procedure 1 Restart the host. The host boots from the iSCSI LUN using iBFT data. During the first boot, the iSCSI initialization script sets up default networking. The network setup is persistent after subsequent reboots. 2 (Optional) Adjust networking configuration using the vSphere Client.

Networking Best Practices

To boot an ESXi host from iSCSI using iBFT, you must properly configure networking. To achieve greater security and better performance, have redundant network adapters on the host. How you set up all the network adapters depends on whether your environment uses shared or isolated networks for the iSCSI traffic and host management traffic.

Shared iSCSI and Management Networks

Configure the networking and iSCSI parameters on the first network adapter on the host. After the host boots, you can add secondary network adapters to the default port group.

Isolated iSCSI and Management Networks

When you configure isolated iSCSI and management networks, follow these guidelines to avoid bandwidth problems.
n n

Your isolated networks must be on different subnets. If you use VLANs to isolate the networks, they must have different subnets to ensure that routing tables are properly set up. VMware recommends that you configure the iSCSI adapter and target to be on the same subnet. If you set up the iSCSI adapter and target on different subnets, the following restrictions apply:
n n

The default VMkernel gateway must be able to route both the management and iSCSI traffic. After you boot your ESXi host, you can use the iBFT-enabled network adapter only for iBFT. You cannot use the adapter for iSCSI traffic.

n n n

Use the first physical network adapter for the management network. Use the second physical network adapter for the iSCSI network. Make sure to configure the iBFT. After the host boots, you can add secondary network adapters to both the management and iSCSI networks.

VMware, Inc.

67

iSCSI SAN Configuration Guide

Change iBFT iSCSI Boot Settings

If settings, such as the IQN name, IP address, and so on, change on the iSCSI storage or your host, update the iBFT. This task assumes that the boot LUN and the data stored on the LUN remain intact. Procedure 1 2 3 4 Shut down the ESXi host. Change iSCSI storage settings. Update the iBFT on the host with the new settings. Restart the host. The host boots using the new information stored in the iBFT.

Troubleshooting iBFT iSCSI Boot

The topics in this section help you to identify and solve problems you might encounter when using iBFT iSCSI boot.

Loss of System's Gateway Causes Loss of Network Connectivity

You lose network connectivity when you delete a port group associated with the iBFT network adapter. Problem A loss of network connectivity occurs after you delete a port group. Cause When you specify a gateway in the iBFT-enabled network adapter during ESXi installation, this gateway becomes the system's default gateway. If you delete the port group associated with the network adapter, the system's default gateway is lost. This action causes the loss of network connectivity. Solution Do not set an iBFT gateway unless it is required. If the gateway is required, after installation, manually set the system's default gateway to the one that the management network uses.

Changing iSCSI Boot Parameters Causes ESXi to Boot in Stateless Mode

Changing iSCSI boot parameters on the network adapter after the first boot does not update the iSCSI and networking configuration on the ESXi host. Problem If you change the iSCSI boot parameters on the network adapter after the first ESXi boot from iSCSI, the host will boot in a stateless mode. Cause The firmware uses the updated boot configuration and is able to connect to the iSCSI target and load the ESXi image. However, when loaded, the system does not pick up the new parameters, but continues to use persistent networking and iSCSI parameters from the previous boot. As a result, the ESXi host cannot connect to the target and boots in the stateless mode.

68

VMware, Inc.

Chapter 4 Booting from iSCSI SAN

Solution 1 2 3 Use the vSphere Client to connect to the ESXi host. Re-configure the iSCSI and networking on the host to match the iBFT parameters. Perform a rescan.

Collecting Diagnostic Information for ESXi Hosts

If you boot from SAN using iBFT and your ESXi host does not have a local diagnostic partition, you need to set up the vSphere Management Assistant (vMA) to collect diagnostic information from your host and store it for analysis. If your ESXi host experiences serious problems, it creates a file with diagnostic information that can be later analyzed to determine the cause of the problems. You set up your ESXi host to act as a net dump client that transfers the diagnostic file over the network. vMA acts as the net dump server that collects the diagnostic information and saves it to /var/core on the server. When you set up the net dump environment, follow these guidelines:
n n

Do not install vMA on the same physical host where you set up the net dump client. If you have multiple ESXi hosts that require the net dump configuration, configure each host separately. One vMA instance is sufficient for collecting the core dump files from multiple ESXi hosts.

Configure vSphere Management Assistant

The vSphere Management Assistant (vMA) is a virtual machine that you configure to act as a net dump server that collects diagnostic information from your ESXi host. Prerequisites Deploy and configure vMA on a physical server different form the server where you set up the net dump client. For information, see the vSphere Management Assistant Guide on http://www.vmware.com/support/pubs. Procedure 1 2 Log in to vMA as administrator. Enable the net dump server on vMA.
# sudo chkconfig vmware-netdumper on

Start the net dump server.

# sudo/etc/init.d/vmware-netdumper start # sudo lokkit --quiet --port=6500:udp

Configure ESXi Host

Configure an ESXi host to act as the net dump client that transfers diagnostic information over the network. Use vSphere CLI to configure your ESXi host. Prerequisites Configure vMA as the net dump server and obtain its IP address.

VMware, Inc.

69

iSCSI SAN Configuration Guide

Procedure 1 Enter the IP address of the ESXi host.

# esxcfg-advcfg -s IP_address_ESXi /Net/NetdumpVmkIP

Specify the network adapter to use.

# esxcfg-advcfg -s vmnic /Net/NetdumpVmkNic

Specify the port group attached to the network adapter.

# esxcfg-advcfg -s portgroup /Net/NetdumpVmkPG

Specify the IP address of the net dump server.

# esxcfg-advcfg -s IP_address_netdump /Net/NetdumpServerIP

(Optional) Enter the IP address of gateway to reach the net dump server.
# esxcfg-advcfg -s IP_address_gateway /Net/NetdumpServerGateway

70

VMware, Inc.

Managing ESX/ESXi Systems That Use SAN Storage

This section helps you manage your ESX/ESXi system, use SAN storage effectively, and perform troubleshooting. It also explains how to find information about storage devices, adapters, multipathing, and so on. This chapter includes the following topics:
n n n n n n n n n n n n

Viewing Storage Adapter Information, on page 71 Viewing Storage Device Information, on page 72 Viewing Datastore Information, on page 74 Resolving Storage Display Issues, on page 75 Path Scanning and Claiming, on page 79 Sharing Diagnostic Partitions, on page 84 Avoiding and Resolving SAN Problems, on page 84 Optimizing SAN Storage Performance, on page 85 Resolving Performance Issues, on page 88 SAN Storage Backup Considerations, on page 91 Managing Duplicate VMFS Datastores, on page 93 Storage Hardware Acceleration, on page 96

Viewing Storage Adapter Information

In the vSphere Client, you can display storage adapters that your host uses and review their information. When you list all available adapters, you can see their models, types, such as Fibre Channel, Parallel SCSI, or iSCSI, and, if available, their unique identifiers. As unique identifiers, iSCSI adapters use iSCSI names. When you display details for each iSCSI adapter, you see the following information. Software iSCSI and dependent hardware iSCSI adapters need to be configured or enabled before you can view their information. Table 5-1. Storage Adapter Information
Adapter Information Model iSCSI Name iSCSI Alias Description Model of the adapter. A unique name formed according to iSCSI standards that identifies the iSCSI adapter. A friendly name used instead of the iSCSI name.

VMware, Inc.

71

iSCSI SAN Configuration Guide

Table 5-1. Storage Adapter Information (Continued)

Adapter Information IP Address (independent hardware iSCSI) Connected Targets Devices Paths Description An address assigned to the iSCSI adapter. Number of targets accessed through the adapter. All storage devices or LUNs the adapter can access. All paths the adapter uses to access storage devices.

View Storage Adapter Information

Use the vSphere Client to display storage adapters and review their information. Procedure 1 2 3 4 5 6 In Inventory, select Hosts and Clusters. Select a host and click the Configuration tab. In Hardware, select Storage Adapters. To view details for a specific adapter, select the adapter from the Storage Adapters list. To list all storage devices the adapter can access, click Devices. To list all paths the adapter uses, click Paths.

Copy Storage Adapter Names to Clipboard

You can copy the name of an adapter to a clipboard directly from the UI. Procedure 1 2 3 4 5 In Inventory, select Hosts and Clusters. Select a host and click the Configuration tab. In Hardware, select Storage Adapters. Select the adapter from the Storage Adapters list. In the Details panel, highlight the value in the name field, and select Copy from the right-click menu.

Viewing Storage Device Information

You can use the vSphere Client to display all storage devices or LUNs available to your host, including all local and networked devices. If you use any third-party multipathing plug-ins, storage devices available through the plug-ins also appear on the list. For each storage adapter, you can display a separate list of storage devices accessible just through this adapter. When you review a list of storage devices, you typically see the following information. Table 5-2. Storage Device Information
Device Information Name Identifier Runtime Name LUN Description A friendly name that the host assigns to the device based on the storage type and manufacturer. You can change this name to a name of your choice. A universally unique identifier that is intrinsic to the storage device. The name of the first path to the device. The LUN number that shows the position of the LUN within the target.

72

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Table 5-2. Storage Device Information (Continued)

Device Information Type Transport Capacity Owner Hardware Acceleration Location Partitions Description Type of device, for example, disk or CD-ROM. Transportation protocol your host uses to access the device. Total capacity of the storage device. The plug-in, such as the NMP or a third-party plug-in, the host uses to manage the storage device. Information on whether the storage device assists the host with various virtual machine management operations. The status can be Supported, Not Supported, or Unknown. A path to the storage device in the /vmfs/devices/ directory. Primary and logical partitions, including a VMFS datastore, if configured.

Understanding Storage Device Naming

In the vSphere Client, each storage device, or LUN, is identified by several names. Name Identifier A friendly name that the host assigns to a device based on the storage type and manufacturer. You can modify the name using the vSphere Client. A universally unique identifier that the host extracts from the storage. Depending on the type of storage, the host uses different algorithms to extract the identifier. The name of the first path to the device. The runtime name is created by the host. The runtime name is not a reliable identifier for the device, and is not persistent. The runtime name has the following format: vmhba#:C#:T#:L#, where
n

Runtime Name

vmhba# is the name of the storage adapter. The name refers to the physical adapter on the host, not to the SCSI controller used by the virtual machines. C# is the storage channel number. Software iSCSI initiators use the channel number to show multiple paths to the same target.

T# is the target number. Target numbering is decided by the host and might change if there is a change in the mappings of targets visible to the host. Targets that are shared by different hosts might not have the same target number. L# is the LUN number that shows the position of the LUN within the target. The LUN number is provided by the storage system. If a target has only one LUN, the LUN number is always zero (0).

For example, vmhba1:C0:T3:L1 represents LUN1 on target 3 accessed through the storage adapter vmhba1 and channel 0.

VMware, Inc.

73

iSCSI SAN Configuration Guide

Display Storage Devices for a Host

You can use the vSphere Client to display all storage devices or LUNs available to your host, including all local and networked devices. If you use any third-party multipathing plug-ins, storage devices available through the plug-ins also appear on the list. Procedure 1 2 3 4 5 In Inventory, select Hosts and Clusters. Select a host and click the Configuration tab. In Hardware, select Storage. Click Devices. To view additional details about a specific device, select the device from the list.

Display Storage Devices for an Adapter

For each storage adapter on your host, you can display a list of storage devices accessible just through this adapter. Procedure 1 2 3 4 5 In Inventory, select Hosts and Clusters. Select a host and click the Configuration tab. In Hardware, select Storage Adapters. Select the adapter from the Storage Adapters list. Click Devices.

Copy Storage Device Identifiers to Clipboard

A storage device identifier is a universally unique ID that the host assigns to a storage device or LUN. Depending on the type of storage, the host uses different algorithms to create the identifier and it can become quite long and complex. You can copy the storage device identifier directly from the UI. Procedure 1 2 Display a list of storage devices. Right-click a device and select Copy identifier to clipboard.

Viewing Datastore Information

You can display all datastores available to your hosts and analyze their properties. Datastores are added to the vSphere Client in the following ways:
n n

Created on an available storage device. Discovered when a host is added to the inventory. When you add a host to the inventory, the vSphere Client displays any datastores available to the host.

If your vSphere Client is connected to a vCenter Server system, you can see datastore information in the Datastores view. This view displays all datastores in the inventory, arranged by a datacenter. Through this view, you can organize datastores into folder hierarchies, create new datastores, edit their properties, or remove existing datastores.

74

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

This view is comprehensive and shows all information for your datastores including hosts and virtual machines using the datastores, storage reporting information, permissions, alarms, tasks and events, storage topology, and storage reports. Configuration details for each datastore on all hosts connected to this datastore are provided on the Configuration tab of the Datastores view. NOTE The Datastores view is not available when the vSphere client connects directly to your host. In this case, review datastore information through the host storage configuration tab. The following table describes the datastore details that you can see when you review datastores. Table 5-3. Datastore Information
Datastore Information Identification Device Capacity Free Type Storage I/O Control Hardware Acceleration Location Extents Path Selection Paths Description Editable friendly name that you assign to the datastore. Storage device, on which the datastore is deployed. If the datastore spans over multiple storage devices, only the first storage device is shown. Total formatted capacity of the datastore. Available space. File system that the datastore uses, either VMFS or NFS. Allows cluster-wide storage I/O prioritization. See the vSphere Resource Management Guide. Information on whether the datastore assists the host with various virtual machine management operations. The status can be Supported, Not Supported, or Unknown. A path to the datastore in the /vmfs/volumes/ directory. Individual extents that the datastore spans and their capacity (VMFS datastores only). Path selection policy the host uses to access storage (VMFS datastores only). Number of paths used to access storage and their status (VMFS datastores only).

Review Datastore Properties

Use the vSphere Client to review datastore properties. Procedure 1 2 3 4 Select a host in the inventory and click the Configuration tab. In Hardware, select Storage. Click the Datastores view. To display details for a particular datastore, select the datastore from the list.

Resolving Storage Display Issues

When you use the vSphere Client to view storage devices available to your ESX/ESXi host and the output differs from what you expect, perform troubleshooting tasks. Perform the following troubleshooting tasks if you have display issues.

VMware, Inc.

75

iSCSI SAN Configuration Guide

Table 5-4. Troubleshooting iSCSI LUN Display

Troubleshooting Task Check cable connectivity. Description If you do not see a port, the problem could be cable connectivity or routing. Check the cables first. Ensure that cables are connected to the ports and a link light indicates that the connection is good. If each end of the cable does not show a good link light, replace the cable. Controls connectivity between different subnets on your Ethernet configuration. If your ESX/ESXi system and iSCSI storage are not on the same subnet, ensure that appropriate routing exists between the subnets. Also, ensure that the subnet mask and gateway address are set correctly on the iSCSI storage and the iSCSI initiator in the ESX/ESXi host. If the expected LUNs do not appear after rescan, access control might not be configured correctly on the storage system side: n If CHAP is configured, ensure that it is enabled on the ESX/ESXi host and matches the storage system setup. n If IP-based filtering is used, ensure that the iSCSI HBA or the VMkernel port group IP address and service console IP address are allowed. n If you are using initiator name-based filtering, ensure that the name is a qualified iSCSI name and matches the storage system setup. n For booting from a SAN, ensure that each host sees only required LUNs. Do not allow any host to see any boot LUN other than its own. Use storage system software to make sure that the host can see only the LUNs that it is supposed to see. n Ensure that theDisk.MaxLUN setting allows you to view the LUN you expect to see. If a storage system has more than one storage processor, make sure that the SAN switch has a connection to the SP that owns the LUNs you want to access. On some storage systems, only one SP is active and the other SP is passive until a failure occurs. If you are connected to the wrong SP (the one with the passive path) you might not see the expected LUNs, or you might see the LUNs but get errors when trying to access them. The software iSCSI initiator in ESX/ESXi requires that a VMkernel network port have access to the iSCSI storage. The software initiator uses the VMkernel for data transfer between the ESX/ESXi system and the iSCSI storage. Perform a rescan each time you complete the following tasks: n Create new LUNs on a SAN. n Change the LUN masking on an ESX/ESXi host storage system. n Reconnect a cable. n Make a change to a host in a cluster. n Change CHAP settings or add new discovery addresses.

Check routing settings.

Check access control configuration.

Check storage processor setup.

For software iSCSI, check network configuration. Rescan your iSCSI initiator.

Datastore Refresh and Storage Rescan Operations

The datastore refresh operation updates the datastore lists and storage information, such as the datastore capacity, displayed in the vSphere Client. When you perform datastore management tasks or make changes in the SAN configuration, you might need to rescan your storage. When you perform VMFS datastore management operations, such as creating a VMFS datastore or RDM, adding an extent, and increasing or deleting a VMFS datastore, your host or the vCenter Server automatically rescans and updates your storage. You can disable the automatic rescan feature by turning off the Host Rescan Filter. See Turn off vCenter Server Storage Filters, on page 78. In certain cases, you need to perform a manual rescan. You can rescan all storage available to your host, or, if you are using the vCenter Server, to all hosts in a folder, cluster, and datacenter. If the changes you make are isolated to storage connected through a specific adapter, perform a rescan for this adapter.

76

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Perform the manual rescan each time you make one of the following changes.
n n n n n n

Create new LUNs on a SAN. Change the path masking on a host. Reconnect a cable. Change CHAP settings. Add or remove discovery or static addresses. Add a single host to the vCenter Server after you have edited or removed from the vCenter Server a datastore shared by the vCenter Server hosts and the single host.

IMPORTANT If you rescan when a path is unavailable, the host removes the path from the list of paths to the device. The path reappears on the list as soon as it becomes available and starts working again.

Perform Storage Rescan

When you make changes in your SAN configuration, you might need to rescan your storage. You can rescan all storage available to your host. If the changes you make are isolated to storage accessed through a specific adapter, perform rescan for only this adapter. Use this procedure if you want to limit the rescan to storage available to a particular host or accessed through a particular adapter on the host. If you want to rescan storage available to all hosts managed by your vCenter Server system, you can do so by right-clicking a datacenter, cluster, or folder that contains the hosts and selecting Rescan for Datastores. Procedure 1 2 In the vSphere Client, select a host and click the Configuration tab. In the Hardware panel, select Storage Adapters, and click Rescan above the Storage Adapters panel. You can also right-click an individual adapter and click Rescan to rescan just that adapter. IMPORTANT On ESXi, it is not possible to rescan a single storage adapter. If you rescan a single adapter, all adapters are rescanned. 3 To discover new disks or LUNs, select Scan for New Storage Devices. If new LUNs are discovered, they appear in the device list. 4 To discover new datastores or update a datastore after its configuration has been changed, select Scan for New VMFS Volumes. If new datastores or VMFS volumes are discovered, they appear in the datastore list.

Change the Number of Scanned LUNs

By default, the VMkernel scans for LUN 0 to LUN 255 for every target (a total of 256 LUNs). You can modify the Disk.MaxLUN parameter to improve LUN discovery speed. IMPORTANT You cannot discover LUNs with a LUN ID number that is greater than 255. Reducing the value can shorten rescan time and boot time. However, the time to rescan LUNs might depend on other factors, including the type of storage system and whether sparse LUN support is enabled.

VMware, Inc.

77

iSCSI SAN Configuration Guide

Procedure 1 2 3 4 In the vSphere Client inventory panel, select the host, click the Configuration tab, and click Advanced Settings under Software. Select Disk. Scroll down to Disk.MaxLUN. Change the existing value to the value of your choice, and click OK. The value you enter specifies the LUN after the last one you want to discover. For example, to discover LUNs from 0 through 31, set Disk.MaxLUN to 32.

Disable Sparse LUN Support

You can disable the default sparse LUN support to decrease the time ESX/ESXi needs to scan for LUNs. The VMkernel provides sparse LUN support by default. The sparse LUN support enables the VMkernel to perform uninterrupted LUN scanning when a storage system presents LUNs with nonsequential LUN numbering, for example 0, 6, and 23. If all LUNs that your storage system presents are sequential, you can disable the sparse LUN support. Procedure 1 2 3 In the vSphere Client inventory panel, select the host, click the Configuration tab, and click Advanced Settings under Software. In the Advanced Settings dialog box, select Disk. Scroll down to Disk.SupportSparseLUN, change the value to 0, and click OK.

Turn off vCenter Server Storage Filters

When you perform VMFS datastore management operations, vCenter Server uses default storage filters. The filters help you to avoid storage corruption by retrieving only the storage devices, or LUNs, that can be used for a particular operation. Unsuitable LUNs are not displayed for selection. You can turn off the filters to view all LUNs. Before making any changes to the LUN filters, consult with the VMware support team. You can turn off the filters only if you have other methods to prevent LUN corruption. Procedure 1 2 3 In the vSphere Client, select Administration > vCenter Server Settings. In the settings list, select Advanced Settings. In the Key text box, type a key.
Key config.vpxd.filter.vmfsFilter config.vpxd.filter.rdmFilter config.vpxd.filter.SameHostAndTra nsportsFilter config.vpxd.filter.hostRescanFilter Filter Name VMFS Filter RDM Filter Same Host and Transports Filter Host Rescan Filter NOTE If you turn off the Host Rescan Filter, your hosts continue to perform a rescan each time you present a new LUN to a host or a cluster.

In the Value text box, type False for the specified key.

78

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

5 6

Click Add. Click OK. You are not required to restart the vCenter Server system.

vCenter Server Storage Filtering

vCenter Server provides storage filters to help you avoid storage device corruption or performance degradation that can be caused by an unsupported use of LUNs. These filters are available by default. Table 5-5. Storage Filters
Filter Name VMFS Filter Description Filters out storage devices, or LUNs, that are already used by a VMFS datastore on any host managed by vCenter Server. The LUNs do not show up as candidates to be formatted with another VMFS datastore or to be used as an RDM. Filters out LUNs that are already referenced by an RDM on any host managed by vCenter Server. The LUNs do not show up as candidates to be formatted with VMFS or to be used by a different RDM. If you need virtual machines to access the same LUN, the virtual machines must share the same RDM mapping file. For information about this type of configuration, see Setup for Failover Clustering and Microsoft Cluster Service. Filters out LUNs ineligible for use as VMFS datastore extents because of host or storage type incompatibility. Prevents you from adding the following LUNs as extents: n LUNs not exposed to all hosts that share the original VMFS datastore. n LUNs that use a storage type different from the one the original VMFS datastore uses. For example, you cannot add a Fibre Channel extent to a VMFS datastore on a local storage device. Automatically rescans and updates VMFS datastores after you perform datastore management operations. The filter helps provide a consistent view of all VMFS datastores on all hosts managed by vCenter Server. NOTE If you present a new LUN to a host or a cluster, the hosts automatically perform a rescan no matter whether you have the Host Rescan Filter on or off. Key config.vpxd.filter.vmfsFilter

RDM Filter

config.vpxd.filter.rdmFilter

Same Host and Transports Filter

config.vpxd.filter.SameHostAndTransportsFilter

Host Rescan Filter

config.vpxd.filter.hostRescanFilter

Path Scanning and Claiming

When you start your ESX/ESXi host or rescan your storage adapter, the host discovers all physical paths to storage devices available to the host. Based on a set of claim rules defined in the /etc/vmware/esx.conf file, the host determines which multipathing plug-in (MPP) should claim the paths to a particular device and become responsible for managing the multipathing support for the device. By default, the host performs a periodic path evaluation every 5 minutes causing any unclaimed paths to be claimed by the appropriate MPP.

VMware, Inc.

79

iSCSI SAN Configuration Guide

The claim rules are numbered. For each physical path, the host runs through the claim rules starting with the lowest number first. The attributes of the physical path are compared to the path specification in the claim rule. If there is a match, the host assigns the MPP specified in the claim rule to manage the physical path. This continues until all physical paths are claimed by corresponding MPPs, either third-party multipathing plugins or the native multipathing plug-in (NMP). For general information on multipathing plug-ins, see Managing Multiple Paths, on page 22. For the paths managed by the NMP module, a second set of claim rules is applied. These rules determine which Storage Array Type Plug-In (SATP) should be used to manage the paths for a specific array type, and which Path Selection Plug-In (PSP) is to be used for each storage device. For example, for a storage device that belongs to the EMC CLARiiON CX storage family and is not configured as ALUA device, the default SATP is VMW_SATP_CX and the default PSP is Most Recently Used. Use the vSphere Client to view which SATP and PSP the host is using for a specific storage device and the status of all available paths for this storage device. If needed, you can change the default VMware PSP using the vSphere Client. To change the default SATP, you need to modify claim rules using the vSphere CLI. You can find some information about modifying claim rules in Managing Storage Paths and Multipathing Plug-Ins, on page 103. For detailed descriptions of the commands available to manage PSA, see the vSphere Command-Line Interface Installation and Scripting Guide and the vSphere Command-Line Interface Reference.

Viewing the Paths Information

Use the vSphere Client to determine which SATP and PSP the ESX/ESXi host uses for a specific storage device and the status of all available paths for this storage device. You can access the path information from both, the Datastores and Devices views. For datastores, you review the paths that connect to the device the datastore is deployed on. The path information includes the SATP assigned to manage the device, the path selection policy (PSP), and a list of paths with their physical characteristics, such as an adapter and target each path uses, and the status of each path. The following path status information can appear: Active Paths available for issuing I/O to a LUN. A single or multiple working paths currently used for transferring data are marked as Active (I/O). NOTE For hosts that run ESX/ESXi 3.5 or earlier, the term active means the only path that the host is using to issue I/O to a LUN. Standby Disabled Dead The path is operational and can be used for I/O if active paths fail. The path is disabled and no data can be transferred. The software cannot connect to the disk through this path.

If you are using the Fixedpath policy, you can see which path is the preferred path. The preferred path is marked with an asterisk (*) in the Preferred column.

View Datastore Paths

Use the vSphere Client to review the paths that connect to storage devices the datastores are deployed on. Procedure 1 2 3 Log in to the vSphere Client and select a server from the inventory panel. Click the Configuration tab and click Storage in the Hardware panel. Click Datastores under View.

80

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

From the list of configured datastores, select the datastore whose paths you want to view or configure. The Details panel shows the total number of paths being used to access the device and whether any of them are broken or disabled.

Click Properties > Manage Paths to open the Manage Paths dialog box. You can use the Manage Paths dialog box to enable or disable your paths, set multipathing policy, and specify the preferred path.

View Storage Device Paths

Use the vSphere Client to view which SATP and PSP the host uses for a specific storage device and the status of all available paths for this storage device. Procedure 1 2 3 4 Log in to the vSphere Client and select a server from the inventory panel. Click the Configuration tab and click Storage in the Hardware panel. Click Devices under View. Click Manage Paths to open the Manage Paths dialog box.

Setting a Path Selection Policy

For each storage device, the ESX/ESXi host sets the path selection policy based on the claim rules defined in the /etc/vmware/esx.conf file. By default, VMware supports the following path selection policies. If you have a third-party PSP installed on your host, its policy also appears on the list. Fixed (VMW_PSP_FIXED) Fixed AP (VMW_PSP_FIXED_AP) Most Recently Used (VMW_PSP_MRU) The host always uses the preferred path to the disk when that path is available. If the host cannot access the disk through the preferred path, it tries the alternative paths. The default policy for active-active storage devices is Fixed. Extends the Fixed functionality to active-passive and ALUA mode arrays. The host selects the path that it used recently. When the path becomes unavailable, the host selects an alternative path. The host does not revert back to the original path when that path becomes available again. There is no preferred path setting with the MRU policy. MRU is the default policy for active-passive storage devices. The host uses an automatic path selection algorithm rotating through all active paths when connecting to active-passive arrays, or through all available paths when connecting to active-active arrays. This implements load balancing across the physical paths available to your host. Load balancing is the process of spreading I/O requests across the paths. The goal is to optimize performance in terms of throughput, such as I/O per second, megabytes per second, or response times. Table 5-6 summarizes how the behavior of host changes, depending on the type of array and the failover policy.

Round Robin (VMW_PSP_RR)

VMware, Inc.

81

iSCSI SAN Configuration Guide

Table 5-6. Path Policy Effects

Policy/Controller Most Recently Used Fixed Active/Active Administrator action is required to fail back after path failure. VMkernel resumes using the preferred path when connectivity is restored. Active/Passive Administrator action is required to fail back after path failure. VMkernel attempts to resume using the preferred path. This can cause path thrashing or failure when another SP now owns the LUN. Next path in round robin scheduling is selected.

Round Robin Fixed AP

No fail back.

For ALUA arrays, VMkernel picks the path set to be the preferred path. For both A/A and A/P and ALUA arrays, VMkernel resumes using the preferred path, but only if the path-thrashing avoidance algorithm allows the fail-back.

Change the Path Selection Policy

Generally, you do not have to change the default multipathing settings your host uses for a specific storage device. However, if you want to make any changes, you can use the Manage Paths dialog box to modify a path selection policy and specify the preferred path for the Fixed policy. Procedure 1 2 Open the Manage Paths dialog box either from the Datastores or Devices view. Select a path selection policy. By default, VMware supports the following path selection policies. If you have a third-party PSP installed on your host, its policy also appears on the list.
n n n n

Fixed (VMW_PSP_FIXED) Fixed AP (VMW_PSP_FIXED_AP) Most Recently Used (VMW_PSP_MRU) Round Robin (VMW_PSP_RR)

3 4

For the fixed policy, specify the preferred path by right-clicking the path you want to assign as the preferred path, and selecting Preferred. Click OK to save your settings and exit the dialog box.

Disable Paths
You can temporarily disable paths for maintenance or other reasons. You can do so using the vSphere Client. Procedure 1 2 3 Open the Manage Paths dialog box either from the Datastores or Devices view. In the Paths panel, right-click the path to disable, and select Disable. Click OK to save your settings and exit the dialog box.

You can also disable a path from the adapters Paths view by right-clicking the path in the list and selecting Disable.

82

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Path Management and Manual, or Static, Load Balancing

Balancing loads among available paths improves performance. If your array supports the ALUA protocol, your host uses that protocol to perform load balancing. If your array does not support the ALUA protocol and you want your host to do automatic load balancing, configure your devices to use the Round Robin PSP. If you want to do the load balancing yourself, you can perform manual load balancing. With both active-active and active-passive storage arrays, you can set up your host to use different paths to different LUNs so that your adapters are being used evenly. If a path fails, the surviving paths carry all the traffic. Path failover might take a minute or more, because the SAN might converge with a new topology to try to restore service. This delay is necessary to allow the SAN to stabilize its configuration after topology changes. You can configure your ESX/ESXi host to load balance traffic across multiple adapters by assigning preferred paths to your LUNs. Path policy must be set to Fixed. The following example demonstrates how manual load balancing is performed with an active-active array. Assume the following setup, shown in Figure 5-1.
n n n

Active/Active SPs An ESX/ESXi system Two iSCSI HBAs

ESX/ESXi HBA1 HBA2

Figure 5-1. Manual Load Balancing with iSCSI

IP network

SP1

SP2

storage array

For load balancing, set the preferred paths as follows.

n n n n

For LUN 1: HBA1-SP1-LUN1 For LUN 2: HBA2-SP1-LUN2 For LUN 3: HBA1-SP2-LUN3 For LUN 4: HBA2-SP2-LUN4

With active-passive arrays, you can perform load balancing if the array supports two active paths and the HBA ports can access both SPs in an array. You can use the VMW_PSP_FIXED_AP path selection policies to do static path load balancing on active-passive arrays.

VMware, Inc.

83

iSCSI SAN Configuration Guide

Set Guest Operating System Timeout

Increase the standard disk timeout value so that a Windows guest operating system is not extensively disrupted during a path failover. Path failover occurs when the active path to a LUN is changed from one path to another, usually because of some SAN component failure along the current path. I/O might pause for 30 to 60 seconds until the iSCSI driver determines that the link is unavailable and until failover is complete. As a result, the virtual machines (with their virtual disks installed on SAN storage) can appear unresponsive. If you attempt to display the host, its storage devices, or its adapter, the operation might appear to stall. After failover is complete, I/O resumes normally. In case of multiple breakages, all connections to SAN storage devices might be lost. If none of the connections to the storage device is working, some virtual machines might encounter I/O errors on their virtual SCSI disks. For Windows 2000 and Windows Server 2003 guest operating systems, you can set operating system timeout by fusing the registry. Procedure 1 2 3 4 5 Back up your Windows registry. Select Start > Run. From the command prompt type regedit.exe, and click OK. In the left-panel hierarchy view, double-click HKEY_LOCAL_MACHINE, then System, then CurrentControlSet, then Services, and then Disk. Select the TimeOutValue and set the data value to x03c (hexadecimal) or 60 (decimal). After you make this change, Windows waits at least 60 seconds for delayed disk operations to complete before it generates errors. 6 Click OK to exit the Registry Editor.

Sharing Diagnostic Partitions

Generally, you use the local disk of your ESX/ESXi host as a diagnostic partition. If you have diskless ESX servers that boot from a SAN, multiple hosts can share one diagnostic partition on the same SAN LUN. If more than one ESX/ESXi system uses the same LUN as the diagnostic partition, that LUN must be zoned so that all the servers can access it. Each server needs 100MB of space, so the size of the LUN determines how many servers can share it. Each ESX/ESXi system is mapped to a diagnostic slot. VMware recommends at least 16 slots (1600MB) of disk space if servers share a diagnostic partition. If there is only one diagnostic slot on the device, all ESX/ESXi systems sharing that device map to the same slot. This setup can easily create problems. If two ESX/ESXi systems perform a core dump at the same time, the core dumps are overwritten on the diagnostic partition.

Avoiding and Resolving SAN Problems

When using ESX/ESXi in conjunction with a SAN, you must follow specific guidelines to avoid SAN problems. You should observe these tips for avoiding and resolving problems with your SAN configuration:
n n

Place only one VMFS datastore on each LUN. Multiple VMFS datastores on one LUN is not recommended. Do not change the path policy the system sets for you unless you understand the implications of making such a change.

84

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Document everything. Include information about configuration, access control, storage, switch, server and iSCSI HBA configuration, software and firmware versions, and storage cable plan. Plan for failure:
n

Make several copies of your topology maps. For each element, consider what happens to your SAN if the element fails. Cross off different links, switches, HBAs and other elements to ensure you did not miss a critical failure point in your design.

Ensure that the iSCSI HBAs are installed in the correct slots in the ESX/ESXi host, based on slot and bus speed. Balance PCI bus load among the available busses in the server. Become familiar with the various monitor points in your storage network, at all visibility points, including ESX/ESXi performance charts, Ethernet switch statistics, and storage performance statistics. Be cautious when changing IDs of the LUNs that have VMFS datastores being used by your ESX/ESXi host. If you change the ID, virtual machines running on the VMFS datastore will fail. If there are no running virtual machines on the VMFS datastore, after you change the ID of the LUN, you must use rescan to reset the ID on your host. For information on using rescan, see Perform Storage Rescan, on page 77.

Optimizing SAN Storage Performance

Several factors contribute to optimizing a typical SAN environment. If the network environment is properly configured, the iSCSI components provide adequate throughput and low enough latency for iSCSI initiators and targets. If the network is congested and links, switches or routers are saturated, iSCSI performance suffers and might not be adequate for ESX/ESXi environments.

Storage System Performance

Storage system performance is one of the major factors contributing to the performance of the entire iSCSI environment. If issues occur with storage system performance, consult your storage system vendors documentation for any relevant information. When you assign LUNs, remember that you can access each shared LUN through a number of ESX/ESXi hosts, and that a number of virtual machines can run on each host. One LUN used by an ESX/ESXi host can service I/O from many different applications running on different operating systems. Because of this diverse workload, the RAID group that contains the ESX/ESXi LUNs should not include LUNs that other hosts use that are not running ESX/ESXi for I/O intensive applications. Enable read caching and write caching. Load balancing is the process of spreading server I/O requests across all available SPs and their associated host server paths. The goal is to optimize performance in terms of throughput (I/O per second, megabytes per second, or response times). SAN storage systems require continual redesign and tuning to ensure that I/O is load balanced across all storage system paths. To meet this requirement, distribute the paths to the LUNs among all the SPs to provide optimal load balancing. Close monitoring indicates when it is necessary to manually rebalance the LUN distribution. Tuning statically balanced storage systems is a matter of monitoring the specific performance statistics (such as I/O operations per second, blocks per second, and response time) and distributing the LUN workload to spread the workload across all the SPs. NOTE Dynamic load balancing is not currently supported with ESX/ESXi.

VMware, Inc.

85

iSCSI SAN Configuration Guide

Server Performance
You must consider several factors to ensure optimal server performance. Each server application must have access to its designated storage with the following conditions:
n n n

High I/O rate (number of I/O operations per second) High throughput (megabytes per second) Minimal latency (response times)

Because each application has different requirements, you can meet these goals by choosing an appropriate RAID group on the storage system. To achieve performance goals, perform the following tasks:
n

Place each LUN on a RAID group that provides the necessary performance levels. Pay attention to the activities and resource utilization of other LUNS in the assigned RAID group. A high-performance RAID group that has too many applications doing I/O to it might not meet performance goals required by an application running on the ESX/ESXi host. Provide each server with a sufficient number of network adapters or iSCSI hardware adapters to allow maximum throughput for all the applications hosted on the server for the peak period. I/O spread across multiple ports provides higher throughput and less latency for each application. To provide redundancy for software iSCSI, make sure the initiator is connected to all network adapters used for iSCSI connectivity. When allocating LUNs or RAID groups for ESX/ESXi systems, multiple operating systems use and share that resource. As a result, the performance required from each LUN in the storage subsystem can be much higher if you are working with ESX/ESXi systems than if you are using physical machines. For example, if you expect to run four I/O intensive applications, allocate four times the performance capacity for the ESX/ESXi LUNs. When using multiple ESX/ESXi systems in conjunction with vCenter Server, the performance needed from the storage subsystem increases correspondingly. The number of outstanding I/Os needed by applications running on an ESX/ESXi system should match the number of I/Os the SAN can handle.

Network Performance
A typical SAN consists of a collection of computers connected to a collection of storage systems through a network of switches. Several computers often access the same storage. Figure 5-2 shows several computer systems connected to a storage system through an Ethernet switch. In this configuration, each system is connected through a single Ethernet link to the switch, which is also connected to the storage system through a single Ethernet link. In most configurations, with modern switches and typical traffic, this is not a problem. Figure 5-2. Single Ethernet Link Connection to Storage

86

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

When systems read data from storage, the maximum response from the storage is to send enough data to fill the link between the storage systems and the Ethernet switch. It is unlikely that any single system or virtual machine gets full use of the network speed, but this situation can be expected when many systems share one storage device. When writing data to storage, multiple systems or virtual machines might attempt to fill their links. As Figure 5-3 shows, when this happens, the switch between the systems and the storage system has to drop data. This happens because, while it has a single connection to the storage device, it has more traffic to send to the storage system than a single link can carry. In this case, the switch drops network packets because the amount of data it can transmit is limited by the speed of the link between it and the storage system. Figure 5-3. Dropped Packets
1 Gbit 1 Gbit

1 Gbit dropped packets

Recovering from dropped network packets results in large performance degradation. In addition to time spent determining that data was dropped, the retransmission uses network bandwidth that could otherwise be used for current transactions. iSCSI traffic is carried on the network by the Transmission Control Protocol (TCP). TCP is a reliable transmission protocol that ensures that dropped packets are retried and eventually reach their destination. TCP is designed to recover from dropped packets and retransmits them quickly and seamlessly. However, when the switch discards packets with any regularity, network throughput suffers significantly. The network becomes congested with requests to resend data and with the resent packets, and less data is actually transferred than in a network without congestion. Most Ethernet switches can buffer, or store, data and give every device attempting to send data an equal chance to get to the destination. This ability to buffer some transmissions, combined with many systems limiting the number of outstanding commands, allows small bursts from several systems to be sent to a storage system in turn. If the transactions are large and multiple servers are trying to send data through a single switch port, a switch's ability to buffer one request while another is transmitted can be exceeded. In this case, the switch drops the data it cannot send, and the storage system must request retransmission of the dropped packet. For example, if an Ethernet switch can buffer 32KB on an input port, but the server connected to it thinks it can send 256KB to the storage device, some of the data is dropped. Most managed switches provide information on dropped packets, similar to the following:
*: interface is up IHQ: pkts in input hold queue OHQ: pkts in output hold queue RXBS: rx rate (bits/sec) TXBS: tx rate (bits/sec) TRTL: throttle count IQD: pkts dropped from input queue OQD: pkts dropped from output queue RXPS: rx rate (pkts/sec) TXPS: tx rate (pkts/sec)

Table 5-7. Sample Switch Information

Interface * GigabitEt hernet0/1 IHQ 3 IQD 9922 OHQ 0 OQD 0 RXBS 47630300 0 RXPS 62273 TXBS 47784000 0 TXPS 63677 TRTL 0

VMware, Inc.

87

iSCSI SAN Configuration Guide

In this example from a Cisco switch, the bandwidth used is 476303000 bits/second, which is less than half of wire speed. In spite of this, the port is buffering incoming packets and has dropped quite a few packets. The final line of this interface summary indicates that this port has already dropped almost 10,000 inbound packets in the IQD column. Configuration changes to avoid this problem involve making sure several input Ethernet links are not funneled into one output link, resulting in an oversubscribed link. When a number of links transmitting near capacity are switched to a smaller number of links, oversubscription is a possibility. Generally, applications or systems that write a lot of data to storage, such as data acquisition or transaction logging systems, should not share Ethernet links to a storage device. These types of applications perform best with multiple connections to storage devices. Figure 5-4 shows multiple connections from the switch to the storage. Figure 5-4. Multiple Connections from Switch to Storage
1 Gbit 1 Gbit 1 Gbit 1 Gbit

Using VLANs or VPNs does not provide a suitable solution to the problem of link oversubscription in shared configurations. VLANs and other virtual partitioning of a network provide a way of logically designing a network, but do not change the physical capabilities of links and trunks between switches. When storage traffic and other network traffic end up sharing physical connections, as they would with a VPN, the possibility for oversubscription and lost packets exists. The same is true of VLANs that share interswitch trunks. Performance design for a SANs must take into account the physical limitations of the network, not logical allocations.

Resolving Performance Issues

The vSphere Client offers extensive facilities for collecting performance information. The information is graphically displayed in the vSphere Client. The vSphere Client updates its display periodically. You can also use the resxtop vSphere CLI command that allows you to examine how ESX/ESXi hosts use resources. For information about resxtop, see the Resource Management Guide or the vSphere Command-Line Interface Installation and Scripting Guide.

Checking Ethernet Switch Statistics

Many Ethernet switches provide different methods for monitoring switch health. Switches that have ports operating near maximum throughput much of the time do not provide optimum performance. If you have ports in your iSCSI SAN running near the maximum, reduce the load. If the port is connected to an ESX/ESXi system or iSCSI storage, you can reduce the load by using manual load balancing. If the port is connected between multiple switches or routers, consider installing additional links between these components to handle more load. Ethernet switches also commonly provide information about transmission errors, queued packets, and dropped Ethernet packets. If the switch regularly reports any of these conditions on ports being used for iSCSI traffic, performance of the iSCSI SAN will be poor.

88

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Resolving Path Thrashing

If your server is unable to access a LUN, or access is very slow, you might have a problem with path thrashing, also called LUN thrashing. Path thrashing might occur when two hosts access the LUN through different SPs and, as a result, the LUN is never actually available. Only specific SAN configurations in conjunction with the following conditions can cause the path thrashing:
n

You are working with an active-passive array. Path thrashing only occurs on active-passive arrays. For active-active arrays or arrays that provide transparent failover, path thrashing does not occur. Two hosts access the same LUN using different storage processors (SPs). This can happen in two ways.
n

For example, the LUN is configured to use the Fixed PSP. On Host A, the preferred path to the LUN is set to use a path through SP A. On Host B, the preferred path to the LUN is configured to use a path through SP B. Path thrashing can also occur if Host A can access the LUN only with paths through SP A, while Host B can access the LUN only with paths through SP B.

This problem can also occur on a direct connect array (such as AX100) with HBA failover on one or more nodes. Path thrashing is a problem that you typically do not experience with other operating systems. No other common operating system uses shared LUNs for more than two servers. That setup is typically reserved for clustering. If only one server is issuing I/Os to the LUN at a time, path thrashing does not become a problem. In contrast, multiple ESX/ESXi systems might issue I/O to the same LUN concurrently.

Understanding Path Thrashing

The SPs in a storage array are like independent computers that have access to some shared storage. Algorithms determine how concurrent access is handled. For active-passive arrays, only one SP at a time can access all the sectors on the storage that make up a given LUN. The ownership is passed between the storage processors. Storage systems use caches and SP A must not write anything to disk that invalidates the SP B cache. Because the SP has to flush the cache when it finishes the operation, it takes a little time to move the ownership. During that time, neither SP can process I/O to the LUN. For active-active arrays, the algorithms allow more fine-grained access to the storage and synchronize caches. Access can happen concurrently through any SP without extra time required. Consider how path selection works:
n n

On an active-active array the ESX/ESXi system starts sending I/O down the new path. On an active-passive arrays, the ESX/ESXi system checks all standby paths. The SP of the path that is currently under consideration sends information to the system on whether it currently owns the LUN.
n

If the ESX/ESXi system finds an SP that owns the LUN, that path is selected and I/O is sent down that path. If the ESX/ESXi host cannot find such a path, the ESX/ESXi host picks one of the standby paths and sends the SP of that path a command to move the LUN ownership to the SP.

Path thrashing can occur as a result of the following path choice: If server A can reach a LUN only through one SP, and server B can reach the same LUN only through a different SP, they both continually cause the ownership of the LUN to move between the two SPs, effectively ping-ponging the ownership of the LUN. Because the system moves the ownership quickly, the storage array cannot process any I/O (or can process only very little). As a result, any servers that depend on the LUN will experience low throughput due to the long time it takes to complete each I/O request.

VMware, Inc.

89

iSCSI SAN Configuration Guide

Resolve Path Thrashing

Use this procedure to resolve path thrashing. Path thrashing occurs on active-passive arrays when two hosts access the LUN through different SPs and, as a result, the LUN is never actually available. Procedure 1 2 3 Ensure that all hosts sharing the same set of LUNs on the active-passive arrays use the same storage processor. Correct any cabling or masking inconsistencies between different ESX/ESXi hosts and SAN targets so that all HBAs see the same targets. Configure the path to use the Most Recently Used PSP (the default) or VMW_PSP_FIXED_AP.

Equalize Disk Access Between Virtual Machines

You can adjust the maximum number of outstanding disk requests with the Disk.SchedNumReqOutstanding parameter in the vSphere Client. When two or more virtual machines are accessing the same LUN, this parameter controls the number of outstanding requests that each virtual machine can issue to the LUN. Adjusting the limit can help equalize disk access between virtual machines. This limit does not apply when only one virtual machine is active on a LUN. In that case, the bandwidth is limited by the queue depth of the storage adapter. Procedure 1 2 3 4 In the vSphere Client, select the host in the inventory panel. Click the Configuration tab and click Advanced Settings under Software. Click Disk in the left panel and scroll down to Disk.SchedNumReqOutstanding. Change the parameter value to the number of your choice and click OK.

This change can impact disk bandwidth scheduling, but experiments have shown improvements for diskintensive workloads. What to do next If you adjust this value in the VMkernel, you might also want to adjust the queue depth in your storage adapter.

Set Maximum Queue Depth for Software iSCSI

If you notice unsatisfactory performance for your software iSCSI LUNs, you can change their maximum queue depth by using the vicfg-module command. Procedure 1 On the vSphere CLI, run the following command:
vicfg-module -s iscsivmk_LunQDepth=value iscsi_vmk

The iscsivmk_LunQDepth parameter sets the maximum number of outstanding commands, or queue depth, for each LUN accessed through the software iSCSI adapter. The default value is 128. 2 Reboot your system.

CAUTION Setting the queue depth to a value higher than the default can decrease the total number of LUNs supported.

90

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Reducing SCSI Reservations

Operations that require getting a file lock or a metadata lock in VMFS result in short-lived SCSI reservations. SCSI reservations lock an entire LUN. Excessive SCSI reservations by a server can cause performance degradation on other servers accessing the same VMFS. Examples of operations that require getting file locks or metadata locks include:
n n n n

Virtual machine power on. vMotion. Virtual machines running with virtual disk snapshots. File operations that require opening files or doing metadata updates.

NOTE ESX/ESXi uses the SCSI reservations mechanism only when a LUN is not VAAI capable. If a LUN is VAAI capable and supports Hardware Acceleration, ESX/ESXi uses atomic test and set (ATS) algorithm to lock the LUN. Performance degradation can occur if such operations occur frequently on multiple servers accessing the same VMFS. For instance, VMware recommends that you do not run many virtual machines from multiple servers that are using virtual disk snapshots on the same VMFS. Limit the number of VMFS file operations when many virtual machines run on the VMFS.

SAN Storage Backup Considerations

In the SAN environment, backups have two goals. The first goal is to archive online data to offline media. This process is repeated periodically for all online data on a time schedule. The second goal is to provide access to offline data for recovery from a problem. For example, database recovery often requires retrieval of archived log files that are not currently online. Scheduling a backup depends on a number of factors:
n

Identification of critical applications that require more frequent backup cycles within a given period of time. Recovery point and recovery time goals. Consider how precise your recovery point needs to be, and how long you are willing to wait for it. The rate of change (RoC) associated with the data. For example, if you are using synchronous/asynchronous replication, the RoC affects the amount of bandwidth required between the primary and secondary storage devices. Overall impact on SAN environment, storage performance (while backing up), and other applications. Identification of peak traffic periods on the SAN (backups scheduled during those peak periods can slow the applications and the backup process). Time to schedule all backups within the datacenter. Time it takes to back up an individual application. Resource availability for archiving data; usually offline media access (tape).

n n

n n n

Include a recovery-time objective for each application when you design your backup strategy. That is, consider the time and resources necessary to reprovision the data. For example, if a scheduled backup stores so much data that recovery requires a considerable amount of time, examine the scheduled backup. Perform the backup more frequently, so that less data is backed up at a time and the recovery time decreases.

VMware, Inc.

91

iSCSI SAN Configuration Guide

If a particular application requires recovery within a certain time frame, the backup process needs to provide a time schedule and specific data processing to meet this requirement. Fast recovery can require the use of recovery volumes that reside on online storage to minimize or eliminate the need to access slow offline media for missing data components.

Snapshot Software
Snapshot software allows an administrator to make an instantaneous copy of any single virtual disk defined within the disk subsystem. Snapshot software is available at different levels:
n

ESX/ESXi hosts allow you to create snapshots of virtual machines. This software is included in the basic ESX/ESXi package. Third-party backup software might allow for more comprehensive backup procedures and might contain more sophisticated configuration options.

Administrators make snapshots for a variety of reasons:

n n n n n

Backup Disaster recovery Availability of multiple configurations, versions, or both Forensics (looking at a snapshot to find the cause of problems while your system is running) Data mining (looking at a copy of your data to reduce load on production systems)

Using a Third-Party Backup Package

Using third-party software has the advantage of a uniform environment. However, the additional cost of the third-party snapshotting software can become higher as your SAN grows. If you are using third-party backup software, make sure that the software is supported with ESX/ESXi hosts. If you use snapshots to back up your data, consider the following points:
n

Some vendors support snapshots for both VMFS and RDMs. If both are supported, you can make either a snapshot of the whole virtual machine file system for a host, or snapshots for the individual virtual machines (one per disk). Some vendors support snapshots only for a setup using RDM. If only RDM is supported, you can make snapshots of individual virtual machines.

See your storage vendors documentation. NOTE ESX/ESXi systems also include a Consolidated Backup component.

Layered Applications
SAN administrators customarily use specialized array-based software for backup, disaster recovery, data mining, forensics, and configuration testing. Storage providers typically supply two types of advanced services for their LUNs: snapshotting and replication. When you use an ESX/ESXi system in conjunction with a SAN, you must decide whether array-based or hostbased tools are more suitable for your particular situation.

92

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Array-Based (Third-Party) Solution

When you use an ESX/ESXi system in conjunction with a SAN, you must decide whether array-based tools are more suitable for your particular situation. When you consider an array-based solution, keep in mind the following points:
n

Array-based solutions usually result in more comprehensive statistics. With RDM, data always takes the same path, which results in easier performance management. Security is more transparent to the storage administrator when you use RDM and an array-based solution because with RDM, virtual machines more closely resemble physical machines. If you use an array-based solution, physical compatibility RDMs are often used for the storage of virtual machines. If you do not intend to use RDM, check the storage vendor documentation to see if operations on LUNs with VMFS volumes are supported. If you use array operations on VMFS LUNs, carefully read the section on resignaturing.

File-Based (VMFS) Solution

When you use an ESX/ESXi system in conjunction with a SAN, you must decide whether host-based tools are more suitable for your particular situation. When you consider a file-based solution that uses VMware tools and VMFS instead of the array tools, be aware of the following points:
n

Using VMware tools and VMFS is better for provisioning. One large LUN is allocated and multiple .vmdk files can be placed on that LUN. With RDM, a new LUN is required for each virtual machine. Snapshotting is included with your ESX/ESXi host at no extra cost. The file-based solution is therefore more cost-effective than the array-based solution. Using VMFS is easier for ESX/ESXi administrators. ESX/ESXi administrators who use the file-based solution are more independent from the SAN administrator.

n n

Managing Duplicate VMFS Datastores

When a LUN contains a VMFS datastore copy, you can mount the datastore with the existing signature or assign a new signature. Each VMFS datastore created in a LUN has a unique UUID that is stored in the file system superblock. When the LUN is replicated or snapshotted, the resulting LUN copy is identical, byte-for-byte, with the original LUN. As a result, if the original LUN contains a VMFS datastore with UUID X, the LUN copy appears to contain an identical VMFS datastore, or a VMFS datastore copy, with exactly the same UUID X. ESX/ESXi can determine whether a LUN contains the VMFS datastore copy, and either mount the datastore copy with its original UUID or change the UUID, thus resignaturing the datastore.

Mounting VMFS Datastores with Existing Signatures

You might not have to resignature a VMFS datastore copy. You can mount a VMFS datastore copy without changing its signature. For example, you can maintain synchronized copies of virtual machines at a secondary site as part of a disaster recovery plan. In the event of a disaster at the primary site, you can mount the datastore copy and power on the virtual machines at the secondary site. IMPORTANT You can mount a VMFS datastore copy only if it does not collide with the original VMFS datastore that has the same UUID. To mount the copy, the original VMFS datastore has to be offline.

VMware, Inc.

93

iSCSI SAN Configuration Guide

When you mount the VMFS datastore, ESX/ESXi allows both reads and writes to the datastore residing on the LUN copy. The LUN copy must be writable. The datastore mounts are persistent and valid across system reboots. Because ESX/ESXi does not allow you to resignature the mounted datastore, unmount the datastore before resignaturing.

Mount a VMFS Datastore with an Existing Signature

If you do not need to resignature a VMFS datastore copy, you can mount it without changing its signature. Prerequisites Before you mount a VMFS datastore, perform a storage rescan on your host so that it updates its view of LUNs presented to it. Procedure 1 2 3 4 5 Log in to the vSphere Client and select the server from the inventory panel. Click the Configuration tab and click Storage in the Hardware panel. Click Add Storage. Select the Disk/LUN storage type and click Next. From the list of LUNs, select the LUN that has a datastore name displayed in the VMFS Label column and click Next. The name present in the VMFS Label column indicates that the LUN is a copy that contains a copy of an existing VMFS datastore. 6 7 Under Mount Options, select Keep Existing Signature. In the Ready to Complete page, review the datastore configuration information and click Finish.

What to do next If you later want to resignature the mounted datastore, you must unmount it first.

Unmount Datastores
When you unmount a datastore, it remains intact, but can no longer be seen from the hosts that you specify. It continues to appear on other hosts, where it remains mounted. You can unmount only the following types of datastores:
n n

NFS datastores VMFS datastore copies mounted without resignaturing

You cannot unmount an active mounted datastore. Procedure 1 2 Display the datastores. Right-click the datastore to unmount and select Unmount.

94

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

If the datastore is shared, specify which hosts should no longer access the datastore. a If needed, deselect the hosts where you want to keep the datastore mounted. By default, all hosts are selected. b c Click Next. Review the list of hosts from which to unmount the datastore, and click Finish.

Confirm that you want to unmount the datastore.

Resignaturing VMFS Copies

Use datastore resignaturing to retain the data stored on the VMFS datastore copy. When resignaturing a VMFS copy, ESX/ESXi assigns a new UUID and a new label to the copy, and mounts the copy as a datastore distinct from the original. The default format of the new label assigned to the datastore is snap-snapID-oldLabel, where snapID is an integer and oldLabel is the label of the original datastore. When you perform datastore resignaturing, consider the following points:
n n n n n

Datastore resignaturing is irreversible. The LUN copy that contains the VMFS datastore that you resignature is no longer treated as a LUN copy. A spanned datastore can be resignatured only if all its extents are online. The resignaturing process is crash and fault tolerant. If the process is interrupted, you can resume it later. You can mount the new VMFS datastore without a risk of its UUID colliding with UUIDs of any other datastore, such as an ancestor or child in a hierarchy of LUN snapshots.

Resignature a VMFS Datastore Copy

Use datastore resignaturing if you want to retain the data stored on the VMFS datastore copy. Prerequisites To resignature a mounted datastore copy, first unmount it. Before you resignature a VMFS datastore, perform a storage rescan on your host so that the host updates its view of LUNs presented to it and discovers any LUN copies. Procedure 1 2 3 4 5 Log in to the vSphere Client and select the server from the inventory panel. Click the Configuration tab and click Storage in the Hardware panel. Click Add Storage. Select the Disk/LUN storage type and click Next. From the list of LUNs, select the LUN that has a datastore name displayed in the VMFS Label column and click Next. The name present in the VMFS Label column indicates that the LUN is a copy that contains a copy of an existing VMFS datastore. 6 7 Under Mount Options, select Assign a New Signature and click Next. In the Ready to Complete page, review the datastore configuration information and click Finish.

VMware, Inc.

95

iSCSI SAN Configuration Guide

What to do next After resignaturing, you might have to do the following:

n

If the resignatured datastore contains virtual machines, update references to the original VMFS datastore in the virtual machine files, including .vmx, .vmdk, .vmsd, and .vmsn. To power on virtual machines, register them with vCenter Server.

Storage Hardware Acceleration

The hardware acceleration functionality enables your host to offload specific virtual machine and storage management operations to compliant storage hardware. With the storage hardware assistance, your host performs these operations faster and consumes less CPU, memory, and storage fabric bandwidth. To implement the hardware acceleration functionality, the Pluggable Storage Architecture (PSA) uses a combination of special array integration plug-ins, called VAAI plug-ins, and an array integration filter, called VAAI filter. The PSA automatically attaches the VAAI filter and vendor-specific VAAI plug-ins to those storage devices that support the hardware acceleration. To view and manage the VAAI filter and VAAI plug-ins available on your host, use the vSphere CLI commands. You can find some information about managing the VAAI filter and VAAI plug-ins in Managing Hardware Acceleration Filter and Plug-Ins, on page 110. For descriptions of the commands, see the vSphere Command-Line Interface Installation and Scripting Guide and the vSphere Command-Line Interface Reference.

Hardware Acceleration Requirements and Benefits

The hardware acceleration functionality works only if you use an appropriate host and storage array combination. Use the following hosts and storage arrays:
n n

ESX/ESXi version 4.1 or later. Storage arrays that support storage-based hardware acceleration. ESX/ESXi version 4.1 does not support hardware acceleration with NAS storage devices.

On your host, the hardware acceleration is enabled by default. To enable the hardware acceleration on the storage side, check with your storage vendor. Certain storage arrays require that you explicitly activate the hardware acceleration support on the storage side. When the hardware acceleration functionality is supported, the host can get hardware assistance and perform the following operations faster and more efficiently:
n n n n n n

Migration of virtual machines with Storage vMotion Deployment of virtual machines from templates Cloning of virtual machines or templates VMFS clustered locking and metadata operations for virtual machine files Writes to thin provisioned and thick virtual disks Creation of fault-tolerant virtual machines

96

VMware, Inc.

Chapter 5 Managing ESX/ESXi Systems That Use SAN Storage

Hardware Acceleration Support Status

For each storage device and datastore, the vSphere Client displays the hardware acceleration support status in the Hardware Acceleration column of the Devices view and the Datastores view. The status values are Unknown, Supported, and Not Supported. The initial value is Unknown. The status changes to Supported after the host successfully performs the offload operation. If the offload operation fails, the status changes to Not Supported. When storage devices do not support or provide only partial support for the host operations, your host reverts to its native methods to perform unsupported operations.

Turn off Hardware Acceleration

If your storage devices do not support the hardware acceleration functionality, you can turn it off by using the vSphere Client advanced settings. As with any advanced settings, before disabling the hardware acceleration, consult with the VMware support team. Procedure 1 2 3 4 In the vSphere Client inventory panel, select the host. Click the Configuration tab, and click Advanced Settings under Software. Click VMFS3 and change the value in the VMFS3.HardwareAcceleratedLocking field to zero. Click DataMover and change the values in each of the following fields to zero:
n n

DataMover.HardwareAcceleratedMove DataMover.HardwareAcceleratedInit

Click OK to save your changes.

VMware, Inc.

97

iSCSI SAN Configuration Guide

98

VMware, Inc.

iSCSI SAN Configuration Checklist

This topic provides a checklist of special setup requirements for different storage systems and ESX/ESXi hosts. Table A-1. iSCSI SAN Configuration Requirements
Component All storage systems Topology EMC Symmetrix EMC Clariion HP MSA HP EVA Comments Write cache must be disabled if not battery backed. No single failure should cause HBA and SP failover, especially with active-passive storage arrays. Enable the SPC2 and SC3 settings. Contact EMC for the latest settings. Set the EMC Clariion failover mode to 1 or 4. Contact EMC for details. No specific requirements For EVA3000/5000 firmware 4.001 and later, and EVA4000/6000/8000 firmware 5.031 and later, set the host type to VMware. Otherwise, set the host mode type to Custom. The value is:
n n

EVA3000/5000 firmware 3.x: 000000002200282E EVA4000/6000/8000: 000000202200083E

NetApp EqualLogic LeftHand ESX/ESXi Configuration

If any of your iSCSI initiators are a part of an initiator group (igroup), disable ALUA on the NetApp array. Make sure ARP Redirect is enabled on hardware iSCSI adapters. Make sure ARP Redirect is enabled on hardware iSCSI adapters. Set the following Advanced Settings for the ESX/ESXi host: n Set Disk.UseLunReset to 1 n Set Disk.UseDeviceReset to 0 A multipathing policy of Most Recently Used must be set for all LUNs hosting clustered disks for active-passive arrays. A multipathing policy of Most Recently Used or Fixed may be set for LUNs on active-active arrays. Allow ARP redirection if the storage system supports transparent failover.

VMware, Inc.

99

iSCSI SAN Configuration Guide

100

VMware, Inc.

VMware vSphere Command-Line Interface

In most cases, the vSphere Client is well-suited for monitoring an ESX/ESXi host connected to SAN storage. Advanced users might, at times, want to use some VMware vSphere Command-Line Interface (vSphere CLI) commands for additional details. For more information, see vSphere Command-Line Interface Installation and Scripting Guide. This appendix includes the following topics:
n n n n n

resxtop Command, on page 101 vicfg-iscsi Command, on page 101 vicfg-mpath Command, on page 101 esxcli corestorage claimrule Command, on page 102 vmkping Command, on page 102

resxtop Command
The resxtop command provides a detailed look at ESX/ESXi resource use in real time. For detailed information about resxtop, see the Resource Management Guide and vSphere Command-Line Interface Installation and Scripting Guide.

vicfg-iscsi Command
The vicfg-iscsi command allows you to configure software or hardware iSCSI on ESX/ESXi hosts, set up CHAP parameters, and set up iSCSI networking. For details, see the vSphere Command-Line Interface Installation and Scripting Guide and the vSphere CommandLine Interface Reference.

vicfg-mpath Command
Use the vicfg-mpath command to view information about storage devices, paths, and multipathing plug-ins. For details, see the vSphere Command-Line Interface Installation and Scripting Guide and the vSphere CommandLine Interface Reference.

VMware, Inc.

101

iSCSI SAN Configuration Guide

esxcli corestorage claimrule Command

Use the esxcli corestorage claimrule command to manage claim rules. Claim rules determine which multipathing module should claim paths to a particular device and manage the device. For details, see the vSphere Command-Line Interface Installation and Scripting Guide and the vSphere CommandLine Interface Reference.

vmkping Command
The vmkping command allows you to verify the VMkernel networking configuration. Usage example:
vmkping [options] [host|IP address]

Table B-1. vmkping Options

Option -6 -4 -I -D -c count -I interval -s size -d -v Description Use IPv6 - ICMPv6 Echo request. Use IPv4 (default). Outgoing interface - for IPv6 scope. VMkernel TCP stack debug mode. Set packet count. Set interval. Set send size. Set DF bit on IPv4 packets. Verbose.

102

VMware, Inc.

Managing Multipathing Modules and Hardware Acceleration Plug-Ins

Use the vSphere CLI to manage the Pluggable Storage Architecture (PSA) multipathing plug-ins and Hardware Acceleration plug-ins. This appendix includes the following topics:
n n n

Managing Storage Paths and Multipathing Plug-Ins, on page 103 Managing Hardware Acceleration Filter and Plug-Ins, on page 110 esxcli corestorage claimrule Options, on page 113

Managing Storage Paths and Multipathing Plug-Ins

Using the vSphere CLI you can manage the PSA multipathing plug-ins and storage paths assigned to them. You can display all multipathing plug-ins available on your host. You can list any third-party MPPs, as well as your host's NMP and SATPs and review the paths they claim. You can also define new paths and specify which multipathing plug-in should claim the paths. For more information about commands available to manage PSA, see the vSphere Command-Line Interface Installation and Scripting Guide and the vSphere Command-Line Interface Reference.

List Multipathing Claim Rules for the Host

Use the vSphere CLI to list available multipathing claim rules. Claim rules indicate which multipathing plug-in, the NMP or any third-party MPP, manages a given physical path. Each claim rule identifies a set of paths based on the following parameters:
n n n n

Vendor/model strings Transportation, such as SATA, IDE, Fibre Channel, and so on Adapter, target, or LUN location Device driver, for example, Mega-RAID

Procedure
u

Use the esxcli corestorage claimrule list --claimrule-class=MP to list the multipathing claim rules. Example: Sample Output of the esxcli corestorage claimrule list Command, on page 104 shows the output of the command.

VMware, Inc.

103

iSCSI SAN Configuration Guide

Example: Sample Output of the esxcli corestorage claimrule list Command

Rule Class MP MP MP MP MP MP MP MP MP MP MP MP MP MP Rule 0 1 2 3 4 101 101 200 200 201 201 202 202 65535 Class runtime runtime runtime runtime runtime runtime file runtime file runtime file runtime file runtime Type transport transport transport transport transport vendor vendor vendor vendor location location driver driver vendor Plugin NMP NMP NMP NMP NMP MASK_PATH MASK_PATH MPP_1 MPP_1 MPP_2 MPP_2 MPP_3 MPP_3 NMP Matches transport=usb transport=sata transport=ide transport=block transport=unknown vendor=DELL model=Universal Xport vendor=DELL model=Universal Xport vendor=NewVend model=* vendor=NewVend model=* adapter=vmhba41 channel=* target=* lun=* adapter=vmhba41 channel=* target=* lun=* driver=megaraid driver=megaraid vendor=* model=*

This example indicates the following:

n

The NMP claims all paths connected to storage devices that use the USB, SATA, IDE, and Block SCSI transportation. The MASK_PATH module by default claims all paths returning SCSI inquiry data with a vendor string of DELL and a model string of Universal Xport. The MASK_PATH module is used to mask paths from your host. The MPP_1 module claims all paths connected to any model of the NewVend storage array. The MPP_3 module claims the paths to storage devices controlled by the Mega-RAID device driver. Any paths not described in the previous rules are claimed by NMP. The Rule Class column in the output describes the category of a claim rule. It can be MP (multipathing plug-in), Filter, or VAAI. The Class column shows which rules are defined and which are loaded. The file parameter in the Class column indicates that the rule is defined. The runtime parameter indicates that the rule has been loaded into your system. For a user-defined claim rule to be active, two lines with the same rule number should exist, one line for the rule with the file parameter and another line with runtime. Several low numbered rules have only one line with the Class of runtime. These are system-defined claim rules that you cannot modify.

n n n n

Display Multipathing Modules

Use the vSphere CLI to list all multipathing modules loaded into the system. Multipathing modules manage physical paths that connect your host with storage. Procedure
u

To list all multipathing modules, run the following command:

esxcli corestorage plugin list --plugin-class=MP

At a minimum, this command returns the NMP and the MASK_PATH modules. If any third-party MPPs have been loaded, they are listed as well.

104

VMware, Inc.

Appendix C Managing Multipathing Modules and Hardware Acceleration Plug-Ins

Display SATPs for the Host

Use the vSphere CLI to list all VMware NMP SATPs loaded into the system. Procedure
u

To list all VMware SATPs, run the following command.

esxcli nmp satp list

For each SATP, the command displays information that shows the type of storage array or system this SATP supports and the default PSP for any LUNs using this SATP. Keep in mind the following:
n

If no SATP is assigned to the device by the claim rules, the default SATP for iSCSI or FC devices is VMW_SATP_DEFAULT_AA. The default PSP is VMW_PSP_FIXED. If VMW_SATP_ALUA is assigned to a specific storage device, but the device is not ALUA-aware, there is no claim rule match for this device. In this case, the device is claimed by the default SATP based on the device's transport type. The default PSP for all devices claimed by VMW_SATP_ALUA is VMW_PSP_MRU. The VMW_PSP_MRU selects an active/optimized path as reported by the VMW_SATP_ALUA, or an active/unoptimized path if there is no active/optimized path. This path is used until a better path is available (MRU). For example, if the VMW_PSP_MRU is currently using an active/unoptimized path and an active/optimized path becomes available, the VMW_PSP_MRU will switch the current path to the active/optimized one.

Display NMP Storage Devices

Use vSphere CLI to list all storage devices controlled by the VMware NMP and display SATP and PSP information associated with each device. Procedure 1 To list all storage devices, run the following command:
esxcli nmp device list

To show information for a specific device, run the following:

esxcli nmp device list -d device_ID

Add Multipathing Claim Rules

Use the vSphere CLI to add a new multipathing PSA claim rule to the set of claim rules on the system. For the new claim rule to be active, you first define the rule and then load it into your system. You add a new PSA claim rule when, for example, you load a new multipathing plug-in (MPP) and need to define which paths this module should claim. You may need to create a claim rule if you add new paths and want an existing MPP to claim them. CAUTION When creating new claim rules, be careful to avoid a situation when different physical paths to the same LUN are claimed by different MPPs. Unless one of the MPPs is the MASK_PATH MPP, this configuration will cause performance problems.

VMware, Inc.

105

iSCSI SAN Configuration Guide

Procedure 1 To define a new claim rule, on the vSphere CLI, run the following command:
esxcli corestorage claimrule add

For information on the options that the command requires, see esxcli corestorage claimrule Options, on page 113. 2 To load the new claim rule into your system, run the following command:
esxcli corestorage claimrule load

This command loads all newly created multipathing claim rules from your system's configuration file.

Example: Defining Multipathing Claim Rules

n

Add rule # 500 to claim all paths with the NewMod model string and the NewVend vendor string for the NMP plug-in.
# esxcli corestorage claimrule add -r 500 -t vendor -V NewVend -M NewMod -P NMP

After you load the claim rule and run the esxcli corestorage claimrule list command, you can see the new claim rule appearing on the list. NOTE The two lines for the claim rule, one with the Class of runtime and another with the Class of file, indicate that the new claim rule has been loaded into the system and is active.
Rule Class MP MP MP MP MP MP MP MP MP n Rule 0 1 2 3 4 101 101 500 500 Class runtime runtime runtime runtime runtime runtime file runtime file Type transport transport transport transport transport vendor vendor vendor vendor Plugin NMP NMP NMP NMP NMP MASK_PATH MASK_PATH NMP NMP Matches transport=usb transport=sata transport=ide transport=block transport=unknown vendor=DELL model=Universal Xport vendor=DELL model=Universal Xport vendor=NewVend model=NewMod vendor=NewVend model=NewMod

Add rule # 321 to claim the path on adapter vmhba0, channel 0, target 0, LUN 0 for the NMP plug-in.
# esxcli corestorage claimrule add -r 321 -t location -A vmhba0 -C 0 -T 0 -L 0 -P NMP

Add rule # 1015 to claim all paths provided by Fibre Channel adapters for the NMP plug-in.
# esxcli corestorage claimrule add -r 1015 -t transport -R fc -P NMP

Add a rule with a system assigned rule id to claim all paths provided by Fibre Channel type adapters for the NMP plug-in.
# esxcli corestorage claimrule add --autoassign -t transport -R fc -P NMP

106

VMware, Inc.

Appendix C Managing Multipathing Modules and Hardware Acceleration Plug-Ins

Delete Multipathing Claim Rules

Use the vSphere CLI to remove a multipathing PSA claim rule from the set of claim rules on the system. Procedure 1 Delete a claim rule from the set of claim rules.
esxcli corestorage claimrule delete -r claimrule_ID

For information on the options that the command takes, see esxcli corestorage claimrule Options, on page 113. NOTE By default, the PSA claim rule 101 masks Dell array pseudo devices. Do not delete this rule, unless you want to unmask these devices. 2 Remove the claim rule from the ESX/ESXi system.
esxcli corestorage claimrule load

Mask Paths
You can prevent the ESX/ESXi host from accessing storage devices or LUNs or from using individual paths to a LUN. Use the vSphere CLI commands to mask the paths. When you mask paths, you create claim rules that assign the MASK_PATH plug-in to the specified paths. Procedure 1 Check what the next available rule ID is.
esxcli corestorage claimrule list

The claim rules that you use to mask paths should have rule IDs in the range of 101 200. If this command shows that rule 101 and 102 already exist, you can specify 103 for the rule to add. 2 Assign the MASK_PATH plug-in to a path by creating a new claim rule for the plug-in.
esxcli corestorage claimrule add -P MASK_PATH

For information on command-line options, see esxcli corestorage claimrule Options, on page 113. 3 Load the MASK_PATH claim rule into your system.
esxcli corestorage claimrule load

Verify that the MASK_PATH claim rule was added correctly.

esxcli corestorage claimrule list

If a claim rule for the masked path exists, remove the rule.
esxcli corestorage claiming unclaim

Run the path claiming rules.

esxcli corestorage claimrule run

After you assign the MASK_PATH plug-in to a path, the path state becomes irrelevant and is no longer maintained by the host. As a result, commands that display the masked path's information might show the path state as dead.

VMware, Inc.

107

iSCSI SAN Configuration Guide

Example: Masking a LUN

In this example, you mask the LUN 20 on targets T1 and T2 accessed through storage adapters vmhba2 and vmhba3. 1 2
#esxcli corestorage claimrule list #esxcli #esxcli #esxcli #esxcli corestorage corestorage corestorage corestorage claimrule claimrule claimrule claimrule add add add add -P -P -P -P MASK_PATH MASK_PATH MASK_PATH MASK_PATH -r -r -r -r 109 110 111 112 -t -t -t -t location location location location -A -A -A -A vmhba2 vmhba3 vmhba2 vmhba3 -C -C -C -C 0 0 0 0 -T -T -T -T 1 1 2 2 -L -L -L -L 20 20 20 20

3 4 5 6

#esxcli corestorage claimrule load #esxcli corestorage claimrule list #esxcli corestorage claiming unclaim -t location -A vmhba2 #esxcli corestorage claiming unclaim -t location -A vmhba3 # esxcli corestorage claimrule run

Unmask Paths
When you need the host to access the masked storage device, unmask the paths to the device. Procedure 1 Delete the MASK_PATH claim rule.
esxcli conn_options corestorage claimrule delete -r rule#

Verify that the claim rule was deleted correctly.

esxcli conn_options corestorage claimrule list

Reload the path claiming rules from the configuration file into the VMkernel.
esxcli conn_options corestorage claimrule load

Run the esxcli corestorage claiming unclaim command for each path to the masked storage device. For example:
esxcli conn_options corestorage claiming unclaim -t location -A vmhba0 -C 0 -T 0 -L 149

Run the path claiming rules.

esxcli conn_options corestorage claimrule run

Your host can now access the previously masked storage device.

Define NMP SATP Rules

The NMP SATP claim rules specify which SATP should manage a particular storage device. Usually you do not need to modify the NMP SATP rules. If you need to do so, use vSphere CLI to add a rule to the list of claim rules for the specified SATP. You might need to create an SATP rule when you install a third-party SATP for a specific storage array.

108

VMware, Inc.

Appendix C Managing Multipathing Modules and Hardware Acceleration Plug-Ins

Procedure 1 To add a claim rule for a specific SATP, run the esxcli nmp satp addrule command. The command takes the following options.
Option -c|--claim-option Description Set the claim option string when adding a SATP claim rule. This string is passed to the SATP when the SATP claims a path. The contents of this string, and how the SATP behaves as a result, are unique to each SATP. For example, some SATPs support the claim option strings tpgs_on and tpgs_off. If tpgs_on is specified, the SATP will claim the path only if the ALUA Target Port Group support is enabled on the storage device. Set the claim rule description when adding a SATP claim rule. Set the device when adding SATP claim rules. Device rules are mutually exclusive with vendor/model and driver rules. Set the driver string when adding a SATP claim rule. Driver rules are mutually exclusive with vendor/model rules. Force claim rules to ignore validity checks and install the rule anyway. Show the help message. Set the model string when adding SATP a claim rule. Vendor/Model rules are mutually exclusive with driver rules. Set the option string when adding a SATP claim rule. Set the default PSP for the SATP claim rule. Set the PSP options for the SATP claim rule. The SATP for which a new rule will be added. Set the claim transport type string when adding a SATP claim rule. Set the vendor string when adding SATP claim rules. Vendor/Model rules are mutually exclusive with driver rules.

-e|--description -d|--device -D|--driver -f|--force -h|--help -M|--model -o|--option -P|--psp -O|--psp-option -s|--satp -R|--transport -V|--vendor

NOTE When searching the SATP rules to locate a SATP for a given device, the NMP searches the driver rules first. If there is no match, the vendor/model rules are searched, and finally the transport rules. If there is still no match, NMP selects a default SATP for the device. 2 To delete a rule from the list of claim rules for the specified SATP, run the following command. You can run this command with the same options you used for addrule.
esxcli nmp satp deleterule

Reboot your host.

Example: Defining an NMP SATP Rule

The following sample command assigns the VMW_SATP_INV plug-in to manage storage arrays with vendor string NewVend and model string NewMod.
# esxcli nmp satp addrule -V NewVend -M NewMod -s VMW_SATP_INV

If you run the esxcli nmp satp listrules -s VMW_SATP_INV command, you can see the new rule added to the list of VMW_SATP_INV rules.

VMware, Inc.

109

iSCSI SAN Configuration Guide

Managing Hardware Acceleration Filter and Plug-Ins

The hardware acceleration, or VAAI, filter in combination with vendor-specific VAAI plug-ins are attached to storage devices that support the hardware acceleration. Using the vSphere CLI you can display and manipulate the VAAI filter and VAAI plug-ins.

Display Hardware Acceleration Filter

Use the vSphere CLI to view the hardware acceleration, or VAAI, filter currently loaded into your system. Procedure
u

Run the esxcli corestorage plugin list --plugin-class=Filter command.

The output of this command is similar to the following:

Plugin name VAAI_FILTER Plugin class Filter

Display Hardware Acceleration Plug-Ins

Use the vSphere CLI to view hardware acceleration plug-ins, also called VAAI plug-ins, currently loaded into your system. Procedure
u

Run the esxcli corestorage plugin list --plugin-class=VAAI command.

The output of this command is similar to the following:

Plugin name VMW_VAAIP_EQL VMW_VAAIP_NETAPP VMW_VAAIP_CX Plugin class VAAI VAAI VAAI

Verify Hardware Acceleration Status of a Storage Device

Use the vSphere CLI to verify the hardware acceleration support status of a particular storage device. This command also helps to determine which VAAI filter is attached to the device. Procedure
u

Run the esxcli corestorage device list --d device_ID command.

The output shows the hardware acceleration, or VAAI, status that can be unknown, supported, or unsupported. If the device supports the hardware acceleration, the output also lists the VAAI filter attached to the device.
# esxcli corestorage device list --d naa.60a98000572d43595a4a52644473374c naa.60a98000572d43595a4a52644473374c Display Name: NETAPP Fibre Channel Disk(naa.60a98000572d43595a4a52644473374c) Size: 20480 Device Type: Direct-Access Multipath Plugin: NMP Devfs Path: /vmfs/devices/disks/naa.60a98000572d43595a4a52644473374c Vendor: NETAPP Model: LUN Revision: 8000 SCSI Level: 4 Is Pseudo: false Status: on

110

VMware, Inc.

Appendix C Managing Multipathing Modules and Hardware Acceleration Plug-Ins

Is RDM Capable: true Is Local: false Is Removable: false Attached Filters: VAAI_FILTER VAAI Status: supported Other UIDs: vml.020003000060a98000572d43595a4a52644473374c4c554e202020

View Hardware Acceleration Plug-In for a Device

Use the vSphere CLI to view the hardware acceleration, or VAAI, plug-in attached to a storage device that supports the hardware acceleration. Procedure
u

Run the esxcli vaai device list --d device_ID command. For example:
# esxcli vaai device list -d naa.6090a028d00086b5d0a4c44ac672a233 naa.6090a028d00086b5d0a4c44ac672a233 Device Display Name: EQLOGIC iSCSI Disk (naa.6090a028d00086b5d0a4c44ac672a233) VAAI Plugin Name: VMW_VAAIP_EQL

List Hardware Acceleration Claim Rules

For each storage device that supports the hardware acceleration functionality, the claim rules specify the hardware acceleration filter and the hardware acceleration plug-in to manage this storage device. You can use the vSphere CLI to list the hardware acceleration filter and plug-in claim rules. Procedure 1 To list the filter claim rules, run the esxcli corestorage claimrule list --claimrule-class=Filter command. In this example, the filter claim rules specify devices that should be claimed by the VAAI_FILTER filter.
# esxcli corestorage claimrule list --claimrule-class=Filter Rule Class Rule Class Type Plugin Matches Filter 65430 runtime vendor VAAI_FILTER vendor=EMC model=SYMMETRIX Filter 65430 file vendor VAAI_FILTER vendor=EMC model=SYMMETRIX Filter 65431 runtime vendor VAAI_FILTER vendor=DGC model=* Filter 65431 file vendor VAAI_FILTER vendor=DGC model=*

To list the VAAI plug-in claim rules, run the esxcli corestorage claimrule list --claimruleclass=VAAI command. In this example, the VAAI claim rules specify devices that should be claimed by a particular VAAI plugin.
esxcli corestorage claimrule list --claimrule-class=VAAI Rule Class Rule Class Type Plugin Matches VAAI 65430 runtime vendor VMW_VAAIP_SYMM vendor=EMC VAAI 65430 file vendor VMW_VAAIP_SYMM vendor=EMC VAAI 65431 runtime vendor VMW_VAAIP_CX vendor=DGC VAAI 65431 file vendor VMW_VAAIP_CX vendor=DGC

model=SYMMETRIX model=SYMMETRIX model=* model=*

VMware, Inc.

111

iSCSI SAN Configuration Guide

Add Hardware Acceleration Claim Rules

To configure hardware acceleration for a new array, you need to add two claim rules, one for the VAAI filter and another for the VAAI plug-in. For the new claim rules to be active, you first define the rules and then load them into your system. Procedure 1 Define a new claim rule for the VAAI filter by using the esxcli corestorage claimrule add --claimruleclass=Filter --plugin=VAAI_FILTER command. For information about the options that the command requires, see esxcli corestorage claimrule Options, on page 113. 2 3 Define a new claim rule for the VAAI plug-in by using the esxcli corestorage claimrule add -claimrule-class=VAAI command.

Load both claim rules by using the following commands:

esxcli corestorage claimrule load --claimrule-class=Filter esxcli corestorage claimrule load --claimrule-class=VAAI

Run the VAAI filter claim rule by using the esxcli corestorage claimrule run --claimruleclass=Filter command.

NOTE Only the Filter-class rules need to be run. When the VAAI filter claims a device, it automatically finds the proper VAAI plug-in to attach.

Example: Defining Hardware Acceleration Claim Rules

To configure Hardware Acceleration for IBM arrays using the VMW_VAAI_T10 plug-in, use the following sequence of commands:
# esxcli corestorage claimrule add --claimrule-class=Filter --plugin=VAAI_FILTER --type=vendor -vendor=IBM --autoassign # esxcli corestorage claimrule add --claimrule-class=VAAI --plugin=VMW_VAAI_T10 --type=vendor -vendor=IBM --autoassign # esxcli corestorage claimrule load --claimrule-class=Filter # esxcli corestorage claimrule load --claimrule-class=VAAI # esxcli corestorage claimrule run --claimrule-class=Filter

Delete Hardware Acceleration Claim Rules

Use the vSphere CLI to delete existing hardware acceleration claim rules. Procedure
u

Use the following commands:

esxcli corestorage claimrule delete -r claimrule_ID --claimrule-class=Filter esxcli corestorage claimrule delete -r claimrule_ID --claimrule-class=VAAI

112

VMware, Inc.

Appendix C Managing Multipathing Modules and Hardware Acceleration Plug-Ins

esxcli corestorage claimrule Options

Certain esxcli corestorage claimrule commands, for example the commands that you run to add new claim rules, remove the rules, or mask paths, require that you specify a number of options. Table C-1. esxcli corestorage claimrule Options
Option -A|--adapter -u|--autoassign -C|--channel -c|--claimrule-class -d|--device -D|--driver -f|--force -h|--help -L|--lun -M|--model -P|--plugin -r|--rule -T|--target -R|--transport Description Indicate the adapter of the paths to use in this operation. The system will auto assign a rule ID. Indicate the channel of the paths to use in this operation. Indicate the claim rule class to use in this operation. Valid values are: MP, Filter, VAAI Indicate the device Uid to use for this operation. Indicate the driver of the paths to use in this operation. Force claim rules to ignore validity checks and install the rule anyway. Show the help message. Indicate the LUN of the paths to use in this operation. Indicate the model of the paths to use in this operation. Indicate which PSA plug-in to use for this operation. Indicate the claim rule ID to use for this operation. Indicate the target of the paths to use in this operation. Indicate the transport of the paths to use in this operation. Valid values are: block, fc, iscsi, iscsivendor, ide, sas, sata, usb, parallel, unknown. Indicate which type of matching is used for claim/unclaim or claimrule. Valid values are: vendor, location, driver, transport, device. Indicate the vendor of the paths to use in this operation.

-t|--type -V|--vendor

VMware, Inc.

113

iSCSI SAN Configuration Guide

114

VMware, Inc.

Index

Symbols
* next to path 80

A
access control 15 active-active disk arrays, managing paths 83 active-passive disk arrays managing paths 83 path thrashing 89 adaptive scheme 20 advanced settings Disk.MaxLUN 77 Disk.SchedNumReqOutstanding 90 Disk.SupportSparseLUN 78 allocations, LUN 30 applications, layered 92 array-based solution 93 asterisk next to path 80 authentication 15, 44, 75

commands esxcli corestorage claimrule 102 resxtop 101 vicfg-iscsi 101 vicfg-mpath 101 vmkping 102 configuring dynamic discovery 43 iSCSI storage 51 static discovery 44 current multipathing state 80

D
data digests 15 datastore copies, mounting 93 datastores creating on iSCSI storage 51 displaying 74 managing duplicate 93 mounting 94 paths 80 refreshing 76 reviewing properties 75 unmounting 94 Dell PowerVault MD3000i storage systems 59 dependent hardware iSCSI and associated NICs 34 configuration workflow 32 considerations 33 reviewing adapters 33 diagnostic partitions, sharing 84 disabling paths 82 disaster recovery 16 discovery address 43 dynamic 43 static 44 disk access, equalizing 90 disk arrays active-active 30, 81 active-passive 30, 81, 89 disk shares 20 disk timeout 84 Disk.MaxLUN 77 Disk.SchedNumReqOutstanding 90

B
backups considerations 91 third-party backup package 92 boot from iSCSI SAN configuring HBAs 63 configuring iSCSI settings 64 guidelines 62 hardware iSCSI 63 iBFT 64 preparing SAN 62 software iSCSI 64

C
CHAP disabling 47 for discovery targets 46 for iSCSI initiators 45 for static targets 46 mutual 44 one-way 44 CHAP authentication 15, 44, 75 CHAP authentication methods 44 checklist 99 claim rules 79

VMware, Inc.

115

iSCSI SAN Configuration Guide

Disk.SupportSparseLUN 78 dump partitions, sharing 84 dynamic discovery, configuring 43 dynamic discovery addresses 43

E
educational support 7 EMC CLARiiON 54 EMC Symmetrix, pseudo LUNs 55 equalizing disk access 90 EqualLogic, storage systems 59 ESX/ESXi hosts and iSCSI SAN 71 sharing VMFS 18 esxcli corestorage claimrule command 102 esxcli corestorage command, options 113 ESXi, configuring for net dump 69 EUI 12 EVA (HP StorageWorks) 56

host type 54 HP LeftHand P4000 VSA 59 HP StorageWorks EVA 56 MSA 55

I
I/O delay 25, 29 iBFT 64 iBFT iSCSI boot booting an ESXi host 67 changing boot sequence 66 installing an ESXi host 66 limitations 65 networking best practices 67 setting up ESXi 65 troubleshooting 68 IP address 12 IQN 12 iSCSI, with multiple NICs 37 iSCSI adapters about 29 hardware 13 software 13 iSCSI alias 12 iSCSI boot, iBFT 64 iSCSI Boot Firmware Table, See iBFT iSCSI boot parameters, configuring 65 iSCSI HBA, alias 32 iSCSI initiators advanced parameters 48 configuring advanced parameters 49 configuring CHAP 45 hardware 31 setting up CHAP parameters 44 viewing in vSphere Client 71 iSCSI names, conventions 12 iSCSI networking, creating a VMkernel port 37 iSCSI ports 12 iSCSI SAN boot 61 concepts 11 iSCSI sessions adding for a target 50 displaying 50 duplicating 51 managing 49 removing 51 iSCSI storage, adding 51 iSCSI storage systems, working with ESX/ESXi 53 issues performance 88 visibility 75

F
failover I/O delay 25 transparent 14 failover paths, status 80 failure, server 27 file-based (VMFS) solution 93 FilerView 57 finding information 17 Fixed path policy, path thrashing 89

H
hardware acceleration about 96 benefits 96 deleting claim rules 112 disabling 97 requirements 96 status 97 hardware acceleration plug-ins 103 hardware iSCSI, and failover 24 hardware iSCSI adapters dependent 13 independent 13 hardware iSCSI initiators changing iSCSI name 32 configuring 31 installing 31 setting up discovery addresses 43 setting up naming parameters 32 viewing 31 header digests 15 high-tier storage 27

116

VMware, Inc.

Index

J
jumbo frames enabling for dependent hardware iSCSI 42 enabling for software iSCSI 42 using with iSCSI 41

L
layered applications 92 LeftHand Networks SAN/iQ storage systems 59 Linux Cluster host type 54 Linux host type 54 load balancing, manual 83 locations of virtual machines 27 loss of network connection, troubleshooting 68 lower-tier storage 27 LUN decisions adaptive scheme 20 predictive scheme 20 LUN discovery, VMkernel 28 LUN not visible, SP visibility 75 LUNs allocations 30 changing number scanned 77 creating and rescan 75, 77 decisions 19 display and rescan 28 making changes and rescan 76 masking 107 multipathing policy 81 one VMFS volume per 29 setting multipathing policy 81 sparse 78

disabled paths 80 standby paths 80 viewing the current state of 80 multipathing claim rules adding 105 deleting 107 multipathing plug-ins, path claiming 79 multipathing policy 81 multipathing state 80 mutual CHAP 44

N
NAA 12 Native Multipathing Plug-In 22, 23 net dump configuring ESXi 69 configuring vMA 69 NetApp provisioning storage on CLI 58 provisioning storage on FilerView 57 NetApp storage system 57 network adapters, configuring for iBFT iSCSI boot 65 network performance 86 network virtualization 10 networking, configuring 30 NFS datastores, unmounting 94 NICs, mapping to ports 38 NMP I/O flow 24 path claiming 79 See also Native Multipathing Plug-In

O
one-way CHAP 44 outstanding disk requests 90

M
maintenance 16 manual load balancing 83 masking LUNs 107 metadata updates 19 mid-tier storage 27 Most Recently Used path policy, path thrashing 89 mounting VMFS datastores 93 MPPs displaying 104 See also multipathing plug-ins MRU path policy 81 MSA (HP StorageWorks) 55 MTU 42 multipathing activating for software iSCSI 40 active paths 80 broken paths 80

P
passive disk arrays, path thrashing 89 path claiming 79 path failover array-based 25 host-based 24 path failure rescan 76, 77 path management 22, 83 path policies changing defaults 82 Fixed 24, 25, 81 Most Recently Used 24, 81 MRU 81 Round Robin 24, 81 Path Selection Plug-Ins 24 path thrashing, resolving 90

VMware, Inc.

117

iSCSI SAN Configuration Guide

paths disabling 82 masking 107 preferred 80 unmasking 108 performance checking Ethernet switch statistics 88 issues 88 network 86 optimizing 85 SCSI reservations 18 storage system 85 plug-ins hardware acceleration 103 multipathing 103 Pluggable Storage Architecture 22 port binding, examples 41 port binding, removing 41 port redirection 25 predictive scheme 20 preferred path 80 prioritizing virtual machines 20 problems performance 88 visibility 75 PSA, See Pluggable Storage Architecture PSPs, See Path Selection Plug-Ins

Q
queue depth 29, 90

R
rescan LUN creation 7577 LUN display 28 LUN masking 75 path masking 76, 77 when path is down 76, 77 reservations, reducing SCSI reservations 91 resxtop command 101 Round Robin path policy 24, 81

S
SAN accessing 21 backup considerations 91 benefits 16 server failover 28 specifics 17 troubleshooting 84 SAN management software 17 SAN restrictions, when working with ESX/ESXi 30

SAN storage performance, optimizing 85 SATPs adding rules 108 displaying 105 See also Storage Array Type Plug-Ins scanning, changing number 77 SCSI controllers 10 SCSI reservations, reducing 91 server failover 28 server failure 27 server performance 86 sharing diagnostic partitions 84 sharing VMFS across servers 18 snapshot software 92 software iSCSI and failover 24 networking 36 software iSCSI adapters, queue depth 90 software iSCSI boot, changing settings 68 software iSCSI initiators configuring 34 enabling 35 setting up discovery addresses 43 SP visibility, LUN not visible 75 sparse LUN support 78 static discovery, configuring 44 static discovery addresses 43 storage adapters copying names to clipboard 72 displaying in vSphere Client 72 viewing in vSphere Client 71 storage area network 9 Storage Array Type Plug-Ins 23 storage devices accessible through adapters 74 available to hosts 74 displaying 105 hardware acceleration status 110 identifiers 74 naming 73 paths 81 viewing information 72 storage filters disabling 78 host rescan 79 RDM 79 same host and transports 79 VMFS 79 storage systems Dell PowerVault MD3000i 59 EMC CLARiiON 54 EMC Symmetrix 55 EqualLogic 59

118

VMware, Inc.

Index

HP StorageWorks 55 LeftHand Networks SAN/iQ 59 NetApp 57 performance 85 types 14 storage virtualization 10

T
targets 13 targets vs. LUNs 13 technical support 7 testing, storage systems 53 third-party backup package 92 third-party management applications 17 TimeoutValue parameter 29 troubleshooting changing iSCSI boot parameters 68 loss of network connection 68

VMFS volume resignaturing 93 VMkernel, LUN discovery 28 VMkernel interface, with Jumbo Frames enabled 42 VMkernel ports 38 vmkping command 102 vMotion 16, 30, 54 VMware DRS, using with vMotion 30 VMware HA 16, 27, 54 VMware NMP I/O flow 24 See also Native Multipathing Plug-In VMware PSPs, See Path Selection Plug-Ins VMware SATPs, See Storage Array Type PlugIns volume resignaturing 93, 95 vSphere CLI 40 vSphere Client 101 vSwitch, with Jumbo Frames enabled 42

U
use cases 16

W
Windows GOS timeout 84

V
VAAI claim rules defining 112 deleting 112 VAAI filter 111 VAAI plug-in 111 VAAI filter, displaying 110 VAAI plug-ins displaying 110 listing for devices 111 vicfg-iscsi command 101 vicfg-module 90 vicfg-mpath command 101 virtual machines accessing SAN 21 equalizing disk access 90 I/O delay 25 locations 27 prioritizing 20 virtualization 9 visibility issues 75 vMA, collecting net dump 69 vMA, configuring for net dump 69 VMFS one volume per LUN 29 sharing across ESX/ESXi hosts 18 volume resignaturing 93 VMFS datastores changing signatures 95 resignaturing copies 95 unmounting 94

VMware, Inc.

119

iSCSI SAN Configuration Guide

120

VMware, Inc.