Skip to main content

Embedded priint:comet PDF Renderer - Setup Guide for Ubuntu 24.04.2 LTS

This guide outlines the steps to get the rendering-service 4.7 with an embedded PDF renderer instance up and running on a fresh Ubuntu 24.04.2 LTS system.

Prerequisites​

  • Ubuntu 24.04.2 LTS
  • Internet connection
  • Publishing Server - Version: >= 2025.2 (4.7)
  • Rendering Service - Version: >= 4.7 - Latest version of rendering-service.jar.
  • Latest version of the libs - Version: >= 5.0 (FTP) or (GitLab repository) (internal access only).

Installation Steps​

1. Install JDK 21​

Install Java Development Kit 21:

apt install openjdk-21-jdk

2. Install Fonts and Applications​

Run the following commands to install the necessary fonts and applications:

locale-gen --lang en_US.UTF-8 && \
apt update && \
apt install software-properties-common -y && \
apt update &&  \
apt install -y msttcorefonts fonts-tlwg-garuda-ttf fontconfig unzip net-tools zip vim curl tidy libltdl7 \
      libboost-program-options1.83.0 libboost-atomic1.83.0 libboost-chrono1.83.0 \
      libboost-date-time1.83.0 libboost-filesystem1.83.0 libboost-locale1.83.0 \
      libboost-serialization1.83.0 libboost-system1.83.0 libboost-thread1.83.0 \
      libodbc2 libicu74 libpcre3 python3.12 python3-pip && \
rm -rf /var/lib/apt/lists/* && \
pip3 install --break-system-packages --upgrade pillow && \
cd /usr/lib/python3.12 &&\
ln -s /usr/local/lib/python3.12/dist-packages/PIL/ &&\
ln -s /usr/local/lib/python3.12/dist-packages/pillow-* &&\
ln -s /usr/local/lib/python3.12/dist-packages/pillow.libs

3. priint:comet PDF Renderer (Native Libraries)​

Ensure you have a folder containing native libraries. The libs can be found at this GitLab repository (internal access only) or on the priint FTP Server in the folder https://webftp.priint.com/#/Comet_PDF/5.0/latest/. The Libs ("lib/native/linux") can be found together with a "config" folder in the archive "priint-renderer-pdf-linux-5.0-RXXXXX.tar.gz".

contents-renderer-archive.png

Copy comet_pdf.1.so and libxl.so from the "lib" and all from the "config" folder as a subfolder of your Rendering Service Application.

4. Environment Variable​

Set the LD_LIBRARY_PATH environment variable:

export LD_LIBRARY_PATH=/path/to/native/libs

Replace /path/to/native/libs with the actual path to the native libraries.

Make sure this variable survives a system reboot. Consider placing it in /etc/environment or ~/.profile.

5. Configuration Files​

Adjust the logback.xml, worker config JSON, and rendering-service config YAML to your preferences. Detailed setup instructions are available here.

6. License Folder​

Ensure the license and configuration folder is present, holds the required pdf-profiles and is correctly referenced in the rendering-service configuration YAML. In particular, the PDF renderer license should be placed in the config folder.

7. Rendering-Service.jar​

Make sure you have the latest version of 4.7 rendering-service.jar.

8. Run the Rendering-Service​

Start the rendering-service with the following command:

java -Dspring.config.additional-location=file:application.yml -Dworkers.config=pdf-workers-config.json -jar rendering-service.jar

Conclusion​

Following these steps should get your rendering-service 4.7 with embedded PDF renderer successfully running on Ubuntu 24.04.2 LTS. For additional support, refer to the documentation or reach out to the support team.