Overview
The HxBench application is delivered in the form of an QEMU copy-on-write version 2 (qcow2) image. Setting up an application involves deploying a virtual machine, configuring the virtual machine, and configuring the HxBench application.
IWE Network Recommendation
The HxBench Controller assigns static IP addresses to the test VMs from a private IP address of range 169.254.0.xxx. This section describes how to set up the network to deploy the test to virtual machines successfully and to run storage performance testing. You can set up the network manually to run the tests. This section provides the step-by-step tasks for manual network creation.
-
Log into Intersight.
-
Under Operate, navigate to Virtualization -> Clusters -> <your-cluster-name> -> Networking -> Cluster Virtual Networks.
-
Click Create. Enter Name as hxbench-private and provide your VLAN ID.
-
Click Create.
Deploy the IWE HxBench Controller
Take the following steps to deploy the IWE HxBench Controller:
Procedure
| Step 1 |
Download Cisco-HxBench <Current Version> IWE.tar.gz file from https://hyperflexsizer.cloudapps.cisco.com.. Navigate to IWE as follows: DOWNLOAD HX TOOLS > HyperFlex Bench > IWE |
| Step 2 |
Untar Cisco-HxBench-<Current-Version>-IWE.tar.gz |
| Step 3 |
In the extracted folder, locate the files Cisco-HxBench-Controller.qcow2, Cisco-HxBench-TestVM.qcow2. Copy the files to the file server. When uploaded, make sure the file-server links of the image are accessible from IWE cluster. |
| Step 4 |
Run the command bash Generate_user_data.sh to prompt for IP configuration, proxy and new password for HxBench controller. Default password is password. |
| Step 5 |
Configure the static or DHCP IP by following the instructions prompted in the terminal. |
| Step 6 |
The script provides UserData as output in encoded format. |
| Step 7 |
Open the Controller_VM_deployment.json file and copy the output from the previous step. Paste it in <User-Data>. |
| Step 8 |
Replace <File-Path> with the HXBench Controller image file server link. |
| Step 9 |
Replace first <Network-Name> with VM network name and Second <Network-Name> with hxbench-private network you created. |
| Step 10 |
Replace <Reg-MOID> with your cluster's Registered device MOID. Use this API link and click Send. https://intersight.com/apidocs/apirefs/api/v1/virtualization/IweClusters/get/ |
| Step 11 |
Save the Controller_VM_deployment.json file and post its contents to the API below. Click Send.https://intersight.com/apidocs/apirefs/api/v1/virtualization/VirtualMachines/post/ |
| Step 12 |
Monitor the progress of the VM deployment at intersight.com. Navigate to Virtual-Machines as follows: Operate ->Hyperflex Clusters -> <your-cluster> -> Operate -> Virtual-Machines. Another way to monitor the status is by using the iwectl command from any Host. |
| Step 13 |
The IP address of the VM appears, when the VM is deployed. |
| Step 14 |
To change the IP address of the VM, modify the /etc/network/interfaces file of HxBench VM accordingly. |
Configure the Virtual Machine
Procedure
| Step 1 |
Log into the virtual machine from the HxBench Web Interface.
|
||||
| Step 2 |
If you selected DHCP during deployment, the HxBench Application starts running when the VM boots up with the assigned DHCP address. Make a note of the IP address assigned to the VM. If you selected static IP address, use the same to access the HxBench Controller and the HxBench Web Interface. |
Access the HxBench Web Interface
To access the HxBench Web Interface, enter http://<IPaddressof theVM>:8000/hxbench/index.html in your browser.
Log in to the HxBench Web Interface using the following credentials:
|
Username |
appadmin |
|
Password |
Use the new password provided during Generate_user_data.sh script execution. |
Configure the HxBench Application
During initial login to the HxBench application after the installation, perform the following steps.
Procedure
| Step 1 |
Upload Vdbench software to the HxBench controller. |
||||||||||
| Step 2 |
Upon successful completion of Vdbench software upload, click Next. Provide your Interdsight details where the IWE cluster is present. Complete the following fields and click Save.
|
Feedback