Perl-DB-Upgradescripte: nicht manuell Datenbankhandle committen
[kivitendo-erp.git] / doc / html / ch02s05.html
1 <html><head>
2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3    <title>2.5. Anpassung der PostgreSQL-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.0.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s04.html" title="2.4. kivitendo-Konfigurationsdatei"><link rel="next" href="ch02s06.html" title="2.6. Webserver-Konfiguration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.5. Anpassung der PostgreSQL-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s04.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.5. Anpassung der PostgreSQL-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Anpassung-der-PostgreSQL-Konfiguration"></a>2.5. Anpassung der PostgreSQL-Konfiguration</h2></div></div></div><p>PostgreSQL muss auf verschiedene Weisen angepasst werden.</p><div class="sect2" title="2.5.1. Zeichensätze/die Verwendung von Unicode/UTF-8"><div class="titlepage"><div><div><h3 class="title"><a name="Zeichens%C3%A4tze-die-Verwendung-von-UTF-8"></a>2.5.1. Zeichensätze/die Verwendung von Unicode/UTF-8</h3></div></div></div><p>kivitendo setzt zwingend voraus, dass die Datenbank Unicode/UTF-8 als Encoding einsetzt. Bei aktuellen Serverinstallationen
4               braucht man hier meist nicht einzugreifen.</p><p>Das Encoding des Datenbankservers kann überprüft werden. Ist das Encoding der Datenbank "template1" "Unicode" bzw. "UTF-8", so
5         braucht man nichts weiteres diesbezüglich unternehmen. Zum Testen:</p><pre class="programlisting">su postgres
6 echo '\l' | psql
7 exit </pre><p>Andernfalls ist es notwendig, einen neuen Datenbankcluster mit
8         Unicode-Encoding anzulegen und diesen zu verwenden. Unter Debian und
9         Ubuntu kann dies z.B. für PostgreSQL 9.3 mit dem folgenden Befehl
10         getan werden:</p><pre class="programlisting">pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 9.3 clustername</pre><p>Die Datenbankversionsnummer muss an die tatsächlich verwendete
11         Versionsnummer angepasst werden.</p><p>Unter anderen Distributionen gibt es ähnliche Methoden.</p><p>Das Encoding einer Datenbank kann in <span class="command"><strong>psql</strong></span> mit
12         <code class="literal">\l</code> geprüft werden.</p></div><div class="sect2" title="2.5.2. Änderungen an Konfigurationsdateien"><div class="titlepage"><div><div><h3 class="title"><a name="%C3%84nderungen-an-Konfigurationsdateien"></a>2.5.2. Änderungen an Konfigurationsdateien</h3></div></div></div><p>In der Datei <code class="filename">postgresql.conf</code>, die je nach
13         Distribution in verschiedenen Verzeichnissen liegen kann (z.B.
14         <code class="filename">/var/lib/pgsql/data/</code> oder
15         <code class="filename">/etc/postgresql/</code>, muss sichergestellt werden,
16         dass TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den
17         Parameter <code class="varname">listen_address</code> gesteuert. Laufen
18         PostgreSQL und kivitendo auf demselben Rechner, so kann dort der Wert
19         <code class="literal">localhost</code> verwendet werden. Andernfalls müssen
20         Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden,
21         was mit dem Wert <code class="literal">*</code> geschieht.</p><p>In der Datei <code class="filename">pg_hba.conf</code>, die im gleichen
22         Verzeichnis wie die <code class="filename">postgresql.conf</code> zu finden
23         sein sollte, müssen die Berichtigungen für den Zugriff geändert
24         werden. Hier gibt es mehrere Möglichkeiten. sinnvoll ist es nur die
25         nögiten Verbindungen immer zuzulassen, für eine lokal laufenden
26         Datenbank zum Beispiel:</p><pre class="programlisting">local all kivitendo password
27 host all kivitendo 127.0.0.1 255.255.255.255 password</pre></div><div class="sect2" title="2.5.3. Erweiterung für servergespeicherte Prozeduren"><div class="titlepage"><div><div><h3 class="title"><a name="Erweiterung-f%C3%BCr-servergespeicherte-Prozeduren"></a>2.5.3. Erweiterung für servergespeicherte Prozeduren</h3></div></div></div><p>In der Datenbank <code class="literal">template1</code> muss die
28         Unterstützung für servergespeicherte Prozeduren eingerichet werden.
29         Melden Sie sich dafür als Benutzer “postgres” an der Datenbank an:
30         </p><pre class="programlisting">su - postgres
31 psql template1</pre><p>
32
33         führen Sie die folgenden Kommandos aus:</p><pre class="programlisting">create language 'plpgsql';
34 \q</pre></div><div class="sect2" title="2.5.4. Datenbankbenutzer anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Datenbankbenutzer-anlegen"></a>2.5.4. Datenbankbenutzer anlegen</h3></div></div></div><p>Wenn Sie nicht den Datenbanksuperuser “postgres” zum Zugriff
35         benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer
36         anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen
37         können:</p><p>Die Frage, ob der neue User Superuser sein soll, können Sie mit nein
38         beantworten, genauso ist die Berechtigung neue User (Roles) zu
39         generieren nicht nötig.</p><pre class="programlisting">su - postgres
40 createuser -d -P kivitendo
41 exit</pre><p>Wenn Sie später einen Datenbankzugriff konfigurieren, verändern
42         Sie den evtl. voreingestellten Benutzer “postgres” auf “kivitendo” bzw.
43         den hier gewählten Benutzernamen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s04.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s06.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.4. kivitendo-Konfigurationsdatei&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.6. Webserver-Konfiguration</td></tr></table></div></body></html>