Zum Hauptinhalt springen
Hilfecenter

PDF-Verarbeitungsdienst einrichten

Den JOD-Server (jod-server.jar) für teamspace/projectfacts einrichten – ein Hilfsdienst, der Word-Dokumente in PDFs umwandelt und Dokumente zu einem PDF zusammenfasst. Unter Linux und Windows.

Voraussetzungen

  • Eine laufende teamspace-Installation
  • Die Datei jod-server.jar – auf Anfrage über teamspace-classic

Der PDF-Verarbeitungsdienst (JOD-Server) ist ein Hilfsdienst, der Word-Dokumente in PDFs umwandelt und das Zusammenfassen verschiedener Dokumentenarten in ein PDF ermöglicht. Du kannst ihn auf demselben Server betreiben, auf dem projectfacts/teamspace läuft.

Für die PDF-Funktion benötigst du die Datei jod-server.jar. Wir stellen sie dir auf Anfrage zur Verfügung. Nutzt du den Dienst nicht, sind in der web.xml keine Anpassungen nötig.

Linux

  1. Installiere LibreOffice: 
    apt install libreoffice
  2. Kopiere die jod-server.jar nach /opt/jod-server/.
  3. Erstelle /opt/jod-server/config.properties: 
    port=3902
threads=2
whitelist=*
    port ist frei wählbar. Um eine IP-Adresse freizugeben, gib sie unter whitelist als RegEx an.
  4. Lege Benutzer und Gruppe an: 
    groupadd -r jod
useradd -r -s /bin/false -g jod jod
chown jod: /opt/jod-server
  5. Erstelle /etc/systemd/system/jod.service: 
    [Unit]
Description=JOD-Server

[Service]
WorkingDirectory=/opt/jod-server
ExecStart=/bin/java -jar jod-server.jar
User=jod
Type=simple
Restart=on-failure
RestartSec=15

[Install]
WantedBy=multi-user.target
  6. Aktiviere den Dienst: 
    systemctl daemon-reload
systemctl enable jod.service
  7. Ergänze in der web.xml von projectfacts den Eintrag (oder passe ihn an): 
    <context-param>
   <param-name>pdfConvertService.url</param-name>
   <param-value>127.0.0.1:3902</param-value>
</context-param>

Windows

  1. Lege unter C:\projectfacts\ den Ordner jod-server an (C:\projectfacts\jod-server) und kopiere die jod-server.jar hinein.
  2. Erstelle die Datei jod-server-start.bat: 
    java -Dserver.port=3902 -jar jod-server.jar
  3. Lege eine Aufgabenplanung an, damit die Batch-Datei nach dem Serverstart automatisch ausgeführt wird.
  4. Ergänze in der web.xml den pdfConvertService.url-Eintrag (siehe Linux-Schritt 7).

Typische Fragen & Anforderungen

Du möchtest …So geht’s
Word-Dokumente als PDF erzeugenDen JOD-Server einrichten und pdfConvertService.url in der web.xml setzen.
Einen anderen Port verwendenIn config.properties (Linux) bzw. der .bat (Windows) den Port ändern und in der web.xml angleichen.
Den Dienst nach Serverstart automatisch startenLinux: systemctl enable jod.service. Windows: Aufgabenplanung für die .bat.

Verwandte Themen