-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
* IO::Wrap (aus dem Paket IO::Stringy)
+ * PDF::API2
+
* YAML
* Template
Für Debian oder Ubuntu benötigen Sie diese Pakete:
- `apache postgresql libdbi-perl libdbd-pg-perl libpgperl
+ `apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl
libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl
libyaml-perl libtext-csv-perl libio-stringy-perl libtemplate-perl'
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
**********************************
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:
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
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
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.
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