APTARE IT Analytics Installation and Upgrade Guide for Linux

To configure Xvfb:

1. 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

2. Use yum to install Xvfb.
3. If the OS is RHEL 8 or CentOS 8, install rpm libXtst if not already installed.

   # yum install libXtst

4. 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
     

5. 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
   

6. Restart APTARE services.
7. Test a wide report to ensure the exported PDF appears without truncation.