Folgende Schritte sind durchzuführen, damit dein eigenes Bestellsystem funktioniert.

Falls du die Standard-Installation wählen willst, dann schau doch zuerst bei den ersten Schritten nach!

Installation über das beigelegte Raspberry Image

Die einfachste Möglichkeit das System zum Laufen zu bekommen ist das image.zip zu eintpacken und via Balena Etcher auf deine Karte zu spielen. Das Image funktioniert zumindest am Raspi 3B, 4, 4B und dem 5er.

Alle System-Passwörter sind hier „orderjutsu„. Du kannst die Passwörter umstellen, indem du auf der Boot Partition, die du auch auf Windows mounten kannst, eine password.txt anlegst und das neue Passwort reinschreibst.

Url: http://192.168.192.10
Benutzername: admin@orderjutsu.local
Passwort: admin
Web-App: http://192.168.192.10/app/ (funktioniert auch mit iOS)
Android: http://192.168.192.10/app.apk 

Nach dem Entpacken musst du das Automatische-Update durchführen um die aktuellste Version am System zu haben.


Du brauchst ein grundlegendes Verständnis von Linux und die Fähigkeit, einen Text-Editor wie nano oder vi zu nutzen um dieser Anleitung zu folgen!

Hier sind alle Schritte nochmal genau beschrieben wenn du es per Hand installieren willst. Wenn du Fehlmeldungen wie „Schwerer Fehler: SQLSTATE[HY000] [1045] Access denied for user ‚oderjutsu’@’localhost‘ (using password: NO)“ nicht interpretieren kannst, dann ist die manuelle Installation nichts für dich.

1. Installation des Betriebsystems

Nach diesem Schritt kannst du auf deinen optimierten Rapsberry per SSH mit Fixer IP verbinden.

Seit dem PI5 gibt es auch ein eigenes Imager Tool von Raspberry, zu finden unter https://www.raspberrypi.com/software/.

Hier gibt es einiges an Settings und vairanten, wähle die Variante, die dir am besten passt. Ich nutze Netzwerkkabel, brauche daher kein WLAN und ich nutze die 64bit Lite Variante des Betriebssystems.

Du kannst aber auch die Desktop Version nutzen.

Nimm bitte deinen Namen und nicht „orderjutsu“ als Hauptuser, denn das würde später ein Problem verursachen!

Aktivere SSH in den Diensten, damit wir uns auf den Server verbinden können.

Jetzt kannst du den Raspberry zusammenbauen und an deinen Router hängen. Ich preferiere LAN-Kabel. Du kannst die nächsten Schritte aber auch über WLAN oder per HDMI Kabel am Fernseher erledigen. Das musst du dann aber ergoogeln.

IP Addresse finden

Am leichtesten ist es, am Router nachzuschauen.

Der leichteste Weg führt über den Router.

Es gibt noch andere Wege, die IP zu finden. Du kannst gerne auf der Raspberry Seite nachlesen.

SSH Verbindung

Mit der IP startest du Putty und verbindest dich als User pi auf die IP. Das Standard-Passwort ist raspberry

Verbinden per Putty zum Raspberry per SSH.
Auf den nächsten Schritt wird schon hingewiesen.

Jetzt solltest du gleich das Passwort ändern, wie oben beschrieben mit dem Befehl passwd.

Wie du eine PPK-Autentifizierung ohne Passwort über SSH/Putty machst, ergoogelst du am besten.

Jetzt configurieren wir den Raspberry noch ein wenig.

Fixe IP vergeben

Am einfachsten über den Command sudo nmtui

Hier kannst du alle Netzwerkverbindungen prüfen und einstellen.

Den Raspberry tunen mit raspi-config

Zuerst wechselst du den Benutzer mit sudo -i.

Den Benutzer zu root wechseln.

Jetzt kannst du mal das System updaten mit apt update und apt upgrade -y. Ist nie verkehrt und dauert nur ein paar Minuten. Kommt zwar im zweiten Teil dazu, aber auch System Pakete sollten aktuell sein.

Mit dem Command raspi-config stellst du gleich mal zwei Sachen um.

  1. Advanced Options – Expand Filesystem – geht von selber
  2. Advanced Options – Memory Split – hier reichen 4MB
  3. Network Options – N1 Hostname – orderjutsu.local

Dann mal restarten und schauen ob alles passt.

2. Installation der Webserver-Komponenten

Wenn dieser Schritt erledigt ist, ist dein Raspberry für Orderjutsu bereit und optimiert. Danach wirst du die Software installieren.

Login via SSH am Raspberry und Wechsel zum root user mit sudo -i und dann kommen nach der Reihe diese Befehle.

sudo -i

Und jetzt beginnt die eigentliche Installation…

apt update

export DEBIAN_FRONTEND="noninteractive"
 
echo "postfix postfix/mailname string orderjutsu.local" | debconf-set-selections 
echo "postfix postfix/main_mailer_type string 'Internet Site'" | debconf-set-selections

#prepare for ondrey package
sudo apt install lsb-release
curl https://packages.sury.org/php/apt.gpg | sudo tee /usr/share/keyrings/suryphp-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/suryphp-archive-keyring.gpg] https://packages.sury.org/php/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/sury-php.list
sudo apt update

# PHP Version 
PHP_VERSION=7.4
 
