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

^ **:!: 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 80%>ACHTUNG: Nur für **X2 12.10 PHP 7.1** und neuer</wrap> ^
| :!: Beachten Sie die: [[de:x2|Wichtigen Informationen zu X2]] |

\\

===== WICHTIG: Update von Ubuntu 12.04/14.04/16.04 auf 18.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 18.04 LTS.
  - LAMP Installieren: <code bash>sudo apt-get update
sudo dpkg-reconfigure tzdata
sudo apt-get install tasksel
sudo tasksel install lamp-server
sudo mysql -u root
  mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'ustrich';
  mysql> quit
sudo mysql_secure_installation
  Press y|Y for Yes, any other key for No: n
  ...
  Remove anonymous users? (Press y|Y for Yes, any other key for No) : y
  Disallow root login remotely? (Press y|Y for Yes, any other key for No) : y
  Remove test database and access to it? (Press y|Y for Yes, any other key for No) : y
  Reload privilege tables now? (Press y|Y for Yes, any other key for No) : y
</code>
    * **:!: ACHTUNG: ** Wenn Sie das VALIDATE PASSWORD plugin installieren wählen Sie LOW als Level aus! 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 openjdk-11-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.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>
 
    * 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-ldap php-tidy php-mbstring php-zip php7.2-gd</code>
      * Erstellen Sie die Datei ''/etc/php/7.2/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 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_p71.zip'' nach ''/var/www/html/ustrich/''

Beachten Sie, dass die ustrich.2_p71.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_p71.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)

\\
\\
.
\\
\\