====== Installationsbeispiel für Ubuntu Linux 16.04 (Als Server) für untermStrich X2 ======

<WRAP round important 60%>
Installation auf Ubuntu Linux 16.04 werden nicht mehr unterstützt.

Neuinstallation auf  sind nicht mehr empfohlen. Nur PHP 7.0 und [[https://wiki.ubuntu.com/Releases|End of Standard Support April 2021]])
</WRAP>

^ **:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR. ** ^
| Die Firma untermStrich software gmbh übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen! |
^ ** :!: ACHTEN SIE AUF DIE SICHERHEIT IHRES SERVERS!! ** ^
| Apache, PHP, MySQL muss wie auch untermStrich aktuell gehalten werden. Dies gilt besonders, wenn der Server im Internet verfügbar sein soll. |

\\

^ <wrap center round important 60%>ACHTUNG: Nur für X2 nicht für X.1</wrap> ^
| ** Diese Anleitung ist nur für [[de:x2|untermStrich X2]] gültig. ** |
| :!: Beachten Sie die: [[de:x2|Wichtigen Informationen zu X2]] |

\\

===== WICHTIG: Update von Ubuntu 12.04/14.04 auf 16.04 =====
<WRAP center round important 90%>
[[de:faq:mysql_backup_unter_ubuntu_linux|Sichern Sie die Datenbank ]]vor dem Update!\\
Es kann notwendig werden, die Datenbank nach dem Ubuntu Update neu einzuspielen, vor allem nach dem  [[https://askubuntu.com/questions/766917/14-04-to-16-04-killed-mysql|Update von 14.04 auf 16.04.]]
</WRAP>

  * Ein direktes Update ist nicht möglich. Verschieben sie das untermStrich Programmverzeichnis ''/var/www/html/ustrich'' nach ''/var/www/html/ustrich.old'' und führen Sie die Installation wie unten beschrieben aus:

===== I. Ubuntu Server installieren =====
  - Ubuntu Server herunterladen
    * [[http://www.ubuntu.com/download/server/download]]
    * :!r: Diese Anleitung bezieht sich auf Ubuntu 16.04 LTS.
  - Installieren
    * **:!: Wählen Sie bei der Installation ''LAMP'' aus!**
      * **:!: ACHTUNG: ** Bewahren Sie das MySQL root Kennwort gut auf. Sie benötigen es, um später untermStrich zu installieren, ein Backup auszuführen u.s.w..
===== II. Ubuntu Server vorbereiten =====
Mit diesen Befehlen bereiten Sie den Server so vor, dass Sie später keine Komponenten mehr installieren müssen.

:!: Selbstverständlich ist dies nur einer der vielen möglichen Wege.
Wenn Sie eine andere Methode bevorzugen, erhalten Sie in **Schritt V** durch den Installer alle notwendigen Informationen.

:!: Beachten Sie dennoch **Schritt III und IV**
 
    * Software
      * <code bash>sudo apt-get install unzip
sudo apt-get install automysqlbackup
sudo apt-get install php
sudo apt-get install php-cli
sudo apt-get install openjdk-8-jre-headless
</code>
    * ioncube
      * <code bash>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.0/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.0.so</code> Die Versionsnummer in der Loader Datei (ioncube_loader_lin_**7.0**.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>
 
    * Apache
      * <code bash>sudo a2enmod rewrite
sudo a2enmod expires</code>
      * Öffnen Sie die Datei '' /etc/apache2/sites-enabled/000-default.conf'' und ergänzen Sie den Directory Block:
        * <code ini><VirtualHost *:80>
...
<Directory /var/www/html/ustrich>
AllowOverride All
Require all granted
</Directory>
...
</VirtualHost></code>

    * PHP
      * <code bash>sudo apt-get install php-xml php-mcrypt php-ldap php-tidy php-mbstring php-zip</code>
      * Erstellen Sie die Datei ''/etc/php/7.0/mods-available/ustrich.ini'' mit dem Inhalt:
        * <code ini>upload_max_filesize = 100M
post_max_size = 130M</code>
      * und erstellen Sie einen Symlink in die beiden apache2 und cli Verzeichnisse:
        * <code bash>sudo phpenmod ustrich</code>
        * <code bash>sudo phpenmod mcrypt</code>
        * <code bash>sudo service apache2 restart</code>


===== III. MySQL =====
  - **:!: Unbedingt anlegen:** MySQL Anpassung für Connector 4VX
    * Folgende Datei anlegen ''/etc/mysql/conf.d/ft_lower.cnf'':<file>
[mysqld]
lower_case_table_names=1
sql-mode="STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION"
</file>
  - Sie sollten nun den [[de:faq:mysql_optimieren|MySQL Server optimieren]].
  - Wenn Sie den [[de:installation:installation#connector_4vx|Connector 4VX]] nutzen möchten, müssen Sie die bind-address anpassen. 
    * Öffnen Sie dazu die Datei ''/etc/mysql/mysql.conf.d/mysqld.cnf '' und ändern Sie bitte den Eintrag <code>bind-address            = 0.0.0.0</code>
  - MySQL neu starten
    * <code>sudo service mysql restart</code>
  - **:!: Mögliches Problem bei einigen Linux Distributionen:** Dies betrifft z.B. openSUSE. {{page>de:faq:binary_logging&noheader}}
  - **:!: Backup:** <wrap center round important 60%>Sie sollten regelmäßig ein Backup der MySQL Datenbank durchführen.</wrap> Dies ist unter Ubuntu sehr einfach.
    * :!: [[de:faq:mysql_backup|Informationen zum Backup]]
    * Wenn Sie manuell ein Backup erstellen möchten, können Sie auch die grafische [[http://www.mysql.de/downloads/workbench/|Workbench]] nutzen. Im Bereich "Administration" finden Sie "Export/Import".
    * Sehr detailierte Information von Oracle (MySQL) für Systemadministratoren: [[http://dev.mysql.com/doc/refman/5.1/de/disaster-prevention.html|Datensicherung und Wiederherstellung]]
  -   - **Wenn Sie von Version 9 Updaten möchten:**
    * Migrieren Sie nun die Datenbank auf MySQL.
    * Dies muss von einem **Windows PC** aus erfolgen.
    * Bitte aktualisieren Sie davor untermStrich auf Version 9.3!
===== IV. Herunterladen =====
Die aktuelle Version der X2 für PHP7 finden Sie unter: [[https://webservices.untermstrich.com/update/]]

Entpacken Sie die ''ustrich.2_p7.zip'' nach ''/var/www/html/ustrich/''

Beachten Sie, dass die ustrich.2_p7.zip kein Verzeichnis ustrich beinhaltet. Entpacken Sie die Datei also am Besten bereits im Verzeichnis ''/var/www/html/ustrich''.

<code bash>
sudo unzip ustrich.2_p7.zip -d /var/www/html/ustrich/
</code>

===== V. Zugriffsrechte =====
Achten Sie darauf, dass "alle" lesenden Zugriff benötigen: ''sudo chmod -R a+r /var/www/html/ustrich''\\
Auf folgendes Verzeichnis wird auch Schreibzugriff benötigt:
''sudo chmod -R a+w /var/www/html/ustrich/writeable''\\

Als Besitzer der Dateien kann ''root'' bleiben. Sie müssen dann jedoch bei untermStrich X Updates diese als root auf der Konsole bestätigen:
<code bash>
sudo php /var/www/html/ustrich/update.php -u
</code>

Ansonsten können Sie auch den Besitzer ändern - Diese Konfiguration ist jedoch weniger sicher, allerdings sind Updates damit vollständig über die Weboberfläche durchführbar:
<code bash>
sudo chown -R www-data:www-data /var/www/html/ustrich/
</code>

===== VI. Installation von untermStrich X2 =====
  * :righty: Folgen Sie der [[de:installation:installation#i_neuinstallation_oder_update_ausfuehren|Installation von untermStrich X]]

Der untermStrich X2 Installer gibt Ihnen alle Befehle an, die Sie zum Konfigurieren benötigen. (a2enmod)

\\
\\
.
\\
\\