Scsi Storage
Scsi Storage
You can find the most up-to-date technical documentation on the VMware website at:
https://docs.vmware.com/
VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
©
Copyright 2019 VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc. 2
Contents
2 Certification Requirements 9
Required Software 10
Required Hardware 10
License Requirement 11
Installation and Configuration Overview 11
Installing ESXi 12
Configuring ESXi Hosts 13
Installing vCenter Server 14
Configuring the vCenter Server 14
Installing STAF and HWE vibs on the ESXi Hosts 14
Allocating LUNs 16
Setup requirements for Configuration and Verification, Data Intergity, Failover, iSCSI, Functional
and Permanent Device Loss Tests 17
Special Tests 17
Configuring Datastores 18
Guest Operating Systems for Storage Certifications 18
Installing and Configuring Virtual Machines 18
Naming Convetion for Virtual Machines 19
Minimum Requirements for Virtual Machines 19
Installing Tools on Virtual Machines 20
Setup Requirements for VAAI - ATS, BlockZero, and FullCopy Tests 21
Setup Requirements for Thin Provisioning Tests 22
Setup Requirements for Thin Provisioning Space Reclamation and TPUNMAP Tests 23
Setup Requirements for Extended Xcopy 23
Testbed Topology (VMFS5 TP UNMAP) 23
Testbed Topology (VMFS6 Automatic Unmap) 23
Additional Settings for Virtual Machine 24
Certification Types 25
Full Certification 25
Recertification 26
Storage Virtual Appliance (SVA) Certification 26
Minor Storage Firmware Revision (mSFR) Certification 26
Storage Certification Questionnaire 27
User Parameters 29
VMware, Inc. 3
VMware Storage Certification Guide (SCSI Block)
Online Mode 36
Offline Mode 36
VMware, Inc. 4
VMware Storage Certification Guide (SCSI Block)
9 Appendix 82
VMware, Inc. 5
About Storage Certification Guide
(SCSI Block) 1
The VMware Storage Certification Guide ( SCSI Block) explains how to install and configure a
Storage Certification testbed.
The Storage Certification supports ESXi version 8.0, and includes the certification tests for the
Block storage program (iSCSI, FC, FCoE, NAS-SVD and SAS).
NAS storage certifications are covered in the NAS certification document. Contact your VMware
representative for more information.
Clustered VMDK: Clustered VMDK support for WSFC type failover clusters to use shared VMDK
as quorum drive is added in vSphere 8.0 for FC Storage arrays. Storage array must support
Write Exclusive-All Registrants (WE-AR) type SCSI3 Persistent Reservation which is a mandatory
pre-requisite for this feature. Certification tests verify this pre-requisite.
Note
n Clustered VMDK feaure is supported only for FC arrays in this release.
n If your array firmware/OS is already certified and wants to add Clustered VMDK support in 8.0
VCG, select Partial Certification drop-down menu on Session Configuration page in the VIVa
UI and click Support for WE-AR Type Reservation check-box under partial certification. It lists
only subset of tests specific to Clustered VMDK feature support requirement.
Intended Audience
This guide is intended for VMware partners who want to certify a storage device with ESXi to claim
compatibility in the VMware HCL.
VMware, Inc. 6
VMware Storage Certification Guide (SCSI Block)
n Installing and operating VMware Server, VMware Workstation, or VMware Player used to run
the certification
n Storage Test Descriptions - List of tests for iSCSI, NAS-SVD, FC, FCoE and SAS.
n iSCSI Storage Certification - Testbed topology and list of tests to run for iSCSI.
n Fibre Channel Storage Certifications - Testbed topologies for FC SAN and DAS certifications.
n SVD/Gateway Storage Certifications - Testbed topologies for SVD/Gateway, NAS SVD and
list of tests to run SVD/Gateway certifications..
VMware Documentation
For information about configuring and running certification tests, and submitting results using the
VIVa user interface, refer to the VMware Integration Validation User Guide available on the VIVa
platform > Help > User Guide.
Note You must be familiar with the VMware Integration Validation User Guide before you start
your certification.
Document Feedback
VMware welcomes your suggestions to improve our documentation. If you have comments, send
your feedback to your project email alias.
VMware, Inc. 7
VMware Storage Certification Guide (SCSI Block)
Technical Support
To obtain technical support for tests in this guide, create a DCPN from the VMware Integration
Validation User Interface.
VMware, Inc. 8
Certification Requirements
2
This chapter describes the testbed requirements for storage certification.
Review this chapter before setting up your testbeds and make sure you meet all of the
requirements defined here. Then consult the chapter specifying the type of certification
environment you want to set up.
n Required Software
n Required Hardware
n License Requirement
n Installing ESXi
n Allocating LUNs
n Setup requirements for Configuration and Verification, Data Intergity, Failover, iSCSI,
Functional and Permanent Device Loss Tests
n Special Tests
n Configuring Datastores
n Certification Types
n User Parameters
VMware, Inc. 9
VMware Storage Certification Guide (SCSI Block)
Required Software
All storage certifications require the following software:
n ESXi
n vCenter Server
n VMware Tools
n Guest operating system listed in Table 2-2. Recommended Minimum Guest Operating Systems
for Storage Certifications
Required Hardware
All hardware components, except for the storage array under test, must be listed in the VMware
Compatibility Guides for systems, I/O, or SAN.
n Local disk minimum capacity required if boot from SAN is not available: 73 GB
n HBA and NIC port requirements for storage traffic—see Figure 2-1. Virtual Machine and
Storage Topology for iSCSI Storage.
n Two ports for vmkernel. 1 GB or higher are required for VMotion network.
n CPU: 2vCPU
n Minimum memory: 4 GB
n For Block storage array certification, if the array supports multiple storage processors
then a minimum of two storage processors are required.
n For SVD device certification, the storage array must be an FC device consisting of a
minimum of two storage processors and connected to the back-end of the SVD.
n For NAS-SVD or clustered NAS, the storage array must consist of two storage
processors or a minimum of two NAS nodes or gateways.
VMware, Inc. 10
VMware Storage Certification Guide (SCSI Block)
n SVD arrays:
n Two VMFS datastores, see Chapter 5 iSCSI Storage Certification to set up the topology for
the type of certification you want to run.
n For software iSCSI certification, you must configure the iSCSI network. For more
information, see Chapter 5 iSCSI Storage Certification.
n LUNs : 2 x 500GB LUNs from Source and Destination arrays shared across both ESXi
servers.
License Requirement
You must have licenses for the guest operating systems, vCenterServer and ESXi.
For detailed instructions, see the corresponding sections referenced in each step.
Procedure
1 Install and configure ESXi hosts. For more information, see Installing ESXi.
2 Install and configure vCenter Server. For more information, see Installing vCenter Server.
n Add hosts. Ensure that the two hosts used for tests are added to cluster. Remove extra
hosts or clusters from vCenter.
VMware, Inc. 11
VMware Storage Certification Guide (SCSI Block)
5 Install and configure virtual machines. For more information, see Installing and Configuring
Virtual Machines.
Installing ESXi
The storage certification testbed requires installing and configuring two ESXi hosts, labeled ESXi
A and ESXi B in the topology diagrams, for each certification type. See the relevant certification
chapter.
Prerequisites
n All tests must be performed with ESXiinstalled on boot from SAN. Otherwise a footnote on the
HCL will be added to indicate boot from SAN is not supported with the array. You must have
one array on the system under test.
Note Boot from SAN is not supported from the software FCoE adapter for ESXi.
n All tests run across a multi-host environment. For example, the virtual machine data integrity
test runs on the virtual machines on both ESXi hosts concurrently.
n Enable VMotion and verify that VAAI is enabled in both ESXi hosts. VAAI is enabled by
default.
Procedure
7 In the Hardware Clock section, uncheck the UTC radio box to deactivate the default settings.
8 Go to the Date and Time section and select Change. Manually set the wall clock time to match
the time set on your system components. For example: ESXi server(s), storage array(s) and
switch synchronization.
VMware, Inc. 12
VMware Storage Certification Guide (SCSI Block)
9 Click Accept.
11 Press F9 to quit.
Prerequisites
Install ESXi using the bootable CD-ROM. Set the ESXi date and time to wall clock date and time
using the excli system time set command.
Procedure
2 After the ESXi host restarts, press F2 to enter the Customize System menu.
Note For IPv6 tests, configure IPv6 address for ESXi Servers and iSCSI target server.
5 Navigate to Configuration Management Network > DNS Configuration to set the Primary and
Alternative DNS Server IP and hostname. The DNS server must successfully resolve the ESXi
and vCenter hostname.
6 Select Troubleshooting Mode Options and enable ESX Shell, SSH and Restart the
Management Agents.
8 Press Esc to return to the main screen, then press Alt+F1 to log onto the console as root.
9 Deactivate the firewall on both ESXi hosts at the command prompt before testing. . Use the
following commands to deactivate the firewall:
10 If you have not already done so, install the vSphere Web Client.
11 Using the vSphere Web Client, connect to ESXi for licensing and final installation steps.
VMware, Inc. 13
VMware Storage Certification Guide (SCSI Block)
12 From the SAN storage array, assign LUNs to the iSCSI HBAs in the ESXi system. A minimum of
four paths per LUN must be visible through the ESXi system.
13 Verify the LUN visibility and path selection. Use the client or the command line interface to
view your storage targets and path information.
Note The vCenter virtual machine is on a datastore that resides on the local device of ESXi and
not on the storage under test.
Procedure
3 Add both ESXi hosts to this cluster in this datacenter. Do not add any other ESXi hosts in this
datacenter.
What to do next
Note Ensure that HA and DRS are deactivated for the cluster. They will be activated by the tests
when required.
a Copy the STAF folder from the container to the datastore in the ESXi Host.
#docker images
VMware, Inc. 14
VMware Storage Certification Guide (SCSI Block)
#exit
2 Check the libcrypto under /lib64/libcrypt* on both the ESXi Hosts using the following
command.
ls /lib64/libcrypt*
if libcrypto.so.3 is the output of the above command, install staf_ssl3.vib on the ESXi
Host
n If libcrypto.so.3 is the output of Step 2, install staf_ssl3.vib on ESXi Host using the
following command:
n If libcrypto.so.3 is not the output of Step 2, install staf.vib on ESXi Host using the
following command:
Note The script must be run from the root directory using the following command:
install_staf.sh /vmfs/volumes/<datastore_name>/
7 Verify that the STAF is installed correctly and is pingable using the following command:
VMware, Inc. 15
VMware Storage Certification Guide (SCSI Block)
Allocating LUNs
VMware recommends allocating a minimum of 35 LUNs on the block storage array assigned to
both ESXi hosts used according to the table.
2 VMFS Spanning 50 GB
2 Pass-thru RDMs 5 GB
2 Non-pass-thru RDMs 5 GB
2 1 VMFS6, 1 VMFS5 50 GB
Note
n All LUNs mentioned in the Table 2-1. Block Storage-LUN Usage should be defined as visible to
both ESXi hosts.
n The boot LUNS for ESXi A and ESXi B are an important exception, shown in the first line of
Table 2-1. Block Storage-LUN Usage.
n The boot LUN for ESXi A should not be visible to ESXi B, and vice versa.
n The boot LUNs for ESXi A and ESXi B must not be shared by the two hosts.
With respect to creating any remaining unused LUNs, do not make LUN IDs perfectly sequential.
There should be gaps between the ID integers, for example: LUN ID 1, 3, 5 and so on.
VMware, Inc. 16
VMware Storage Certification Guide (SCSI Block)
n Verify
n LunReset
n HBA_Port_Failover
n SwitchPort_Failover
n StorageProcessor_Reset_Stress
n StorageProcessor_NDU
n VMKNIC_Failover
n vMotion_Storage_vMotion
n High_Availabilty
n Dynamic_Resource_Sheduling
n Unplanned_Device_Loss
Note This setup is not mandatory for Hot_Add_LUNs and Hot_Remove_LUNs, Volume_Grow
and Static_Discovery tests. These tests will also work without VMs. For more information about
these tests, see Chapter 4 Storage Test Descriptions.
Special Tests
(Special tests must not be queued with other tests)
n High_Availabilty
n Dynamic_Resource_Sheduling
These test cases need host reboot and VM migration, Ensure the following:
n Setup must only have VMs mentioned in Table 2-3. Remove any extra VMs registered to hosts.
n Run these test cases individually. Do not queue them with other tests.
n After these test runs are complete, ensure that the setup is intact. Verify that the VMs are
registered to the correct host and datastore.
n SCSI3 PR WE-RO tests, SCSI3 PR WE-AR tests, Shared VMDK support: These tests require
additional VM and configurations must be run separately.
VMware, Inc. 17
VMware Storage Certification Guide (SCSI Block)
Configuring Datastores
Configure a minimum of two datastores shared between the two ESXi hosts.
n Each datastore must host two virtual machines, two on each ESXi host.
n An additional RHEL-6 VM is required for SCSI3 PR WE-RO and WE-AR (Shared VMDK
support) tests. Create and configure the additional VM only before running those tests
separately.
Table 2-2. Recommended Minimum Guest Operating Systems for Storage Certifications
Red Hat Enterprise Linux (RHEL)6 64-bit for LSI SAS/LSI Parallel
An additional RHEL-6 VM is required for SCSI3 PR WE-RO and WE-AR (Shared VMDK support)
tests. Create and configure the additional VM only before running those tests separately. See the
SCSI3 PR tests section for more details.
The following figure illustrates the topology for each ESXi host and virtual machine configuration
for iSCSI storage:
VMware, Inc. 18
VMware Storage Certification Guide (SCSI Block)
Figure 2-1. Virtual Machine and Storage Topology for iSCSI Storage
Note Do not use -p as a value for <Adapter Type>. Using -p may cause anomalous behavior.
n One virtual network adapter connected to the virtual machine management network virtual
switch.
n 20 GB of virtual disk for the virtual machine system drive for Linux virtual machines with 2 GB
of available free space.
VMware, Inc. 19
VMware Storage Certification Guide (SCSI Block)
n For block storage, Datastores 1 and 2 are on VMFS. Also, you need 10 iSCSI volumes of size 3
GB mounted on both ESXi hosts. All the iSCSI volume names must be in sequential order.
Ensure that after you reboot the host, it boots properly and does not wait or expect an input to
proceed. Some hosts prompt you to press F1 to proceed with the boot or a security warning might
display stating that the box has been opened and needs input to proceed.
Note
n Ensure that /usr/local/etc/ directory exists in all the Virtual Machines.
n All the VMs mentioned in the following table must have the same root password.
n ESXi hosts must be added to Host Selection page in VIVa, using the root username. Also,
ensure that both the ESXi hosts have same root password.
n Each VM must have only one RDM mounted as /rdm1 and must be 5 GB or more.
n While creating FS on RDM, if you are creating ext4 file system in SUSE 11, ensure that it is not
mounted as read-only.
n Ensure that glibc libraries are installed in all the VMs. Run the following command to install
the libraries (if required):
ESXiA-VM1- RHEL6 64 bit LSI Parallel YES Non Pass-thru Shared on VMFS6
lin-lsiPAR Datastore 1
ESXiB-VM2- SLES 11 32 bit Bus Logic YES Non Pass-thru Shared on VMFS5
lin-BUS Datastore 2
Prerequisites
1 Linux Operating Systems as listed in Table 2-2. Recommended Minimum Guest Operating
Systems for Storage Certifications
VMware, Inc. 20
VMware Storage Certification Guide (SCSI Block)
2 VMware Tools
Procedure
1 In vSphere Web Client or vSphere Client, mount the VMware Tools virtual disk on the guest
operating system.
To mount VMware tools, Right click the VM, click Guest OS and then select Install VMware
Tools.
4 Open a terminal window and run the installer and configure VMware Tools by using the
following command. This command may vary slightly across different Linux distributions.
cd vmware-tools-distrib
sudo ./vmware-install.pl -d
Results
The vmware-config-tools.pl configuration file runs after the installer file completes execution.
VMware, Inc. 21
VMware Storage Certification Guide (SCSI Block)
Figure 2-2. Virtual Machine and Storage Configuration for VAAI, ATS, BlockZero, and FullCopy
Tests
Note The boot virtual disk for the virtual machines used in the test must not exceed 6 GB.
Datastores D1, D2, and rawLUN P1 must be shared between both the hosts. Both D1 and D2
datastores must have minimum of 50 GB free space. The RawLUN P1 must be 20 GB.
n TPReportCapable
n TP_Soft_Error_Distributed
n TP_Hard_Limit_Provision_More
n Create a datastore named TESTVOL using the thin provisioned LUN of 10 GB. The test cases
fails if the free space on TESTVOL is greater than 10 GB. This datastore should be shared
across both the hosts.
n Another thin provisioned raw LUN of 3 GB is needed. This LUN must be added to TESTVOL
when prompted by the TP_Hard_Limit_Provision_More test.
VMware, Inc. 22
VMware Storage Certification Guide (SCSI Block)
VMFS6 is the new file system version shipped with vSphere 2016 release. On VMFS6 datastores,
vSphere 2016 supports the following:
n Automatic asynchronous reclamation of free space for VMFS file deletion or truncation.
The unmap opertation on the VMFS5 datastore continues to be manual operation. Successful
completion of the tests validates that the TP UNMAP feature operates in a stable manner with the
specified storage array.
n 1 x RHEL7 VM with name "rhel7-64bitpv" The VM "rhel7-64bitpv" can be kept on some local or
other datastores which is not used by test.
n One VMFS5 and VMFS6 datastore created on both source & destination LUNs.
n Do not keep any VM on test datastores as the test tries to unmount/remount these datastores
while adding claim rules, so unmount operation will fail if there are registered VMs on these
datastores.
n Create a datastore using thin provisioned LUN of 400 GB. Datastore version must be VMFS5
and shared across both the hosts.
n Create RHEL 6 64 bit VM on the datastore created in the previous step. It must be registered
to the primary host. Remove extra vmdks apart from GOS vmdk before running these tests.
n An extra thin provisioned raw LUN of 50 GB must be presented to both the hosts.
n The GOS VMDK size must not be greater than 20 GB. No additional VMDKs must be
attached except for the GOS VMDK.
VMware, Inc. 23
VMware Storage Certification Guide (SCSI Block)
n Ensure that C:\Temp directory is created in this VM before running Automatic UNMAP
tests.
n Auto login must be enabled on the VM, with the password set as ca$hc0w. For more
information, see the Additional Settings for Virtual Machine.
n VMFS6 datastore created on a thin-provisioned LUN. The datastore size must be 200 GB or
more.
n VMFS6 datastore spanned across two thin-provisioned LUNs. The datastore size must be 200
GB or more.
n VMFS6 datastore created on a misaligned partition. The datastore size must be 200 GB or
more.
n For the Volume Grow test, four additional thin provisioned raw LUNs of 10 GB are needed.
Example output:
partedUtil getUsableSectors
/vmfs/devices/disks/naa.600601605bd02d0048f0a9c64a16e511
1 41943039
In the preceding example, 41943039 is end sector number. Use this number to create
partition.
VMware, Inc. 24
VMware Storage Certification Guide (SCSI Block)
To enable auto login on Windows Administrator accounts, perform the following steps:
1 Navigate to Start > Run. In the Run window, type netplwiz and click OK.
2 In the Users tab, clear the checkbox for Users must enter a user name and password to use
this computer, and click Apply.
4 In the Automatically Log On window, enter the Windows administrator user name that you
want to automatically log into and the account password, and click OK.
Networking inside the virtual machines is configured for DHCP. For each virtual machine, set disk
time out value to 60.
For example:
For Windows virtual machines, set the Driver Signing Options to Ignore. Reboot the host to check
if Windows expects an input to proceed. Some hosts prompt you to press F1 to proceed or a
security warning might appear stating that the box has been opened and needs user input to
proceed.
Certification Types
VMware recognizes several levels/kinds of certifications.
Full Certification
Full Certification is a mandatory certification for all new releases of ESXi (with the exception of
binary compilable releases) and if the storage array is getting certified for the first time with
VMware.
Partners must run and pass all test items designated by the corresponding certification kit.
VMware, Inc. 25
VMware Storage Certification Guide (SCSI Block)
Recertification
A recertification is required when something cannot be carried forward. It is specifically required in
following two cases:
n If a partner makes one or more critical changes in the firmware or features of an array product
that has already been certified.
n If VMware releases a new vSphere version that requires recertification to verify compatibility
with a partner’s previously certified products.
mSFR certification process is changed in new VIVa certification platform. mSFR approval request
must be raised through DCPN tool after initial steps of test session creation and questionnaire
inputs in VIVa. mSFR approval request appears as a manual test in VIVa. As a part of this test,
DCPN case can be created from VIVa and upload the request form. Upon review and approval of
the request, the test status is marked as passed and allows to run remaining mSFR tests.
Therefore, VMware offers an option to run a minimal, basic set of tests with a shorter total test
duration, rather than running a full certification. If the firmware update meets the criteria for a
recertification, perform the following:
2 A new test case MSFR_Approval_test is available in Test Selection page. This is a manual test
added specifically for mSFR approval.
3 Click the flag icon which is next to MSFR_Approval_test on theTest Execution page and
create a support request.
4 You have to download mSFR request form from code.vmware.com and fill all the required
details and upload to the support request created.
5 Once you get the approval, the MSFR_Approval_test will be automatically marked as passed.
VMware, Inc. 26
VMware Storage Certification Guide (SCSI Block)
6 After that you can run all the listed tests and proceed for submission.
Note
n Complete the mSFR approval process before running the tests
n You must be certain that your array firmware meets the mSFR certification criteria. If it is
determined later that your configuration requires full certification, the log review process may
reject the submitted certification.
n Certification type—select Full Certification or Partial Feature Certification, the required tests
are displayed in the test catalog. For more information about test configurations for other
protocols, see respective certification guides.
FC FC SAN
FC DAS
FC SAN - SVD
NAS NAS-SVD
VMware, Inc. 27
VMware Storage Certification Guide (SCSI Block)
Note If your array is Software and Hardware iSCSI, you must select the Software and
Hardware iSCSI topology and select any one of configurations from below list.
n Indicate if there are more than one SP controllers in the storage array.
n Select No otherwise.
n VAAI support in the array: Select specific primitives to certify or supported—Block Zero,
Full Copy, Hardware Assisted, Locking (also called Atomic Test and Set (ATS)), and Thin
Provisioning. Indicate if an Async VAAI plug-in is required for any of these VAAI primitives.
n Support for WE-AR type reservation: Select Yes, if FC arrays supports Write Exclusive - All
Registrants type SCSI3 persistent reservation to claim support for Shared VMDK feature.
n Select No if a vendor-specific plug-in is not supported, and if the certification is for the
VAAI T10 plug-in.
n Select Yesif the array supports iSCSI over IPv6. This selection lists the tests which support
both iSCSI over IPv4 and iSCSI over IPv6.
n Select No if the array does not supports iSCSI over IPv6. This selection lists the tests which
only support iSCSI over IPv4. IPv6 test cases will be hidden if this option is selected.
n Does your array support 1 MB UNMAP granularity or less than 1 MB UNMAP granularity?
VMware, Inc. 28
VMware Storage Certification Guide (SCSI Block)
n Select No if the array only supports UNMAP granularity of more than 1 MB.
n SVS Support: Any software based storage solution which is implemented as a virtual appliance
and serve storage to storage clients or servers outside the Storage cluster through iSCSI or
NAS host IO protocol can come for certification.
n mSFR support
User Parameters
Prompts appear where you must enter these parameters. You might have to enter more
information during a specific test.
Note Perform the following steps to fetch parameter values for HOST1PG and HOST2PG:
1 In the vCenter, navigate to Host > Configure > Storage Adapters and click Hba used for iSCSI
port binding.
2 Enter the vmkernel adapter names listed under the Network Port Binding section for vmhba.
For example: vmk1, vmk2. Port group names such as VMkernel/VMkernel 2 are not applicable
anymore. Test case fails if port group names are entered.
Extended xCOPY
VMware, Inc. 29
VMware Storage Certification Guide (SCSI Block)
Certification Type
Data Store
dstype Enter datastore type as VMFS for Provide the datastore type.
iSCSI protocol.
PrimaryDSPathPolicy Enter Path Policy for VMFS After path policy is used, you
Datastore 1, VMW_PSP_FIXED, can have PathPolicyDS1 and
VMW_PSP_FIXED_AP, PathPolicyDS1 set to the same value.
VMW_PSP_MRU,
VMW_PSP_MRU_RANKED,
VMW_PSP_RR, partner_PSP.
SecondaryDSPathPolicy Enter Path Policy for VMFS After path policy is used, you
Datastore 2, VMW_PSP_FIXED, can have PathPolicyDS1 and
VMW_PSP_FIXED_AP, PathPolicyDS1 set to the same value.
VMW_PSP_MRU,
VMW_PSP_MRU_RANKED,
VMW_PSP_RR, partner_PSP.
vMotion Information
I/O Tools
SG3 Enter the full path for the folder When running GOS SCSI2/SCSI3 tests
location of SG-3util for Windows only, use the Windows expected
virtual machines. path with a backslash (\). Example:
C:\SG-3util For the Verify test only,
use a forward slash (/).
H1VM1 Enter VM name for RHEL6 VM on Used functional, fail over, and other
Host1. tests.
VMware, Inc. 30
VMware Storage Certification Guide (SCSI Block)
H1VM2 Enter VM name for SLES 11 64bit Used functional, fail over, and other
Linux VM on Host1. tests.
H2VM1 Enter VM name for RHEL6 Linux VM Used functional, fail over, and other
on Host2. tests.
H2VM2 Enter VM name for SLES 11 32bit Linux Used functional, fail over, and other
VM on Host2. tests.
PRIMARYCHAPNAME Enter TestHost initiator CHAP Name. Provide the initiator CHAP name for
ESXi A.
PRIMARYCHAPSECRET Enter TestHost initiator CHAP Secret. Provide the initiator CHAP secret for
ESXi A.
SECONDARYCHAPNAME Enter AuxHost initiator CHAP Name. Provide the initiator CHAP name for
ESXi B.
SECONDARYCHAPSECRET Enter AuxHost initiator CHAP Secret. Provide the initiator CHAP secret for
ESXi B.
MUTUALCHAPNAME Enter initiator Mutual CHAP Name. Provide the initiator mutual CHAP
name, used for the BiDirectionalChap
test.
MUTUALCHAPSECRET Enter initiator Mutual CHAP Secret. Provide the initiator mutual CHAP
secret, used for the BiDirectionalChap
test.
Vmhba Enter VMHBA under test. Enter the VMHBA id of the HBA (For
example: vmhba2).
staticIPv6Address1 Enter IPV6 address of HBA. Enter the IPV6 address of HBA.
staticIPv6Address2 Enter second IPV6 address of HBA. Enter the second IPV6 address of
HBA.
gatewayIPv6 Enter IPv6 address of gateway of Enter the IPv6 address of gateway of
HBA. HBA.
TargetName Enter IPv6 address of Target. Enter the IPv6 address of Target.
NoOfLunsPerTarget Enter number of LUNs for target. Enter the number of LUNs for target.
ESXHostname Enter FQDN of ESX host under test. Enter the FQDN of ESX host under
test.
ESXip Enter IP address of ESX under test. Enter the IP address of ESX under
test.
VMware, Inc. 31
VMware Storage Certification Guide (SCSI Block)
vmnic1 Enter vmnic to be used for Enter the vmnic to be used for
PortGroup1. PortGroup1 (For example: vmnic1)
vmnic2 Enter vmnic to be used for Enter the vmnic to be used for
PortGroup2. PortGroup2 (For example: vmnic2)
vmnicIPv6add1 Enter IPv6 address for PortGroup1. Enter the IPv6 address for
PortGroup1.
vmnicIPv6add2 Enter IPv6 address for PortGroup2. Enter the IPv6 address for
PortGroup2.
TestVswitch Enter the vSwitch configured for SW Enter the vSwitch name.
FCoE (For example: vSwitch1).
vmnicIPv4add1 Enter IPv4 address for PortGroup1 Enter IPv4 address for PortGroup1
vmnicIPv4add2 Enter IPv4 address for PortGroup2 Enter IPv4 address for PortGroup2
gatewayIPv4 Enter IPv4 address of gateway of HBA Enter IPv4 address of gateway of HBA
SHAREDLUN Enter Test LUN UUID for GOS Enter the LUN naa for Pass-thru
SCSI3PR and SCSI2 Reserve Tests. RDM for GOS SCSI-3 Persistent
Reservation tests and GOS SCSI-2
Reserve/Release tests.
HOST1PG Enter 2 VMkernel NICs for VMkernel Port group network label of VMkernel
virtual switch-on Host 1. type vSwitch. For example: VMk1,
VMk2. This parameter is used for
VMKNIC_Failover test.
For more information, see Note.
HOST2PG Enter 2 VMkernel NICs for VMkernel Port group network label of VMkernel
virtual switch-on Host 2. type vSwitch. For example: VMk1,
VMk2. This parameter is used for
VMKNIC_Failover test.
For more information, see Note.
TESTVOL Please Enter Thin Provisioned VMFS6 VAAI Thin Provisioned VMFS volume.
Volume (Capacity of 10 GB).
TESTVOL_LUN Enter naa ID of the LUN used Thin TESTVOL LUN id.
Provisioned VMFS Volume.
VMware, Inc. 32
VMware Storage Certification Guide (SCSI Block)
LUNformat Enter the device format of the LUN. Enter the device format of the LUN.
For example: 512e or 512n and
so on. This parameter is used for
VMFS_Spanning test.
ISCFSupport Does your array supports Internal Used for the array that has
Storage Controller Failovers (ISCF) transparent failover to ESXi Host.
'yes', or 'no'.
primaryHostHBA Enter primary host HBA. Enter vmhba# for the primary ESXi
host (For example: vmba1).
secondaryHostHBA Enter secondary host HBA. Enter vmhba# for the secondary ESXi
host (For example: vmba1).
PDLLun Enter the naa ID for the PDL LUN. LUN NAA number to unmap/remove
for Unplanned_Device_Loss test.
Ensure that this LUN is free and
datastores are not created using this
LUN.
GOSvmdkPath Enter GOS vmdk path for standard- Used by Full_Copy_Clone_VM test.
vm. You can use an existing virtual
machine for this test.
SHAREDLUN Enter the naa ID of shared LUN for Enter a naa id of the rdm which is
SCSI3PR tests for SHAREDLUN. used for scsi3pr tests.
ThinProvisionedLUN Enter a free thin provisioned LUN naa Enter the naa ID of the
ID for ThinProvisionedLUN (50 GB). thin provisioned raw LUN
of 50 GB. Needed for
VGrowEagerZeroedThickSReclaim
test.
ThinProvisionedDatastore Enter the Thin Provisioned VMFS Enter the name of the VMFS5
Volume for ThinProvisionedDatastore datastore created using thin
(400 GB). provisioned LUN of 400 GB. This is
used for TPUNMAP tests.
TPVM Enter the linux VM name for UNMAP Enter the RHEL 6 64 bit VM name.
tests for 'TPVM'. This is used for TPUNMAP tests.
TVPMPassword Enter the root password for the VM Enter root password for TPVM.
for 'TPVMPassword'.
VMware, Inc. 33
VMware Storage Certification Guide (SCSI Block)
Vendor Enter Array Vendor Name. Vendor Name of the array on which
you are running certification. For
example: VMW.
ESXi1_boot_device is ESXi1 booted from SAN. Enter yes if your array supports boot
from SAN.
ESXi2_boot_device is ESXi2 booted from SAN. Enter yes if your array supports boot
from SAN.
MajorCertSR For MSFR, SR number of previously Enter the SR number of the Major
certified Major Firmware version. Firmware version, which is using the
mSFR. If you have no mSFR, input NA.
mSFReligibilitySR For MSFR, Enter SR number of mSFR Enter the SR number which approves
eligibility approval request. the mSFR eligibility. If you have no
mSFR input NA.
Vendor Enter Array Vendor Name. Vendor Name of the array on which
you are running certification. For
example: VMW.
Model Enter Array Model. Array Model of which you are running
certification. For example: datatank10.
ESXi1_boot_device is ESXi1 booted from SAN. Enter yes if your array supports boot
from SAN.
ESXi2_boot_device is ESXi2 booted from SAN. Enter yes if your array supports boot
from SAN.
MajorCertSR For MSFR, SR number of previously Enter the SR number of the Major
certified Major Firmware version. Firmware version, which is using the
mSFR. If you have no mSFR, input NA.
mSFReligibilitySR For MSFR, Enter SR number of mSFR Enter the SR number which approves
eligibility approval request. the mSFR eligibility. If you have no
mSFR input NA.
vmdevice Enter the name of the HBA/NIC/CNA Enter the name of the HBA/NIC/CNA
device used to connect the Storage device used to connect the Storage
array. array.
VMware, Inc. 34
VMware Storage Certification Guide (SCSI Block)
DriverName Enter the Driver name of vmhba or Enter the Driver name of adapter or
vmnic used for the certification. NIC connected to array according to
the following command:
Note Ensure that IO Adapter driver
For software iSCSI : esxcli network
used in the certification testbed is
nic get -n <vmnic>
a certified or inbox driver in ESXi
8.0. Driver name entered match with For others: esxcli storage san
the value in VMware HCL, otherwise <Protocol> list
submission fails.
DriverVersion Enter the Driver version of vmhba or Enter the Driver version of adapter or
vmnic used for the certification. NIC connected to array according to
the following command:
Note Ensure that IO Adapter
For software iSCSI : esxcli network
driver version used in the certification
nic get -n <vmnic>
testbed is a certified or inbox driver
in ESXi 8.0. Driver version entered For others: esxcli storage san
match with the value in VMware HCL, <Protocol> list
otherwise submission fails.
ServerModel Enter the Server model used for the Enter the Server model used for the
certification. certification according to the VCG.
VMware, Inc. 35
Running the Tests
3
This chapter provides information about running the certification tests in online and offline modes.
For more information, see the VMware Integration Validation User Guide.
n Online Mode
n Offline Mode
Online Mode
Before running the certification tests in online mode, verify the testbed prerequisites.
Procedure
2 In the Agent Selection tab, select the Online Mode radio button.
If you don't have an agent deployed already, download the agent OVA file by clicking the
AGENT IMAGE button and deploy the agent. For steps to deploy and register the agent, see
the VMware Integration Validation User Guide.
Note Agent VM must be deployed on the third ESXi host, not on test hosts.
6 In the Test Parameters tab, enter the parameters required for the selected tests.
Offline Mode
Before running the certification tests in offline mode, verify the testbed prerequisites.
VMware, Inc. 36
VMware Storage Certification Guide (SCSI Block)
Procedure
3 In the Agent Selection tab, select the Offline Mode radio button.
Note Agent VM must be deployed on the third ESXi host, not on test hosts.
6 In the Test Selection tab, all the tests are selected by default.
7 In the Test Parameters tab, update the parameters required for the selected tests.
c In the Host Selection tab, enter the host details and click NEXT.
e In the Test Parameters tab, enter the required parameters and click NEXT.
VMware, Inc. 37
Storage Test Descriptions
4
This chapter describes the storage tests and estimated runtime. For VN2VN supported arrays,
VN2VN must be enabled.
Extended Xcopy
VMware, Inc. 38
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
mSFR Test
CopyBinary Test
VMware, Inc. 39
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
iSCSI Tests
Dynamic Target Discovery with iSCSI Verifies that ISCSI targets can be 20
IPv4 Target Names discovered over IPv4 iSCSI SAN by
specifying the IPv4 iSCSI target name
VMware, Inc. 40
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
Static Target Discovery with iSCSI Verifies that iSCSI targets can be 20
IPv4 Target Names discovered over IPv4 iSCSI SAN
by specifying the IPv4 iSCSI Target
names.
Target discovery with discovery Verifies that the same subnet targets 20
IPv4 address in same Subnet with are discovered through the iSCSI
portbinding for depedent or software adapter when there is compliant
iSCSI adapters port binding configured for the iSCSI
adapter.
Verify the Boot time with iSCSI targets The purpose of this test case is to 20
discovered via ipv4 iSCSI SAN verify the boot time with iSCSI.
Functional Tests
VMware, Inc. 41
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
SVD Tests
VMware, Inc. 42
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
ATS Tests
VMware, Inc. 43
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
BlockZero Tests
FullCopy Tests
VMware, Inc. 44
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
VMware, Inc. 45
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
VMware, Inc. 46
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
Note
n For running the variable VAAI Array reported XCOPY Transfer size tests, create the following RHEL 7 virtual
machines on the primary datastore that is registered to the primary ESXi host.
n XCOPY_VM_eager_zeroed_thick
n XCOPY_VM_thick
n XCOPY_VM_thin
n Ensure that the above VMs have the same root password.
n The guest operating system’s VMDK type of the three RHEL 7 virtual machines that you create must correspond to
the virtual machine’s name.
n Run the following command on the LUNs used to run the tests and make sure VAAI T10 plug-in VMW_VAAIP_T10
is listed.
b If there is an existing claimrule for the array, remove it using the following command:
d If there is an existing claimrule for the array, remove it using following commands. Skip to step f if there is no
claimrule.
f Add filter claim rule using the following command for VAAI T10 plugin: \
After adding the claimrule, load and run the Filter using commands mentioned in steps 5.
VMware, Inc. 47
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
Note Before running the Thin Provisioning tests, ensure that a VMFS6 datastore is created using 10 GB thin provisioned
LUN. The datastore must be shared between both the ESXi hosts. Test cases fails if free space for the datastore exceeds
10 GB.
VMware, Inc. 48
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
TP UNMAP Tests
Note Review the information in Table 2-4 to update the space reclamation status in the claim form before submitting
the certification request.
VMware, Inc. 49
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
VMware, Inc. 50
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
iSER Tests
VMware, Inc. 51
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
Note Tests similar to the IPv4 configuration appear for IPv6 based on your questionnaire selections. Descriptions for
the common tests appear earlier in this table. Following are the details specific to IPv6 tests.
Dynamic Target Discovery with iSCSI Verifies that ISCSI targets can be 20
IPv6 Target Names discovered over ipv6 iSCSI SAN
by specifying the IPv6 iSCSI target
names.
VMware, Inc. 52
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
Static Target Discovery with iSCSI Verifies that iSCSI targets can be 20
IPv6 Target Names discovered over ipv6 iSCSI SAN by
specifying the IPv6 iSCSI Target
names.
Target discovery with discovery Verifies that the same subnet targets 20
IPv6 address in same Subnet with are discovered through the iSCSI
portbinding for dependent-iSCSI adapter when there is compliant
adapters port binding configured for the iSCSI
adapter.
Verify the Boot time with iSCSI targets The purpose of this test case is to 20
discovered using ipv6 iSCSI SAN verify the boot time with iSCSI.
VMware, Inc. 53
VMware Storage Certification Guide (SCSI Block)
Prerequisites
n Red Hat Enterprise Linux (RHEL 6) 64-bit for LSI SAS is the recommended Guest Operating
Systems for SCSI3PR Tests.
Procedure
# wget http://sourceforge.net/projects/staf/files/staf/V3.4.26/
STAF3426-setup-linux-amd64.bin
# vi /usr/local/staf/bin/STAF.cfg
VMware, Inc. 54
VMware Storage Certification Guide (SCSI Block)
# reboot
4 Download and install SG3-Util package version 1.28 and above, and its dependency packages.
Note For certain tests like vMotion_Storage_vMotion, VMware HA and DRS must not have a
configured shared RDM. Ensure that the shared RDM is created just before SCSI-3PR reserve
tests and removed as soon as the tests are successfully completed.
Procedure
1 In the vSphere Web Client inventory, select the RHEL6 virtual machine and power it off.
2 Select Edit Settings and select a new SCSI controller device and click Add.
3 Expand New SCSI controller and change type to VMware paravirtual, change SCSI BUS
Sharing to Physical and click OK.
4 Select Edit Settings again and select a new RDM DISK device and click Add.
6 Expand New Hard disk, Ensure that the compatibility mode is physical and change virtual
Device Node to SCSI controller1 and SCSI (1:0).
Procedure
1 From the vSphereWeb client inventory, select the RHEL6 virtual machine and power it off.
2 Select Edit Settings and select a new SCSI controller device and click Add.
3 Expand New SCSI controller and change type to VMware paravirtual, change SCSI BUS
Sharing to Physical and click OK.
4 Select Edit Settings again and select a new Exisiting Hard Disk device and click Add.
5 Select the vmdk file from the disk, which was added as RDM in the virtual machine on ESXi A
and click OK.
6 Expand New Hard disk and change virtual Device Node to SCSI controller1 and SCSI (1:0).
VMware, Inc. 55
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
VMware, Inc. 56
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
VMware, Inc. 57
VMware Storage Certification Guide (SCSI Block)
Test Name Test Description Estimated Test Run Time (in minutes)
Refer SCSI-3 PR WE-RO tests configuration steps for configuring RHEL VM.
Note
n The virtual machine must be in the power on state.
n Multiple paths from hosts to storage are required: Use FIXED MPP only.
VMware, Inc. 58
VMware Storage Certification Guide (SCSI Block)
Table 4-1. SCSI-3 WE-AR Persistent Reservation Tests - Shared VMDK (continued)
VMware, Inc. 59
VMware Storage Certification Guide (SCSI Block)
Table 4-1. SCSI-3 WE-AR Persistent Reservation Tests - Shared VMDK (continued)
Example output:
partedUtil getUsableSectors
/vmfs/devices/disks/naa.600601605bd02d0048f0a9c64a16e511
1 41943039
In the preceding example, 41943039 is end sector number. Use this number to create
partition.
VMware, Inc. 60
VMware Storage Certification Guide (SCSI Block)
VMware, Inc. 61
iSCSI Storage Certification
5
This chapter contains information specific to iSCSI certifications.
n Tests
n Tests
n Tests
To certify an independent HW iSCSI adapter, configure your testbed as described in this section.
To certify a dependent HW iSCSI adapter, see Software iSCSI Testbed Topology or Software and
Hardware iSCSI Testbed Topology.
Set up the Hardware iSCSI test environment according to the topology shown in figure.
VMware, Inc. 62
VMware Storage Certification Guide (SCSI Block)
n Dual single ported HBAs or one single dual ported HBA on each ESXi host.
n The HBAs on any ESXi host must be from the same vendor. Different ESXi host may have
HBAs from a
different vendor.
Tests
The Hardware iSCSI certification requires these additional tests:
Static_Discovery
UniDirectionalChap
VMware, Inc. 63
VMware Storage Certification Guide (SCSI Block)
n Use one Software iSCSI adapter and one Dependent Hardware iSCSI adapter.
As defined in the VMware iSCSI SAN Configuration Guide for ESXi 5.x, a Dependent Hardware
iSCSI adapter depends on VMware networking and iSCSI configuration and management
interfaces provided by VMware.
Set up the Software iSCSI test environment according to the following topology.
n Dual single ported NICs or one single dual ported NIC on each ESXi host.
n Two Software iSCSI adapters on each ESXi host or one Software iSCSI adapter and one
Dependent Hardware iSCSI adapter on each ESXi host.
n For IPv6 tests, configure an IPv6 address for ESXi hosts and the iSCSI target array.
VMware, Inc. 64
VMware Storage Certification Guide (SCSI Block)
Use the vSphere CLI command to bind the iSCSI port to the iSCSI adapter:
The following examples show how to bind multiple ports that you created for physical NICs to the
software iSCSI adapter or to multiple adapters (one for software iSCSI adapter, one for dependent
hardware iSCSI adapter).
Note For software iSCSI, repeat this command for each iSCSI port connecting all ports with the
software iSCSI adapter.
This example shows how to connect the iSCSI ports vmk1 and vmk2 to the software iSCSI adapter
vmhba33.
If you use the vSphere Web Client to display the Paths view for the vmhba33 adapter in this
example, you see that the adapter uses two different 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 indicate the two
network adapters used for multipathing in this example.
Example: Connecting iSCSI Ports to One Software iSCSI Adapter and One Dependent Hardware
iSCSI Adapter
This example shows how to connect the iSCSI ports vmk1 and vmk2 to the corresponding SW iSCSI
adapter vmhba33 and the Dependent Hardware iSCSI adapter (vmhba34).
VMware, Inc. 65
VMware Storage Certification Guide (SCSI Block)
Figure 5-3. Example Network Configuration Setup for Software and Hardware iSCS - Screen 1
Figure 5-4. Example Network Configuration Setup for Software and Hardware iSCS - Screen 2
Tests
The Software iSCSI certification requires the following additional tests.
Tests marked with two asterisks (**) are part of a partial certification as well as a full certification.
UniDirectionalChap
VMKNIC_Failover
Static_Discovery
BiDirectionalChap
For the VMKNIC_Failover test: Use vmk1, vmk2 for the port group name in the vmkernel virtual
switches on ESXi A and ESXi B.
VMware, Inc. 66
VMware Storage Certification Guide (SCSI Block)
Additionally, there are two configuration options for the Software iSCSI part of the configuration.
n Use one Software iSCSI adapter and one Dependent Hardware iSCSI adapter.
As defined in the VMware iSCSI SAN Configuration Guide for ESXi 5.x, a Dependent Hardware
iSCSI adapter depends on VMware networking and iSCSI configuration and management
interfaces provided by VMware.
Set up the Software and Hardware iSCSI test environment according to the following topology:
n Dual single ported NIC or single dual ported NIC installed on the first ESXi host.
n Dual single ported HBAs or single dual ported HBA installed on the second ESXi host.
n Two Software iSCSI adapters must be configured on ESXi A or one Software iSCSI adapter and
one Dependent Hardware iSCSI adapter must be configured on ESXi A.
VMware, Inc. 67
VMware Storage Certification Guide (SCSI Block)
n For IPv6 tests, configure an IPv6 address for ESXi hosts and the iSCSI target array.
Use the vSphere CLI command to bind the iSCSI port to the iSCSI adapter:
The following examples show how to bind multiple ports that you created for physical NICs to
the software adapter or to multiple adapters (one for software iSCSI adapter, one for dependent
hardware iSCSI adapter).
Note With dependent hardware iSCSI, make sure to bind each port to an appropriate
corresponding adapter.
This example shows how to connect the iSCSI ports vmk1 and vmk2 to the software iSCSI adapter
vmhba33.
If you use the vSphere Web Client to display the Paths view for the vmhba33 adapter in this
example, you see that the adapter uses two different 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 indicate the two
network adapters used for multipathing in this example.
Example: Connecting iSCSI Ports to One Software iSCSI Adapter and One Dependent Hardware
iSCSI Adapter
This example shows how to connect the iSCSI ports vmk1 and vmk2 to the corresponding SW iSCSI
adapter vmhba33 and the Dependent Hardware iSCSI adapter (vmhba34).
VMware, Inc. 68
VMware Storage Certification Guide (SCSI Block)
Figure 5-6. Example Network Configuration Setup for Software iSCSI - Screen 1
Figure 5-7. Example Network Configuration Setup for Software iSCSI - Screen 2
Tests
The Software and Hardware iSCSI certification requires these additional tests:
UniDirectionalChap
Max_Targets
BiDirectionalChap
VMware, Inc. 69
VMware Storage Certification Guide (SCSI Block)
improve performance and lower CPU utilization by replacing the TCP stack's transport protocol
with an RDMA transport.
Since moving data uses RDMA, it lands in its final destination on the remote end without additional
copying from the TCP packet buffers. An RDMA engine within the RDMA controller handles data
transport and security concerns.
Note Storage vendors who support iSER at their target array side must go through the
certification process to list their model in HCL.
n RHEL 6 OS
Procedure
VMware, Inc. 70
VMware Storage Certification Guide (SCSI Block)
n 6 - 10 GB LUNs
n 6 - 2 GB LUNs
Test Configuration
The following list contains the requirements for the test configuration:
Procedure
1 Create the NFS server on any Linux machine (for example, RHEL 6).
3 Copy the <VMname>.vmdk file and add it to the mount point created on the NFS server.
Procedure
1 Create a RHEL 6 virtual machine with an 8 GB disk and name it RHEL6_U5_64bit_8G. Deploy
this virtual machine.
3 Copy the disk files to the NFS mount point that is, both RHEL6_U5_64bit_8G.vmdk and
RHEL6_U5_64bit_8G-flat.vmdk.
4 In addition, copy the disk files to the datastore you created, that is, copy both
RHEL6_U5_64bit_8G.vmdk and RHEL6_U5_64bit_8G-flat.vmdk.
VMware, Inc. 71
VMware Storage Certification Guide (SCSI Block)
Procedure
7 Select Linux as the Guest OS Family and RHEL 6 as the Guest OS Version.
8 Remove the existing hard disk by clicking the cross mark at the New Hard Disk option.
9 Select Existing Hard Disk from New Device in the drop down menu and click Add.
10 Browse the previously created RHEL vmdk (for example, the RHEL VMDK created in Step 4).
11 Go to Edit setting, select New Hard Disk from the New device drop down menu and click
Add.
12 Change the new hard disk size to 1 GB (must be 1 GB only) and click OK.
13 Go to the VM folder in the datastore on which the VM is deployed and locate Add.vmdk.
14 Copy the Add.vmdk to the NFS mount point created in Step 2 and also to the datastore
created in Step 3 under Configuring the NFS Server.
Tests
iSER_Failover
iSER_AllPathDown
iSER_DT
iSER_ReserveRelease
iSER_RDM_Import_Export_Physical
iSER_RDM_Import_Export_Virtual
iSER_SVmotionWithSnapshot
iSER_SuspentResume
iSER_Target_LunReset
iSER_VMFSSpan
iSER_MaskUnMaskLun
iSER_AddRemove
VMware, Inc. 72
VMware Storage Certification Guide (SCSI Block)
Test Parameters
The following table describes the test parameters that you must supply to the plug-in.
VMware, Inc. 73
Fibre Channel Storage
Certifications 6
This chapter contains information specific to Fibre Channel SAN and DAS certifications.
n Two ESXihosts
n Dual single ported HBAs or single dual ported HBA on each ESXi host
VMware, Inc. 74
VMware Storage Certification Guide (SCSI Block)
n The HBAs on any ESXi host must be from the same vendor. Different ESXi host may have
HBAs from a different vendor.
n Dual FC switches
n Dual single ported HBAs or one single dual ported HBA on each ESXi host
n The HBAs on any ESXi host must be from the same vendor. Different ESXi host may have
HBAs from a different vendor.
VMware, Inc. 75
VMware Storage Certification Guide (SCSI Block)
VMware, Inc. 76
SVD/Gateway Storage
Certifications 7
The Storage Virtualization Device (SVD) certification allows you to certify multi-protocol SVDs and
Gateway devices. Gateways are typically protocol converters like the iSCSI Gateways.
SVDs can aggregate and virtualize external SAN LUNs and can also perform protocol conversions
like Gateways. SVDs can be array controller, network, appliance or software-based storage
virtualization features.
The SVD certification is for ESXi hosts connected to multi-protocol SVDs and Gateways that export
LUNs from back-end external SAN storage devices.
If you follow the optimization guidelines listed here, you do not need to perform two separate
certifications for array-based SVDs. The SVD will be listed under both Storage Array as well as
SVD in the VMware Hardware Compatibility List with one certification.
n Datastore1
n Pass-thru and non-pass-thru RDMs assigned to virtual machines located on ESXi A host
Use back-end storage array LUNs for all remaining datastores and RDMs.
Use back-end storage array LUNs for all datastores and RDMs.
Use back-end storage array LUNs for all datastores and RDMs.
This chapter contains information specific to SVD certifications for the Software and Hardware
iSCSI protocol.
n SVD/Gateway Tests
VMware, Inc. 77
VMware Storage Certification Guide (SCSI Block)
n Dual single ported HBAs/NICs or one single dual ported HBA/NIC on each ESXi host.
n The HBAs on any ESXi host must be from the same vendor. Different ESXi host may have
HBAs from a different vendor.
n Dual single ported NIC or single dual ported NIC installed on one ESXi host.
n Dual single ported HBAs or single dual ported HBA installed on the second ESXi host.
n Two Software iSCSI adapters must be configured on ESXi A or one Software iSCSI adapter and
one dependent Hardware iSCSI adapter must be configured on ESXi A.
VMware, Inc. 78
VMware Storage Certification Guide (SCSI Block)
VMware, Inc. 79
VMware Storage Certification Guide (SCSI Block)
SVD/Gateway Tests
Run the following tests for the SVD/Gateway certification for FC and iSCSI:
n SVD_Backend_Switch_Port_Disable_Enable
n SVD_Backend_StorageProcessor_Reset_Stress
n SVD_backend_StorageProcessor_NDU
VMware, Inc. 80
Certification Results Submission
8
To submit the certification results, enter the necessary details in the Submission page and click
SUBMIT RESULTS:
Note Other details needed for submission such as Firmware Version and Array Model and so on
are fetched by the Collect_Storage_Information test. Ensure that this test is run just before you
submit the results.
For more information about submitting the test results, see the VMware Integration Validation
User Guide.
VMware, Inc. 81
Appendix
9
Third Party Script
The ThirdPartyScript requires details about Switch IP addresses, Port numbers, Switch login
credentials for host and Storage Switches. For SVD topology, user needs to provide SVD switch
details. This script automatically opens a connection to a switch or storage processor (SP) to:
n Reset SP
n Reset SP
n Perform SP NDU
Before running the tests validate the script by running below commands:
n Enable Port:
n Disable Port:
n SP NDU:
VMware, Inc. 82
VMware Storage Certification Guide (SCSI Block)
n SP Reset:
Note where
The script expects a string value, that is, activate to activate the port, deactivate to deactivate the
port, spndu to perform NDU on SP and spreset to perform SP Reset. Running the script with the
enable parameter must call the function to enable the switch port. Running the script with the
deactivate parameter must call the function to deactivate the switch port.
Before running the tests, you must perform the following steps:
2 Change the permissions of the script by running the following command in agent VM.
chmod +x /certcontent/<scriptName>.py
3 Log in to agent VM, edit the settings.conf file and change the following values from False to
True:
#vi /vmware/agent/conf/settings.conf
priveleged=True
usehostnetwork=True
Note To avoid revealing passwords during certification, use temporary or dummy passwords/
accounts on the switches and SPs.
VMware, Inc. 83
VMware Storage Certification Guide (SCSI Block)
Sample Script
Agent VM supports connection to switch through Telnet and SSH. You can use either Telnet
or SSH script to establish connection to switch and perform the desired operation. Following
are the script examples. Check the activate/deactivate command syntax and ensure that it is
changed to reflect the correct command syntax for your switch. Also, implement SP Reset and
NDU operations according to your SP behaviour.
Note
n Ensure that SSH/Telnet to switch is working from agent VM.
n Since the scripts are in python, you must resolve indentation errors of the script by running it
in format mentioned above.
#!/usr/bin/env python3
import json
import sys
import configparser
import os
import re
import subprocess
import telnetlib
import xml.etree.ElementTree as ET
#import paramiko
'''
from xml.etree.ElementTree import ElementTree
from xml.etree.ElementTree import Element
import xml.etree.ElementTree as etree'''
help = 'help'
print(switchIP)
print(port)
print(username)
tn = telnetlib.Telnet(switchIP,'23')
tn.write(username.encode('ascii') + b"\r")
tn.write(password.encode('ascii') + b"\r")
tn.write('enable'.encode('ascii') + b"\r")
tn.write(password.encode('ascii') + b"\r")
tn.write('configure terminal'.encode('ascii') + b"\r")
tn.write(('interface GigabitEthernet'+port).encode('ascii') + b"\r")
if (operation == 'disable'):
tn.write('shutdown'.encode('ascii') + b"\r")
elif (operation == 'enable'):
VMware, Inc. 84
VMware Storage Certification Guide (SCSI Block)
if (operation == 'spreset'):
print ("\n Perfrom Storage Processor Reset operation to your array here: SP " +
sp + " login " + splogin + " password " + sppassword + " operation " + operation) #,
sp,splogin,sppassword,operation)
elif (operation == 'spndu'):
print ("Perfrom Storage Processor Non Disruptive Upgrade (SP NDU) operation to your
array here: SP " + sp + " login " + splogin + " password " + sppassword + " operation " +
operation)
else:
print ("Invalid operation specified")
sys.exit(-1)
def main():
if len(sys.argv) == 6:
switch = sys.argv[1]
port = sys.argv[2]
userid = sys.argv[3]
password = sys.argv[4]
operation = sys.argv[5]
sys.exit(0)
elif len(sys.argv) == 3:
sp = sys.argv[1]
operation = sys.argv[2]
VMware, Inc. 85
VMware Storage Certification Guide (SCSI Block)
sys.exit(0)
else:
print ("Invalid number of operations specified")
sys.exit(-1)
if __name__== '__main__':
main()
#!/usr/bin/env python3
import json
import sys
import configparser
import os
import re
import subprocess
import xml.etree.ElementTree as ET
import paramiko
import time
'''
from xml.etree.ElementTree import ElementTree
from xml.etree.ElementTree import Element
import xml.etree.ElementTree as etree'''
ssh_client = paramiko.SSHClient()
ssh_client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
print(switchIP)
print(port)
print(usr)
print(operation)
ssh_client.connect(hostname=switchIP, username=usr, password=pwd, timeout=10, port=22)
print ("Connection established")
VMware, Inc. 86
VMware Storage Certification Guide (SCSI Block)
chan = ssh_client.invoke_shell()
chan.send('enable\n')
time.sleep(0.5)
chan.send('1lvdp@s5\n')
time.sleep(0.5)
output = chan.recv(1024)
print(output.decode("ascii"))
chan.send('configure terminal\n')
time.sleep(0.5)
output = chan.recv(1024)
print(output.decode("ascii"))
chan.send('interface GigabitEthernet'+port+'\n')
time.sleep(0.5)
output = chan.recv(1024)
print(output.decode("ascii"))
if (operation == 'disable'):
chan.send('shutdown\n')
time.sleep(0.5)
elif (operation == 'enable'):
chan.send('no shutdown\n')
time.sleep(0.5)
else:
print ("Invalid operation specified. Failing the test");
sys.exit(-1)
chan.send('exit\n')
time.sleep(0.5)
chan.send('exit\n')
time.sleep(0.5)
chan.send('exit\n')
time.sleep(0.5)
output = chan.recv(1024)
print(output.decode("ascii"))
ssh_client.close()
if (operation == 'spreset'):
print ("\n Perfrom Storage Processor Reset operation to your array here: SP " +
sp + " login " + splogin + " password " + sppassword + " operation " + operation) #,
sp,splogin,sppassword,operation)
elif (operation == 'spndu'):
print ("Perfrom Storage Processor Non Disruptive Upgrade (SP NDU) operation to your
array here: SP " + sp + " login " + splogin + " password " + sppassword + " operation " +
operation)
else:
print ("Invalid operation specified")
sys.exit(-1)
def main():
if len(sys.argv) == 6:
VMware, Inc. 87
VMware Storage Certification Guide (SCSI Block)
switch = sys.argv[1]
port = sys.argv[2]
userid = sys.argv[3]
password = sys.argv[4]
operation = sys.argv[5]
sys.exit(0)
elif len(sys.argv) == 3:
sp = sys.argv[1]
operation = sys.argv[2]
sys.exit(0)
else:
print ("Invalid number of operations specified")
sys.exit(-1)
if __name__== '__main__':
main()
VMware, Inc. 88