[PR #1322] [MERGED] Fix: Stirling-PDF > LibreOffice/unoconv Integration Issues #2950

Closed
opened 2025-11-20 05:32:41 -05:00 by saavagebueno · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/community-scripts/ProxmoxVE/pull/1322
Author: @m6urns
Created: 1/7/2025
Status: Merged
Merged: 1/9/2025
Merged by: @michelroegl-brunner

Base: mainHead: stirling-pdf-fix


📝 Commits (3)

  • f1bad5e Modify install script to install core libreoffice components. Configure a running libreoffice service and setup env variables so they are accessible to StirlingPDF. Modify stirlingPDF service to wait for libreoffice service to start. Enable and explicitly start libreoffice and stirlingPDF services.
  • 32f8d1c Apply suggestions from code review
  • 501c1f8 Update stirling-pdf-install.sh

📊 Changes

1 file changed (+43 additions, -10 deletions)

View changed files

📝 install/stirling-pdf-install.sh (+43 -10)

📄 Description

✍️ Description

The current installation script for the StirlingPDF LXC has issues with LibreOffice and unoconv integration, causing document conversion failures. These issues are caused by the following:

  1. Missing LibreOffice dependencies
  2. No dedicated LibreOffice listener service
  3. Incorrect port configuration for unoconv/LibreOffice communication
  4. Missing environment variables for Python-UNO bridge

Issues with document conversion and missing environmental variables were resolved by:

  1. Adding essential LibreOffice packages (libreoffice-core, libreoffice-common, libreoffice-base-core)
  2. Explicitly installing python3-uno
  3. Creating a dedicated LibreOffice listener service configured for port 2002 (unoconv's default)
  4. Adding necessary environment variables for proper Python-UNO bridge functionality
  5. Modifying StirlingPDF service to depend on LibreOffice listener service
  6. Adding service configuration for automatic restarts


🛠️ Type of Change

Please check the relevant options:

  • Bug fix (non-breaking change that resolves an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change unexpectedly)
  • New script (a fully functional and thoroughly tested script or set of scripts)

Prerequisites

The following steps must be completed for the pull request to be considered:

  • Self-review performed (I have reviewed my code to ensure it follows established patterns and conventions.)
  • Testing performed (I have thoroughly tested my changes and verified expected functionality.)
  • Documentation updated (I have updated any relevant documentation)

📋 Additional Information (optional)

Provide any extra context or screenshots about the feature or fix here.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/community-scripts/ProxmoxVE/pull/1322 **Author:** [@m6urns](https://github.com/m6urns) **Created:** 1/7/2025 **Status:** ✅ Merged **Merged:** 1/9/2025 **Merged by:** [@michelroegl-brunner](https://github.com/michelroegl-brunner) **Base:** `main` ← **Head:** `stirling-pdf-fix` --- ### 📝 Commits (3) - [`f1bad5e`](https://github.com/community-scripts/ProxmoxVE/commit/f1bad5ef52e266b5b5df649b967036eef59dd4bc) Modify install script to install core libreoffice components. Configure a running libreoffice service and setup env variables so they are accessible to StirlingPDF. Modify stirlingPDF service to wait for libreoffice service to start. Enable and explicitly start libreoffice and stirlingPDF services. - [`32f8d1c`](https://github.com/community-scripts/ProxmoxVE/commit/32f8d1c930aa08177136aa150ecc5ca69ff0b9af) Apply suggestions from code review - [`501c1f8`](https://github.com/community-scripts/ProxmoxVE/commit/501c1f8ee14c153bb508ec85532cf010ab19ca89) Update stirling-pdf-install.sh ### 📊 Changes **1 file changed** (+43 additions, -10 deletions) <details> <summary>View changed files</summary> 📝 `install/stirling-pdf-install.sh` (+43 -10) </details> ### 📄 Description ## ✍️ Description The current installation script for the StirlingPDF LXC has issues with LibreOffice and unoconv integration, causing document conversion failures. These issues are caused by the following: 1. Missing LibreOffice dependencies 2. No dedicated LibreOffice listener service 3. Incorrect port configuration for unoconv/LibreOffice communication 4. Missing environment variables for Python-UNO bridge Issues with document conversion and missing environmental variables were resolved by: 1. Adding essential LibreOffice packages (libreoffice-core, libreoffice-common, libreoffice-base-core) 2. Explicitly installing python3-uno 3. Creating a dedicated LibreOffice listener service configured for port 2002 (unoconv's default) 4. Adding necessary environment variables for proper Python-UNO bridge functionality 5. Modifying StirlingPDF service to depend on LibreOffice listener service 6. Adding service configuration for automatic restarts - - - - Related Issue: #1321 --- ## 🛠️ Type of Change Please check the relevant options: - [x] Bug fix (non-breaking change that resolves an issue) - [ ] New feature (non-breaking change that adds functionality) - [ ] Breaking change (fix or feature that would cause existing functionality to change unexpectedly) - [ ] New script (a fully functional and thoroughly tested script or set of scripts) --- ## ✅ Prerequisites The following steps must be completed for the pull request to be considered: - [x] Self-review performed (I have reviewed my code to ensure it follows established patterns and conventions.) - [x] Testing performed (I have thoroughly tested my changes and verified expected functionality.) - [ ] Documentation updated (I have updated any relevant documentation) --- ## 📋 Additional Information (optional) Provide any extra context or screenshots about the feature or fix here. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
saavagebueno added the pull-request label 2025-11-20 05:32:41 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SVI/ProxmoxVE#2950