Installing Enterprise Agent on VirtualBox

Last updated: Tue Mar 26 15:41:15 GMT 2019

This article describes how to set up the ThousandEyes Enterprise Agent using the Virtual Appliance OVA with VirtualBox. To download VirtualBox visit: https://www.virtualbox.org

Please see the installation guides for VirtualBox as below:

Windows: Section 2.1 here: https://www.virtualbox.org/manual/ch02.html
Mac OS: Section 2.2 here: https://www.virtualbox.org/manual/ch02.html 
For your convenience, ThousandEyes provides an image of a Virtual Machine with the Enterprise Agent installed in OVA (Open Virtual Appliance) format updated bi-weekly and hence downloading a recent image for new Enterprise Agent installs is strongly recommended. If your prefer more granular control of the your Enterprise Agent and the underlying Operating System, we recommend the Enterprise Agent deployment using Linux Package method.

Step-by-step guide

Please follow the below steps to install ThousandEyes Virtual Appliance
  1. To download the most recent Enterprise Agent image, begin by navigating to Agents > Enterprise Agents (thousandeyes-va-<version>.ova).  
  2. Click on the Add New Enterprise Agent button.
step-2
  1. The Add New Enterprise Agent button will reveal various install options available for the Enterprise Agent. This install guide will cover deployment using the OVA package. Select Download - OVA to receive the latest version.
step-3
  1. Once the image is downloaded open the VirtualBox application and click on File > Import Appliance. The below screenshot is of VirtualBox version 5.2.20 r125813 (Qt5.6.3) on MacOS Mojave, depending on version and Operating System, appearance could have minor differences.
step-4
  1. Click on the Browse button and select the downloaded Virtual Appliance image.                                                                                                                         
step-5
  1. Once the image is selected click the Continue button.
  2. The Appliance settings menu will display. You will see many options preconfigured. However, the options mentioned below can be re-configured:
    • The Name of VM
    • CPU Count
    • RAM
    • Hard disk Space,
    • Network Interface.
Enterprise Agent hardware requirements are mentioned here. The agent is designed to operate within the specifications listed in the article. Choosing settings which are higher than the recommended specifications will not provide additional benefits to Enterprise Agent performance. However, Enterprise Agent performance will be degraded if settings are configured which are below the recommendations. Once finished making changes  click Import.
step-7
  1. Wait for the appliance to be imported and visible in the VirtualBox Manager window. Once the import is complete (8), double-click the new machine to start.
step-8
  1. Once the machine boots up, a welcome screen displays the default values for the Virtual Appliance IP address, username, and password. The Virtual Appliance IP address is obtained via DHCP by default. If you are not using DHCP, you may configure a static IP by pressing "N" and following the interactive setup wizard. The available network configuration options here are the following: Hostname, IPv4/IPv6, and DNS. To reset the Virtual Appliance password to the default value, press "R". The Web UI can be accessed at http://<Virtual Appliance IP address>. The access can be upgraded to HTTPS by following the steps mentioned here.                          
step-9
  1. To open the Web UI, open a web browser and enter the URL displayed on the welcome screen. Once you are at the URL, enter the default username and password. Then, click Login. You will be prompted to change the default password. Enter the current and new passwords, then click Change Password.     
step-10
  1. Obtain the Account Group Token as guided here. Navigate to the Agent tab in the Web UI. Enter the Account Group Token in the Account Group Token box, then click Save Changes. 
step-11
  1. The Browser will now be redirected to Review page, click Complete to finish setup.                                         
step-12
  1. If the Review page shows all checks green as in above screenshot, your Enterprise Agent is now ready to run tests. The newly added Enterprise Agent would appear in the Settings > Enterprise Agents window, as seen below:                                                                          
step-13

Basic Troubleshooting 

  • If your VM displays just a black screen, virtualization might be disabled or not available. This can be confirmed in Windows machine as instructed here
  • If Path Visualization appears broken or incomplete, this might be due to NAT, this article explains the phenomenon in detail.

Related Articles: