vSAN

Configure HCI Bench for VMware vSAN Performance Testing

In the previous post, we took a look at what the HCI Bench utility is and how it is installed for testing VMware vSAN performance.  It is the preferred tool for VMware vSAN performance testing and is at least the one that VMware mentions in documentation and blog posts as the utility that is recommended to use since the native performance testing tools in the vSAN UI have been removed.  Let’s take a further look at how to configure HCI Bench for VMware vSAN performance testing including setting up the utility with Vdbench from Oracle as well as creating or uploading the parameter file that controls the type of disk testing that is performed.

Configure HCI Bench for VMware vSAN Performance Testing

Once you have deployed the HCI Bench control VM that is the management plan for the HCI Benchmark testing environment, you need to browse out to the web interface of the control VM.  To connect, simply browse out to either the IP or FQDN of the HCI Bench control VM port 8080.

http://<IP or FQDN>:8080

Below, the screenshots are actually one flowing web page that you scroll through.  I have broken this between screenshots for ease of viewing and explanation.  The first set of configurables has you configuring the vCenter connection, username and password, datacenter name, and cluster name.

Configure-the-vCenter-connection-for-HCI-Bench
Configure the vCenter connection for HCI Bench

Below, you continue the configuration of the test environment with the configuration of the virtual network switch/portgroup you want to connect the test VMs to that HCI bench provisions.  Also, you can configure the vSAN datastore.

Configuring-cluster-network-datastore-and-hosts
Configure the vCenter connection for HCI Bench

You can configure specific hosts to deploy to as well along with the root password.  Selecting the EASY RUN checkbox, allows letting HCI bench simply configure a general parameter file for testing and greatly simplifies the configuration of the test itself.  You can also configure the number of VMs, amount of disks provisioned, size of the data disks.

Root-password-vdbench-guest-VM-password-test-name
Root password vdbench guest VM password test name

Next we get into the configuration of the actual parameter file.  Again, if you selected the EASY RUN, this section won’t be available.  However, if you want to manually configure it which most will want to do to tweak down on the parameters of the benchmark run, these are configurable.  You can generate a parameter file or upload a parameter file.  On this screen there are other housekeeping options.

Selecting-or-generating-a-parameter-file
Selecting or generating a parameter file

If you choose to generate a vdbench parameter file, you will be taken to another page (new tab will open) that allows configuring the read/write ratios, block size, etc.

Generating-a-parameter-file-for-vdbench
Generating a parameter file for vdbench

You can also upload a parameter file.  If you search around the net, there are already a lot of great preconfigured parameter files available for download that have already been created.  You can download these parameter files and tweak as desired and then upload.  Simply choose the file and upload it via the interface.

Uploading-a-custom-parameter-file-for-HCI-Bench
Downloading and uploading vdbench file

Another item you will need to do is actually download the vdbench utility from Oracle.  The software is free to use, but VMware does not have distribution rights to the software, so it requires downloading it from Oracle and then uploading the zip file to the appliance via the interface.  Again, the interface is very intuitive for this process.  One note here as mentioned in the previous post, vdbench requires you sign up for a free Oracle account which is a bit annoying but a necessary evil.

Downloading-and-uploading-vdbench-file
Downloading and uploading vdbench file

Below, you can see we have uploaded the vdbench zip file.

Uploading-the-vdbench-file-for-HCI-Bench
Uploading the vdbench file for HCI Bench

Once nice option with the HCI Bench interface is you can Validate the configuration, parameter file, connection to vCenter, etc.  It will display information that looks like the following.  This saves time in troubleshooting any errors that may be encountered otherwise.

You-can-test-the-configuration-before-actually-performing-the-benchmark
You can test the configuration before actually performing the benchmark

Once you select the Test button, you will see the Deployment Started displayed.  At this point, it starts deploying the VM template via vCenter and then will clone the additional machines off the template that is deployed.

Deplying-the-vdbench-guest-VMs-for-HCI-Bench-1
Deplying the vdbench guest VMs for HCI Bench

After a while, depending on the options you select, the progress will show Test is finished and you will be able at that point to view the results.

HCI-Bench-test-finishes
HCI Bench test finishes

If you click the Results button, you will see the index of the results.

Results-screen-for-HCI-Bench-runs
Results screen for HCI Bench runs

IIfyou click on one of the res.txt files, you will see similar to the following with the output of the IOPs, throughput, latency, etc.  Very helpful indeed!

Viewing-the-results-of-the-HCI-Bench-vSAN-benchmark
Viewing the results of the HCI Bench vSAN benchmark

Concluding Thoughts

Hopefully you will find this look at how to configure HCI Bench for VMware vSAN performance testing helpful.  The interface is very intuitive and easy to navigate.  There are a few cumbersome things such as not having direct access to the vdbench utility, however, this is a purely licensing related issue.  Otherwise, the HCI Bench utility is the documented utility that VMware uses to benchmark vSAN datastores.  Stay tuned for more HCI Bench and VMware vSAN related posts soon.

Subscribe to VirtualizationHowto via Email 🔔

Enter your email address to subscribe to this blog and receive notifications of new posts by email.

Brandon Lee

Brandon Lee is the Senior Writer, Engineer and owner at Virtualizationhowto.com and has over two decades of experience in Information Technology. Having worked for numerous Fortune 500 companies as well as in various industries, Brandon has extensive experience in various IT segments and is a strong advocate for open source technologies. Brandon holds many industry certifications, loves the outdoors and spending time with family.

Related Articles

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.