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)

• lokale TSE (zur Zeit werden nur TSE der Firma Swissbit unterstützt)

Installationswege¶

Seit Version 2.0.4 gibt es verschiedene Wege, OrderSprinter auf einem Ubuntu-System aufzusetzen:

1. Verwendung eines Installationsskripts

2. Manuelle Installation

Mit Version 2.0.4 ist im entpackten OrderSprinter-Download ein Installationsskript im Unterverzeichnis /scripts enthalten, mit dem auf einem Ubuntu oder einem Linux Mint (jeweils mit Version 20 getestet) die Kernapplikation und wahlweise zusätzlich ein Javaprinter und der TSEConnector installiert werden können. Außerdem bietet das Skript die Möglichkeit, die Instanz mit Beispieldaten (Raumplan, Benutzer, Speisekarte) zu füllen sowie einen Cron-Job zu installieren, der jede Nacht um 4 Uhr ein Backup auf einen angeschlossenen USB-Stick vornimmt.

Da das Installationsskript viele Änderungen am System vornimmt, bietet sich die Nutzung vor allem auf einem frisch aufgesetzten System an, bei dem noch keine vorher existierende Konfiguration durch das Skript beschädigt werden kann. Hat man jedoch bereits schützenswerte Konfigurationen (Apache-, PHP-, Datenbankkonfiguration) sowie Daten (Datenbank, Webservercontent), so sollte man stattdessen den manuelle Installationsweg wählen und gegebenenfalls Schritte auslassen oder abändern, damit sie zur bereits eingerichteten Systemumgebung passen. Außerdem geht das Installationsskript davon aus, dass das Ubuntu-System gemäß Standard ohne Umkonfigurationen (z.B. Pfaden zum html-Content und zur php.ini) vorliegt. Ist das nicht der Fall, muss entweder das Skript angepasst werden oder eben der manuelle Installationsweg beschritten werden. Der manuelle Installationsweg bietet auf jeden viele Freiheitsgrade.

In diesem Beitrag werden aus diesem Grund beide Wege gezeigt.

Installationsskript¶

Das Installationsskript ubuntuinstaller.sh befindet sich im scripts-Unterverzeichnis. Es geht von einem frisch installierten Ubuntu-System in der Installationsvariante Minimal aus und muss mit root-Rechten gestartet werden:

cd {scripts-Verzeichnis}
sudo ./ubuntuinstaller.sh 

Das Skript fragt den Nutzer nun nach dem Umfang der Installation:

1. Soll in die Kernapplikation auch ein Set von Beispieldaten eingespielt werden?

2. Installation des Javaprinters? Wird dies mit j bestätigt, so wird ein Service javaprinter aufgesetzt, der den ersten am USB-Port erkannten Bondrucker zum Ausdruck aller Bontypen benutzt. Da viele Bondrucker intern über ein USB-Interface angeschlossen sind, werden sie oft nicht als Drucker erkannt. In solchen Fällen muss dann später in der Datei /usr/local/bin/javaprinter/config.json die VendorID und ProductID des angeschlossenen Druckers manuell eingesetzt werden (die Parameter findet man über das Kommando lsusb).

3. Installation des TSEConnectors? Bestätigt der Anwender dies, so wird der TSEConnector als Service eingerichtet. Allerdings arbeitet der TSEConnector zunächst im Simulationsmodus, der jedoch in der Datei /usr/local/bin/tseconnector.bat auf den Modus normal umgestellt werden kann. Wird der TSEConnector installiert, so wird die Kernkomponente so konfiguriert, dass alle Bestellungen und Belege über den TSEConnector/TSE signiert werden.

4. Konfiguration eines Cronjobs zur nächtlichen Sicherung der Datenbank: Ein Cronjob kann jede Nacht testen, ob ein USB-Stick angeschlossen ist. In diesem Fall wird dieser eingebunden (mount), ein Backup der Datenbank darauf gespeichert (jeweils die letzten drei werden auf dem Speichermedium vorgehalten) und der Stick wieder ausgehängt (unmount).

