Collecting diagnostic information from a vSphere Storage Appliance (VSA) cluster
search cancel

Collecting diagnostic information from a vSphere Storage Appliance (VSA) cluster

book

Article ID: 343292

calendar_today

Updated On:

Products

VMware vSphere ESXi

Issue/Introduction

VMware Technical Support routinely requests diagnostic information from you when a support request is handled. This diagnostic information contains product specific logs and configuration files from the host on which the product is run. The information is gathered using a specific script or tool for each product.

This article provides procedures for obtaining diagnostic information for VMware vSphere Storage Appliance (VSA).

The diagnostic information collected can then be uploaded to VMware Technical Support. To uniquely identify your information, use the Support Request (SR) number you received when you opened your Support Request.



Environment

VMware vSphere Storage Appliance 5.1.x
VMware vSphere Storage Appliance 1.0.x
VMware vSphere Storage Appliance 5.5.x

Resolution

You can collect logs from a vSphere Storage Appliance cluster using the vSphere Client or the vSphere Storage Appliance command line:

Using the vSphere Client and VSA Manager

To collect logs using the vSphere Client:

  1. Open the vSphere Client and connect to vCenter Server.
  2. Click the VSA Manager tab.
  3. Click Export VSA Logs in the top-right corner.

    Notes:
    • The Export VSA Logs dialog shows a message that VSA Manager collects all logs from the running VSA cluster members, VSA Manager, and the VSA cluster service. After it completes the collection, the Download VSA Logs button appears.
    • In VSA 5.5, click Actions > Export Logs.

  4. Click the Download VSA Logs button.
  5. Save the resulting .zip log bundle in a directory on the client.

Using the vSphere Storage Appliance command line

  1. Open the vSphere Client and connect to vCenter Server.
  2. Locate each vSphere Storage Appliance virtual machine in the inventory.
  3. Select each vSphere Storage Appliance and open a console.
  4. Log in as the root user and enter the password.

    Notes:
    • You can also use the default username svaadmin and password svapass. For more information, see VMware vSphere Storage Appliance FAQ (2001389).
    • For all 5.x versions of VSA, you will log in as the svaadmin user and then execute the command:

      sudo su -

    • For the 1.x version of VSA, if you have logged in as the svaadmin user, you need to log in as root with the command:

      su -


  5. Collect a log bundle using this command:

    /usr/sbin/sva-support

    Note: The command output shows the filename of the produced log bundle. For example, /support/sva-HostnameOrIPAddress-diag-info-yyyy-mm-dd.hh-mm-ss.zip.

  6. Run this command, if SSH is not running :

    sshon

    Note: sshon and sshoff are commands in the Root-level CLI to start and stop the SSH.

  7. Use an SSH/SCP based client to download the VSA log bundle to your internet-accessible workstation.


Additional Information

If you need to manually review or collect the cluster service logs, they are located in the following folders:

Windows:

C:\Program Files\VMware\Infrastructure\VSA Manager\VSAClusterService-1.5\logs

Linux:

/home/vmwarevcsadmin/VSAClusterService-5.1.1/logs

For more information, see Location of vSphere Storage Appliance log files (2003547).

Collecting diagnostic information for VMware products
Uploading diagnostic information for VMware
FAQ for VMware vSphere Storage Appliance (VSA) 1.0.x