X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.txt;h=075d483240b2d6c5ccea435fa5196e96b32b1d5f;hb=ca865495f86d40196a33cf279f55b4fc541cbf3c;hp=d4a3ac4d8327bbff4c58b3cdd01f7dfc0203bc70;hpb=8c7e44938a661e035f62840e1e177353240ace5d;p=kivitendo-erp.git diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt index d4a3ac4d8..075d48324 100644 --- a/doc/INSTALL.txt +++ b/doc/INSTALL.txt @@ -1,14 +1,15 @@ -Inhaltsverzeichnis -****************** +Table of Contents +***************** Inhalt der Anleitung 1 Aktuelle Hinweise 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 @@ -69,6 +70,8 @@ Bestandteil einer Standard-Perl-Installation sind: * IO::Wrap (aus dem Paket IO::Stringy) + * PDF::API2 + * YAML * Template @@ -97,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 ********************************** @@ -114,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'). - `chown -R www-data: lx-office-erp/' + Der folgende Befehl ändert den Besitzer für die oben genannten +Verzeichnisse auf einem Debian/Ubuntu-System: + + `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: @@ -157,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 @@ -174,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 @@ -246,7 +293,7 @@ LDAP-Server Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss -bei der Installation und bei einem Upgrade von einer Version vor v2.4.4 +bei der Installation und bei einem Upgrade von einer Version vor v2.6.0 angelegt werden. Eine Beispielkonfigurationsdatei `config/authentication.pl.default' existiert, die als Vorlage benutzt werden kann. @@ -470,7 +517,7 @@ zugewiesen werden. Dazu gibt es zwei M 7.6 Migration alter Installationen ================================== -Wenn Lx-Office 2.4.4 über eine ältere Version installiert wird, in der +Wenn Lx-Office 2.6.0 über eine ältere Version installiert wird, in der die Benutzerdaten noch im Dateisystem im Verzeichnis `users' verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten automatisch in die Authentifizierungsdatenbank zu übernehmen. Dies