Webservice: PDF-Export

A quality version of this page, approved on 1 April 2019, was based off this revision.

Tips for this Document

Please, read this manual completely and work through the single installation steps one after another.
For editing the configuration files with a text editor, the files must be saved in UTF-8 coding without BOM (Byte Order Mark).
The placeholder <installpath-bluespice> stands for the path to your BlueSpice installation, e.g C:\inetpub\wwwroot\bluespice (Windows) or /var/www/bluespice (Linux).
The placeholder <tomcat-webapps> stands for the path to the Webapps directory of your Tomcat server, e.g. C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps (Windows) or /var/lib/tomcat8/webapps (Linux).

Restart the Tomcat Webserver like described here.

Go to the directory <installpath-bluespice>/settings.d. Open the file 020-BlueSpiceUEModulePDF.php in a text editor.

In the second line is a 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 to the <installpath-bluespice> folder. Execute the following command:

php maintenance/update.php (Linux)
php maintenance\update.php (Windows))

	In Windows, make sure that the environment variables are set correctly to access the php command.

	Note that you must update the file system permissions after running update.php.

When the script is finished with the "Done" message, the web service is successfully installed.

If there is a problem with PDF export in BlueSpice, first check the file system permissions.