On Linux Systems

If you installed Web Reports on a Linux system, to export reports as PDF documents via Google Chrome, run the following steps:

Install the rpm package google-chrome-stable with version not lower than 116.0.5845.187
On the BigFix console, click Fixlets and Tasks
Search for the following task ID:
- Task ID: 5512: BES Web Reports: Enable PDF Reports - Linux
Run the action in this task.

Otherwise, you do not have to install extra components, but you must run some configuration steps if they apply to your environment as follows.

If BigFix server uses a proxy connection to communicate over the Internet and you run Web Reports using Firefox on the Linux system where you installed the Web Reports.

Ensure that the Firefox browser is not configured for the system's fully qualified hostname. For example, if your network domain is mynetwork.com, configure the Firefox connection settings as highlighted in the following picture:

If the DISPLAY variable is set to a value different from DISPLAY=:0.0

Manually change the export statement in the /etc/init.d/beswereports file as follows:

Stop the Web Reports service by running:
```
/etc/init.d/beswereports stop
```
Edit the file /etc/init.d/beswereports.
Set the DISPLAY variable to correctly point to your X server.
Save the file.
Restart the Web Reports service by running:
```
/etc/init.d/beswereports start
```

If the runlevel set on your Linux system is different from 5.

Modify the runlevel and set it to 5, or use xvfb.

Run these steps if you decide to use xvfb:

Set up the optional channel as follows:
```
rhn-channel --add --channel=rhel-x86_64-server-optional-6
```
Install the packages:
```
yum install xorg-x11-server-Xvfb.x86_64
yum install gstreamer-plugins-base-XXX
yum install urw-fonts-XXX
```
where XXX depends on the specific version number of the packages installed, for example: gstreamer-plugins-base-0.10.36-10.e17.x86_64.

Note: On Red Hat Linux 8, the library to use for the yum install command is urw-base35-fonts-XXX, where XXX depends on the specific version number of the packages installed.

You can get the full, current name of these packages by running the following commands on your system:
```
rpm -qa | grep urw-fonts
rpm -qa | grep gstreamer
```
Important: This step is no longer required if you install or upgrade to BigFix 10.0.5.
Modify the script that manages the PDF exports as follows:
1. Edit the script /var/opt/BESWebReportsServer/BESReportsData/BESExe/generatepdf.sh
2. Prepend:
```
xvfb-run -a -s "-screen 0 1024x768x16"
```
  before the statement:
```
$besexe_folder$athena_folder$athena_executable --ignore-certificate-errors 
--delay 5000 --no-cache $arg1 $arg2
```
  so that it is a unique command line as follows:
```
xvfb-run -a -s "screen 0 1024x768x16" $besexe_folder$athena_folder$athena_executable 
--ignore-certificate-errors --delay 5000 --no-cache $arg1 $arg2
```
3. Save the script file.

If you cannot generate the PDF.

If the generation of the PDF does not complete successfully and the /var/log/BESWebReportsPdfExport.log file shows the following error:

error while loading shared libraries: libXss.so.1: cannot open shared object file: No such file or directory

Install the following library which is required on Red Hat by issuing the command:

sudo yum install libXScrnSaver

If you experience a slow rendering when the PDF is generated.

If the generation of the PDF takes longer than 5 seconds to display the Web Reports exports to the PDF only the data that were available before the 5 seconds elapsed. To bypass this limitation, increase the delay as follows:

Edit the script /var/opt/BESWebReportsServer/BESReportsData/BESExe/generatepdf.sh
Increase the value that is assigned to –delay in the statement:
```
$besexe_folder$athena_folder$athena_executable --ignore-certificate-errors 
--delay 5000 --no-cache $arg1 $arg2
```
The value is expressed in milliseconds and 5000 ms is the default vale.
Save the script file.