What's New
Product Documentation

Install the Enterprise Agent with BrowserBot on Oracle Linux Server 7

By default, the Linux package installation of the Enterprise Agent on supported version of Oracle Linux Operating System will show a warning due to missing dependency packages for BrowserBot component. The following step by step guide will enable the repository holding the Enterprise Agent dependency packages, before attempting to run the Enterprise Agent installation script.


All the commands below should be run as root. To reduce the content repetition, all "sudo" command prefixes have been removed and the whole guide assumes that you are running each command in a root shell.

To reach the root shell, use the following command:

$ sudo -s

The expected output is marked with bold characters on every sample command output below.

Step 1: Download the Oracle Linux Release 7 Update for x86 (64 bit) from the Oracle web site

You need to register with Oracle or use an existing Oracle account to download the installation media from the Oracle Software Delivery Cloud.

Step 2: Install the Oracle Linux 7 Operating System

Proceed with a basic installation. In software selection, we recommend you proceed with the default Minimal Install under Base Environment.

Step 3: Enable the Oracle Optional repository (user either yum-config-manager or manually)

3.1 With yum-config-manager

# yum install yum-utils -y
# yum-config-manager --enable ol7_optional_latest

3.2 Manually

# vi /etc/yum.repos.d/public-yum-ol7.repo

Use your preferred text editor to replace enabled=0 with enabled=1 on the section below, then save and exit the file.

name=Oracle Linux $releasever Optional Latest ($basearch)

Step 4: Install ThousandEyes Enterprise Agent

Complete the Linux package installation by following this article: Enterprise Agent deployment using Linux Package method

Troubleshooting the Installation

The install_thousandeyes.sh script, used with -b switch for installing BrowserBot, will display the warning:

Installing ThousandEyes' BrowserBot (Package required for Page Load and Transaction tests) [ WARNING ]
(Failed installing ThousandEyes' BrowserBot)
Starting ThousandEyes
Starting ThousandEyes' BrowserBot [ WARNING ]
(Failed starting ThousandEyes' BrowserBot)
  • Default ThousandEyes Linux Package Installation Log

    Look for errors in the default installation log.

# cat /tmp/install_thousandeyes*.log

Sample output errors:

yum -y -q install te-browserbot
Error: Package: te-browserbot-1.84.2-1.x86_64 (thousandeyes)
Requires: xorg-x11-server-Xvfb
You could try using --skip-broken to work around the problem
You could try running: rpm -Va --nofiles --nodigest
systemctl start te-browserbot
Failed to start te-browserbot.service: Unit not found.

Verify Repositories

# yum repolist enabled
Loaded plugins: ulninfo
repo id repo name status
ol7_UEKR4/x86_64 Latest Unbreakable Enterprise Kernel Release 4 for Oracle Linux 7Server (x86_64) - enabled by default 110
ol7_latest/x86_64 Oracle Linux 7Server Latest (x86_64) - required, enabled by default 12,501
ol7_optional_latest/x86_64 Oracle Linux 7Server Optional Latest (x86_64) - required, manually enabled at Step 3 9,608
thousandeyes ThousandEyes - required, enabled by the install_thousandeyes.sh script 72
repolist: 22,291