Installation

Aus Letto-Wiki
Zur Navigation springen Zur Suche springen

Allgemeines

Der Letto-Server wurde in Java für JavaEE [1] Server entwickelt. Prinzipiell sollte Letto auf jedem JavaEE-Server unter Windows oder Linux lauffähig sein. Wir haben jedoch als Serverumgebung nur Ubuntu-Server mit TomEE getestet und empfehlen deshalb auch diese Laufzeitumgebung.

Als Datenbank wird eine MySQL-Datenbank verwendet, welche idealerweise am gleichen Server wie der TomEE läuft. Es ist jedoch auch mögliche einen zentralen MySQL-Server zu verwenden welcher im LAN zur Verfügung steht.

siehe auch

Installation des Ubuntu Servers

Installation auf einem Ubuntu-Server mit Docker-Containern

  • Installation von Ubuntu 20.04 oder 22.04 Server ohne apache webserver (Port 80 und 443 müssen frei sein!)
  • Einrichten der Namensauflösung dass der Server aus dem Internet über seinen Namen erreichbar ist
  • Download des Installationsscripts von http://letto.at/download/letto/install-letto-ubuntu-docker.sh
wget http://letto.at/download/letto/install-letto-ubuntu-docker.sh
  • start des Installationsscripts als root
bash ./install-letto-ubuntu-docker.sh
  • Nach der Installation ist das Setup-Service über einen Browser auf dem https-Port 9096 erreichbar.
  • Alle weiteren Konfigurationen erfolgen dann im Setup-Service
    • Beim ersten Start muss eine allgemeine Information des Servers für den Lizenzserver und die Passwörter für den MySQL-Server angegeben werden.
    • Dann kann die Schule angelegt werden. Es wird dabei vom Lizenzserver eine beschränkte Demolizenz angefordert. Das Schulkürzel welches bei der Einrichtung agegeben wird erscheint immer als Kennung der Schule am Server (auch in der URL) und kann später nicht mehr geändert werden!
    • Nach der Installation der Schule bitte mit uns in Verbindung setzen, dass wir eine angepasste Demolizenz vergeben können.

Installation auf anderen Host-Systemen mit Docker-Containern

  • Prinzipiell ist natürlich jeder Server für die Docker-Installation von LeTTo verwendbar. Es existiert lediglich nur für Ubuntu ein fertiges Installationsscript für die Installation. Für andere Host-Betriebssysteme bitte ebenfalls das Installationsscript für Ubuntu herunterladen jedoch nicht direkt ausführen sondern an das Betriebssystem anpassen bzw. schrittweise angepasst die Installation händisch durchführen. Den Großteil der Installation übernimmt das Setup-Programm lettosetup.jar welches nach der Installation direkt am Host am https-Port 9096 läuft.
  • Unter Windows gibts es nur ein sehr experimentelles Basis-Script nachdem noch einige undokumentierte Anpassungen notwendig sind https://letto.at/download/letto/install-letto-windows-docker.bat

Installation mit dem Setup-Service

