6.0
Table Of Contents
- vSphere Command-Line Interface Concepts and Examples
- Contents
- About This Book
- vSphere CLI Command Overviews
- Introduction
- List of Available Host Management Commands
- Targets and Protocols for vCLI Host Management Commands
- Supported Platforms for vCLI Commands
- Commands with an esxcfg Prefix
- ESXCLI Overview
- Connection Options for vCLI Host Management Commands
- Connection Options for DCLI Commands
- vCLI Host Management Commands and Lockdown Mode
- Managing Hosts
- Managing Files
- Managing Storage
- Introduction to Storage
- Examining LUNs
- Detaching Devices and Removing a LUN
- Working with Permanent Device Loss
- Managing Paths
- Managing Path Policies
- Scheduling Queues for Virtual Machine I/O
- Managing NFS/NAS Datastores
- Monitoring and Managing SAN Storage
- Monitoring and Managing Virtual SAN Storage
- Monitoring vSphere Flash Read Cache
- Monitoring and Managing Virtual Volumes
- Migrating Virtual Machines with svmotion
- Configuring FCoE Adapters
- Scanning Storage Adapters
- Retrieving SMART Information
- Managing iSCSI Storage
- iSCSI Storage Overview
- Protecting an iSCSI SAN
- Command Syntax for esxcli iscsi and vicfg-iscsi
- iSCSI Storage Setup with ESXCLI
- iSCSI Storage Setup with vicfg-iscsi
- Listing and Setting iSCSI Options
- Listing and Setting iSCSI Parameters
- Enabling iSCSI Authentication
- Setting Up Ports for iSCSI Multipathing
- Managing iSCSI Sessions
- Managing Third-Party Storage Arrays
- Managing NMP with esxcli storage nmp
- Path Claiming with esxcli storage core claiming
- Managing Claim Rules
- Managing Users
- Managing Virtual Machines
- vmware-cmd Overview
- Listing and Registering Virtual Machines
- Retrieving Virtual Machine Attributes
- Managing Virtual Machine Snapshots with vmware-cmd
- Powering Virtual Machines On and Off
- Connecting and Disconnecting Virtual Devices
- Working with the AnswerVM API
- Forcibly Stopping Virtual Machines with EXCLI
- Managing vSphere Networking
- Introduction to vSphere Networking
- Retrieving Basic Networking Information
- Network Troubleshooting
- Setting Up vSphere Networking with vSphere Standard Switches
- Setting Up Virtual Switches and Associating a Switch with a Network Interface
- Retrieving Information About Virtual Switches
- Adding and Deleting Virtual Switches
- Checking, Adding, and Removing Port Groups
- Managing Uplinks and Port Groups
- Setting the Port Group VLAN ID
- Managing Uplink Adapters
- Adding and Modifying VMkernel Network Interfaces
- Setting Up vSphere Networking with vSphere Distributed Switch
- Managing Standard Networking Services in the vSphere Environment
- Setting the DNS Configuration
- Adding and Starting an NTP Server
- Managing the IP Gateway
- Setting Up IPsec
- Managing the ESXi Firewall
- Monitoring VXLAN
- Monitoring ESXi Hosts
- Index
Getting Started with vSphere Command-Line Interfaces
48 VMware, Inc.
Thetypeofarrayandthepathpolicydeterminethebehaviorofthehost.
Multipathing Considerations
Thefollowingconsiderationshelpyouwithmultipathing:
IfnoSATPisassignedtothedevicebytheclaimrules,thedefaultSATPforiSCSIorFCdevicesis
VMW_SATP_DEFAULT_AA.ThedefaultPSPisVMW_PSP_FIXED.
WhenthesystemsearchestheSATPrulestolocateaSATPforagivendevice,itsearchesthedriverrules
first.Ifthereisnomatch,thevendor/modelrulesaresearched,andfinallythetransportrulesare
searched.Ifnomatchoccurs,NMPselectsadefaultSATPforthedevice.
IfVMW_SATP_ALUAisassignedtoaspecificstoragedevice,butthedeviceisnotALUA‐aware,noclaim
rulematchoccursforthisdevice.ThedeviceisclaimedbythedefaultSATPbasedonthedeviceʹs
transporttype.
ThedefaultPSPforalldevicesclaimedbyVMW_SATP_ALUAisVMW_PSP_MRU.TheVMW_PSP_MRUselectsan
active/optimizedpathasreportedbytheVMW_SATP_ALUA,oranactive/unoptimizedpathifthereis
noactive/optimizedpath.Thispathisuseduntilabetterpathisavailable(MRU).Forexample,ifthe
VMW_PSP_MRUiscurrently
usinganactive/unoptimizedpathandanactive/optimizedpathbecomes
available,theVMW_PSP_MRUwillswitchthecurrentpathtotheactive/optimizedone.
Table 4-1. Supported Path Policies
Policy Description
VMW_PSP_FIXED Thehostusesthedesignatedpreferredpath,ifithasbeenconfigured.Otherwise,thehost
selectsthefirstworkingpathdiscoveredatsystemboottime.Ifyouwantthehosttousea
particularpreferredpath,specifyitthroughthevSphereWebClient,orbyusingesxcli
storage nmp psp fixed deviceconfig set.See“Changing
PathPolicies”onpage 49.
Thedefaultpolicyforactive‐activestoragedevicesisVMW_PSP_FIXED.
Note:IfthehostusesadefaultpreferredpathandthepathʹsstatusturnstoDead,anewpath
isselectedaspreferred.However,ifyouexplicitlydesignatethepreferredpath,itwillremain
preferred
evenwhenitbecomesinaccessible.
VMW_PSP_MRU Thehostselectsthepaththatitusedmostrecently.Whenthepathbecomesunavailable,the
hostselectsanalternativepath.Thehostdoesnotrevertbacktotheoriginalpathwhenthat
pathbecomesavailableagain.ThereisnopreferredpathsettingwiththeMRU
policy.MRU
isthedefaultpolicyforactive‐passivestoragedevices.
TheVMW_PSP_MRUrankingcapabilityallowsyoutoassignrankstoindividu alpaths.Toset
rankstoindividualpaths,usetheesxclistoragenmppspgenericpathconfigsetcommand.
Fordetails,seetheVMwareknowledgebasearticle2003468.
VMW_PSP_RR Thehost
usesanautomaticpathselectionalgorithmthatrotatesthroughallactivepaths
whenconnectingtoactive‐passivearrays,orthroughallavailablepathswhenconnectingto
active‐activearrays.Automaticpathselectionimplementsloadbalancingacrossthephysical
pathsavailabletoyourhost.LoadbalancingistheprocessofspreadingI/O
requestsacross
thepaths.ThegoalistooptimizethroughputperformancesuchasI/Opersecond,megabytes
persecond,orresponsetimes.
VMW_PSP_RRisthedefaultforanumberofarraysandcanbeusedwithbothactive‐activeand
active‐passivearraystoimplementloadbalancingacrosspathsfor
differentLUNs.
Table 4-2. Path Policy Effects
Policy Active/Active Array Active/Passive Array
MostRecentlyUsed Administratoractionisrequiredtofail
backafterpathfailure.
Administratoractionisrequiredtofailback
afterpathfailure.
Fixed VMkernelresumesusingthepreferred
pathwhenconnectivityisrestored.
VMkernelattemptstoresumebyusingthe
preferredpath.Thisactioncancausepath
thrashingorfailurewhenanotherSP
now
ownstheLUN.
RoundRobin Nofailback. Nextpathinroundrobinschedulingis
selected.