xvfb-run: command not found when starting Spectrum OneClick WebApp

Products

• Spectrum
• Network Observability

Issue/Introduction

Spectrum OneClick WebApp (WebTomcat) fails to start. A blank screen appears in the browser when attempting to access the WebApp URL.

Symptoms

The following error appears in the $SPECROOT/webtomcat/logs/catalina.out file:

bash
/opt/spectrum/webtomcat/bin/catalina.sh: line 464: xvfb-run: command not found
/opt/spectrum/webtomcat/bin/catalina.sh: line 475: xvfb-run: command not found

Tomcat for the OneClick WebApp will not start when running $SPECROOT/webtomcat/bin/startWebTomcat.sh.

Environment

Release: All Supported Releases

Spectrum OneClick WebApp

Cause

The X virtual frame buffer (Xvfb) RPM is missing from the Linux operating system. WebTomcat requires this utility to provide a virtual display environment for the application.

Resolution

Install the missing Xvfb package and restart the WebTomcat service.

1. Log in to the Spectrum server as root (or sudo).

2. Install the required RPM: yum\dnf install -y xorg-x11-server-Xvfb

   Note: If the package is not found, attempt using the optional repository: yum\dnf install -y --enablerepo rhel-7-server-optional-rpms xorg-x11-server-Xvfb

3. Restart the WebTomcat service:

   • Navigate to $SPECROOT/webtomcat/bin/
   • Run ./stopWebTomcat.sh then ./startWebTomcat.sh

See Download Broadcom products and software for the latest Spectrum updates. To speak with a customer representative or a Support Engineer see Contact Support.

Additional Information

• System Requirements for Linux
• Troubleshoot OneClick WebApp
• Subscribe to this article (Reference KB 275360) to be updated on fix status.
• Get Started with the Broadcom Support Portal