Archived - Installing and Removing ThousandEyes X Virtual Framebuffer on Enterprise Agents
Last updated
Last updated
With the release of te-browserbot
2.0, X Virtual Framebuffer is baked into the containerized runtime environment used by page load and transaction tests, so te-xvfb
is no longer a requirement or suggested dependency of te-browserbot
. This article is only applicable to agents running te-browserbot
version 1.
For your convenience, ThousandEyes provides a wrapper of the X Virtual Framebuffer (Xvfb) installation package for installation on ThousandEyes Enterprise Agents. This wrapper is distributed as a Linux package called te-xvfb, and is included with all Enterprise Agent installations by default.
This article describes when you might need te-xvfb, and how to opt in or out of having it installed on ThousandEyes Enterprise Agents.
"Xvfb is an X server that can run on machines with no display hardware and no physical input devices. It emulates a dumb framebuffer using virtual memory". You can read more about X Virtual Framebuffer .
Xvfb is not required for most browser-based test configurations, but there are notable exceptions.
If you are using Kerberos authentication or for page load or transaction browser-based tests, you must install the ThousandEyes X Virtual Framebuffer on your Enterprise Agents.
When a browser-based test requiring Xvfb runs on an agent without Xvfb, an "X11 Service is not running" error is visible in the test's views.
Installing an Enterprise Agent with Xvfb requires no additional effort:
Linux package agents will come installed with te-xvfb unless the -W
flag is passed to the install_thousandeyes.sh
script
Appliance (e.g. TEVA, TEPA, HyperV, etc.) images include te-xvfb.
Docker images include te-xvfb.
Copy and run the following commands:
Install the appliance as normal.
Run the following command:
ThousandEyes does not distribute a Docker image that excludes Xvfb. To exclude Xvfb from a Docker agent installation, you must build a custom Docker image based on the standard ThousandEyes image:
Create a Dockerfile that conforms to the following template:
Build and push your custom Docker image.
Deploy a Docker agent using your customer Docker image in place of thousandeyes/enterprise-agent
.
Once your agent has upgraded to a version of te-browserbot that no longer depends on te-xvfb (1.146 or greater), take the following installation-specific steps:
apt
(e.g. Ubuntu)Run the following command:
yum
(e.g. CentOS and RHEL)Run the following command:
Run the following command:
You can remove X Virtual Framebuffer, but its removal will not persist across container restarts. We recommend re-installing the agent using a custom Docker image, as described above.
If you encounter this error message, you can confirm that Xvfb is installed and running by checking its status:
your appliance.
your appliance.