UPSA VM for troubleshooting

Products

• VMware NSX
• VMware vSphere ESXi

Issue/Introduction

This KB provides the steps to download and deploy UPSA VM for troubleshooting.

Environment

VMware ESXi
VMware NSX-T Data Center

Resolution

HOW TO DEPLOY UPSA VM

• Download the attachment in this KB
• On your vCenter select the host where to deploy the UPSA VM 
• On the hosts run the following:

• • Right click and select "deploy OVF template"
  • Local file (choose the file downloaded) and click next
  • Change the "Virtual machine name:" to UPSAXX or any other appropriate name. Click next
  • Select your storage (Please pick the same storage used by the VM experiencing issues). Click next
  • Select the same portgroup that the VM that is giving issues is on then click next
  • Click finish
  • The UPSA VM is now deployed.
    
    
• Static IP assignment to UPSA VM:
  
  
  • Assign an IP address and a default route to the UPSA VM in non-persistent mode.  These network configurations will be cleared upon UPSA VM reboot.
    • Login to UPSA VM through web console.
    • Collect a free IP from the VLAN/portgroup attached to the VM.
    • Run the following commands to add static IP address
      • ifconfig eth0 <IP address> netmask <Subnet mask>
      • ip route add default via <Gateway IP address>
      • ip a (Command to verify the IP address of the UPSA VM.)
        
        
  • Assign an IP address and a default route to the UPSA VM in persistent mode
    • Run the following command and provide the necessary information.

      ./setup.network.manual

      

HOW TO RUN BANDWIDTH TESTS USING UPSA VMS

• Deploy two UPSA VMs on your target datapath. Perform testing by configuring one VM as the server and the other as the client using the pre-installed Iperf or Netperf tools.
  • IPerf Testing:
    1. Setup one VM as an Iperf server. 
       - iperf3 -s -p <port>
    2. Setup the other VM as an Iperf client. 
       - iperf3 -c <Iperf server IP> -p <port>

• • Netperf Testing:
    1. Setup one VM as a Netserver.
       - netserver -d -D
    2. Setup the other VM as a Netserver client.
       - netperf -H <Netserver IP> -l <Test Duration in Secs> -c -C -t TCP_STREAM

 

Additional Information

Detailed Iperf technical documentation 

Detailed Netperf technical documentation