Installing a Physical Appliance

Last updated: Thu Jan 17 13:56:00 GMT 2019

For customers who require a turnkey hardware and software solution, the ThousandEyes Enterprise Agent can be installed on prescribed off-the-shelf hardware. A downloadable ISO image is used to install a supported version of Ubuntu LTS, the ThousandEyes Enterprise Agent, and management software onto approved Intel NUC hardware, which provides a convenient form-factor that is easily shipped to branch offices, partner sites and other environments where provisioning will only require connection to power and a wired network.

This article details the hardware requirements of the Physical Appliance and the steps required to download and install the ISO image to the hardware, and subsequent configuration.

Hardware requirements

The Physical Appliance hardware must conform to the specifications used for validation by ThousandEyes. While the installation may work with other configurations, we test and support only the components listed in the table below.

NUC 6th & 7th generations

ManufacturerComponentPart Number
Intel NUC i3
NUC i5
NUC i7
NUC6I3SYH,NUC6I3SYK,NUC7I3BNH,NUC7I3BNK
NUC6i5SYH,NUC6i5SYK,NUC7I5BNH,NUC7I5BNK
NUC6I7SYH,NUC6I7SYK,NUC7I7BNH,NUC7I7BNK
Crucial4GB DDR4 2400 MT/S (PC4-19200) SODIMMCT4G4SFS824A
Transcend64GB SATA III 6 Gb/s M.2 SSDMTS800

NUC 5th generation

ManufacturerComponentPart Number
Intel NUC i3
NUC i5
NUC i7
NUC5I3RYK, NUC5I3RYH 
NUC5i5RYK, NUC5i5RYH
NUC5I7RYK, NUC5I7RYH
Crucial4GB DDR3 PC3-12800 SODIMMCT51264BF160B
Transcend64GB SATA III 6 Gb/s M.2 SSDMTS800

 

Downloading the installer

Download the appliance installer in one of two ways: a generic installer (which does not come preconfigured), or a custom installer (which allows preconfiguration certain advanced options for the agent).

Generic installer

Browse to Settings > Agents > Enterprise Agents and click the Add New Agent button.  Select the "Appliance" package type, and click the Download ISO button in the Physical Appliance Installer row.

Screen_Shot_2016-07-05_at_5.04.57_PM.png

Account-specific installer

Browse to Settings > Agents > Enterprise Agents and click the Add New Agent button.  Select the "Custom Appliance" package type, and provide the appliance details.  The appliance name is a name for the image, and you can add proxy information, specify whether or not the configuration web server is enabled, and enter preseeded SSH keys.  In a custom appliance model, your account token is built into the image.

Screen_Shot_2016-07-05_at_5.14.59_PM.png

Once the fields are complete, click the Generate - ISO.  The appliance installer will take between 15 and 30 minutes to generate.  You'll get an email with a download link once the image has been generated.

Download the appliance once you have the link.

Writing the ISO to a USB disk

The download process will provide an .ISO which can be written to a USB disk as a bootable image.  The following process describes writing the image to a USB disk on Mac OS X and Windows.

Mac OS X / Linux instructions

    1. Insert a USB disk with a size of at least 1GB into a USB port on your computer.  The disk’s content will be overwritten, so be sure to save any content you need.
    2. open a terminal window
    3. type diskutil list, and identify the physical disk you’re interested in imaging.  it should be /dev/diskN.  In the example below, I have a 1GB USB disk in the USB port.
dave@schadenfreude ~/Downloads> diskutil list
/dev/disk0 (internal, physical):
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:      GUID_partition_scheme                        *500.3 GB   disk0
   1:                        EFI EFI                     209.7 MB   disk0s1
   2:          Apple_CoreStorage Macintosh HD            499.4 GB   disk0s2
   3:                 Apple_Boot Recovery HD             650.0 MB   disk0s3
/dev/disk1 (internal, virtual):
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:                  Apple_HFS Macintosh HD           +499.1 GB   disk1
                                 Logical Volume on disk0s2
                                 DCA39E1F-1CB4-4386-8E67-0AD63B4A069D
                                 Unencrypted
