What's New
Product Documentation
Enterprise Agent Deployment Using Linux Package Method
The ThousandEyes Enterprise Agent can be deployed on a variety of Linux distributions such as Ubuntu, RedHat Enterprise Linux (RHEL), and CentOS. Supported operating systems can be found in Supported Enterprise Agent Operating Systems.
For Linux distributions not on this list, you may be able to install Docker and the Enterprise Agent Docker container. For more details, see Enterprise Agent deployment using Docker.

Installation

Log in to the Linux system on which you will install the ThousandEyes Enterprise Agent. Log in either as the root user, or a user which has been granted “sudo” access to the necessary package management and other commands required for the installation. Then log into the ThousandEyes application and follow the steps found under Agents > Enterprise Agents > +Add New Agent > Linux Package, explained in detail below.
The first step downloads the installation script from ThousandEyes:
1
curl -Os https://downloads.thousandeyes.com/agent/install_thousandeyes.sh
Copied!
The second command enables execute permission for the installation script:
1
chmod +x install_thousandeyes.sh
Copied!
The third command runs the script:
1
sudo ./install_thousandeyes.sh -b <Account Group Installation Token>
Copied!
Notes
    The -b flag can be removed if BrowserBot is not wanted or if your subscription is "Standard" (no BrowserBot license). For more details, see What is the BrowserBot?
    The Account Group Installation Token identifies the Agent as belonging to a specific Account Group and can be found under Cloud & Enterprise Agents > Agent Settings+Add New Agent > Show Account Group Token for Installation.
    If there are multiple Account Groups in your organization you will need to copy the token from the Account Group context in which you wish the Agent to be first seen. An Agent can be shared between groups. Additional information could be found here: Working with Agent settings.
    If multiple IP addresses are detected on the system, you will be prompted to choose the appropriate one during installation.

Advanced Options

To display the advanced options when installing the Agent use either -h or --help flags.
1
$ ./install_thousandeyes.sh --help
2
Usage: ./install_thousandeyes.sh [-b [-F] [-L]] [-f] [-h] [-I INSTALL_LOG] [-l LOG_PATH] [-t PROXY_TYPE -P PROXY_LOCATION [-U PROXY_USER -u PROXY_PASS]] [-r REPO] [-s] ACCOUNT_TOKEN
3
-b Also install BrowserBot, an agent component that collects
4
Page Load and Transaction test data using an instance
5
of the Chromium browser
6
-L Also install international language packages for BrowserBot (requires -b)
7
-f Force batch mode
8
-h Print this message
9
-I INSTALL_LOG Set the install log location to INSTALL_LOG
10
-l LOG_PATH Set the log path to LOG_PATH
11
-t PROXY_TYPE Set the proxy type: DIRECT (default, no proxy), STATIC, or PAC
12
-P PROXY_LOCATION Set the proxy location, format depends on PROXY_TYPE
13
DIRECT
14
PROXY_LOCATION is an invalid option for DIRECT
15
STATIC
16
host:port for hostname or IPv4 address
17
[IPv6 IP]:port for IPv6 address
18
PAC
19
URL where PAC file can be found
20
-U PROXY_USER Set the proxy user to PROXY_USER
21
-u PROXY_PASS Set the proxy password to PROXY_PASS
22
-r REPO Force the installer to install from REPO (overriding original ones)
23
-s Skip the repository creation
Copied!

Post-Installation

Once the installation completes, the Agent will start automatically. Normally, within a minute the Agent will appear under Cloud & Enterprise Agents > Agent Settings
To avoid synchronization problems with the ThousandEyes collector it is strongly recommended that you install a Network Time Protocol (NTP) package. To download and install an NTP package issue the following commands on the Agents host machine:

Ubuntu

    1.
    sudo apt-get install ntp (Download and install NTP service)
    2.
    service ntp start (Start the NTP service)
    3.
    service ntp status (View current status)
    If you wish to use alternate NTP servers, edit /etc/ntp.conf:
1
$ service ntp status
2
* NTP server is running
3
4
$ cat /etc/ntp.conf
5
# /etc/ntp.conf, configuration for ntpd; see ntp.conf(5) for help
6
7
# Specify one or more NTP servers.
8
9
# Use servers from the NTP Pool Project. Approved by Ubuntu Technical Board
10
# on 2011-02-08 (LP: #104525). See http://www.pool.ntp.org/join.html for
11
# more information.
12
server 0.ubuntu.pool.ntp.org
13
server 1.ubuntu.pool.ntp.org
14
server 2.ubuntu.pool.ntp.org
15
server 3.ubuntu.pool.ntp.org
Copied!
Red Hat Enterprise Linux or CentOS
    1.
    yum install ntp (Install the NTP service)
    2.
    systemctl start ntpd (Start the NTP service)
    3.
    systemctl enable ntpd (Enable NTP to start on reboots)
    4.
    systemctl status ntpd (Print the current status)
If you wish to use alternate NTP servers, edit /etc/ntp.conf:
1
$ systemctl status ntpd
2
● ntpd.service - Network Time Service
3
Loaded: loaded (/usr/lib/systemd/system/ntpd.service; enabled; vendor preset: disabled)
4
Active: active (running) since Wed 2017-03-01 16:23:16 EST; 15min ago
5
Main PID: 12567 (ntpd)
6
CGroup: /system.slice/ntpd.service
7
└─12567 /usr/sbin/ntpd -u ntp:ntp -g
8
9
$ cat /etc/ntp.conf
10
# For more information about this file, see the man pages
11
# ntp.conf(5), ntp_acc(5), ntp_auth(5), ntp_clock(5), ntp_misc(5), ntp_mon(5).
12
13
# Use public servers from the pool.ntp.org project.
14
# Please consider joining the pool (http://www.pool.ntp.org/join.html).
15
server 0.centos.pool.ntp.org iburst
16
server 1.centos.pool.ntp.org iburst
17
server 2.centos.pool.ntp.org iburst
18
server 3.centos.pool.ntp.org iburst
Copied!
We recommend you ensure the NTP service starts at boot time by restarting your system and verifying the ntpd process is automatically started.
Last modified 5mo ago