Ausführung des Terminal Installer

Voraussetzungen

Damit der Installer im Terminal lauffähig ist, muss laufende testWare Instanz auf einem Webserver oder in einem Container vorhanden sein.

Vorbereitungen

Mit der testWare Instanz verbinden

Die Installation im Terminal setzt voraus, dass man sich auf dem Terminal (auch Kommandozeile genannt) des Servers in dem Stammverzeichnis der testWare befindet.

Verbinden Sie sich zum Beispiel per ssh mit dem Server.

computer:~$ ssh system@domain.tld

Verwenden Sie einen traditionellen Webserver, wechseln Sie in das Stammverzeichnis z.B. /var/www/testware

cd /var/www/testware

Für Systeme mit einer Containerlaufzeit öffnen Sie einen Terminal in den testWare Container. Als Beispiel für einen Docker Container names testware-app

docker compose exec -ti testware-app /bash

Ausführen

Warnung

Dieser Befehl sollte nur für ein neue Instanz verwendet werden.

Eine produktiv laufende Instanz sollte vorher gesichert werden, da alle Daten gelöscht werden.

Hinweis:
Werte mit [ ] sind Defaultwerte und können durch eine Betätigung der Enter Taste übernommen werden.

Nach der Eingabe des Befehels wir die obige Warnung im Terminal ausgegeben

Im Stammverzeichnis wird der Installer mit folgendem Befehl gestartet:

php artisan testware:install

Nach der Eingabe des Befehels wir die obige Warnung im Terminal ausgegeben

computer:/var/www/testware$ php artisan testware:install W A R N I N G This installer will reset your database! All data will be lost and cannot be restored! Type [yes] to proceed or [no] to exit without changes [no]:

Wenn die Warnung mit yes bestätigt wurde werden alle Tabellen in der Datenbank gelöscht und neu erstellt.

Vorgabewerte

Anschließend wird die Möglichkeit gegeben, gängige Vorgabewerte einzufügen

Fill database with default entries [yes] or leave it empty [no] ? (yes/no) [yes]:

Die Vorgabewerte sind:

  • Benutzerrollen
  • Länderliste der EU
  • 3 Adresstypen (Haus-, Rechnungs- und Lieferadresse)
  • 8 Prüfintervalle (Jahr, Monat, Tag etc.)
  • 3 Gebäudearten (Büro, Werkstatt, Lager)
  • 4 Raumarten (Büro, Werkstatt, Lagerraum, Materialraum)
  • 2 Produktstati (verfügbar, gesperrt)
  • 1 Produktkategorie (ohne)
  • 4 Gerätestati (verfügbar, beschädigt, Reparatur, gesperrt)
  • 3 Stellplatztypen (Lagerfach, Schublade, Lagerplatz)
  • 6 Dokumenttypen (Anleitung, Funktionsprüfbericht, Prüfbericht, Zeichnung, Vorschrift, Anforderung)

Systemadministrator

Als nächstes kann ein Systemadministratorkonto eingerichtet werden. Dieser wird für die weiteren Schritte, wie den Web-Installer benötigt.

Create new user with SysAdmin privileges? (yes/no) [yes]:

Für die Einrichtung wird die E-Mail Adresse benötigt. Sie dient als Benutzername bei der Anmeldung.

E-Mail (used for login):

Nach erfolgter Eingabe wird die Bestätigung der E-Mail Adresse gefordert. Damit soll verhindert werden, dass fehlerhafte E-Mail Adressen Probleme verursachen. Ist die Adresse korret wird diese mit yes bestätigt.

Confirm given e-mail address : [eingegebene email addresse] (yes/no) [no]:

Anschließend wird der Anzeigename vergeben. Dieser Name wird im Menü angezeigt und sollte daher nicht zu lange sein.

Username (will be displayed in app):

Danach wird der komplette Name angegeben.

Full name:

Da die testWare von Hause aus mehrsprachig programmiert wurde kann die Sprache des Benutzers angegeben werden. Der Vorgabewert ist de. Es sind noch Übersetzungen für en (English etwa 90% übersetzt) und fr (Fränzösich etwa 70% übersetzt) vorhanden.

Language [de]:

Als letzten Pflichtpunkt wird das Passwort vergeben.

Bitte beachten, dass in den meisten Terminals keine Eingabe zu sehen ist. Viele Terminals zeigen ein Schlüsselsymbol, um zu zeigen, dass ein Passwort eingegeben wird.
Password (min. 8 charakters): Confirm the password:

Mitarbeiter

Nach der Bestätigung des Passwortes ist das Sys-Admin Konto angelegt. Optional kann diesem ein Mitarbeiter zugeordnet / angelegt werden.

Is this user going to be an employee as well? (yes/no) [no]:

Ein Mitarbeiter hat als einziges erforderliches Feld den Nachnahmen. Der Installer versucht aus dem angegebenen kompletten Namen diesen zu erkennen. Dieser wird dann als Vorgabewert vorgeschlagen.

Name [Nachname]:

Es können die weiteren, optionalen Daten eingegeben werden. Das sind folgende Felder

Surename [Vorname]: Birthday (YYYY-MM-DD): Employee ID: Employed on (YYYY-MM-DD): Phone-#: Mobile-#: E-Mail [default value the e-mail already provided]:

Diese Felder sind optional. Es müssen nicht alle ausgefüllt werden.

Die Werte für [Vorname] und [E-Mail] werden von dem Benutzerkonto übernommen.

Abschlussaufgaben

Damit ist der Installer von den Eingaben her abgeschlossen. Es werden noch Schlüssel erstellt, die für Sicherheitsfeatures verwendet werden. Die Schlüssel werden in die .env Datei als APP_KEY und APP_HSKEY eingetragen.

Generate new encryption keys ...

Ist dies erfolgt, erscheint eine Meldung, welche den Abschluss des Installationsschritts bestätigt.

Please use the newly created user to login at https://domain.tld/installer to set your company, location and complete the setup process.

Nun kann die Einrichtung des testWare erfolgen. Das kann entweder direkt in der Verwaltung erfolgen, oder mit Hilfe des Web-Installer.