/dev/disk2 (external, physical):
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:     FDisk_partition_scheme                        *1.0 GB     disk2
   1:             Windows_FAT_32 UBUNTU-SERV             1.0 GB     disk2s1
  1. run diskutil unmountDisk /dev/diskN (replace N with actual disk number from output of (c) above.

    dave@schadenfreude ~/Downloads> diskutil unmountDisk /dev/disk2
    Unmount of all volumes on disk2 was successful
  2. Next, write the image to disk.  Run sudo dd if=<path_to_downloaded_iso> of=/dev/diskN, wait until it completes.

    dave@schadenfreude ~/Downloads> sudo dd if=thousandeyes-pa-1.9.100.iso of=/dev/disk2
    1175552+0 records in
    1175552+0 records out
    601882624 bytes transferred in 267.718384 secs (2248193 bytes/sec)

Windows Instructions

While many Windows-compatible applications for writing bootable ISO images to USB are available, we've chosen one for documentation purposes.

  1. Download & install Rufus from here: https://rufus.akeo.ie/
  2. Launch Rufus
  3. Insert a USB disk with a size of at least 1GB into a USB port on your computer.  The disk’s content will be overwritten, so be sure to save any content you need.

    User-added image
  4. Select the destination device using the Device dropdown.  If you only have one USB disk inserted, it will be autoselected.
  5. Browse to and select the ISO downloaded earlier in these instructions.
  6. Select "DD Image" option in the dropdown next to "Create a bootable disk using".
  7. Click the start button
  8. If prompted (in case you have forgotten to select "DD Image" mode earlier), choose to write in "DD Image" mode.User-added image
  9. Confirm that your destination disk will be overwritten.

    User-added image
  10. When complete, eject the disk.

 

Imaging the device

Now that you've got a bootable ISO image, time to image the box.

  1. Take the freshly written USB disk and put it into an approved hardware device.  

    NOTE: In order to complete the installation correctly, the device needs to be connected to a network with non-proxied access to the Internet, on a segment where a DHCP service is available. If these requirements are not satisfied, the installation will come to an end, but it will not be completed correctly. The following behavior anomalies are known indicators of an unsuccessful appliance installation:
    • The agent doesn't detect the keyboard connected.
    • The agent boots into the "thousandeyes-va login:" prompt screen, instead of a blue management console shown below.
  2. Power up the machine.  
  3. If the device’s hard disk is bootable (if it has already been used for something), you’ll need to connect a monitor and keyboard, to force the machine to boot from USB.  

    Press F10 to enter into the boot menu, and select the USB stick attached.  
     
  4. Allow the USB disk to boot into ‘Install Ubuntu Server ThousandEyes Edition’, this will happen automatically without user intervention.

    Screen_Shot_2016-03-02_at_5.52.11_PM.png


    If the machine doesn't boot into an installation process, and instead shows a "media not bootable" error, then re-create the install media using the steps above.
     
  5. On the Finishing the installation screen, ‘Running preseed...’ is the last step of the process.  There will not be a warning that the device is shutting down, or an indication that the imaging process is complete.
  6. The device will shut down once the image has been successfully applied. 
     

Configuring the agent

The last step is configuring the agent.  Depending on whether you've downloaded the generic installer or a custom installer, you'll need to configure the Agent.  Power on the device after installation has been completed, and manage the network settings using the console that comes up.

Screen_Shot_2016-03-02_at_6.51.53_PM.png

  1. Access the ThousandEyes Virtual Appliance Setup interface through the URL in that screen with the credentials shown.
  2. On the Access tab, you'll be prompted for a new password. This is required to continue with the installation.
  3. On the Agent tab, you'll be prompted for the Account Group Token. The Account Group Token can be found on the Account Groups tab of the Account Settings page for a specific account group, or from the Settings > Agents > Enterprise Agents page.  



     
  4. Paste the Account Group Token into the Account Group Token field. The field will turn blue. 




    Select Yes if Browserbot is to be used on the agent. 
     
  5. Click through the remaining menus. Confirm that in the Diagnostics step, that all checks complete successfully.
  6. The Enterprise Agent should now appear in the Agents > Enterprise Agents page of the ThousandEyes portal.