Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Sollten Sie sich für die Bare Metal Lösung entschieden haben finden Sie hier alle wichtigen Informationen zur Installation der notwendigen Komponenten für Troi unter Ubuntu. Der Betrieb der Troi Software auf eigener Infrastruktur benötigt grundlegende Linux Kenntnisse, insbesondere im Umgang mit der Konsole.

...

Die Bare Metal Variante setzt Ubuntu 18.04 Headless LTS als Basissystem voraus. Troi läuft in der Theorie auch unter anderen *Nix Systemen, aber nur Ubuntu wird offiziell als Bare Metal System unterstützt.

Step-By-Step

Sicherstellen das Ubuntu auf dem aktuellen Stand ist

Der eingesetzte Ubuntu Server sollte auf dem aktuellen Stand sein:

...

Hardware

  • OS: Linux (Bevorzugt Ubuntu 18.04 LTS Headless)
  • Prozessor: mind. 2 VCPU's 2,4 GHz
  • RAM: mind. 4 GB RAM

  • HD: mind. 25 GB (empfohlen 2 HDs im Raid1-Verbund)

Step-By-Step

Sicherstellen das Ubuntu auf dem aktuellen Stand ist

Der eingesetzte Ubuntu Server sollte auf dem aktuellen Stand sein:

Code Block
languagebash
sudo apt update
sudo apt dist-upgrade

...

Code Block
languagebash
sudo apt install openjdk-8-jre-headless nginx-light php7.2-fpm php7.2-curl php7.2-gd php7.2-cli php7.2-mysql php7.2-mbstring php7.2-zip php7.2-sqlite3 php7.2-bcmath php7.2-xml php7.2-intl php-redis redis-server


Installation des Datenbankservers: Hier kann zwischen MySQL 5.7 oder MariaDB (mind. 10.3) gewählt werden. In unserem Beispiel hier setzen wir auf MySQL:

...

Der FOPServer kann über folgenden Link heruntergeladen werden: https://dist.troi.software/fopserver/fopserver-v2.36.0.tar.gz

Download und Installation per Shell:

Code Block
languagebash
cd /tmp
wget https://dist.troi.software/fopserver/fopserver-v2.6.30.tar.gz
mkdir -p /opt/troi /var/troi/fopserver/log
tar -C /opt/troi -xzf fopserver-v2.36.0.tar.gz
rm /tmp/fopserver-v2.36.0.tar.gz
chown -R www-data:www-data /var/troi /opt/troi

...

Code Block
/var/troi/fopserver/log/fopserver.log {
        rotate 12
        daily
        copytruncate
        missingok
        notifempty
        compress
        delaycompress
}

JobScheduler

Der FOPServer JobScheduler kann über folgenden Link heruntergeladen werden: https://dist.troi.software/jobscheduler/jobscheduler-linux.tar.gz

...

Code Block
[mysqld]
explicit_defaults_for_timestamp = Off
sql_mode =
innodb_strict_mode = 0


MariaDB ab Version 10.4 benötigt eine zusätzliche Änderung, um die Performance unter Troi zu verbessern:

...

Info
titlePerformance Probleme

Unter MariaDB 10.3 sollte der Parameter `join_buffer_size` nicht angepasst werden, da dieser die Performance stark beeinträchtigen kann.

...

Es empfiehlt sich, die Konfiguration in eine eigene Konfigurationsdatei abzulegen (z.B. /etc/php/7.2/fpm/pool.d/nginx/sites-available/troi.conf) um Änderungen bei Systemupdates vorzubeugen.

...

Die Troi Datenbank wird als MySQL Datenbankdump per GZIP Komprimiert Archive ausgeliefert. Der Import erfolgt wird wie folgt durchgeführt:

Code Block
zcat troi.sql.gz | mysql -u troi -p troi_live --default-character-set=utf8

...

Info
titleMySQL Import Fehler

Eventuell tritt ein Fehler beim Import auf: ERROR 1227 (42000) at line *: Access denied; you need (at least one of) the SUPER privilege(s) for this operation

Dieser kann ignoriert werden.

Applikation

Die Software selbst wird in das zuvor in Nginx festgelegte übergeordnete Webverzeichnis gelegt, bedeutet bei unserem Beispiel also /var/www/troi. Vergessen Sie bitte nicht die Rechte der Dateien / Ordner anzupassen.

Folgende Konfiguration muss angepasst werden:


Datenbank- / Cacheeinstellungen:


Code Block
.env

Sicherung

In einem Produktivbetrieb ist die Datensicherung von größter Bedeutung. Folgende Punkte gibt es bei der Sicherung zu beachten:

  • Sicherung der Datenbank
  • Sicherung der Konfiguration (troi/config)
  • Sicherung der Dateianhänge (troi/storage)