Skip to main content

Rendering-service 4.4 with priint:pdf renderer Setup Guide for Ubuntu 22.04.3 LTS

This guide outlines the steps to get the rendering-service 4.4 with PDF renderer up and running on a fresh Ubuntu 22.04.3 LTS system.

Prerequisites​

  • Ubuntu 22.04.3 LTS
  • Internet connection
  • Latest version of rendering-service.jar.
  • Latest version of the libs (GitLab repository).

Installation Steps​

1. Install Fonts and Applications​

Run the following commands to install necessary fonts and applications:

locale-gen --lang en_US.UTF-8 && \
apt update && \
apt install software-properties-common -y && \
add-apt-repository ppa:deadsnakes/ppa -y &&  \
apt update &&  \
apt install -y msttcorefonts fonts-tlwg-garuda-ttf fontconfig unzip net-tools curl python3.8 libpython3.8 tidy libltdl7

2. Install JDK 17​

Install Java Development Kit 17:

apt install openjdk-17-jdk

3. Native Libraries​

Ensure you have a folder containing all native libraries. The libs can be found at this GitLab repository.

A checklist of the required libraries is as follows:

  • comet_pdf.1.so
  • comet_pdf.2.so
  • comet_pdf.3.so
  • comet_pdf.4.so
  • libboost_date_time.a
  • libboost_date_time.so -> libboost_date_time.so.1.71.0
  • libboost_date_time.so.1.71.0
  • libboost_filesystem.a
  • libboost_filesystem.so -> libboost_filesystem.so.1.71.0
  • libboost_filesystem.so.1.71.0
  • libboost_locale.a
  • libboost_locale.so -> libboost_locale.so.1.71.0
  • libboost_locale.so.1.71.0
  • libboost_program_options.a
  • libboost_program_options.so -> libboost_program_options.so.1.71.0
  • libboost_program_options.so.1.71.0
  • libboost_system.a
  • libboost_system.so -> libboost_system.so.1.71.0
  • libboost_system.so.1.71.0
  • libboost_thread.a
  • libboost_thread.so
  • libboost_thread.so.1.71.0
  • libicudata.so.66 -> libicudata.so.66.1
  • libicudata.so.66.1
  • libicui18n.so.66 -> libicui18n.so.66.1
  • libicui18n.so.66.1
  • libicuuc.so.66 -> libicuuc.so.66.1
  • libicuuc.so.66.1
  • libodbc.a
  • libodbccr.a
  • libodbccr.so -> libodbccr.so.2.0.0
  • libodbccr.so.1 -> libodbccr.so.2
  • libodbccr.so.2 -> libodbccr.so.2.0.0
  • libodbccr.so.2.0.0
  • libodbcinst.a
  • libodbcinst.so -> libodbcinst.so.2.0.0
  • libodbcinst.so.1 -> libodbcinst.so.2
  • libodbcinst.so.2 -> libodbcinst.so.2.0.0
  • libodbcinst.so.2.0.0
  • libodbc.so -> libodbc.so.2.0.0
  • libodbc.so.1 -> libodbc.so.2
  • libodbc.so.2 -> libodbc.so.2.0.0
  • libodbc.so.2.0.0
  • libxl.so

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.

5. Configuration Files​

Adjust the logback.xml, worker config JSON, and rendering-service config YAML to your preferences. Detailed setup instructions are available in the HELP.md file shipped with the rendering-service jar or here.

6. License Folder​

Ensure the license folder is present and correctly referenced in the rendering-service configuration YAML.

7. Rendering-Service.jar​

Make sure you have the latest version of 4.4 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.4 with PDF renderer successfully running on Ubuntu 22.04.3 LTS. For additional support, refer to the documentation or reach out to the support team.