K (Textersetzung - „Box Note“ durch „Hinweisbox“) |
Keine Bearbeitungszusammenfassung Markierung: 2017-Quelltext-Bearbeitung |
||
Zeile 1: | Zeile 1: | ||
{{ | {{DISPLAYTITLE:Webservice: PDF-Export}} | ||
__TOC__ | |||
Dieses Dokument beschreibt die Installation des PDF-Export von BlueSpice. Bitte beachten Sie, dass als Applikationsserver [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat|Apache Tomcat]] (Windows) bzw. [[Setup:Installationsanleitung/Systemvorbereitung/Linux/Jetty|Jetty]] fertig installiert und konfiguriert auf dem BlueSpice-Server laufen muss. | |||
* | ==Verschieben der BShtml2PDF Anwendung== | ||
* | Verschieben Sie die Datei "BShtml2PDF.war" aus dem Verzeichnis <code>extensions/BlueSpiceUEModulePDF/webservices</code> der BlueSpice-Quellen nach in das webapps-Verzeichnis Ihres Applikationsservers. In der Regel lauten die Standardpfade wie folgt: | ||
*C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps '''(Apache Tomcat unter Windows)''' | |||
*/var/lib/jetty9/webapps '''(Jetty unter Debian)''' | |||
Die Anwendung wird im Regelfall on-the-fly gestartet, ohne dass ein Neustart des Applikationsservers nötig ist. | |||
==Überprüfen der Funktionalität== | |||
Die korrekte Funktionalität des BShtml2PDF Service können Sie wie folgt überprüfen: | |||
===Unter Windows=== | |||
Öffnen Sie im Internet Explorer die URL <nowiki>http://localhost:8080/BShtml2PDF</nowiki>. Bei korrekter Funktionalität sollten Sie folgende Webseite sehen: | |||
[[File:Setup:Tomcat_Check_03.png|center|400px|Tomcat Check 03]] | |||
==Aktivieren von PDF-Export in BlueSpice== | |||
Wechseln Sie in das Verzeichnis <code><installpath-bluespice>/settings.d</code>. | |||
Öffnen Sie die Datei <br>'''020-BlueSpiceUEModulePDF.php''' in einem Texteditor. | |||
In der zweiten Zeile finden Sie einen Code, der bei dies Erweiterungen deaktiviert: | |||
return; // Disabled. Needs Tomcat | |||
Fügen Sie wahlweise ein Kommentarzeichen ('''#''') an den Anfang dieser Zeile ein oder löschen Sie diese Zeile komplett, speichern die Datei und verlassen Sie diese wieder. | |||
Öffnen Sie nun eine Kommandozeile und wechseln in den Ordner <code><installpath-bluespice></code>. Führen Sie dort folgenden Befehl aus: | |||
php maintenance/update.php ''(Linux)'' | |||
php maintenance\update.php ''(Windows))'' | |||
{{Hinweisbox | |||
|Note text=Achten Sie unter Windows darauf, dass die [[Setup:Installationsanleitung/Systemkonfigurationen/Umgebungsvariablen|Umgebungsvariablen]] korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.}} | |||
{{Hinweisbox | |||
|Note text=Beachten Sie unter Linux, dass Sie nach dem Ausführen der update.php die [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte#Verrechtung_unter_Linux|Dateisystemrechte]] neu anpassen müssen.}} | |||
Sobald das Script mit der Meldung "Done" abgeschlossen ist ist der Webservice erfolgreich installiert.<br /><br /> | |||
[[Datei:Setup:Setup_bluespice_maintenance_update.jpg|center|400x556px]] | |||
==Troubleshooting== | |||
Sollte es beim PDF-Export in BlueSpice Probleme geben überprüfen Sie zu allererst die [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|Dateisystemrechte]]. | |||
==Download Webservices== | |||
Sollten die erforderliche war-Datei nicht in Ihrem Installationspaket vorhanden sein, können Sie sie hier herunterladen: [https://buildservice.bluespice.com/webservices3.tar.gz Webservices] | |||
[[de:{{FULLPAGENAME}}]] | |||
[[en:Setup:Installation_Manual/Webservices/PDF-Export]] |
Version vom 19. Januar 2022, 09:13 Uhr
Dieses Dokument beschreibt die Installation des PDF-Export von BlueSpice. Bitte beachten Sie, dass als Applikationsserver Apache Tomcat (Windows) bzw. Jetty fertig installiert und konfiguriert auf dem BlueSpice-Server laufen muss.
Verschieben der BShtml2PDF Anwendung[Bearbeiten | Quelltext bearbeiten]
Verschieben Sie die Datei "BShtml2PDF.war" aus dem Verzeichnis extensions/BlueSpiceUEModulePDF/webservices
der BlueSpice-Quellen nach in das webapps-Verzeichnis Ihres Applikationsservers. In der Regel lauten die Standardpfade wie folgt:
- C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps (Apache Tomcat unter Windows)
- /var/lib/jetty9/webapps (Jetty unter Debian)
Die Anwendung wird im Regelfall on-the-fly gestartet, ohne dass ein Neustart des Applikationsservers nötig ist.
Überprüfen der Funktionalität[Bearbeiten | Quelltext bearbeiten]
Die korrekte Funktionalität des BShtml2PDF Service können Sie wie folgt überprüfen:
Unter Windows[Bearbeiten | Quelltext bearbeiten]
Öffnen Sie im Internet Explorer die URL http://localhost:8080/BShtml2PDF. Bei korrekter Funktionalität sollten Sie folgende Webseite sehen:
Aktivieren von PDF-Export in BlueSpice[Bearbeiten | Quelltext bearbeiten]
Wechseln Sie in das Verzeichnis <installpath-bluespice>/settings.d
.
Öffnen Sie die Datei
020-BlueSpiceUEModulePDF.php in einem Texteditor.
In der zweiten Zeile finden Sie einen Code, der bei dies Erweiterungen deaktiviert:
return; // Disabled. Needs Tomcat
Fügen Sie wahlweise ein Kommentarzeichen (#) an den Anfang dieser Zeile ein oder löschen Sie diese Zeile komplett, speichern die Datei und verlassen Sie diese wieder.
Öffnen Sie nun eine Kommandozeile und wechseln in den Ordner <installpath-bluespice>
. Führen Sie dort folgenden Befehl aus:
php maintenance/update.php (Linux) php maintenance\update.php (Windows))
Sobald das Script mit der Meldung "Done" abgeschlossen ist ist der Webservice erfolgreich installiert.
Troubleshooting[Bearbeiten | Quelltext bearbeiten]
Sollte es beim PDF-Export in BlueSpice Probleme geben überprüfen Sie zu allererst die Dateisystemrechte.
Download Webservices[Bearbeiten | Quelltext bearbeiten]
Sollten die erforderliche war-Datei nicht in Ihrem Installationspaket vorhanden sein, können Sie sie hier herunterladen: Webservices