Install the Enterprise Agent with BrowserBot on Oracle Linux Server 7

Last updated: Tue Apr 16 12:04:21 GMT 2019

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.

Installation

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.

[ol7_optional_latest]
name=Oracle Linux $releasever Optional Latest ($basearch)
baseurl=https://yum.oracle.com/repo/OracleLinux/OL7/optional/latest/$basearch/
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle
gpgcheck=1
enabled=1

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