Vorbereitung¶

Benötigte Hardware:

• Computer mit frisch installiertem Ubuntu. Unter Ubuntu 18.04 reicht die Installationsvariante "Minimale Installation" (wurden bereits Änderungen am System vorgenommen, ist die Installation möglicherweise anzupassen)

• WLAN-Router

• mobiles Endgerät (Smartphone, Tablet etc.)

• USB-Bondrucker (muss das ESC/POS-Protokoll beherrschen, aber das ist i.d.R. immer der Fall bei Bondruckern)

Installation¶

Die Installation besteht aus folgenden Schritte:

1. Installation der richtigen Umgebung (Webserver, Datenbank, PHP mit den richtigen Extensions)

2. Installation der Webapplikation

3. Installation des Druckservers (Einbau als Service)

sudo apt-get install apache2 libapache2-mod-php php mariadb-server php-mysql php-gd php-curl php-zip php-xml openjdk-8-jre 

sudo service apache2 restart 

sudo mysqladmin -u root password 123 

sudo mysql -u root --password=123 

CREATE DATABASE ordersprinter DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci; 

GRANT ALL ON ordersprinter.* TO os@localhost IDENTIFIED BY "secret"; 

sudo apt-get install unzip 

sudo mv webapp/* /var/www/html/ 

sudo chown -R www-data:www-data /var/www/html 

sudo chmod 774 /var/www/html/php
sudo chmod 664 /var/www/html/php/config.php 

Installation der Webapplikation¶

Öffnet man den Webbrowser (z.B. Firefox, denn damit testet auch der OrderSprinter-Autor) und ruft die URL http://localhost auf, sollte man die Installationsseite sehen. Erscheint stattdessen die Ubuntu-Informationsseite, wird Inhalt aus dem Cache dargestellt. In diesem Fall hilft ein Reload der Webseite.

Im ersten Schritt muss man sich für die Sprache entscheiden. Zur Auswahl stehen Deutsch, Englisch und Spanisch. Die gewählte Sprache wird nicht nur für die Installation verwendet, sondern auch den Beispielbenutzern automatisch zugewiesen (kann aber später geändert werden).

Anschließend wird die Zeitzone abgefragt. Die Zeitzone ist wichtig, damit die Zeitangaben auf den Kassenbons später korrekt sind. Auf dieser Seite befinden sich auch wichtige Hinweise zum Datenschutz: Hat der Server eine Verbindung zum Internet, so erlaubt dies bestimmte Zusatzfunktionen (Email-Bestätigungen, Verwaltungs aus der Ferne per Spider-Komponente, semi-automatische Softwareupdates, Debugdatenversand usw.).

Wenn man mit den Datenschutzbedingungen einverstanden ist und die Zeitzonenauswahl vorgenommen hat, erscheint eine Eingabemaske für die Vorgabe wichtiger Parameter, die im Rahmen der Installation eingetragen werden.

Die Möglichkeit, diese grundsätzlichen Voreinstellungen bereits während der Installation vorgeben zu können, sollen die Ersteinrichtung erleichtern. Die Werte lassen sich aber jederzeit später im laufenden Betrieb ändern.

Danach erreicht man die wichtigste Einstellungsseite:

Im Bereich Datenbank sind die Einstellungen für Datenbank-Name, -Benutzer und -Passwort vorzunehmen, die im vorangegangenen Abschnitt beim Anlegen der Datenbank festgelegt wurden (ordersprinter, os, secret). Ein Tabellenpräfix kann frei gewählt werden. Das Präfix ist nur dann interessant, wenn mehrere Applikationen die gleiche Datenbank verwenden sollen. Das ist für die Installation in kommerziellen Webpaketen interessant. In einem selbst verwalteten Ubuntu-System kann man sich beliebig viele Datenbanken anlegen, so dass die Einstellung hier irrelevant ist. Drückt man nun den Button Teste DB-Zugriff, sollte eine mögliche Fehlermeldung durch ein OK ersetzt werden.

Wurden die Schreibrechte richtig gesetzt, so wird auch dies angezeigt.

Fehlen php-Erweiterungen, so würden die fehlenden Erweiterungen hier angezeigt.

Bevor die Installation startet, muss man ein Administrator-Passwort festlegen.

Die Installation startet, wenn man den Button Starte Installation anklickt. Dabei werden die Tabellen in der Datenbank angelegt, gewisse Voreinstellungen vorgenommen und die Konfigurationsdatei config.php, die die Zugangsparameter für die Datenbank enthält, beschrieben. Dieser Vorgang kann einige Sekunden in Anspruch nehmen.

Anschließend muss man sich für einen Arbeitsablauf entscheiden:

• Digital: Verzicht auf Arbeitsbons. Bestellungen werden in einer Küchen- und Baransicht aufgeführt.

• Arbeitsbons: Bestellungen werden auf Arbeitsbons ausgedruckt (klassischer Ablauf in Gastronomiebetrieben)

• Arbeitsbons und Digital: Der Kellner kann sich bei der Bestellaufnahme entscheiden, welchen Arbeitsablauf er für die jeweilige Bestellung wünscht.

Hat man noch keine Erfahrung mit der Software gemacht, bietet sich die letzte Einstellung an, da man alle Optionen austesten kann.

In einem abschließenden Schritt kann man auswählen, ob neben einem obligatorisch angelegten Admin-Benutzer weitere Benutzer, eine Beispielspeisekarte und ein Musterraumplan angelegt werden sollen. Auch hier sollte man zum Einstieg die letzte Option wählen, denn Löschen und Überschreiben von Einstellungen sind jederzeit möglich.

Hat man sich entschieden, neben dem Admin weitere Benutzer anzulegen, bekommen diese Benutzer ebenso das im vorangegangenen Schritt eingegebene Passwort zugewiesen.

Wurde zu Beginn des Installationsswizards der Restaurantmodus abgewählt, so werden zwar intern weiterhin Beispielräume und -tische angelegt, das hat aber keine Auswirkung, da in diesem Fall die Tischauswahl bei Bestellungen übersprungen wird.

Die Installation ist abgeschlossen, wenn folgende Meldung erscheint:

Bestätigt man diese Meldung, so wird man zur Anmelde-Seite weitergeleitet.

In einem produktiven System sollte man das Unterverzeichnis install löschen. Macht man das nicht, so können alle Leute, die Zugriff auf den Webserver besitzen, die Zugangsdaten zur Datenbank auslesen (mit allen Konsequenzen) oder gleich durch eine Neuinstallation alle Daten löschen!

Grundlegende Konfiguration¶

In der Grundkonfiguration müssen Basisdaten festgelegt werden, damit der Druckserver z.B. später die Druckjobs abrufen darf. Dazu wählt man den admin als Benutzer aus, gibt das während der Installation gewählte Passwort ein und drückt beherzt auf den Anmelden-Button:

Die erste Seite zeigt beim Erstmaligen Anmelden eines Benutzers stets die persönlichen Einstellungen an, so dass man hier die Möglichkeit hat, die Sprache gegebenenfalls zu ändern. Als Admin wählt man über das Hauptmenü nun die Ansicht Verwaltung aus.

Dort befinden sich viele aufklappbare Bereiche. Wenn nicht bereits während der Installation geschehen, muss im Panel Konfiguration muss ein Printcode zugewiesen werden. Dieser dient später dazu, dass sich der Druckservice mit der Webapplikation über eine REST-Schnittstelle die Printjobs abholen darf. Als Beispiel sei hier der Printcode 123 eingegeben (dieser ist auch in der Konfigurationsdatei des Java-Printservers voreingestellt). Am Ende des Panels befindet sich ein Ändern-Button, nach dessen Anklicken die Einstellung übernommen wird.

Im Konfigurationsbereich können noch viele andere Einstellungen vorgenommen werden, die wichtigsten Einstellungen wurden bereits zu Beginn der Installation abgefragt.

Neben den während der Installation angelegten Beispielbenutzern können im aufklappbaren Bereich Benutzer weitere Benutzer angelegt werden. Beim Anlegen kann man festlegen, welche Rechte der Benutzer haben soll. In den benutzerspezifischen Einstellungen kann jeder Benutzer das ihm zugewiesene Passwort ändern sowie weitere Präferenzen einstellen.

Im Bereich Datenbank kann man den Beispielraumplan überschreiben und ein oder mehrere Räume mit Tischen anlegen. Wird nur ein Raum angelegt, so wird später bei der Bestellaufnahme und in der Kassenansicht die Raumauswahl übersprungen.

Physikalisches Setup¶

Wenn man das Gastbestellsystem im Internet aufsetzen möchte, sollte man die Möglichkeit nutzen, über eine Tischlosung und dem Tisch-spezifischen Code zu prüfen, ob der Gast tatsächlich am Platz sitzt:

• Tischlosung: dabei handelt es sich um ein Passwort, welches für alle Bestellungen eingegeben werden muss. Diese Tischlosung kann man beispielsweise der Speisekarte beilegen oder auf einer gut sichtbaren Wandtafel veröffentlichen. Sollten Gäste die Tischcodes kopiert haben, um aus Spaß von zuhause aus zu bestellen, so lässt sich das schnell durch Ändern der Tischlosung unterbinden. Die Tischlosung lässt sich in die Kellneransicht einblenden.

• Tischcodes: Jeden Tisch sollte man gut sichtbar mit der Tischnummer und einem Code versehen. Bei entsprechender Konfiguration müssen Gäste vor einer Bestellung den Tisch und dessen Tischcode angeben.

Soll das Gastbestellsystem stattdessen als lokale Webapplikation installiert werden, so kann man möglicherweise auf die Tageslosung oder die Tischcodes verzichten. Trotzdem muss die Tischnummer für den Gast klar erkennbar sein, denn den Tisch muss er selbst auswählen.

Bei einem lokalen Aufsetzen ist es ratsam, die Netze für das Kern- und das Gastbestellsystem weitestgehend zu trennen, indem man das Gastbestellsystem in einer sogenannten DMZ (Demilitarisierte Zone) einrichtet. Ein mögliches Setup ist das Folgende:

• ein Router bedient das Gastbestellsystem und bietet ein WLAN für die Gäste und erlaubt auch den Zugriff auf das Internet. Der Server des Gastbestellsystems verbindet sich mit diesem Router (oder kann bei entsprechenden Geräten, z.B. mit OpenWrt, direkt auf dem Router untergebracht werden).

• ein weiterer Router für das Kernsystem ist dem nachgeschaltet, d.h. man legt eine Leitung vom Gastbestellrouter zur WAN-Buchse dieses Routers. Zur besseren Trennung sollte man die IP-Adressräume der beiden Netze unterschiedlich machen. Bei einer FritzBox muss man angeben, dass man unter Internetanbieter eintragen vorhandener Zugang über LAN.

Wenn keine weiteren Einstellungen vorgenommen werden, können bei diesem Setup die Geräte, die über den Kernsystemrouter angebunden sind, auf die Geräte im Gastsystem zugreifen, aber andersherum ist keine Verbindung möglich - zumindest in der Standardkonfiguration der meisten Router.

Installation¶

Das Gastbestellsystem ist eine Webapplikation, d.h. sie benötigt ebenso wie das Kernsystem einen Webserver mit PHP sowie eine MySQL-kompatible Datenbank. Anpassungen an der php.ini sind nicht erforderlich, da die Ansprüche an die Webumgebung nicht so groß sind. Nach dem Entpacken des OrderSprinter-Downloads befindet sich die Gastbestellkomponente im Unterverzeichnis gastsystem. Diese muss in das Dokumentenverzeichnis des Webservers kopiert werden.

Wenn das Gastbestellsystem lokal aufgesetzt werden soll, muss im nächsten Schritt muss eine Datenbank angelegt werden. Das lässt sich analog zum Vorgehen für das Kernsystem so erledigen (es sollte aber ein anderes Passwort als "secret" benutzt werden):

CREATE DATABASE gastdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
GRANT ALL ON gastdb.* TO gast@localhost IDENTIFIED BY "secret"; 

Im Unterverzeichnis php befindet sich eine Datei config.php. Darin sind ein Installationscode (CODE) sowie die Verbindungsparameter zur Datenbank eingetragen. Die Verbindungsparameter muss man entsprechend der soeben angelegten Datenbank anpassen:

defined('MYSQL_HOST') || define ( 'MYSQL_HOST','localhost' );
defined('MYSQL_USER') || define ( 'MYSQL_USER',  'gast' );
defined('MYSQL_PASSWORD') || define ( 'MYSQL_PASSWORD',  'secret' );
defined('MYSQL_DB') || define ( 'MYSQL_DB', 'gastdb' ); 

Der voreingestellte CODE sollte auf jeden Fall abgeändert werden, da er zwei Funktionen erfüllt:

• Berechtigung zum Installieren der Gastbestellapplikation

• Zugriff des Kernsystems auf den Gastbestellserver

Zur Ersteinrichtung ist nun die Installationsseite des Gastbestellsystems im Webbrowser aufzurufen: http:\\{URL des Gastbestellsystems}\install.php. Im daraufhin erscheinenden Formular muss der CODE im Feld "Installationscode" eingetragen werden. Mit einem Klick auf "Installation starten" werden die Datenbanktabellen für das Gastbestellsystem vorbereitet.

Noch ist jedoch keine Kommunikation zwischen Kern- und Gastbestellsystem eingerichtet, so dass eine große Warnung eingeblendet wird:

Dieser Warnhinweis wird auch eingeblendet, wenn im Kernsystem kein Benutzer angemeldet ist. In diesem Fall ist wohl davon auszugehen, dass das Restaurant derzeit geschlossen ist oder aus anderen Gründen niemand Bestellungen bearbeiten würde. Eine Gastbestellung würde zu einem solchen Zeitpunkt keinen Sinn ergeben.

In der Konfiguration des Kernsystems muss im Abschnitt "Einstellungen für das Gastbestellsystem" die Verbindung zum Gastbestellsystem eingetragen werden:

• Webserver-Gastsystem: die Webadresse des Gastbestellsystems

• Zugriffscode: der CODE aus der config.php des Gastbestellsystems

• Tageslosung: das Passwort für alle Bestellungen

• Gastbestelljob drucken: steht dies auf "Ja", so werden die Bestellungen als Arbeitsbons gedruckt, anderenfalls landen die Bestellungen je nach Artikeltyp in der Küchen- und Baransicht

• Abfrage Tageslosung: soll der Gast die Tageslosung vor einer Bestellung eintragen müssen

• Abfrage Tischcode: soll der Gast den Tischcode vor einer Bestellung eintragen müssen

• Tageslosung in Bestellansicht anzeigen: die Tageslosung kann in der Bestellansicht des Kellners angezeigt werden

• Timeout: nach diesem Timeout wird in der Gastbestellansicht wieder auf die Startseite gewechselt

In der Verwaltungsansicht muss man nun einstellen, für welche Tische Gastbestellungen möglich sein sollen (Spalte "Gastbestellung") und wie deren Tischcode (Feld "Code") heißen soll. Zudem kann man Tischen in der Gastbestellkomponente einen anderen Namen als in der Bestellansicht für die Kellner zuweisen ("Tischname extern"). Nach den Änderungen darf nicht der Klick auf den "Anwenden"-Button vergessen werden!

In der Angebotsansicht lässt sich für jedes Produkt explizit einstellen, ob es ausschließlich von den Kellnern, von den Gästen, oder von allen Parteien bestellbar sein darf:

Wenn Produkten Bilder zugeordnet wurden, so werden diese bei einer Bestellung durch den Gast angezeigt. Wenn Gäste die Webseite der Gastbestellkomponente aufrufen, können sie die Produkte nun auswählen und als Bestellauftrag abgeben. In regelmäßigen Abständen schickt das Kernsystem die aktuelle Speisekarte und den Raumplan an das Gastbestellsystem und holt die von den Gästen abgegebenen Bestellungen ab. Extras können noch nicht von Gästen hinzugebucht werden.

Wenn das Gastbestellsystem erfogreich funktioniert, sollte man die Datei install.php löschen, damit Unbefugte die Applikation nicht durch Neuaufsetzen kaputtmachen können.

Anforderungen an ein Filialsystem¶

Gastronomische Betriebe ab einer gewissen Größe haben in der Regel lange Öffnungszeiten und laufen mit gutem Personal auch weiter, wenn man als Chef mal nicht vor Ort ist. Ebenso gibt es auch Gastronomen, die mehrere räumlich auseinanderliegende Restaurants betreiben. Es gibt jedenfalls viele Gründe, dass man als Eigentümer auch aus der Ferne einen Blick auf den laufenden Betrieb haben möchte und gegebenenfalls mit dem Personal vor Ort kommunizieren will, ohne den aktuellen Ablauf durch Telefonate zu einem ungünstigen Zeitpunkt zu unterbrechen.

Ein gutes Filialsystem sollte folgende Eigenschaften besitzen:

• es stellt in übersichtlicher Form die relevanten Informationen einer Kassenserverinstanz (z.B. die aktuellen Umsätze) dar, ist aber nicht mit unnützen Angaben überfrachtet (die aktuelle Tischbelegung interessiert aus der Ferne wohl kaum).

• es erlaubt die Übersendung von Nachrichten an das Personal vor Ort

• die Auswahl der Anzeige der verschiedenen zu überwachenden Kassenserverinstanzen muss über das Filialsystem so schnell und einfach möglich sein, dass der Anwender unterwegs einen Zugriff bekommt, ohne große Passwortlisten stets mitführen zu müssen. Die Zugriffseinstellungen sollten im Filialsystem hinterlegt werden können, so dass mit dem Anmelden im Filialsystem die Zugriffe auf die registrierten Instanzen möglich ist.

• es sollte so sicher aufgesetzt werden, dass Unbefugte keinen Zugriff auf die sensiblen Umsatzdaten bekommen

OrderSprinter Spider installieren¶

OrderSprinter enthält die Komponente Spider, die die oben aufgeführten Anforderungen erfüllt. Spider ist wie das Kernsystem und die Gastbestellkomponente als Webapplikation konzipiert. Wie bei der Gastbestellkomponente lässt sich Spider sowohl lokal als auch bei einem Internetprovider aufsetzen. In dieser Anleitung wird wieder davon ausgegangen, dass Spider auf einem dedizierten lokalen mit Ubuntu betriebenen Filialserver aufgesetzt werden soll.

Ähnlich wie bei der Kerninstanz und der Gastbestellsystemkomponente muss auf diesem Rechner also ein Apache mit PHP und eine Datenbank aufgesetzt werden. Die Anforderungen an die PHP-Konfiguration sind bei Spider nicht so groß, so dass die Standardkonfiguration in der php.ini beibehalten bleiben kann.

Gehen wir davon aus, dass die Datenbank mit folgenden Kommandos aufgesetzt wurde:

CREATE DATABASE spider DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
GRANT ALL ON spider.* TO spideruser@localhost IDENTIFIED BY "verysecret"; 

Im nächsten Schritt sollte nun der Inhalt des Unterverzeichnis spider des entpackten OrderSprinter-Downloads in das Dokumentenverzeichnis des Webservers kopiert werden:

sudo mv spider/* /var/www/html/ 

Im Unterverzeichnis php der Spider-Komponente befindet sich eine Datei config.php. Diese muss vom Webserver beschreibbar sein:

sudo chown -R www-data:www-data /var/www/html
sudo chmod 774 /var/www/html/php
sudo chmod 664 /var/www/html/php/config.php 

Im nächsten Schritt ruft man mit dem Webbrowser die Spider-Applikation auf (http://{URL_des_Webservers}). In der erscheinenden Eingabemaske müssen nun die Zugangsparameter für die Datenbank eingetragen werden:

Im letzten Feld der Maske (Zugangspasswort) sollte ein möglichst sicheres Passwort eingetragen werden. Nach einem Klick auf den Button Installation starten werden die Datenbanktabellen angelegt. War die Installation erfolgreich, so erscheint nun das Anmeldefenster:

Jetzt sollte man das Verzeichnis install löschen! Nach Eingabe des Zugangspassworts, welches bei der Installation angegeben werden musste, in die Anmeldemaske kann man sich einloggen. Da noch keine Instanzen eingetragen wurde, ist die Übersicht ziemlich leer:

Die Instanzen, die über Spider gemanaged werden sollen, sollten aus Sicherheitsgründen niemals direkt im Internet ansprechbar sein, sondern Spider sollte die Verbindung über ein VPN herstellen. Wurde Spider bei einem typischen Webprovider aufgesetzt, besteht diese Möglichkeit selten, so dass man sich alternativ damit behelfen kann, dass auch die Kerninstanzen zwar über das Internet angebunden werden, aber per Basic Authentication und https gesichert sind. Zu beiden Themen VPN und Basic Authentication gibt es bei Ubunutusers eigene Artikel, auf die an dieser Stelle verwiesen wird.

Um eine Kerninstanz einzutragen, muss bei dieser ein Fernzugangscode eingetragen worden sein.

Dieser Fernzugangscode muss bei der Registrierung einer Kerninstanz in Spider angegeben werden:

Hat man mehrere Betriebe registriert, so erscheinen diese in der Übersicht:

Verhält sich Spider sehr träge oder scheint die Webapplikation öfters über mehrere Sekunden eingefroren zu sein, so ist wahrscheinlich die Netzwerkverbindung zwischen dem Spider-Server und mindestens einer der registrierten Kerninstanzen gestört.

In der Detailansicht kann man sich die Einnahmen einer ausgewählten Kerninstanz über den Tag verteit anzeigen lassen und Mitteilungen an das Personal der Instanz versenden. Eine Login-Nachricht erhalten die Anwender beim Einloggen in ihr Kassensystem. Eine Kellner-Nachricht wird in die Bestell- oder Kellneransicht der Instanz eingeblendet. Die Nachrichten lassen sich nur über die Spider-Applikation wieder löschen.

Nicht vorhandenene PHP-Erweiterungen¶

Um alle Funktionen der Software nutzen zu können, muss PHP mit folgenden Extensions installiert sein:

• gd

• mysqli

• pdo_mysql

• PDO

• session

• zlib

• curl

• zip

• ftp

• xml

Eine Installation kann auch ohne alle diese Erweiterungen durchgeführt werden, jedoch können viele Funktionen dann zu Fehlern führen. Über den Aufruf http://localhost/install/phpinfo.php kann man sich die PHP-Konfiguration ausgeben lassen, wenn man das Install-Verzeichnis noch nicht gelöscht hat.

Überschreitung des Zeitlimits auf langsamen Servern¶

In der Datei php.ini (deren Speicherort man ebenso über einen Aufruf von http://localhost/install/phpinfo.php ermitteln kann, sind gewisse Vorgaben für die maximal erlaubte Ausführungszeit eines PHP-Skripts enthalten, die für die meisten Systemen passen. Ist der Rechner jedoch sehr langsam, ist eine Erhöhung der max_execution_time ratsam.

Zuweisung des Memory-Limits¶

Wenn nach ausgiebigem Test bestimmte Funktionen nicht mehr funktionieren (Backup, Restore, PDF-Reports), kann es sein, dass die Datenmenge so groß geworden ist, dass der für PHP zugewiesene Speicher nicht ausreicht. In diesem Fall sollte der Wert memory_limit in der php.ini vergrößert werden.

Upload von Dateien funktioniert nicht¶

In der php.ini lässt sich einstellen, wie groß die maximale Größe einer hochladbaren Datei sein darf. Die zu ändernde Variable lautet max_post_size.