apt install -y nginx nginx-extras 
    php$PHP_VERSION-cli php$PHP_VERSION-fpm  php$PHP_VERSION-xml php$PHP_VERSION-soap 
    php$PHP_VERSION-curl php$PHP_VERSION-mbstring php$PHP_VERSION-zip php$PHP_VERSION-gd 
    php$PHP_VERSION-mysql php$PHP_VERSION-common 
    postfix mailutils 
    mariadb-server mariadb-client
 
apt update
apt -y upgrade
sed -i -e 's/^mydestination.*/mydestination = localhost/' /etc/postfix/main.cf
systemctl restart postfix
echo

echo "[mysqld]
bind-address = 0.0.0.0
innodb_flush_log_at_trx_commit = 2
sql_mode=" | tee /etc/mysql/mariadb.conf.d/99-orderjutsu.cnf
systemctl restart mysql
echo

Und jetzt musst du noch composer installieren, das geht so…

 
EXPECTED_SIGNATURE="$(wget -q -O - https://composer.github.io/installer.sig)"
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
ACTUAL_SIGNATURE="$(php -r "echo hash_file('sha384', 'composer-setup.php');")"

if [ "$EXPECTED_SIGNATURE" != "$ACTUAL_SIGNATURE" ]; then
    echo 'ERROR: Invalid installer signature';
    rm composer-setup.php
else
    php composer-setup.php
    rm composer-setup.php
    mv composer.phar /usr/local/bin/composer
fi
echo

Das war es eigentlich schon. Es sollte immer alles irgendwie OK und grün sein. Wenn du die vorgeschlagene IP genommen hast, kannst du jetzt auf http://192.168.192.10 den Nginx-Welcome-Screen sehen.

3. Installation Orderjutsu

Nach diesem Schritt ist Orderjutsu installiert und du kannst mit der Konfiguration einer Veranstaltung beginnen.

Da ich persönlich es für überaus unklug halte, alle Webseiten als www-data auszuführen, legen wir lieber einen neuen User an, der dann als Orderjutsu fungiert und mit dem wir uns dann in weiterer Folge einloggen.

Ich hab dafür ein eigenes Script, das ich eigentlich immer nutze. Das ladest du mit den nächsten Commands runter und führst es gleich aus. Man kann das alles per Hand schreiben, aber das braucht dich alles nicht zu interessieren.


# vorher noch die standardseite löschen
rm /etc/nginx/sites-enabled/default

sudo wget -O /usr/local/bin/ran_useradd https://git.rent-a-ninja.org/snippets/1/raw
sudo chmod +x /usr/local/bin/ran_useradd
sudo ran_useradd orderjutsu.local
#ran_useraadd orderjutsu.local orderjutsu orderjutsu orderjutsu /var/www/vhosts/orderjutsu.local
echo
Setup für einen neuen User mit Datenbank und Passwort.

Das Passwort brauchst du gleich, also notier es dir auf.

Du kannst jetzt auch schon mit SFTP (über Filezilla) auf den Webspace mit den Daten zugreifen.

Nimm jetzt dein erworbenes Orderjutsu.zip und extrahiere es irgendwo hin. Dann ersetze den Inhalt unter /var/www/vhosts/orderjutsu.local/httpdocs auf dem Server mit dem Inhalt des Zips. Bitte vergiss nicht, dies als orderjutsu User zu machen. Sonst hast du später ein Dateirechte-Problem.

Per SFTP kannst du nun den Inhalt des Zip auf den Raspberry kopieren.

ACHTUNG: Auch neue SD Karten können defekt sein. Wenn beim Hochladen der Dateien Fehler auftauchen, könnte es an einer fehlerhaften SD Karte liegen! Versuch bitte zur Sicherheit eine andere Karte.

Du solltest dich jetzt als orderjutsu mit dem vorher notierten Passwort via Putty einloggen und folgendes durchführen.


# ich gehe davon aus, dass du dich jetzt als orderjutsu angemeldet hast.
cd httpdocs
# wenn das nicht klappt, dann hast du beim Kopieren die .env Datei übersehen
# siehst du die nicht, empfehle ich dir das Image zu nutzen!
cp .env.example .env
# ist hier irgendwo ein Fehler, dann wird der eingangs erwähnte "Schwere Fehler" auftreten. 
sed -ne 's/password=(.*)/DB_PASSWORD=1/p' ~/.my.cnf  | tee -a ~/httpdocs/.env
chmod +x update.sh
composer install
php artisan key:generate
php artisan config:clear
echo
Dann installierst du mal alles, das dauert ein bisschen.

Soweit so gut. Jetzt hast du mal die Software installiert. Kümmere dich nicht um irgendwelche „Software-Vorschläge“ oder sonstige Warnungen. Jetzt wird die Datenbank aufgesetzt. Dank Laravel ist das ein recht einfacher Prozess.

php artisan migrate --force --seed
Das Ergebnis sollte irgendwie so aussehen.

Damit ist dein ganz persönliches Orderjutsu einsatzbereit und mit einem Fest vorinstalliert.

4. Administration

Jetzt kannst du dich einloggen:

Url: http://192.168.192.10
Benutzername: admin@orderjutsu.local
Passwort: admin
Web-App: http://192.168.192.10/app/ (funktioniert auch mit iOS)
Android: http://192.168.192.10/app.apk