Der Ubuntuinstaller kann auch direkt von der OrderSprinter-Webseite geladen werden. Der Benutzer wird beim Start des Skripts gefragt, ob es die aktuelle Version der OrderSprinter-Suite downloaden soll, oder ob das Skript bereits aus einem Download der Gesamtsuite gestartet wurde.

Es gibt ein Youtube-Video, welches die Verwendung des Installationsskriptes zeigt: https://www.youtube.com/watch?v=mHDiaCaxeDs

Wurde das Skript unverändert ausgeführt, so haben alle eingerichteten OrderSprinter-Benutzer anschließend das Passwort 123, ebenso wird der Printcode (Zugang des Druckservers) und der Fernzugriffscode (Zugriff über REST) auf 123 gesetzt. Diese und weitere Zugangsdaten (z.B. Datenbankzugang) können durch Anpassungen der entsprechend ausgezeichneten Zeilen am Anfang des Skript angepasst werden.

Die Installation durch das Skript umfasst die Schritte der manuellen Installation inklusive der Schritte der Ersteinrichtung, der Druckerserverinstallation und der TSEConnectorinstallation.

Manuelle Installation¶

In den folgenden Abschnitten wird die manuelle Installation beschrieben. Zusätzlich wird auf die Installation der Filialkomponente Spider sowie der Gastbestellkomponente eingegangen, die nicht im Rahmen des Installationsskriptes installiert werden, weil sie nicht auf dem Webserver der Kernapplikation laufen sollten.

apt-get update
apt-get upgrade 

sudo apt-get install apache2 libapache2-mod-php php mariadb-server php-mysql php-gd php-curl php-zip php-xml default-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 -R u+w /var/www/html 

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 können.

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. Werden die im Rahmen des DSFinv-k Exports als Stammdaten betrachteten Felder nicht ausgefüllt, wird der Benutzer später beim Betreten der Administrationsansicht an deren Nachtragung erinnert.

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 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). Für die Nutzung in Deutschland ist es seit 1.1.2020 vorgeschrieben, dass Kassenbons gedruckt werden, so dass man dies durch eine Konfigurationsänderung erzwingen kann. 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 den 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 (wenn so so konfiguriert wurde). 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: Jedem Tisch kann man einen Code in der Administrationsansicht zuweisen, der bei einer Gastbestellung (optional) angegeben werden muss. Entweder beschriftet man dazu jeden Tisch gut sichtbar mit der Tischnummer und dem Code oder nutzt die Möglichkeit, QRCodes oder NFC-Tags auf die Tische aufzukleben, die sowohl Tischnummer als auch Tischcode enthalten und den Gast nach dem Scannen direkt zur Bestellseite des richtigen Tisches weiterleiten. OrderSprinter erlaubt es, allen Tischen mit einem Klick zufällig generierte Tischcodes zuzuweisen und einen Ausdruck mit allen QRCode zu erstellen.

Soll das Gastbestellsystem stattdessen als lokale Webapplikation installiert werden, so kann man möglicherweise auf die Tageslosung oder die Tischcodes verzichten.

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. Wenn der Webserver auf Dateien um htdocs/db-Verzeichnis schreibend zugreifen darf, kann man sich die Schritte zum Einrichten einer Datenbank für das Gastbestellsystem schenken. Ansonsten wird eine MySQL-kompatible Datenbank benötigt. 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 eine Datenbank angelegt werden, wenn ein Schreibzugriff auf das Unterverzeichnis db nicht möglich oder nicht erwünscht ist. 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. Hat man sich entschieden, die Datenbank zu verwenden, muss man die Verbindungsparameter 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 (wenn die Gastbestellkomponente die Datenbank nutzen soll)

• Zugriff des Kernsystems auf den Gastbestellserver

Nutzt man die Datenbank, so muss zur Ersteinrichtung nun die Installationsseite des Gastbestellsystems im Webbrowser aufgerufen werden: 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 Administrationsansicht 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 Administrationsansicht gibt es das aufklappbare Panel Anbindung Gastbestellsystem, in dem man Funktionen findet, um allen Tischen einen zufällig generierten Tischcode zuzuweisen, und eine Funktion, um alle QRCodes für die Tische anzuzeigen (diese kann man ausdrucken, ausschneiden und damit die Tische bekleben).

In der Artikelansicht 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 erfolgreich 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.