X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.txt;h=075d483240b2d6c5ccea435fa5196e96b32b1d5f;hb=996ddb70dc0d35be7a72e981ab38011a13d09484;hp=1b3786fa84603057e4b7b9269461e312b73f2420;hpb=0603f8f19c70afcbd1b9a5e76c03108f0f15c098;p=kivitendo-erp.git diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt index 1b3786fa8..075d48324 100644 --- a/doc/INSTALL.txt +++ b/doc/INSTALL.txt @@ -6,9 +6,10 @@ Inhalt der Anleitung 2 Benötigte Software und Pakete 3 Installation des Programmpaketes 4 Anpassung der PostgreSQL-Konfiguration - 4.1 Änderungen an Konfigurationsdateien - 4.2 Erweiterung für servergespeicherte Prozeduren - 4.3 Datenbankbenutzer anlegen + 4.1 Zeichensätze/die Verwendung von UTF-8 + 4.2 Änderungen an Konfigurationsdateien + 4.3 Erweiterung für servergespeicherte Prozeduren + 4.4 Datenbankbenutzer anlegen 5 Apache-Konfiguration 6 Benutzerauthentifizierung und Administratorpasswort 6.1 Grundlagen zur Benutzerauthentifizierung @@ -99,6 +100,11 @@ es mit der CPAN-Shell installiert werden. Leider gibt es F denen das nicht möglich oder praktikabel ist. Lx-Office liefert daher das Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen. + Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle +benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: + + `./scripts/installation_check.pl' + 3 Installation des Programmpaketes ********************************** @@ -116,28 +122,67 @@ tar xvzf lxoffice-erp-2.4.x.tgz' Alternativ können Sie auch einen Alias in der Webserverkonfiguration benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen. - Das Verzeichnis muß für den Benutzer beschreibbar sein, unter dem der -Webserver läuft. Dieser ist bei verschiedenen Distributionen -unterschiedlich (z.B. bei Debian/Ubuntu `www-data', bei Fedora core -`apache' oder bei OpenSuSE `wwwrun'). + Die Verzeichnisse `datev', `users', `spool' und `webdav' müssen für +den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die +restlichen Dateien müssen für diesen Benutzer lesbar sein. Der +Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B. +bei Debian/Ubuntu `www-data', bei Fedora core `apache' oder bei +OpenSuSE `wwwrun'). + + Der folgende Befehl ändert den Besitzer für die oben genannten +Verzeichnisse auf einem Debian/Ubuntu-System: - `chown -R www-data: lx-office-erp/' + `chown -R www-data lx-office-erp/datev lx-office-erp/users +lx-office-erp/spool lx-office-erp/webdav' 4 Anpassung der PostgreSQL-Konfiguration **************************************** PostgreSQL muss auf verschiedene Weisen angepasst werden. -4.1 Änderungen an Konfigurationsdateien +4.1 Zeichensätze/die Verwendung von UTF-8 +========================================= + +Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet werden. +Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in Version 8.0 +oder neuer benutzt werden, und der PostgreSQL-Datenbankcluster muss +ebenfalls mit UTF-8 als Locale angelegt worden sein. + + Dieses ist kann überprüft werden: ist das Encoding der Datenbank +"template1" "UTF8", so kann auch Lx-Office mit UTF-8 betrieben werden. +Andernfalls ist es notwendig, einen neuen Datenbankcluster mit +UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und +Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden: + + `pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 +clustername' + + Die Datenbankversionsnummer muss an die tatsächlich verwendete +Versionsnummer angepasst werden. + + Unter anderen Distributionen gibt es ähnliche Methoden. + + Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist +ein Neuanlegen eines weiteren Clusters nicht möglich, so kann Lx-Office +mit ISO-8850-15 als Encoding betrieben werden. + +4.2 Änderungen an Konfigurationsdateien ======================================= In der Datei `postgresql.conf', die je nach Distribution in verschiedenen Verzeichnissen liegen kann (z.B. `/var/lib/pgsql/data/' oder `/etc/postgresql/', muss sichergestellt werden, dass -TCP/IP-Verbindungen aktiviert sind. Dieser Parameter lautet +TCP/IP-Verbindungen aktiviert sind. Für PostgreSQL vor Version v8.0 +lautete dieser Parameter `TCPIP_SOCKET = 1' + Ab v8.0 wird das Verhalten hingegen über den neuen Parameter +`listen_address' gesteuert. Laufen PostgreSQL und Lx-Office auf +demselben Rechner, so kann dort der Wert `localhost' verwendet werden. +Andernfalls müssen Datenbankverbindungen auch von anderen Rechnern aus +zugelassen werden, was mit dem Wert \`*' geschieht. + Bei PostgreSQL-Versionen ab v8.0 und neuer muss zusätzlich der folgende Parameter gesetzt werden: @@ -159,7 +204,7 @@ zuzulassen. Beispielsweise: host all lxoffice 127.0.0.1 255.255.255.255 password' -4.2 Erweiterung für servergespeicherte Prozeduren +4.3 Erweiterung für servergespeicherte Prozeduren ================================================= In der Datenbank `template1' muss die Unterstützung für @@ -176,7 +221,7 @@ create language 'plpgsql' handler plpgsql_call_handler lancompiler Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so'. -4.3 Datenbankbenutzer anlegen +4.4 Datenbankbenutzer anlegen ============================= Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen