Installation per Konsole

• Installation per Konsole
  • Kurzfassung (tl;dr)
  • Vorbereitung
    • Download & Entpacken
    • Datenbank
  • Installation
    • Setup Sprache
    • Systemprüfung
    • QUIQQER Sprache
    • Versionsauswahl
    • Vorlage
    • Datenbank
    • Administrativer Benutzer
    • Pfade

Kurzfassung (tl;dr)

Diese Reihe von Befehlen downloadet, entpackt und startet das Setup.
Bitte achte darauf, dass das Archiv in das aktuelle Verzeichnis geladen und entpackt wird.
Wechsle also vor dem Ausführen des Befehls in das richtige Verzeichnis!

wget https://update.quiqqer.com/quiqqer.tar && tar -xvf quiqqer.tar && php setup.php

Für Entwickler

wget https://update.quiqqer.com/quiqqer.tar && tar -xvf quiqqer.tar && php setup.php --dev

Vorbereitung

Um QUIQQER per Konsole zu installieren, benötigst du Shell-Zugang zu deinem Server. Verbinde dich nun also per SSH mit deinem Server und wechsle in das Verzeichnis, in welches du QUIQQER installieren möchtest.

Wir gehen für diese Anleitung von einem fertig eingerichtetem LAMP-Stack (Linux, Apache, MySql, PHP) aus.

Download & Entpacken

Folgende Befehle können ausgeführt werden, um QUIQQER zu downloaden und zu entpacken.

Achtung:
Diese Befehle downloaden und entpacken QUIQQER in das aktuelle Verzeichnis! Wechsle vor der Ausführung also in das passende Verzeichnis. Im Idealfall das root-Verzeichnis deines Webservers oder Webserver VHosts.

QUIQQER als zip-Datei:

wget https://update.quiqqer.com/quiqqer.zip  && unzip quiqqer.zip

Oder falls auf deinem Server zip nicht installiert ist, als tar-Datei:

wget https://update.quiqqer.com/quiqqer.tar  && tar -xvf quiqqer.tar

Datenbank

QUIQQER benötigt eine Datenbank. Diese kann mit MySQL erstellt werden.
Hierfür kannst du folgende Befehle verwenden:

Zuerst starten wir MySQL:

mysql -u <benutzer> -p

Wenn alles gut läuft, wirst du von der MySQL Shell begrüßt. Erkennbar ist dies an mysql> am Anfang der Terminal-Eingabezeile.

Nun legen wir zuerst eine neue Datenbank mit dem Namen quiqqer an:

CREATE DATABASE quiqqer;

Anschließend erstellen wir einen neuen Datenbankbenutzer quiqqer mit dem Passwort <passwort> (durch ein sicheres Passwort deiner Wahl ersetzen):

CREATE USER 'quiqqer'@'localhost' IDENTIFIED BY '<passwort>';

Da wir nun einen Benutzer haben, geben wir diesem noch Zugriff auf die Datenbank:

GRANT ALL ON quiqqer.* TO 'quiqqer'@'localhost';

Merke dir die eben verwendeten Daten für später.

Installation

Nachdem alle Vorbereitungen abgeschlossen sind, kannst du nun mit der Installation beginnen. Hierfür führst du folgenden Befehl im QUIQQER Root Verzeichnis aus:

php setup.php

Du solltest anschließend folgende Nachricht sehen:

Das Setup wird dich immer wieder nach Angaben fragen, manche dieser Anfragen bieten einen Standardwert an.
Dieser ist in eckigen Klammern ([]) dargestellt.
Der Standardwert wird verwendet, wenn eine leere Eingabe durch die Entertaste bestätigt wird. Beispiel:

Please select a Language for the Setupprocess (de_DE/en_GB) : [de_DE]

Beim Betätigen der Enter-Taste wird de_DE als Sprache für das Setup verwendet.

Setup Sprache

Als Erstes wählst du eine Sprache für das Setup aus. Standardmäßig ist hier de_DE ausgewählt, allerdings kannst du auch en_GB auswählen, um das Setup in Englisch durchzuführen.

Systemprüfung

Nachdem die Sprache gewählt ist, führt das Setup eine Prüfung des Systems durch, um festzustellen, ob QUIQQER auf diesem System einsetzbar ist.

