# Installing a Physical Appliance {% hint style="warning" %} Due to recent platform-wide naming, navigation, and URL changes in the product, you may notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven’t changed. Please bear with us as we update our screenshots to better match the in-product experience. See the full scope of changes on [Naming and Navigation Menu changes - Summary List](https://docs.thousandeyes.com/whats-new/naming-and-nav-phase-2-changes). {% endhint %} For customers requiring a turnkey solution, the ThousandEyes [Enterprise Agent](https://docs.thousandeyes.com/product-documentation/enterprise-agents/what-is-an-enterprise-agent) can be installed on off-the-shelf hardware such as * Intel NUC * Raspberry Pi For Raspberry Pi-specific instructions, see [this article](https://docs.thousandeyes.com/product-documentation/enterprise-agents/installing-an-enterprise-agent-on-raspberry-pi). The combination provides a convenient form-factor that is easily shipped to branch offices, partner sites, and other environments, where provisioning only requires power and a network connection. A downloadable ISO image is used to install Linux Ubuntu LTS, the ThousandEyes Enterprise Agent, and management software onto the hardware. ## Intel NUC This article details the hardware requirements and process required to install the ThousandEyes Enterprise Agent on an Intel NUC. ## Hardware Requirements ### Intel NUC 13th Generation | Subsystem | Manufacturer | Component | Validated Models | | --------- | ------------ | -------------------- | ---------------- | | NUC | Intel | NUC i7 NUC i5 NUC i3 | RNUC13ANHI70000 | | Part Numbers | Memory | Disk | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | NUC13\* | Any memory configuration supported by the NUC.\* A minimum of 2GB, as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | Any single SSD or NVMe disk supported by the NUC\*. A minimum of 20GB as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | For detailed specifications and compatibility matrices for Intel- and manufacturer-validated compatible components, see the links below: * RNUC13ANHI70000: [Specifications](https://www.intel.com/content/www/us/en/products/sku/233099/intel-nuc-13-pro-kit-nuc13anhi7/specifications.html) / [Compatibility Matrix](https://compatibleproducts.intel.com/) ### Intel NUC 12th Generation - OBSOLETE | Subsystem | Manufacturer | Component | Validated Models | | --------- | ------------ | -------------------- | ---------------- | | NUC | Intel | NUC i7 NUC i5 NUC i3 | NUC12WSHi5 | | Part Numbers | Memory | Disk | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | NUC12\* | Any memory configuration supported by the NUC.\* A minimum of 2GB, as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | Any single SSD or NVMe disk supported by the NUC\*. A minimum of 20GB as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | For detailed specifications and compatibility matrices for Intel- and manufacturer-validated compatible components, see the links below: * NUC12WSHi5: [Specifications](https://www.intel.com/content/www/us/en/products/sku/121626/intel-nuc-12-pro-kit-nuc12wshi5/specifications.html) / [Compatibility Matrix](https://compatibleproducts.intel.com/) ### Intel NUC 11th Generation - OBSOLETE | Subsystem | Manufacturer | Component | Part Numbers | | --------- | ------------ | -------------------- | ---------------------------------------------------------------------------------------------------------------------- | | NUC | Intel | NUC i7 NUC i5 NUC i3 | NUC11TNHi3, NUC11TNHi5, NUC11TNHi7, NUC11TNHv5, NUC11TNHv7, NUC11TNKi3, NUC11TNKi5, NUC11TNKi7, NUC11TNKv5, NUC11TNKv7 | | Part Numbers | Memory | Disk | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | NUC11\* | Any memory configuration supported by the NUC.\* A minimum of 2GB, as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | Any single SSD or NVMe disk supported by the NUC\*. A minimum of 20GB as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | For detailed specifications and compatibility matrices for Intel- and manufacturer-validated compatible components, see the links below: * NUC11TNHi3: [Specification](https://www.intel.com/content/www/us/en/products/sku/205604/intel-nuc-11-pro-kit-nuc11tnhi3/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=188811) * NUC11TNHi5: [Specification](https://www.intel.com/content/www/us/en/products/sku/205594/intel-nuc-11-pro-kit-nuc11tnhi5/specifications.html) / [Configuration Matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNHi5) * NUC11TNHi7: [Specification](https://www.intel.com/content/www/us/en/products/sku/205605/intel-nuc-11-pro-kit-nuc11tnhi7/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNHi7) * NUC11TNHv5: [Specification](https://www.intel.com/content/www/us/en/products/sku/205602/intel-nuc-11-pro-kit-nuc11tnhv5/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNHv5) * NUC11TNHv7: [Specification](https://www.intel.com/content/www/us/en/products/sku/205609/intel-nuc-11-pro-kit-nuc11tnhv7/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNHv7) * NUC11TNKi3: [Specification](https://www.intel.com/content/www/us/en/products/sku/205593/intel-nuc-11-pro-kit-nuc11tnki3/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNKi3) * NUC11TNKi5: [Specification](https://www.intel.com/content/www/us/en/products/sku/205603/intel-nuc-11-pro-kit-nuc11tnki5/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNKi5) * NUC11TNKi7: [Specification](https://www.intel.com/content/www/us/en/products/sku/205599/intel-nuc-11-pro-kit-nuc11tnki7/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNKi7) * NUC11TNKv5: [Specification](https://www.intel.com/content/www/us/en/products/sku/205597/intel-nuc-11-pro-kit-nuc11tnhi7/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNHi7) * NUC11TNKv7: [Specification](https://www.intel.com/content/www/us/en/products/sku/205599/intel-nuc-11-pro-kit-nuc11tnki7/specifications.html) / [Configuration matrix](https://compatibleproducts.intel.com/ProductDetails?activeModule=Intel%C2%AE%20NUC\&prdName=NUC11TNKi7) ### Intel NUC 10th Generation - OBSOLETE | Subsystem | Manufacturer | Component | Part Numbers | | --------- | ------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------- | | NUC | Intel | NUC i7 NUC i5 NUC i3 | NUC10i7FNH, NUC10i7FNK, NUC10i5FNH, NUC10i5FNK, NUC10i3FNH, NUC10i3FNK, BXNUC10i5FNH1, BXNUC10i3FNH1, BXNUC10i7FNH1 | | Part Numbers | Memory | Disk | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | NUC10i\* | Any memory configuration supported by the NUC.\* A minimum of 2GB, as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | Any single SSD or NVMe disk supported by the NUC\*. A minimum of 20GB as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | | BXNUC10i\* | **Crucial**: 4GB DDR4-2400 SODIMM 1.2V CT4G4SFS824A | Transcend SSD370S SSD | Specifications and compatibility matrices for Intel- and manufacturer-validated compatible components: * NUC10i7FNH: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc10i7fnh.html); [Component compatibility matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=188811) * NUC10i7FNK: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc10i7fnk.html); [Component compatibility matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=188808) * NUC10i5FNH: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc10i5fnh.html); [Component compatibility matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=189239) * NUC10i5FNK: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc10i5fnk.html); [Component compatibility matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=195507) * NUC10i3FNH: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc10i3fnh.html); [Component compatibility matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=195506) * NUC10i3FNK: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc10i3fnk.html); [Component compatibility matrix](https://compatibleproducts.intel.com/ProductDetails?EPMID=195503) ### Intel NUC 8th Generation - OBSOLETE **NOTICE:** Intel NUC 8th generation systems are only supported for existing deployments. | Subsystem | Manufacturer | Component | Part Numbers | | --------- | ------------ | -------------------- | ----------------------------------------------------- | | NUC | Intel | NUC i7 NUC i5 NUC i3 | NUC8I7BEH, NUC8I5BEH, NUC8I5BEK, NUC8I3BEH, NUC8I3BEK | | Memory | Disk | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Any memory configuration supported by the NUC.\* A minimum of 2GB, as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | Any single SSD or NVMe disk supported by the NUC\*. A minimum of 20GB as specified in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/enterprise-agent-hardware-requirements). | Specifications and compatibility matrices for Intel- and manufacturer-validated compatible components: * NUC8I7BEH: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc8i7beh.html); [Component compatibility matrix](http://compatibleproducts.intel.com/ProductDetails?EPMID=126140) * NUC8I5BEH: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc8i5beh.html); [Component compatibility matrix](http://compatibleproducts.intel.com/ProductDetails?EPMID=126148) * NUC8I5BEK: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc8i5bek.html); [Component compatibility matrix](http://compatibleproducts.intel.com/ProductDetails?EPMID=126147) * NUC8I3BEH: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc8i3beh.html); [Component compatibility matrix](http://compatibleproducts.intel.com/ProductDetails?EPMID=126150) * NUC8I3BEK: [Specification](https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/nuc8i3bek.html); [Component compatibility matrix](http://compatibleproducts.intel.com/ProductDetails?EPMID=126149) * **Memory:** [Vengeance® Series 16GB (2x8GB) DDR4 SODIMM 2400MHz CL16 Memory Kit CMSX16GX4M2A2400C16](https://www.corsair.com/us/en/Categories/Products/Memory/Laptop-and-Notebook-Memory/Vengeance%C2%AE-Series-16GB-\(2x8GB\)-DDR4-SODIMM-2400MHz-CL16-Memory-Kit/p/CMSX16GX4M2A2400C16#tab-overview) * **Disk:** M.2 NVMe [Samsung 970 EVO 250GB (MZ-V7S250B/AM)](https://www.samsung.com/us/computing/memory-storage/solid-state-drives/ssd-970-evo-plus-nvme-m-2-250gb-mz-v7s250b-am/) and M.2 SSD [Transcend 64GB SATA III 6 Gb/s MTS800](https://www.transcend-info.com/Embedded/Products/No-803) ## Installation Environment Requirements The following are required: * **Wired network connection:** The device has to be connected to a network. Wireless connection are not supported. **Note:** When the NUC is powered off and it is connected to an operational Ethernet switch, the LED on lower right of the RJ-45 port on the NUC will be lit. This indicates that a Link signal from the switch is active. * **DHCP service:** A DHCP service for the device to obtain an IP address. * **DNS service:** DHCP service must provide DNS server information to the device. * **Non-proxied and unrestricted access to the Internet:** The installation process downloads several software packages from online resources. Consult [Enterprise Agent Firewall Requirements](https://docs.thousandeyes.com/product-documentation/enterprise-agents/firewall-configuration-for-enterprise-agents) for the list of online locations. The *Troubleshooting* section below lists common issues and their resolution. ## Downloading the Installer Download the installer that fits the requirement: * Generic Appliance. There are no pre-configurations. * Custom Appliance. Includes Enterprise Agent pre-configurations. #### Generic Appliance On the ThousandEyes platform, go to **Network & App Synthetics > Agent Settings**, select **Enterprise Agents** (top line), click **Add New Enterprise Agent** button. Select Package Type **Appliance.** On **Physical Appliance Installer** click **Download - ISO**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-955704748df6458fa2efbb35562370e118c48184%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-1.png?alt=media\&token=2baa1e99-a1e0-417f-b12a-da2b2f9033d2) #### Custom Appliance On the ThousandEyes platform, go to **Cloud & Enterprise Agents> Agent Settings**, select **Enterprise Agents** (top line), click **Add New Enterprise Agent**. Select Package Type **Custom Appliance**. Provide the following information: * **Appliance Name**. Name of the appliance on the ThousandEyes systems and the Linux host name. * **Appliance Type**, select Physical. * If required, select **Add Proxy** and specify the Proxy Host and Proxy Port. * **Web Server**. If the appliance is to be used for Page Load or Transaction test, select On. * **SSH Keys**. The **SSH Public key** of the SSH client to be used to access the appliance, for terminal session. Note that the custom download will include the [Account Group Token](https://docs.thousandeyes.com/product-documentation/enterprise-agents/where-can-i-get-the-account-group-token) required for the Agent to register itself to the ThousandEyes system.\ Click **Generate**. It may take take between 15 and 30 minutes to generate the image. An email will be generated once the image is ready to be downloaded. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-4d052ec9686325312f297e8a44419b1c8a3a2fe5%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-2.png?alt=media\&token=a3bbbd07-4d80-4bf6-b6c0-916c597dda76) ## Writing the ISO Image to a USB Disk The ISO image can be copied to a USB disk (flash drive) and used as a bootable media on the Intel NUC. The following sections describe the process of creating the bootable USB disk on Mac OS X and Windows. #### Mac OS X / Linux Instructions 1. Insert a USB disk that is at least 1GB in size, into a USB port on the Mac. The disk’s content will be overwritten. 2. Open a terminal window. 3. Type `diskutil list` (OS X) or `fdisk -l` (Linux) and identify the physical disk you’re interested in imaging. It should be `/dev/diskN` (OS X) or `/dev/sdN` (Linux). In the example below, I have a 1GB USB disk in my Mac's 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 ``` 4. Run `diskutil unmountDisk /dev/diskN` (OS X) or `umount /dev/sdN` (Linux) to unmount the device (replace `N` with the actual disk number from the output above): ``` dave@schadenfreude ~/Downloads> diskutil unmountDisk /dev/disk2 Unmount of all volumes on disk2 was successful ``` 5. Next, write the image to disk. Run `sudo dd if= 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 The following instructions are based on Rufus, an open-source application for creating bootable USB flash drives. 1. A copy of Rufus can be obtained from [here](https://rufus.ie/). 2. Start Rufus. 3. Connect a USB drive that is at least 1GB in size. The disk’s content will be overwritten. If there is only one USB drive on the Windows system, Rufus automatically selects it and it will be displayed under **Device**. Otherwise, use the down-arrow to select the desired USB drive. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-3ea0f9bc2b5cc948cbf6a923d4145385d072392b%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-3.png?alt=media\&token=79fd6a84-bbe8-4bd1-8066-74f5a462e857) 4. Click **SELECT** and browse to select the downloaded ISO image. In the above screen shot, the filename of the selected image is "thousandeyes-pa-0.162.iso." 5. The screenshot above shows the default settings; they can be left as is. Note that the **Cluster size** default will vary depending on the size of the USB drive. Leave it to the selected default size. 6. Click **START.** ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-8436117075e5711568d79266993ba402bf0f91fb%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-4.png?alt=media\&token=60a5f9da-f692-4096-a0e8-33eab64fe068) 7. On the next screen, select **Write DD Image mode** and click **OK**. DD Image Mode is the recommended format. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-1bd3b353f144794d871e08bf8bb928fe31f62765%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-5.png?alt=media\&token=b0e8ab23-9aa9-4470-8d55-08cc45f3b0df) 8. Click **OK** to start the boot disk creation. 9. When the process completes, remove the USB drive. ## Intel NUC BIOS The following are intended to be a check list of configurations required for the ThousandEyes application. You should consult the appropriate Intel documentation for the applicable procedures. * Intel documentation can be found [here](https://www.intel.com/content/www/us/en/support/articles/000005636/mini-pcs.html). * BIOS update files for the Intel NUC can be found [here](https://downloadcenter.intel.com/search?keyword=bios+nuc). * Check that the display (monitor) used with the NUC are compatible. Check on the Intel documentation. To verify, power up the NUC with the monitor connected, if the Intel splash screen can be seen, the monitor is compatible. * On the NUC, check that the BIOS version is current. If not the most current, upgrade to the latest version. * The appliance is intended to the an always-on device. Verify that the following is set in the BIOS: * After Power Failure setting should be set to Last State or Power On. ## Installing Physical Appliance Software 1. Verify that the installation environment requirements are satisfied. 2. Insert the bootable USB disk in one of the USB slots on the NUC. 3. Power up the NUC. 4. Tap the **F10** key (on the keyboard) to force the BIOS to enter the "Boot" menu. 5. On the boot device menu, use the arrow keys to select the USB drive and press **Enter**. If USB is not shown as an option, power off the NUC, unplug the USB drive, plug it back in and power up the NUC. **Note:** The BIOS will recognize the USB drive as a bootable device even if the USB flash drive is blank (nothing in it). If the BIOS does not recognize the USB drive as a valid bootable device, when there is a USB flash drive inserted, check that the BIOS version is current. If not current upgrade to the latest version. 6. On booting from the USB drive, the installation process will start automatically. `No` user intervention is required, The initial phase will progress fairly quickly, a progress bar will narrate the progress. The final phase is shown by the "Finishing the installation" screen, "Running preseed," the progress bar will show "14%." The installation process are downloading the required software packages. This screen may remain in this state for about 15 minutes, depending on the speed of the network interface and the delays to the download server. Do not power off the NUC. Leave it until it automatically powers off. 7. On completing the installation, the NUC will automatically power off. 8. Remove the installation USB. If you don't remove it once the installation is complete, the NUC attempts to boot again, restarting the installation process. ## Configuring the Enterprise Agent See [How to Set Up the Virtual Appliance](https://docs.thousandeyes.com/product-documentation/enterprise-agents/how-to-set-up-the-virtual-appliance) for a comprehensive set of instructions. The following are the minimum required to enable the Physical Agent to communicate with the ThousandEyes platform. 1. Power on the NUC. After the unit boots, the "ThousandEyes Virtual Appliance" screen (shown below) will be displayed. The IP address displayed depends on the network environment of the NUC. Note the provided username and password. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-6c7b8af12b2533ba8cef1ee9895af18a79fe926c%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-6.png?alt=media\&token=84ad5b25-694f-4a7b-ac66-57d6e9a335d1) 2. Using a browser, access the provided URL (IP address), and log in using the provided username and password. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-25f788f1a91de28f38561c3b2291797f37b86021%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-7.png?alt=media\&token=3018aa94-505c-40ab-b321-b92b1c687fa4) 3. The user will be taken to the **Appliance Access** screen to change the default password. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-673d2648a54b8e64f4c73d2db355ba1a640287a7%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-8.png?alt=media\&token=a414e2cb-f424-4c2f-ad0c-d7a0ff624874) 4. Skip this step if the installation is a Custom Appliance, as the Account Group Token is included in the image. For a Generic Appliance installation, the Account Group Token is obtained on the ISO download screen on the ThousandEyes portal, by clicking "Show Account Group Token for Installation." ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-b1ff7c6b64ee34ee7c3dfb650dd582fd27dc8cb9%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-9.png?alt=media\&token=98597a81-82cd-41ed-bcd9-8773eb46ec41) On the **Agent** screen, copy the Account Group Token to the field provided. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-2a66078f153cf82ab758c018162fd030c7a0ba35%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-10.png?alt=media\&token=0764c652-611b-4efa-9c27-a388e1d23d49) 5. For information on the other parameters, see [How to Set Up the Virtual Appliance](https://docs.thousandeyes.com/product-documentation/enterprise-agents/how-to-set-up-the-virtual-appliance). 6. Verify on the **Status** screen that all diagnostics are green. Follow up and correct any faults shown on the Status screen. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e4c1d4e7ec5d06cb1aeee3be60ca0f5103da744c%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-11.png?alt=media\&token=bf3539f8-9bfd-42a6-884d-e25a38a57af3) 7. If network related parameters were changed, for example disabling IP V6 support, reboot the Agent, through the GUI and verify that all the diagnostics are green. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-7604b94e6da2aa05e5205e85c287bd5e6dc4dd6b%2Fproduct-documentation_enterprise-agents_installing-a-physical-appliance-12.png?alt=media\&token=a69a20ee-72c4-40ab-afb2-d3823b885a84) 8. The Enterprise Agent should now appear in the **Cloud & Enterprise Agents> Agent Settings> Enterprise Agents** page of the ThousandEyes portal. ## Troubleshooting #### USB Drive Not Recognized as a Bootable Device A USB drive is plugged in, tapping F10 at power-up, on the "Boot" BIOS screen, USB drive is not recognized as a bootable device. **Resolution:** Check that the BIOS version is current. If not current, upgrade to the latest version. #### Malformed IP Address Ubuntu installation fails with a "blue screen" showing "Malformed IP Address." **Resolution:** Verify that the Ethernet connection to the NUC has a link signal. Verify that the Link LED on the RJ-45 port is lit.\ Verify that there is a DHCP server on the network (broadcast domain) that the NUC is connected to. #### No Root File System Defined Ubuntu installation fails with "No Root File System Defined" message. This situation can occur if USB devices are attached to the NUC via a USB hub. **Resolution:** Do not use USB hub to connect keyboard and USB flash drive to the NUC. #### "thousandeyes-va login:" Prompt Is Shown on the Screen The expected blue "ThousandEyes Virtual Appliance" management screen is not displayed. Instead, a black screen with "`thousandeyes-va login:"` prompt is shown. This is a symptom of an unsuccessful installation. The agent is missing the **te-pa** package which, in addition to the web admin interface, provides the physical console functionality. **Resolution:** Components of the Virtual Agent are missing. Most likely caused by the lack of non-proxied and unrestricted access to the internet during the appliance installation. Reinstall the appliance in an environment that satisfies the requirements listed in the installation environment requirements. #### Keyboard Not Working When the installation completes, keypresses are not recognized. **Resolution:** Most likely incomplete installation. Reinstall the appliance in an environment that satisfies the requirements listed in the installation environment requirements. #### Do You Need Further Assistance? For further assistance, contact [the ThousandEyes Customer Engineering team](https://docs.thousandeyes.com/product-documentation/getting-started/getting-support-from-thousandeyes).