Installation unter Ubuntu

  • getestet für die LTS-Version 18.04, 20.04 und 22.04
  • VIDEO-Anleitung: Installation Fertigstellung
  • Download von Ubuntu Server [2]und Erzeugung eines Boot Mediums [3] (zB. DVD)
  • Installation mit einem Benutzer letto
  • Bei der Installation nur den OpenSSH Server mit installieren
  • Der Server sollte über eine funktionierende Namensauflösung aus dem Internet erreichbar sein.
  • Eine gegebenenfalls vor dem Server sitzende Firewall sollte ins Internet mindestens folgende Ports freischalten:
    • Eingehend TCP: 80(HTTP), 443(HTTPS)
    • Eingehend ICMP: echo(ping)
    • Ausgehend TCP: 80(HTTP), 443(HTTPS)
    • Ausgehend UDP: 53(DNS)
    • Ausgehend ICMP: echo(ping)
    • Und natürlich alle Antworten auf ausgehende Anfragen
    • Falls eine Authentifizierung über LDAP gewünscht wird muss natürlich der LDAP oder AD-Server mit den notwendigen Ports erreichbar sein.
  • falls der Server nicht auf aktuellem Stand ist, die Updates einspielen und den Server neu starten
  sudo apt-get -y update 
  sudo apt-get -y upgrade
  sudo apt-get -y dist-upgrade
  sudo apt-get -y autoremove
  sudo apt-get -y install -f
  sudo reboot
  • Konfiguration des Servers
    • Starten des Servers
    • Wechseln zu Benutzer root.
      sudo su
    • Wechsel in das Verzeichnis opt
      cd /opt
    • Download des Installationsscripts
      wget https://letto.at/download/letto/install-letto-ubuntu.sh
    • Script in einem Editor konfigurieren 
      nano install-letto-ubuntu.sh
      • Wenn gewünscht, setzen von DNS-Namen, Passwörtern, Email und Heap-Speicher. Notwendíge Einstellungen werden interaktiv abgefragt wenn sie nicht angegeben werden.
      • Mit <Strg>-O und Enter das Script speichern
      • Mit <Strg>-X den Editor verlassen
    • Setzen von Ausführungsrechten 
      chmod 755 install-letto-ubuntu.sh
    • Script starten 
      ./install-letto-ubuntu.sh
      Die Ausführung des Scripts wird je nach Server-Hardware zwischen 20 und 60 Minuten dauern, da die notwendige Installation von LaTeX und Inkscape relativ lange dauert. Falls das Script während der Ausführung abbricht sollte es (ggf. nach Behebung des Fehlers) einfach nochmals gestartet werden.
  • Zertifikat für den Server installieren:
    Bei der Standardeinstellung wurde noch das selbstsignierte Zertifikat vom Apache2 in der Datei /etc/apache2/sites-enabled/letto.conf eingebunden. Dieses Zertifikat kann nun durch ein eigenes gültiges Zertifikat für den Server-DNS-Namen ersetzt werden.
    Falls kein eigenes Zertifikat vorhanden ist, kann auch mit dem Certbot ein selbstzertifiziertes Zertifikat installiert werden. Hierzu kann wie folgt vorgegangen werden:
    • Starten des certbot als root-Benuter 
      certbot --apache -d meinedomain.at
      • Hierbei müssen einige Fragen wie email etc. beantwortet werden.
    • Eintragen des certbot in einen Cronjob wie zB. in der Datei /etc/crontab 
      05 05 * * * root certbot renew
  • Datensicherung einrichten:
    Die Datensicherung wird durch das Script so eingerichtet, das täglich in das Verzeichnis /sicherung gesichert wird. Diese Verzeichnis sollte nun auf eine externe Hardware regelmäßig mit einem sinnvollen Archivierungskonzept gesichert werden.
  • Konfiguration von LeTTo :
    Nun kann der Server über seine URL erreicht und konfiguriert werden.
  • globalen Administrator anlegen:
     :
    • Der Ping zum Lizenzserver muss OK sein damit der Server am Lizenzserver eingetragen werden kann
    • Die Webadresse muss die Adresse sein, mit welcher der Server vom Browser auch erreicht wird, da daran die Lizenz gebunden wird!
    • Der globale Administrator ist für die Administration des Servers zuständig. Für die Verwaltung der Klassen,Lehrer und Schüler gibt es einen getrennten Schuladministrator, welcher bei der Anlage der Schule erstellt wird.
    • Daten speichern und weiter ist nur möglich wenn der Lizenzserver erreichbar ist.
  • als globaler Administator eine Schule anlegen:
     :

     :
    Durch "Schule anlegen und Probelizenz anfordern" wird die Schule erzeugt und vom Lizenzserver eine Demolizenz geladen.
  • als Schuladministrator eine Abteilung anlegen:
     :

Installation unter Ubuntu 18.04

  • Wir empfehlen ausdrücklich die Installation unter Ubuntu 20.04. Das Installationsscript für 18.04 wird ab 2021 nicht mehr gewartet.
  • Download von Ubuntu Server [4] und Erzeugung eines Boot Mediums [5] (zB. DVD)
  • Die weitere Vorgehensweise ist gleich wie bei Ubuntu 20.04 nur sollte das Script install-letto-ubuntu.sh statt install-letto-ubuntu-20.04.sh verwendet werden 
    wget https://letto.at/download/letto/install-letto-ubuntu.sh

globale Konfiguration

Folgende Einstellungen sollte der globale Administrator vornehmen:

Lizenz-Key einspielen

  • Im Regelfall wird die Lizenz automatisch bei der Konfiguration als globaler Administrator als Demolizenz angelegt.
  • Bitte danach mit dem LeTTo-Team in Verbindung setzen damit wir die Demolizenz verlängern oder ein Angebot für eine Lizenz legen können.

Einspielen der Daten

Konfiguration der globalen Einstellungen

  • Im Dialog "Globale Konfiguration" müssen noch die Parameter für Server, AD-Login und Schule eingestellt werden.
  • Als globaler Administrator kann man mit dem Menüpunkt "AD-check" die Authentifikation an einem LDAP-Server oder an einem Active-Directory konfigurieren.

letzte wichtige Server-Konfigurationen

Folgende Konfigurationen sollten noch vorgenommmen werden, werden aber in diesem Wiki nicht explizit beschrieben, sondern sollten von einem Linux/Unix-Fachmann vorgenommen werden.

  • Letto beim Systemstart automatisch starten
  • Datensicherung einrichten
  • Firewall einrichten
  • Zertifikat für den Glassfish für https
  • Verlinkungen und Weiterleitungen auf den Server einrichten
Abgerufen von „https://wiki.letto.at/wiki/index.php?title=Installation&oldid=3164“