Bitte beachten:
Falls das Setup bestimmte Voraussetzungen nicht erkennen kann, wird eine Warnung ausgegeben.
In diesem Fall solltest du selbst überprüfen, ob diese Voraussetzung erfüllt ist.

QUIQQER Sprache

Wenn die Voraussetzungen erfüllt sind, kannst du die Standardsprache für QUIQQER auswählen.

Hier kannst du den zweistelligen Ländercode (ISO 3166-1 alpha-2) eingeben. Für Deutsch wäre dies also de.

Versionsauswahl

Im darauf folgendem Teil kannst du die zu installierende QUIQQER Version auswählen.

Hier solltest du die jeweils neuste stabile Version verwenden (bspw. 1.*).
Allerdings hast du auch die Möglichkeit die instabilen Versionen dev-master oder dev-dev zu installieren.

• dev-master: Dies ist die aktuelle Entwicklungsversion. Diese enthält die neusten Änderungen, kann aber jedoch auch instabil sein.
• dev-dev: Dies ist der aktuelle Entwicklungszweig, welcher auch ungetestete Änderungen enthalten kann und daher nur für die Entwicklung benutzt werden sollte

Vorlage

Ist die Version gewählt, kannst du mit der Auswahl einer Vorlage fortfahren.

Diese können zum Beispiel folgendes Enthalten:

• Das verwendete Template
• Zu installierende Zusatzpakete
• Den Projektnamen des ersten Projekts Vorlagen können auch von Benutzern mitgeliefert, angepasst und geteilt werden.
  Daher erleichtern sie das schnelle Verteilen von mehreren QUIQQER-Installationen.

Nach der Auswahl der Vorlage wirst du gefragt, ob du die Vorlage anpassen möchtest.
Falls dies der Fall ist, gib y ein und gib die nötigen Angaben ein.

Datenbank

Nun folgt die Eingabe der Datenbank Details: Folgende Angaben werden benötigt:

• Datenbank Treiber: Der Treiber welcher für QUIQQER verwendet werden soll. Meistens wird dies MySQL sein
• Datenbank Host: Der Host, auf dem die Datenbank betrieben wird. Meistens localhost, was übersetzt so viel bedeutet wie: "Datenbank läuft auf demselben Server, wie QUIQQER"
• Datenbank Name: Der Name der Datenbank, welche verwendet werden soll (im obigen Beispiel quiqqer).
• Tabellen-Prefix: Das Tabellen Prefix wird vor jede von QUIQQER verwendet Tabelle angehängt, was ermöglicht mehrere QUIQQER Instanzen in einer Datenbank zu betreiben. Falls nur eine QUIQQER-Installation in dieser Datenbank geplant ist, kann das Prefix leer gelassen werden.
• Datenbank Benutzer: Der Benutzer, welcher verwendet wird, um sich am Datenbanksystem anzumelden (im obigen Beispiel quiqqer)
• Datenbank Passwort: Das zugehörige Passwort des obigen Benutzers (im obigen Beispiel <passwort>).

Besonderheiten:

• Wenn die angegebene Datenbank nicht existiert kann QUIQQER versuchen die Datenbank zu erstellen
• Wenn eine Datenbank und Prefix Kombination gewählt wird, die bereits verwendet wird, kann das Setup die gesamte Datenbank löschen.

Administrativer Benutzer

Wenn die Datenbank vorbereitet ist, können Angaben zum administrativen Benutzer getätigt werden.
Dieser Benutzer dient später als Login zum Administrationsbereich und sollte sich daher gut gemerkt werden.

Pfade

Zum Abschluss können noch die Pfade konfiguriert werden. Im Regelfall sind die Standardwerte hier ausreichend.

• Domain: Der Host unter welchem QUIQQER erreichbar sein soll. Beispiel: https://example.com/
• QUIQQER RootVerzeichnis: Absoluter Pfad zum Verzeichnis in welches QUIQQER installiert wird.
• URL Verzeichnis: Der Pfad nach dem Host in der URL. Beispiel: /quiqqer/ für https://example.com/quiqqer/

Wenn die Pfade korrekt gesetzt sind, kann das Setup starten und binnen weniger Minuten ist dein QUIQQER System einsatzbereit.