====== Installationsbeispiel für Ubuntu Linux 20.04 (Als Server) für untermStrich X3 ======

<wrap round important 60%>
Ab X3 13.3.3 PHP 7.1-7.4 oder neuer.
</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. |

\\

===== WICHTIG: Update von Ubuntu 14.04/16.04/18.04 auf 20.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 20.04 LTS.
  - LAMP Installieren: <code bash>sudo apt-get update
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
  VALIDATE PASSWORD COMPONENT can be used to test passwords
  ...
  Press y|Y for Yes, any other key for No: n
  Change the password for root ? ((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: ** 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 [[https://www.ioncube.com/loaders.php]]
      * <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.4/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.4.so</code> Die Versionsnummer in der Loader Datei (ioncube_loader_lin_**7.4**.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>
<wrap center round info 80%>
Wenn Sie HTTPS einrichten und dafür einen eignen VHOST nutzen (etwa default-ssl.conf), müssen Sie diese Änderungen dann natürlich auch dort einfügen.
</wrap>

    * PHP
      * <code bash>sudo apt-get install php-xml php-ldap php-tidy php-mbstring php-zip php7.4-gd php-curl</code>
      * Erstellen Sie die Datei ''/etc/php/7.4/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>

    * Zeitzone ändern
      * {{page>de:faq:ubuntu_timezone#aenderung&noheader}}
===== III. MySQL =====
  - :!: **Konfigurieren und optimieren** Sie nun den [[de:faq:mysql_optimieren|MySQL Server]].
    * Legen Sie die folgende Datei an ''/etc/mysql/conf.d/performance.cnf'':  
      * <code ini>
[mysqld]
</code>{{page>de:faq:mysql_optimieren8}}
  - 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>
  - **:!: 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]]

===== IV. Herunterladen =====
Die aktuelle Version der X3 für PHP7 finden Sie unter: [[https://webservices.untermstrich.com/update/]]

Entpacken Sie die ''ustrich.3_p71.zip'' nach ''/var/www/html/ustrich/''

Beachten Sie, dass die ustrich.3_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.3_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''

==== Zugriffsrechte für das Update ====

<WRAP group>
<WRAP half column>
Sie können den Besitzer ändern um Updates vollständig über die Weboberfläche durchführbar zu machen. Diese Konfiguration ist jedoch weniger sicher:
<code bash>
sudo chown -R www-data:www-data /var/www/html/ustrich/
</code>
</WRAP>
<WRAP half column>
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>

</WRAP>
</WRAP>

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

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

\\
\\
.
\\
\\