Revision 98c56819
Von Werner Hahn vor mehr als 6 Jahren hinzugefügt
| doc/dokumentation.xml | ||
|---|---|---|
| 2 | 2 |
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 3 | 3 |
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> |
| 4 | 4 |
<book id="kivitendo-documentation" lang="de"> |
| 5 |
<title>kivitendo 3.5.1-beta: Installation, Konfiguration, Entwicklung</title> |
|
| 5 |
<title>kivitendo 3.5.1-beta: Installation, Konfiguration, |
|
| 6 |
Entwicklung</title> |
|
| 6 | 7 |
|
| 7 | 8 |
<chapter id="Aktuelle-Hinweise"> |
| 8 | 9 |
<title>Aktuelle Hinweise</title> |
| ... | ... | |
| 524 | 525 |
cd kivitendo-erp/ |
| 525 | 526 |
git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`</programlisting> |
| 526 | 527 |
Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag |
| 527 |
-l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha, beta
|
|
| 528 |
oder rc raus und das tail gibt davon den obersten Treffer zurück).
|
|
| 529 |
Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu
|
|
| 530 |
erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu
|
|
| 531 |
verwalten. Hierfür reicht ein simples <programlisting> git checkout -b meine_eigenen_änderungen</programlisting> |
|
| 528 |
-l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha, |
|
| 529 |
beta oder rc raus und das tail gibt davon den obersten Treffer
|
|
| 530 |
zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
|
|
| 531 |
Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
|
|
| 532 |
damit zu verwalten. Hierfür reicht ein simples <programlisting> git checkout -b meine_eigenen_änderungen</programlisting>
|
|
| 532 | 533 |
nach dem letzten Kommando (weiterführende Informationen <ulink |
| 533 | 534 |
url="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html"> |
| 534 | 535 |
Git Magic</ulink>).</para> |
| ... | ... | |
| 848 | 849 |
\q</programlisting> |
| 849 | 850 |
</note> |
| 850 | 851 |
</sect2> |
| 852 |
|
|
| 851 | 853 |
<sect2 id="Erweiterung-für-trigram"> |
| 852 |
<title>Erweiterung für Trigraph Prozeduren</title> |
|
| 854 |
<title>Erweiterung für Trigram Prozeduren</title> |
|
| 855 |
|
|
| 856 |
<para>Ab Version 3.5.1 wird die Trigram-Index-Erweiterung benötigt. |
|
| 857 |
Diese wird mit dem SQL-Updatescript |
|
| 858 |
sql/Pg-upgrade2/trigram_extension.sql und Datenbank-Super-Benutzer |
|
| 859 |
Rechten automatisch installiert. Um den Systembenutzer "postgres" mit |
|
| 860 |
SuperUserRechten auszustatten braucht dieser ein Passwort.</para> |
|
| 853 | 861 |
|
| 854 |
<para>In der Datenbank <literal>template1</literal> muss die |
|
| 855 |
Unterstützung für Trigram Indexes eingerichet werden. |
|
| 856 |
Melden Sie sich dafür als Benutzer “postgres” an der Datenbank an: |
|
| 857 | 862 |
<programlisting>su - postgres |
| 863 |
psql |
|
| 864 |
\password postgres |
|
| 865 |
|
|
| 866 |
Eingabe Passwort |
|
| 867 |
\q</programlisting> |
|
| 868 |
|
|
| 869 |
<para>Benutzername Postgres und Passwort können jetzt beim Anlegen |
|
| 870 |
einer Datenbank bzw. bei Updatescripten, die SuperuserRechte |
|
| 871 |
benötigen, eingegeben werden.</para> |
|
| 872 |
|
|
| 873 |
<para>Um die Trigramerweiterung selbst zu installieren:</para> |
|
| 874 |
|
|
| 875 |
<para><programlisting>su - postgres |
|
| 858 | 876 |
psql template1</programlisting> führen Sie die folgenden Kommandos aus:</para> |
| 859 | 877 |
|
| 860 | 878 |
<programlisting>CREATE EXTENSION IF NOT EXISTS pg_trgm; |
| 861 | 879 |
\q</programlisting> |
| 862 | 880 |
|
| 863 | 881 |
<note> |
| 864 |
<para><literal>pg_trgm</literal> ist je nach Distribution |
|
| 865 |
nicht im Standard-Paket von Postgres enthalten. Ein |
|
| 866 |
|
|
| 867 |
<programlisting>select * from pg_available_extensions where name ='pg_trgm';</programlisting> |
|
| 868 |
in template1 sollte entsprechend erfolgreich sein. |
|
| 869 |
Andernfalls muss das Paket nachinstalliert werden, bspw. bei debian/ubuntu |
|
| 870 |
|
|
| 871 |
<programlisting>apt install potgresql-contrib</programlisting> |
|
| 872 |
</para> |
|
| 882 |
<para><literal>pg_trgm</literal> ist je nach Distribution nicht im |
|
| 883 |
Standard-Paket von Postgres enthalten. Ein <programlisting>select * from pg_available_extensions where name ='pg_trgm';</programlisting> |
|
| 884 |
in template1 sollte entsprechend erfolgreich sein. Andernfalls muss |
|
| 885 |
das Paket nachinstalliert werden, bspw. bei debian/ubuntu |
|
| 886 |
<programlisting>apt install potgresql-contrib</programlisting></para> |
|
| 873 | 887 |
</note> |
| 874 | 888 |
</sect2> |
| 875 | 889 |
|
| 876 |
|
|
| 877 | 890 |
<sect2 id="Datenbankbenutzer-anlegen"> |
| 878 | 891 |
<title>Datenbankbenutzer anlegen</title> |
| 879 | 892 |
|
| ... | ... | |
| 8366 | 8379 |
angegeben werden. Der hier angegebene Benutzer muss weiterhin das |
| 8367 | 8380 |
Recht haben, Datenbanken anzulegen und zu löschen.</para> |
| 8368 | 8381 |
|
| 8369 |
<para>Der so angegebene Benutzer muss nicht zwingend über Super-User-Rechte verfügen. Allerdings gibt es einige Datenbank-Upgrades, |
|
| 8370 |
die genau diese Rechte benötigen. Für den Fall kann man in diesem Konfigurationsabschnitt einen weiteren Benutzeraccount angeben, |
|
| 8371 |
der dann über Super-User-Rechte verfügt, und mit dem die betroffenen Upgrades durchgeführt werden. In der |
|
| 8372 |
Beispiel-Konfigurationsdatei finden Sie die benötigten Parameter.</para> |
|
| 8373 |
|
|
| 8382 |
<para>Der so angegebene Benutzer muss nicht zwingend über |
|
| 8383 |
Super-User-Rechte verfügen. Allerdings gibt es einige |
|
| 8384 |
Datenbank-Upgrades, die genau diese Rechte benötigen. Für den Fall |
|
| 8385 |
kann man in diesem Konfigurationsabschnitt einen weiteren |
|
| 8386 |
Benutzeraccount angeben, der dann über Super-User-Rechte verfügt, und |
|
| 8387 |
mit dem die betroffenen Upgrades durchgeführt werden. In der |
|
| 8388 |
Beispiel-Konfigurationsdatei finden Sie die benötigten |
|
| 8389 |
Parameter.</para> |
|
| 8374 | 8390 |
</sect2> |
| 8375 | 8391 |
|
| 8376 | 8392 |
<sect2 id="devel.testsuite.execution"> |
Auch abrufbar als: Unified diff
Dokumentation Einrichten postgres als DatenbankSuperUser um
Updatescripte mit Superuserrechten installieren zu können. Betrifft
bisher die Trigram Erweiterung