|
|
# Installation per Konsole
|
|
|
|
|
|
[TOC]
|
|
|
|
|
|
### Schnellbefehl
|
|
|
**Download und Start der Installation**
|
|
|
## 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
|
|
|
```shell
|
|
|
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
|
|
|
```shell
|
|
|
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.
|
... | ... | @@ -29,49 +28,46 @@ Wir gehen für diese Anleitung von einem fertig eingerichtetem LAMP-Stack (**L** |
|
|
|
|
|
Folgende Befehle können ausgeführt werden, um QUIQQER zu downloaden und zu entpacken.
|
|
|
|
|
|
**Achtung**
|
|
|
|
|
|
Diese Befehle downloaden und entpacken QUIQQER in deinem aktuellen Verzeichnis - ohne Unterordner!
|
|
|
Wechsle vor der Ausführung also in das passende Verzeichnis. Im Idealfall das ROOT-Verzeichnis deines Webservers oder Webserver VHosts.
|
|
|
**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
|
|
|
QUIQQER als `zip`-Datei:
|
|
|
```
|
|
|
wget https://update.quiqqer.com/quiqqer.zip
|
|
|
unzip quiqqer.zip
|
|
|
wget https://update.quiqqer.com/quiqqer.zip && unzip quiqqer.zip
|
|
|
```
|
|
|
|
|
|
|
|
|
Oder falls auf deinem Server `zip` nicht installiert ist:
|
|
|
Oder falls auf deinem Server `zip` nicht installiert ist, als `tar`-Datei:
|
|
|
```
|
|
|
wget https://update.quiqqer.com/quiqqer.tar
|
|
|
tar -xvf quiqqer.tar
|
|
|
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:
|
|
|
Diese kann mit MySQL erstellt werden.
|
|
|
Hierfür kannst du folgende Befehle verwenden:
|
|
|
|
|
|
Zuerst starten wir MySql:
|
|
|
```
|
|
|
Zuerst starten wir MySQL:
|
|
|
```shell
|
|
|
mysql -u <benutzer> -p
|
|
|
```
|
|
|
|
|
|
Wenn alles gut läuft, wirst du von der MySql Shell begrüßt.
|
|
|
Erkennbar ist dies am `mysql>` am Anfang der Terminal-Eingabe.
|
|
|
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 Namen `quiqqer` an:
|
|
|
```
|
|
|
Nun legen wir zuerst eine neue Datenbank mit dem Namen `quiqqer` an:
|
|
|
```mysql
|
|
|
CREATE DATABASE quiqqer;
|
|
|
```
|
|
|
|
|
|
Anschließend erstellen wir einen neuen Datenbankbenutzer 'quiqqer':
|
|
|
```
|
|
|
Anschließend erstellen wir einen neuen Datenbankbenutzer `quiqqer` mit dem Passwort `<passwort>` (durch ein sicheres Passwort deiner Wahl ersetzen):
|
|
|
```mysql
|
|
|
CREATE USER 'quiqqer'@'localhost' IDENTIFIED BY '<passwort>';
|
|
|
```
|
|
|
|
|
|
Da wir nun einen Benutzer haben geben wir diesem noch Zugriff auf die Datenbank:
|
|
|
```
|
|
|
Da wir nun einen Benutzer haben, geben wir diesem noch Zugriff auf die Datenbank:
|
|
|
```mysql
|
|
|
GRANT ALL ON quiqqer.* TO 'quiqqer'@'localhost';
|
|
|
```
|
|
|
|
... | ... | @@ -81,7 +77,7 @@ Merke dir die eben verwendeten Daten für später. |
|
|
|
|
|
Nachdem alle Vorbereitungen abgeschlossen sind, kannst du nun mit der Installation beginnen.
|
|
|
Hierfür führst du folgenden Befehl im QUIQQER Root Verzeichnis aus:
|
|
|
```
|
|
|
```shell
|
|
|
php setup.php
|
|
|
```
|
|
|
|
... | ... | @@ -89,47 +85,43 @@ Du solltest anschließend folgende Nachricht sehen: |
|
|
|
|
|
![1-welcome](/uploads/5657d0abad107a0f5af3a5458e578777/1-welcome.png)
|
|
|
|
|
|
**Vorwort**
|
|
|
|
|
|
Das Setup wird dich immer wieder nach Angaben fragen, manche dieser Anfragen bieten einen Standardwert an.
|
|
|
Dieser ist erkennbar durch eckige Klammern "[" & "]", welche den Standardwert umranden.
|
|
|
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:**
|
|
|
|
|
|
Beispiel:
|
|
|
```
|
|
|
Please select a Language for the Setupprocess (de_DE/en_GB) : [de_DE]
|
|
|
```
|
|
|
|
|
|
Beim Betätigen der <kbd>Enter</kbd>-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 auszuführen
|
|
|
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 sollte selbst überprüft werden, ob diese Voraussetzung erfüllt 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 Landescode eingeben. Für Deutsch wäre dies "de"
|
|
|
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 Version auswählen.
|
|
|
Im darauf folgendem Teil kannst du die zu installierende QUIQQER Version auswählen.
|
|
|
|
|
|
Hier solltest du die jeweils neuste Version verwenden.
|
|
|
Allerdings hast du auch die Möglichkeit die Versionen "dev-master" oder "dev-dev" zu verwenden.
|
|
|
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
|
|
|
- `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
|
|
|
|
... | ... | @@ -139,30 +131,30 @@ 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 da schnelle Verteilen von mehreren QUIQQER-Installationen.
|
|
|
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.
|
|
|
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.
|
|
|
* **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
|
|
|
* **Datenbank Passwort:** Das zugehörige Passwort des obigen Benutzers.
|
|
|
- `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.
|
|
|
**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.
|
|
|
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
|
... | ... | @@ -170,8 +162,8 @@ Dieser Benutzer dient später als Login zum Administrationsbereich und sollte si |
|
|
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/`
|
|
|
- `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. |