Make sure that the Apache Tomcat server is completely installed and configured on the BlueSpice server before setting up PDF-Export.
Moving the BShtml2PDF Application
Download the file "BShtml2PDF.war" from https://sourceforge.net/projects/bluespice/files/webservices/BShtml2PDF.war/download and copy it to
The default paths are as follows:
- C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps (Apache Tomcat on Windows)
- /var/lib/jetty9/webapps (Jetty on Debian)
The application usually starts automatically without the need for rebooting the application server.
Checking the functionality
The correct functionality of the BShtml2PDF service can be checked as follows:
On Windows, open Internet Explorer using the URL http://localhost:8080/BShtml2PDF. With correct functionality, you should see the following website:
Enable PDF Export in BlueSpice
Go to the directory
<installpath-bluespice>/settings.d. Open the file 020-BlueSpiceUEModulePDF.php in a text editor.
In the second line is the code to activate the extension:
return; // Disabled. Needs Tomcat
You can either add a comment character (#) to the beginning of this line or delete the line completely, save the file and exit it.
Open a command line and change into the folder
<installpath-bluespice>. Execute the following command:
php maintenance/update.php (Linux) php maintenance\update.php (Windows))
When the script is finished with the "Done" message, you have successfully isntalled the web service .
If there is a problem with the PDF export in BlueSpice, first check the file system permissions.
Download Web services
If the required war-file is missing in your installation package, you can download it here: Webservices.