How to set up the Virtual Appliance

Last updated: Wed Sep 18 15:25:58 GMT 2019

The Virtual Appliance is a virtual machine containing a pre-built ThousandEyes Enterprise Agent, which can be quickly imported into virtualization software.  This article describes the requirements and steps required to install and use the ThousandEyes Virtual Appliance.

System requirements

  • Working network to the virtual machine
  • At least 2 gigabytes of memory for the virtual machine


The installation process for a Virtual Appliance consists of two parts:

  1. Import the Virtual Appliance into your virtualization software (hypervisor)

    Installation instructions fall into one of two groups, depending on the type of hypervisor:
    • Virtualization software that supports Open Virtualization Format (OVA/OVF):
      Oracle VirtualBox, VMWare products, Microsoft Hyper-V for Windows Server 2012, 2016
    • Virtualization software that does not support Open Virtualization Format (OVA/OVF):
      Microsoft Hyper-V for Windows Server 2008
  2. Configure the Virtual Appliance

Importing the Virtual Appliance

Import with Open Virtualization Format (OVA)

  1. Download the latest thousandeyes-va-<version>.ova file from the Cloud & Enterprise Agents > Agent Settings page.  
  2. Double-click the thousandeyes-va-latest.ova file, or import it based on the virtualization software you have.
  3. Go through the steps in the VM application you have.  
    Note: We recommend at least 2GB RAM memory allocated for the Virtual Appliance.
    • Oracle VirtualBox - instructions can be found on the VirtualBox manuals, at this link.
    • VMware Fusion (5.x) - instructions can be found on the VMware Fusion knowledgebase, at this link.
    • VMware Fusion (4.x) - to import an OVA file into VMware Fusion 4.x, you first need to convert the .OVA file that we ship to a .VMX.  This is managed through a standalone converter published by VMware, and is available at this link.  Once you have converted the file to a .VMX file, then it can be imported by following the instructions found on the VMware Fusion Knowledge Base, at this link.
    • VMware Workstation (9.x) - Instructions can be found on the VMware Workstation knowledgebase, at this link.
    • VMware ESXi (4.x-6.x) - Instructions can be found on the VMware Community forum, at this link.
    • Microsoft Hyper-V - Instructions can be found in this ThousandEyes Knowledge Base article.
  4. No matter which platform you choose, you will need to configure your guest (virtual machine) to use a bridged network connection, so that the guest has unimpeded network and Internet access.
  5. Configure the Virtual Appliance.

Import with Microsoft Hyper-V format

The instructions below use Hyper-V Manager from Windows Server 2016, but the steps are similar for prior versions of Hyper-V.
  1. Download the latest thousandeyes-va-<version>.zip file from the Cloud & Enterprise Agents > Agent Settings page.
  2. Extract the zip file to the location that you would like to keep your Virtual Appliance files. We recommend using the default Hyper-V virtual machines folder.
    Note: You cannot move the files after completing these steps.
  3. Run Hyper-V Manager and click on "Import Virtual Machine...".
  4. Click "Browse" to the select location of the extracted files. This folder should contain two folders: "Virtual Hard Disks" and "Virtual Machines" as well as the file "config.xml".
  5. Select "Copy the Virtual Machine (create a new unique ID)" and leave "Duplicate all files so that the same virtual machine can be imported again" unchecked, then click Import.

    TEVA Hyper-V Import
  6. After the virtual machine has been imported, click "Settings...".
  7. Select "Network Adapter" from the left pane.
  8. In the drop-down menu under "Network:" select the appropriate network that you would like this virtual machine to connect to. This network should be accessible to you, and have access to the Internet.

    TEVA Hyper-V Interface
  9. Click Ok.
  10. You can now run the virtual machine by clicking "Connect..." then "Start".

    TEVA Hyper-V Start
  11. Configure the Virtual Appliance.

Configuring the Virtual Appliance

  1. On the first run of the Virtual Appliance, the appliance will attempt to configure its network settings automatically.

    Follow the instructions to setup the screen.

  2. Follow the steps to setup the hostname and network settings for the Virtual Appliance.

  3. Access the ThousandEyes Virtual Appliance interface through the URL in that screen and login with the credentials shown.

  4. You should see the "Initial Configuration" page.
  5. Obtain your Account Group Token from the bottom of the Add New Enterprise Agent dialog available in the Cloud & Enterprise Agents > Agent Settings view:

    Location of Account Group Token in the Add New Enterprise Agent dialog
  6. Paste the Account Group Token into the Account Token field. The field should turn green.

  7. Select "Yes" for Browserbot if you wish; this is required for Page Load and Transaction tests.
  8. Click "Save".
  9. Check that your Agent appears on the Cloud & Enterprise Agents > Agent Settings page, in the ThousandEyes platform.

Related Articles