====== Process Server ======
Funktionen:
  * Umwandlung von DOCX, XLSX, ODT, ODS in PDF
    * Windows COM - Microsoft Office
    * LibreOffice

<wrap round tip 90%>
Empfehlung: Starten Sie mehrere Server (auch auf einem System - Nutzen Sie mehrere unterschiedliche Ports), da ein Server zu einem Zeitpunkt immer nur eine Datei umwandeln kann.
</wrap>

===== Windows =====

  * [[http://open.untermstrich.com/httpserver:index|untermStrich HTTP Server 3.2.1 oder neuer]] installiert
    * :righty: Der [[de:installation:apache_update?s[]=dienste#i_oeffnen_sie_die_dienste|Apache Dienst]] kann deaktiviert werden
    * [[https://webservices.untermstrich.com/update/|untermStrich entpackt]] nach ''C:\Apache24\htdocs\ustrich''
  * Für DOCX und XLSX -> PDF
    * Ein aktuelleres Microsoft Office (Getestet mit Office 2019 und 2007) auf dem System
    * HTTP Server, PHP, ionCube Bundle ab 3.2.1 oder ''extension = php_com_dotnet.dll'' aktiv in der ''php.ini''.
  * Für ODT und ODS -> PDF
    * Ein konfiguriertes [[de:setup:setup:sideboard:system:external_systems#libreoffice|LibreOffice]] ((LibreOffice stellt nicht alle Dokumente exakt gleich wie Microsoft Office dar. Passen Sie dann das Dokument an oder nutzen Sie einen der anderen PDF Konverter.))

==== Start ====
Siehe ''process_server_start_simple.bat''
<code bash>
c:
cd C:\Apache24\htdocs\ustrich
@C:\Apache24\php\php.exe -S 0.0.0.0:17340  -d upload_max_filesize=200M -d post_max_size=200M -d memory_limit=200M  process_server.php
</code>
  * Das Verzeichnis ''C:\Apache24\htdocs\ustrich'' müssen Sie anpassen, wenn untermStrich bei Ihnen in einem anderen Verzeichnis installiert ist.
  * Den Port ''17340'' können Sie frei anpassen, so lange der Port frei ist.
    * :righty: Lassen Sie aber bitte **17342** aus, da dieser vom Connector genutzt wird.
  * Das [[de:process_server:autostart#windows|automatische Starten können Sie wie hier beschrieben]] umsetzen.

==== Konfiguration - Wenn Sie den Process Server auf einem System ohne untermStrich betreiben ====
<wrap center round important 80%>
Dies Anleitung ist nur auszuführen, wenn Sie den Process Server auf einem zusätzlichen System installieren, auf dem nicht bereits ein untermStrich Server betrieben wird!
</wrap>
  - Installieren Sie PHP, indem Sie den [[http://open.untermstrich.com/httpserver:index]] installieren. 
  - Sie können den Apache dann in den Diensten deaktivieren.
  - Entpacken Sie die aktuelle Version von **untermStrich für PHP7.2** [[https://webservices.untermstrich.com/update/]] nach ''C:\Apache24\htdocs\ustrich''
  - Erstellen Sie die Datei ''C:\Apache24\htdocs\ustrich\application\config\config.php'' mit dem Inhalt:
    * <code php>
<?php 
if ( ! defined('BASEPATH')) exit('No direct script access allowed');
require_once 'config-global.php';
require_once 'config-default.php';
#Wenn LibreOffice benötigt wird:#
$config['us_libreoffice_path'] = '...';
</code>
  - Starten Sie den Process Server wie oben beschrieben.

===== macOS =====
  * Für DOCX, XLSX, ODT und ODS -> PDF
    * Installiertes PHP + Ioncube wie für untermStrich
    * :righty: Der Apache ist nicht notwendig
    * [[https://webservices.untermstrich.com/update/|untermStrich entpackt]]
    * Ein konfiguriertes [[de:setup:setup:sideboard:system:external_systems#libreoffice|LibreOffice]] ((LibreOffice stellt nicht alle Dokumente exakt gleich wie Microsoft Office dar. Passen Sie dann das Dokument an oder nutzen Sie einen der anderen PDF Konverter.))

==== Start ====
<code bash>
php -S 0.0.0.0:17340  -d upload_max_filesize=200M -d post_max_size=200M -d memory_limit=200M  process_server.php
</code>
  * Den Port ''17340'' können Sie frei anpassen, so lange der Port frei ist.
    * :righty: Lassen Sie aber bitte **17342** aus, da dieser vom Connector genutzt wird.
  * Je nach Konfiguration müssen Sie den Pfad zu ''php'' angeben.
  * Das [[de:process_server:autostart#mac_os_x|automatische Starten können Sie wie hier beschrieben]] umsetzen.

==== Konfiguration - Wenn Sie den Process Server auf einem System ohne untermStrich betreiben ====
<wrap center round important 80%>
Dies Anleitung ist nur auszuführen, wenn Sie den Process Server auf einem zusätzlichen System installieren, auf dem nicht bereits ein untermStrich Server betrieben wird!
</wrap>
Erstellen Sie die Datei ''/ustrich/application/config/config.php'' mit dem Inhalt:
  * <code php>
<?php 
if ( ! defined('BASEPATH')) exit('No direct script access allowed');
require_once 'config-global.php';
require_once 'config-default.php';
$config['us_libreoffice_path'] = '/Applications/LibreOffice.app/Contents/MacOS/soffice';
</code>

===== Ubuntu Linux =====
  * Für DOCX, XLSX, ODT und ODS -> PDF
    * Installiertes PHP + Ioncube wie für untermStrich
    * :righty: Der Apache ist nicht notwendig
    * Einpacken Sie [[https://webservices.untermstrich.com/update/|untermStrich]] direkt nach ''/ustrich''
      * <code bash>sudo unzip ustrich.4.zip -d /ustrich/</code>
    * Ein konfiguriertes [[de:setup:setup:sideboard:system:external_systems#libreoffice|LibreOffice]] ((LibreOffice stellt nicht alle Dokumente exakt gleich wie Microsoft Office dar. Passen Sie dann das Dokument an oder nutzen Sie einen der anderen PDF Konverter.))

==== Start ====
<code bash>
php -S 0.0.0.0:17340  -d upload_max_filesize=200M -d post_max_size=200M -d memory_limit=200M  process_server.php
</code>
  * Den Port ''17340'' können Sie frei anpassen, so lange der Port frei ist.
    * :righty: Lassen Sie aber bitte **17342** aus, da dieser vom Connector genutzt wird.
  * Das [[de:process_server:autostart#ubuntu_linux|automatische Starten können Sie wie hier beschrieben]] umsetzen.

==== Server Setup - Ubuntu 18.04 - Wenn Sie den Process Server auf einem System ohne untermStrich betreiben ====
<wrap center round important 80%>
Dies Anleitung ist nur auszuführen, wenn Sie den Process Server auf einem zusätzlichen System installieren, auf dem nicht bereits ein untermStrich Server betrieben wird!
</wrap>

  * <code bash>
sudo apt-get update
sudo apt install php-cli

sudo apt-get install unzip

sudo apt install libreoffice-writer libreoffice-calc libreoffice-l10n-de
#Schriftarten von Windows:
sudo apt install ttf-mscorefonts-installer

wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
tar -xzvf ioncube_loaders_lin_x86-64.tar.gz
sudo mv ioncube /usr/lib/php/
</code>
Erstellen Sie die Datei ''/etc/php/7.2/mods-available/ioncube.ini'' mit dem Inhalt:
  * <code ini>
; configuration for php mysql module
; priority=00
zend_extension = /usr/lib/php/ioncube/ioncube_loader_lin_7.2.so</code> Die Versionsnummer in der Loader Datei (ioncube_loader_lin_**7.2**.so) entspricht Ihrer PHP Version. <wrap left round tip 80%>Vergessen Sie nicht den Kommentar ''; priority=00'' genau so zu kopieren.</wrap>
und erstellen Sie einen Symlink in die beiden apache2 und cli Verzeichnisse:
  * <code bash>sudo phpenmod ioncube</code>

Die aktuelle Version von **untermStrich für PHP7.2** finden Sie unter: [[https://webservices.untermstrich.com/update/]] 

  * <code bash>
sudo unzip ustrich.4.zip -d /ustrich/
</code>

Erstellen Sie die Datei ''/ustrich/application/config/config.php'' mit dem Inhalt:
  * <code php>
<?php 
if ( ! defined('BASEPATH')) exit('No direct script access allowed');
require_once 'config-global.php';
require_once 'config-default.php';
$config['us_libreoffice_path'] = '/usr/bin/libreoffice';
</code>

Das [[de:process_server:autostart#ubuntu_linux|automatische Starten können Sie wie hier beschrieben]] umsetzen.