Troubleshooting PDF Reports

This section covers common issues encountered when generating PDF reports.

wkhtmltopdf not found

If report generation to PDF fails with an error such as “wkhtmltopdf binary not configured, not found or not executable in PATH” then wkhtmltopdf was not found on your system.

Although the PDF option cannot be chosen if wkhtmltopdf cannot be found, PDF generation is still possible from historical HTML generated reports.

Causes

• wkhtmltopdf not installed.

• wkhtmltopdf is installed in a non-standard location.

Resolution

Verify that wkhtmltopdf is installed on your system and available in your $PATH;

If not installed, install it via your system package manager. This should be installed alongside opReports on Debian based systems but you may need to install it manually by searching your system's package manager repositories for wkhtmltopdf, wkhtmltox or alternatively from https://wkhtmltopdf.org/downloads.html.

If you have the binary available in a non-standard location then you can manually specify the path using the opreports_wkhtmltopdf_path field in your opCommon.json configuration.

More information on configuration options is available here:opReports ConfigurationPreview