From: Werner Hahn
Date: Tue, 5 Dec 2017 14:16:52 +0000 (+0100)
Subject: Dokumentation Einrichten postgres als DatenbankSuperUser um
X-Git-Tag: release-3.5.4~601
X-Git-Url: http://wagnertech.de/git?a=commitdiff_plain;h=98c56819848545789a75e56f0919856f875724a7;p=kivitendo-erp.git
Dokumentation Einrichten postgres als DatenbankSuperUser um
Updatescripte mit Superuserrechten installieren zu können. Betrifft
bisher die Trigram Erweiterung
---
diff --git a/doc/UPGRADE b/doc/UPGRADE
index 7312ea20a..2c57e6f06 100644
--- a/doc/UPGRADE
+++ b/doc/UPGRADE
@@ -35,8 +35,21 @@ Upgrade auf v3.5.1
installiert werden.
+ * Diese Erweiterung wird mit dem SQL-Updatescript sql/Pg-upgrade2/trigram_extension.sql
+ und Datenbank-Super-Benutzer Rechten automatisch installiert.
+ Um den Systembenutzer "postgres" mit SuperUserRechten auszustatten
+ braucht dieser ein Passwort.
- * Um diese Erweiterung generell in Postgres zu aktivieren, muss folgendes gemacht werden:
+ su - postgres
+ psql
+ \password
+
+ \q
+
+ Passwort und Benutzername können jetzt beim Anlegen einer neuen Datenbank bzw.
+ bei Updatescripten, die SuperUserRechte benötigen eingegeben werden.
+
+ * Um diese Erweiterung manuell zu installieren und generell in Postgres zu aktivieren, muss folgendes gemacht werden:
su - postgres
psql template1
diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml
index b4ad88303..1f8452bfa 100644
--- a/doc/dokumentation.xml
+++ b/doc/dokumentation.xml
@@ -2,7 +2,8 @@
- kivitendo 3.5.1-beta: Installation, Konfiguration, Entwicklung
+ kivitendo 3.5.1-beta: Installation, Konfiguration,
+ Entwicklung
Aktuelle Hinweise
@@ -524,11 +525,11 @@ git clone https://github.com/kivitendo/kivitendo-erp.git
cd kivitendo-erp/
git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`
Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
- -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha, beta
- oder rc raus und das tail gibt davon den obersten Treffer zurück).
- Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu
- erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu
- verwalten. Hierfür reicht ein simples git checkout -b meine_eigenen_änderungen
+ -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha,
+ beta oder rc raus und das tail gibt davon den obersten Treffer
+ zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
+ Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
+ damit zu verwalten. Hierfür reicht ein simples git checkout -b meine_eigenen_änderungen
nach dem letzten Kommando (weiterführende Informationen
Git Magic).
@@ -848,32 +849,44 @@ psql template1 führen Sie die folgenden Kommandos aus:
\q
+
- Erweiterung für Trigraph Prozeduren
+ Erweiterung für Trigram Prozeduren
+
+ Ab Version 3.5.1 wird die Trigram-Index-Erweiterung benötigt.
+ Diese wird mit dem SQL-Updatescript
+ sql/Pg-upgrade2/trigram_extension.sql und Datenbank-Super-Benutzer
+ Rechten automatisch installiert. Um den Systembenutzer "postgres" mit
+ SuperUserRechten auszustatten braucht dieser ein Passwort.
- In der Datenbank template1 muss die
- Unterstützung für Trigram Indexes eingerichet werden.
- Melden Sie sich dafür als Benutzer âpostgresâ an der Datenbank an:
su - postgres
+psql
+\password postgres
+
+Eingabe Passwort
+\q
+
+ Benutzername Postgres und Passwort können jetzt beim Anlegen
+ einer Datenbank bzw. bei Updatescripten, die SuperuserRechte
+ benötigen, eingegeben werden.
+
+ Um die Trigramerweiterung selbst zu installieren:
+
+ su - postgres
psql template1 führen Sie die folgenden Kommandos aus:
CREATE EXTENSION IF NOT EXISTS pg_trgm;
\q
- pg_trgm ist je nach Distribution
- nicht im Standard-Paket von Postgres enthalten. Ein
-
- select * from pg_available_extensions where name ='pg_trgm';
- in template1 sollte entsprechend erfolgreich sein.
- Andernfalls muss das Paket nachinstalliert werden, bspw. bei debian/ubuntu
-
- apt install potgresql-contrib
-
+ pg_trgm ist je nach Distribution nicht im
+ Standard-Paket von Postgres enthalten. Ein select * from pg_available_extensions where name ='pg_trgm';
+ in template1 sollte entsprechend erfolgreich sein. Andernfalls muss
+ das Paket nachinstalliert werden, bspw. bei debian/ubuntu
+ apt install potgresql-contrib
-
Datenbankbenutzer anlegen
@@ -8366,11 +8379,14 @@ $self->{more_texts} = {
angegeben werden. Der hier angegebene Benutzer muss weiterhin das
Recht haben, Datenbanken anzulegen und zu löschen.
- Der so angegebene Benutzer muss nicht zwingend über Super-User-Rechte verfügen. Allerdings gibt es einige Datenbank-Upgrades,
- die genau diese Rechte benötigen. Für den Fall kann man in diesem Konfigurationsabschnitt einen weiteren Benutzeraccount angeben,
- der dann über Super-User-Rechte verfügt, und mit dem die betroffenen Upgrades durchgeführt werden. In der
- Beispiel-Konfigurationsdatei finden Sie die benötigten Parameter.
-
+ Der so angegebene Benutzer muss nicht zwingend über
+ Super-User-Rechte verfügen. Allerdings gibt es einige
+ Datenbank-Upgrades, die genau diese Rechte benötigen. Für den Fall
+ kann man in diesem Konfigurationsabschnitt einen weiteren
+ Benutzeraccount angeben, der dann über Super-User-Rechte verfügt, und
+ mit dem die betroffenen Upgrades durchgeführt werden. In der
+ Beispiel-Konfigurationsdatei finden Sie die benötigten
+ Parameter.
diff --git a/doc/html/ch01.html b/doc/html/ch01.html
index 82e6fc8b7..df35f2d98 100644
--- a/doc/html/ch01.html
+++ b/doc/html/ch01.html
@@ -5,4 +5,5 @@
in der doc/UPGRADE Datei im doc-Verzeichnis der
Installation
Im Schulungs- und Dienstleistungsangebot der entsprechenden
kivitendo-Partner: http://www.kivitendo.de/partner.html
-