3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 User’s Guide 3PAR Inc.
Revision Notice This is the first release of this manual. A complete revision history is provided at the end of this document. Changes The material in this document is for information only and is subject to change without notice. While reasonable efforts have been made in the preparation of this document to assure its accuracy, 3PAR Inc. assumes no liability resulting from errors or omissions in this document or from the use of the information contained herein.
PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide Table of Contents 1 Introduction 1.1 Overview 1.2 1.2 Audience 1.2 1.3 Related Documentation 1.3 1.4 Organization 1.4 1.5 Typographical Conventions 1.5 1.6 Advisories 1.5 2 Overview and Features 2.1 About VMware vStorage APIs for Array Integration (VAAI) 2.1 2.2 About 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 2.2 2.2.1 Hardware Assisted Locking (ATS) 2.3 2.2.2 Full Copy (XCOPY) 2.3 2.2.3 Block Zeroing (WRITE-SAME) 2.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3 Installation and Deinstallation 3.1 Installing 3PAR VAAI Plug-in for VMware vSphere 4.1 3.1 3.1.1 Before You Begin 3.2 3.1.2 Installing the Plug-in Using VMware Update Manager (VUM) 3.2 3.1.3 Installing the Plug-in Using the VMware vSphere CLI for ESX/ESXi Hosts 3.6 3.1.4 Installing the Plug-in Using esxupdate on the ESX Service Console 3.7 3.1.5 Verifying the Installation 3.7 3.2 Deinstalling 3PAR VAAI Plug-in 1.1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 1 Introduction In this chapter 1.1 Overview 1.2 1.2 Audience 1.2 1.3 Related Documentation 1.3 1.4 Organization 1.4 1.5 Typographical Conventions 1.5 1.6 Advisories 1.5 This chapter provides an introduction to using this guide, including information on the target audience, related documentation, and typographical conventions. Introduction 1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 1.1 Overview This guide provides information for installing and using 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1. The 3PAR VAAI Plug-in for VMware vSphere 4.1 enables SCSI primitives that allow 3PAR InServ Storage Servers to take advantage of several VMware virtual machine operations at the meta data level to improve performance. 1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 1.4 Organization This guide is organized as follows: ■ Chapter 1, Introduction (this chapter), provides an introduction to using this guide, including information on the target audience, related documentation, and typographical conventions. ■ Chapter 2, Overview and Features, gives an overview of the VMware VAAI Plug-in and its benefits, features and system requirements.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 1.5 Typographical Conventions This guide employs the following typographical conventions: Typeface Meaning Example ABCDabcd Used for dialog elements When prompted, click Finish to such as titles, button labels, complete the installation. and other screen elements. ABCDabcd Used for paths, filenames, Open the file and screen output. \gui\windows\setup.exe 1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 2 Overview and Features In this chapter 2.1 About VMware vStorage APIs for Array Integration (VAAI) 2.1 2.2 About 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 2.2 2.3 Package Contents 2.4 2.4 System Requirements 2.4 2.5 Special Considerations 2.6 This chapter provides an overview of the VMware VAAI extensions and describes the benefits provided by 3PAR VMware VAAI Plug-in 1.1.0 for vSphere 4.1. 2.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide are typically implemented in-band from ESX to a disk array. ESX extensions to make use of these primitives are collectively referred to as vStorage APIs for Array Integration (VAAI). 2.2 About 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 To keep up with new advances in cloud computing, enhanced capabilities are required by the SCSI layer stack so that SCSI can meet the demands of emerging virtualized infrastructures.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 2.2.1 Hardware Assisted Locking (ATS) Rather than locking the entire LUN, Hardware Assisted Locking (ATS) only locks the blocks on the LUN that are allocated to the VMDK. This enhanced capability is intended to help virtualized data centers in at least two important ways.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide Block Zeroing Increases performance and efficiency by eliminating the writing of zeros as data by the host for the purpose of "cleaning" space for a VMDK. Using the WRITE-SAME command, VMware now transfers the overhead associated with these writes to the storage array by instructing the storage array to assume the burden of writing the zeros on these newly allocated blocks.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 2.4.1 Supported 3PAR Inform OS Versions and Features The following table lists the VMware VAAI features that are supported by the 3PAR plug-in for a given InForm OS version. Table 2-1. 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Feature Support for InForm OS Versions InForm OS Block Zeroing Full Copy Hardware Assisted Locking Version (WRITE_SAME) (XCOPY) (ATS) 2.3.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 2.5 Special Considerations The 3PAR VAAI Plug-in for VMware vSphere 4.1 enables the VAAI primitives for 3PAR devices only. 2.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3 Installation and Deinstallation In this chapter 3.1 Installing 3PAR VAAI Plug-in for VMware vSphere 4.1 3.1 3.2 Deinstalling 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 3.8 This chapter describes how to install and verify installation of 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1. Instructions for deinstalling the software are also provided. NOTE: 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 is only intended for VMware vSphere 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide NOTE: During 3PAR VAAI Plug-in installation, the ESX/ESXi host will enter into maintenance mode. For host maintenance mode behavior, please refer to the VMware knowledge base. NOTE: It is necessary to perform an ESX/ESXi host reboot after the 3PAR VAAI Plug-In 1.1.0 for VMware vSphere 4.1 installation. Please refer to the VMware documentation for ESX/ESXi host reboot instructions and considerations related to your system configuration. 3.1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3.1.2.1 Import the 3PAR VAAI Plug-in Package 1 Copy 3PAR_vaaip_InServ-110.zip to the server that has the vSphere Client installed. 2 Double click the VMware vSphere Client icon on your server. 3 Log on to the vCenter Server through the vSphere Client with administrator privileges. 4 Click the Home icon in the navigation bar. 5 Click the Update Manager icon in the Solutions and Applications pane.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 2 Click the Hosts and Clusters icon in the Inventory pane. 3 Click the DataCenter which has the ESX/ESXi host(s) that you want to stage. 4 Click the Update Manager tab. 5 Click Attach… 6 Select the 3PAR baseline entry in the Extension Baselines section, then click Attach. 7 From the left panel, right click the DataCenter and select Scan for Updates.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide /var/log/vmware/esxupdate.log /var/log/vmware/esxcfg-boot.log For an ESXi host, log onto the ESXi host from vSphere Client, click Home, under the Administration section, then click System logs. Select System Logs to view related event messages. 18 Reboot each ESX/ESXi host. After the reboot, the 3PAR_vaaip_InServ module loads automatically. It is then attached to the 3PAR devices and enabled. Installing 3PAR VAAI Plug-in for VMware vSphere 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3.1.3 Installing the Plug-in Using the VMware vSphere CLI for ESX/ESXi Hosts To perform the installation using VMware vSphere CLI for ESX/ESXi hosts: 1 Install VMware vSphere CLI on a windows machine. (Please follow the VMware vSphere CLI installation user guide for instructions). 2 Copy 3PAR_vaaip_InServ-110.zip to a windows local folder (e.g., c:/tmp).
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3.1.4 Installing the Plug-in Using esxupdate on the ESX Service Console To perform the installation using esxupdate on the ESX host Service Console: 1 Make sure your ESX host does not have another plug-in attached to the 3PAR device. (e.g., VMW_VAAIP_T10). 2 Copy the 3PAR_vaaip_InServ-110.zip file to a local folder on your ESX host (e.g., /root/vaaip/).
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3.1.5.2 Using the ESX Service Console for ESX host: To verify the installation from the ESX console, issue the following command: esxcli corestorage claimrule list –c VAAI The output generated by this command should appear as follows: VAAI runtime vendor 3PAR_vaaip_InServ vendor=3PARdata model=* VAAI file vendor 3PAR_vaaip_InServ vendor=3PARdata model=* 3.2 Deinstalling 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 4 Exit maintenance mode for the ESX/ESXi server by issuing the following command: vicfg-hostops.pl --server -o exit 3.2.2 Deinstalling the Plug-in Using esxupdate on an ESX Host Service Console To un-install 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 using esxupdate: 1 On the ESX host Service Console, run: esxupdate remove -b 3PAR_vaaip_InServ-110 --maintenancemode 2 Reboot the ESX host. Deinstalling 3PAR VAAI Plug-in 1.1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 3.10 Deinstalling 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 4 Troubleshooting In this chapter 4.1 Installation Error Messages 4.2 4.2 Run Time Error Messages 4.6 This chapter lists error messages and provides tips for solving common problems. Troubleshooting 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 4.1 Installation Error Messages For installation problems, please check the following log file then consult the description and suggested actions for each message as described in this section: /var/log/vmware/esxupdate.log MESSAGE 3parvaai:ERR This 3PAR VAAI Plug-in package can only be installed on ESX 4.1 release DESCRIPTION Indicates that 3PAR VAAI Plug-in 1.1.0 for VMware vSphere can only be installed on an ESX/ESXi 4.1 release.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR vmw_vaaip_t10 has already been loaded. Please unload the module and reboot ESX host before you install 3PAR VAAI Plug-in package DESCRIPTION The VMware default vmw_vaaip_t10 module has previously been loaded and attached to 3PAR devices and is causing a conflict with the current installation. SUGGESTED ACTION Unload the vmw_vaaip_t10 module from the ESX/ESXi host, reboot the ESX/ESXi host, then install 3PAR VAAI Plug-in 1.1.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR 3PAR_vaaip_InServ has already been loaded. Please unload the module and reboot ESX host before you reinstall 3PAR VAAI Plug-in package DESCRIPTION The 3PAR VAAI Plug-in module 3PAR_vaaip_InServ has already been loaded. SUGGESTED ACTION Remove the existing 3PAR VAAI Plug-in package, reboot the ESX/ESXi host, then re-install 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 again. 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai: ERR Can not load 3PAR_vaaip_InServ module DESCRIPTION The 3PAR VAAI Plug-in module 3PAR_vaaip_InServ cannot be loaded. Either 3PAR_vaaip_InServ has already been loaded, or some other problem has occurred during the installation. SUGGESTED ACTION Issue the #vmkload_mod -list command to check if the 3PAR_vaaip_InServ module has already been loaded.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide 4.2 Run Time Error Messages For run time problems, please check the following log file then consult the description and suggested actions for each message as described in this section: /var/log/vmkernel or /var/log/vmkernel.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:INFO device((naa.50002ac0006500e8) attribute is set to 0xd DESCRIPTION Specifies the 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 features that are supported by a given 3PAR device. bit 0 = WRITE_SAME support. bit 1 = UNMAP support (not implemented in the current release). bit 2 = ATS support. bit 3 = XCOPY support. SUGGESTED ACTION None. Run Time Error Messages 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR InquiryC0Data(Error get page C0 data, vmkstatus = %s) DESCRIPTION An inquiry into the customer page C0 data has failed. vmkstatus indicates the VMware kernel status. SUGGESTED ACTION Use the information provided by this message in conjunction with any information provided by the following InquiryC0Data error message, then check the 3PAR InServ log for related information that might be helpful in resolving this problem. 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR InquiryC0Data(ScsiDeviceStatus = %s, ScsiHostStatus = %s, ScsiPlugInStatus = %s) DESCRIPTION An inquiry into the customer page C0 data has failed. The vmk_ScsiDeviceStatus is the status reported by the target/LUN itself. ScsiDeviceStatus indicates the device status. vmk_ScsiHostStatus is a status value from the driver/hba. vmk_ScsiPluginStatus is a status value returned from the MP plug-in that was processing the I/O command.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:INFO Device naa.50002ac0006500e8 (3PARdata:VV) DESCRIPTION Shows the device VV WWN, product ID and vendor ID for every loaded storage device. SUGGESTED ACTION None. 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:INFO Device %s (%.*s:%.*s) not supported DESCRIPTION Indicates that the target device is not a 3PAR device and is not supported by 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1. SUGGESTED ACTION None, 3PAR VAAI Plug-in1.1.0 for VMware vSphere 4.1 only supports 3PAR devices. Run Time Error Messages 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR Failed to inquiry page c0, XCOPY/ATS/WRITE_SAME are not supported DESCRIPTION An inquiry into the device page C0 data has failed. As a result, the device will be flagged as not supporting the XCOPY, ATS and WRITE_SAME SCSI commands. SUGGESTED ACTION Check to see what specific XCOPY/ATS/WRITE_SAME features are supported for a given 3PAR InForm OS.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR tpd_claim_device(Out of memory claiming device %s) DESCRIPTION An out of memory error has occurred while 3PAR VAAI Plug-in 1.10 for VMware vSphere 4.1 was performing a claim device function. SUGGESTED ACTION Please check your hardware memory resource setting. Run Time Error Messages 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR tpd_claim_device(Inquiry to device %s failed) DESCRIPTION Indicates that a SCSI Inquiry device command error has occurred. The device might not be ready or is not reachable. SUGGESTED ACTION Please check the connection between the host and 3PAR InServ Storage Server. You can also consult the 3PAR InServ log file for additional details that might be useful in solving the problem. 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR init_module(Failed to register vaaip plugin: %s) DESCRIPTION Failed to register 3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 with the VMware kernel during loading of the plug-in. SUGGESTED ACTION Remove the 3PAR VAAI plug-in module, reboot the ESX host and re-install the 3PAR VAAI Plugin 1.1.0 for VMware vSphere 4.1 package. Run Time Error Messages 4.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide MESSAGE 3parvaai:ERR Failed to unregister the plugin. The module will be unloaded anyway. DESCRIPTION Indicates that the VAAI Plug-in module was not properly unregistered as part of the cleanup process that occurs when the VAAI Plug-in is unloaded from the ESX kernel. Even though the 3PAR VAAI plug-in module was not unregistered from VMware kernel, the module had been unloaded from the kernel.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide Revision History Release level Revision summary 320-200248 Rev A First version of this manual to support the release of 3PAR VAAI Plug- September 2010 in 1.1.0 for VMware vSphere 4.1. Revision History RH.
3PAR VAAI Plug-in 1.1.0 for VMware vSphere 4.1 Users Guide RH.