From 98c56819848545789a75e56f0919856f875724a7 Mon Sep 17 00:00:00 2001 From: Werner Hahn Date: Tue, 5 Dec 2017 15:16:52 +0100 Subject: [PATCH] =?utf8?q?Dokumentation=20Einrichten=20postgres=20als=20Da?= =?utf8?q?tenbankSuperUser=20um=20Updatescripte=20mit=20Superuserrechten?= =?utf8?q?=20installieren=20zu=20k=C3=B6nnen.=20Betrifft=20bisher=20die=20?= =?utf8?q?Trigram=20Erweiterung?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit --- doc/UPGRADE | 15 +++++++++- doc/dokumentation.xml | 66 +++++++++++++++++++++++++++---------------- doc/html/ch01.html | 3 +- doc/html/ch02s03.html | 10 +++---- doc/html/ch02s05.html | 31 +++++++++++--------- doc/html/ch02s06.html | 4 +-- doc/html/ch02s07.html | 6 ++-- 7 files changed, 85 insertions(+), 50 deletions(-) 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 -

  • \ No newline at end of file +

    \ No newline at end of file diff --git a/doc/html/ch02s03.html b/doc/html/ch02s03.html index 8cccce4a4..830949657 100644 --- a/doc/html/ch02s03.html +++ b/doc/html/ch02s03.html @@ -30,11 +30,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).

    Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von 3.4.1 nach 3.5:

    diff --git a/doc/html/ch02s05.html b/doc/html/ch02s05.html
    index 831b3d145..48493a6eb 100644
    --- a/doc/html/ch02s05.html
    +++ b/doc/html/ch02s05.html
    @@ -37,21 +37,26 @@ psql template1

    führen Sie die folgenden Kommandos aus:

    CREATE LANGUAGE 'plpgsql';
    -\q

    2.5.4. Erweiterung für Trigraph Prozeduren

    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
    +\q

    2.5.4. 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.

    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
    [Anmerkung]Anmerkung

    - 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

    2.5.5. Datenbankbenutzer anlegen

    Wenn Sie nicht den Datenbanksuperuser “postgres” zum Zugriff benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen diff --git a/doc/html/ch02s06.html b/doc/html/ch02s06.html index 85a358500..cd3daf6a9 100644 --- a/doc/html/ch02s06.html +++ b/doc/html/ch02s06.html @@ -1,6 +1,6 @@ - 2.6. Webserver-Konfiguration

    2.6. Webserver-Konfiguration

    2.6.1. Grundkonfiguration mittels CGI

    [Anmerkung]Anmerkung

    Für einen deutlichen Performanceschub sorgt die Ausführung + 2.6. Webserver-Konfiguration

    2.6. Webserver-Konfiguration

    2.6.1. Grundkonfiguration mittels CGI

    [Anmerkung]Anmerkung

    Für einen deutlichen Performanceschub sorgt die Ausführung mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt Konfiguration für FastCGI/FCGI beschrieben.

    Der Zugriff auf das Programmverzeichnis muss in der Apache Webserverkonfigurationsdatei httpd.conf eingestellt @@ -108,7 +108,7 @@ AliasMatch ^/url/for/kivitendo-erp-fcgid/[^/]+\.pl /path/to/kivitendo-erp/dispat Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/

    Dann ist unter /url/for/kivitendo-erp/ die normale Version erreichbar, und unter /url/for/kivitendo-erp-fcgid/ die - FastCGI-Version.

    2.6.3. Weitergehende Konfiguration

    Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung + FastCGI-Version.

    2.6.3. Weitergehende Konfiguration

    Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung von kivitendo nur über https-verschlüsselten Verbindungen, sowie weiteren Zusatzmassnahmen, wie beispielsweise Basic Authenticate. Die Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser diff --git a/doc/html/ch02s07.html b/doc/html/ch02s07.html index ce178d66a..d192a85ec 100644 --- a/doc/html/ch02s07.html +++ b/doc/html/ch02s07.html @@ -39,7 +39,7 @@ Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess einzubinden. Da das bei neueren Linux-Distributionen aber nicht zwangsläufig funktioniert, werden auch Start-Scripte mitgeliefert, die - anstelle eines symbolischen Links verwendet werden können.

    2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere + anstelle eines symbolischen Links verwendet werden können.

    2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere OpenSUSE, ältere Fedora)

    Kopieren Sie die Datei scripts/boot/system-v/kivitendo-task-server nach /etc/init.d/kivitendo-task-server. Passen @@ -47,12 +47,12 @@ DAEMON=....). Binden Sie das Script in den Boot-Prozess ein. Dies ist distributionsabhängig:

    • Debian-basierende Systeme:

      update-rc.d kivitendo-task-server defaults
       insserv kivitendo-task-server
    • Ältere OpenSUSE und ältere Fedora:

      chkconfig --add kivitendo-task-server

    Danach kann der Task-Server mit dem folgenden Befehl gestartet - werden:

    /etc/init.d/kivitendo-task-server start

    2.7.3.2. Upstart-basierende Systeme (z.B. Ubuntu bis 14.04)

    Kopieren Sie die Datei + werden:

    /etc/init.d/kivitendo-task-server start

    2.7.3.2. Upstart-basierende Systeme (z.B. Ubuntu bis 14.04)

    Kopieren Sie die Datei scripts/boot/upstart/kivitendo-task-server.conf nach /etc/init/kivitendo-task-server.conf. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile exec ....).

    Danach kann der Task-Server mit dem folgenden Befehl gestartet - werden:

    service kivitendo-task-server start

    2.7.3.3. systemd-basierende Systeme (z.B. neure openSUSE, neuere + werden:

    service kivitendo-task-server start

    2.7.3.3. systemd-basierende Systeme (z.B. neure openSUSE, neuere Fedora, neuere Ubuntu und neuere Debians)

    Kopieren Sie die Datei scripts/boot/systemd/kivitendo-task-server.service nach /etc/systemd/system/. Passen Sie in der -- 2.20.1