Configure X Virtual Frame Buffer (Xvfb)

Xvfb is a graphic manager that ensures proper rendering of the reports or emails exported as PDF files. You can perform this configuration as a part of your pre-installation steps for IT Analytics Portal.

To configure Xvfb:

Ensure that system is configured to boot in graphical target, also known as runlevel 5.
- Check existing default target.
```
# systemctl get-default
```
- Set default target to graphical.target.
```
# systemctl set-default graphical.target
```
Use yum to install Xvfb.
```
# yum install Xvfb
```
If the OS is RHEL 8, install rpm libXtst if not already installed.
```
# yum install libXtst
```

Create a config file for Xvfb.

Run # cd /etc/init.d

Create a file Xvfb_background with this content:

#!/bin/sh
# chkconfig:345 20 80
# /etc/init.d/Xvfb_background
#
# Some things that run always
#touch /var/lock/Xvfb_background
# Carry out specific functions when asked to by the system 
case "$1" in 
start)
echo "Starting script Xvfb_background"
/usr/bin/Xvfb :99 &
;;
stop)
echo "Stopping script Xvfb_background"
x=`pgrep Xvfb`; sudo kill -9 $x
;;
*)
echo "Usage: /etc/init.d/Xvfb_background {start|stop}"
exit 1
;;
esac
exit 0

Run the commands:

# chmod 755 Xvfb_background
# chkconfig --add Xvfb_background
# ./Xvfb_background start
# /usr/lib/systemd/system-generators/systemd-sysv-generator
# systemctl enable Xvfb_background

Confirm the Xvfb process is running on port :99 with:
```
#  ps -ef | grep Xvfb
# netstat -anp | grep Xvfb
```

Update the Tomcat bash profile.

su - tomcat

Modify the profile file to look like the one below:

# vi .bash_profile          
JAVA_HOME=/usr/java
JRE_HOME=
TOMCAT_HOME=/opt/tomcat
export JAVA_HOME JRE_HOME TOMCAT_HOME
STORAGE_HOME=$PORTAL_BASE
export STORAGE_HOME
APTARE_HOME=/opt/aptare
export APTARE_HOME
PORTAL_HOME=$APTARE_HOME/portal
export PORTAL_HOME
export DISPLAY=:99

JAVA_OPTS="-server -DPORTAL_HOME=/opt/aptare/portal -DAPTARE_HOME=/opt/aptare"
export JAVA_OPTS
umask 0022

Restart IT Analytics services.
Test a wide report to ensure the exported PDF appears without truncation.

Configure X Virtual Frame Buffer (Xvfb)

Feedback

Feedback