ordersprinter/scripts/Liesmich.txt

Hinweise zum Inhalt dieses Verzeichnisses:

Es befinden sich in diesem Verzeichnis zwei Skripte:
    1. Installer für Ubuntu
    2. backup-Skript für Linux-Systeme

Backup-Skript:
==============

Mit dem Backup-Skript "backup-db-linux.sh" ist es möglich, auf einem Linux-System 

- ein Backup der Datenbank
- das Kassenbuch (PDF-Zusammenfassung) vom Zeitraum des aktuellen Jahres

auf einem USB-Stick anzulegen. Der USB-Stick wird vor dem Backup eingehängt,
und nachher wieder ausgehängt, so dass er anschließend vom Gerät abgezogen werden kann.

Das Skript kann beispielsweise auf einem Raspberry Pi oder anderen Linux-System eingesetzt
werden.

Das Ein- und Aushängen erfordert eigentlich Root-Berechtigungen. Entweder lässt man das Skript
als Root laufen, oder nutzt Möglichkeiten des setuid (wird hier nicht beschrieben).

Es werden immer die letzten maximal drei Backups gespeichert bzw. aufbewahrt.

Im Skript müssen am Anfang einige Variablen angepasst werden:
- der Gerätenamen des Sticks
- die Zugangsparameter der Datenbank (lassen sich aus der config.php) entnehmen, wenn nicht mehr bekannt. Die Angabe ist nur erforderlich, wenn mysqldump statt das OrderSprinter-internen Backup verwendet werden soll.
- die Server-Baseadresse
- der Remoteaccess-Code, wie er zuvor in der Administrationsansicht eingestellt werden muss
- das Format json oder zip: Wurde in der OrderSprinter-Konfiguration ein tmp-Verzeichnis festgelegt, so werden komprimierte Backups erzeugt (zip), anderenfalls ist json einzutragen.

Im Skript ist standardmäßig die OrderSprinter-interne Backuperstellung aktiviert (Zeile, die mit "wget" beginnt). Alternativ kann auch das MySQL-Dump verwendet werden, dazu ist die mit wget
beginnende Zeile einzukommentieren und die Kommentierung der Zeile, die mit "mysqldump" beginnt, zu entfernen.

Es wird empfohlen, die Ausführung des Skripts über einen cron-Job regelmäßig und automatisisiert
zu starten:

Um z.B. jeden Morgen um 4 Uhr eine Datensicherung zu starten, legt man den Cronjob wie folgt an:

In der Datei /etc/crontab ans Ende folgenden Eintrag und anschließend eine Zeile freilassen:

0 4  * * * root /usr/local/bin/backup-db-linux.sh > /dev/null 2>&1

Ubuntu-Installer:
=================
Der Ubuntu-Installer installiert OrderSprinter auf einem Ubuntu-System. Dabei kann der Benutzer wählen, ob er neben der Kernapplikation auch Beispieldaten (Raumplan, Benutzer, Speisekarte),
den Java-Printserver und den TSEConnector zum Anbinden einer lokalen TSE installieren möchte. Zusätzlich erlaubt das Skript die Konfiguration eines nächtlichen Backups auf einen 
angeschlossenen USB-Stick.

Da der Installer viele Einstellungen am System vornimmt, kann es eine bestehende Konfigurationen überschreiben bzw. es kann auch zu Datenverlust kommen. Die Ausführung dieses Skripts wird
also auf einem System ohne schützenswerte Bestandsdaten empfohlen.

Siehe die Kommentare am Anfang der Skript-Datei