YAML
@item
Template
+@item
+List::MoreUtils
+@item
+Email::Address
@end itemize
Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
Für Debian oder Ubuntu benötigen Sie diese Pakete:
-@code{apache postgresql libdbi-perl libdbd-pg-perl libpgperl libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl libyaml-perl libtext-csv-perl libio-stringy-perl libtemplate-perl}
+@code{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}
Für Fedora Core benötigen Sie unter anderem diese Pakete:
@code{apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy perl-Template-Toolkit}
-Da Perl-CGI-Ajax nicht als Paket für Distributionen bereit steht, muß
-es mit der CPAN-Shell installiert werden. Leider gibt es Fälle, in
-denen das nicht möglich oder praktikabel ist. Lx-Office liefert daher
-das Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.
+Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als
+Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren.
+In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback.
+
+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:
+
+@code{./scripts/installation_check.pl}
@c ---------------------------------------------------------------
@node Installation des Programmpaketes
@chapter Installation des Programmpaketes
-Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) wird im
+Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.0.tgz) wird im
Dokumentenverzeichnis des Webservers (z.B. @code{/var/www/html/},
@code{/srv/www/htdocs} oder @code{/var/www/}) entpackt:
@code{cd /var/www
@*
-tar xvzf lxoffice-erp-2.4.x.tgz}
+tar xvzf lxoffice-erp-2.6.0.tgz}
Verändern Sie evtl. noch den Namen des Verzeichnisses mit
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 @code{www-data}, bei Fedora
-core @code{apache} oder bei OpenSuSE @code{wwwrun}).
+Die Verzeichnisse @code{users}, @code{spool} und @code{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 @code{www-data}, bei Fedora core @code{apache}
+oder bei OpenSuSE @code{wwwrun}).
+
+Der folgende Befehl ändert den Besitzer für die oben genannten
+Verzeichnisse auf einem Debian/Ubuntu-System:
+
+@code{chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav}
+
+Weiterhin muss der Webserver-Benutzer im Verzeichnis @code{templates} Verzeichnisse für
+jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen:
+
+@code{chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates}
-@code{chown -R www-data: lx-office-erp/}
@c ---------------------------------------------------------------
PostgreSQL muss auf verschiedene Weisen angepasst werden.
@menu
+* Zeichensätze/die Verwendung von UTF-8:: Was bei der Verwendung von UTF-8 zu beachten ist
* Änderungen an Konfigurationsdateien:: Anpassungen für Anmeldung am Server und Featureunterstützung
* Erweiterung für servergespeicherte Prozeduren:: Lx-Office benutzt servergespeicherte Prozeduren
* Datenbankbenutzer anlegen:: Um den Zugriff besser zu reglementieren
@end menu
+@node Zeichensätze/die Verwendung von UTF-8
+@section 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:
+
+@code{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-8859-15 als Encoding betrieben werden.
+
+Das Encoding einer Datenbank kann in @code{psql} mit @code{\l} geprüft werden.
+
@node Änderungen an Konfigurationsdateien
@section Änderungen an Konfigurationsdateien
In der Datei @code{postgresql.conf}, die je nach Distribution in
verschiedenen Verzeichnissen liegen kann
(z.B. @code{/var/lib/pgsql/data/} oder @code{/etc/postgresql/}, muss
-sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Dieser
-Parameter lautet
+sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für
+PostgreSQL vor Version v8.0 lautete dieser Parameter
@code{TCPIP_SOCKET = 1}
-Bei PostgreSQL-Versionen ab v8.0 und neuer muss zusätzlich der
-folgende Parameter gesetzt werden:
-
-@code{default_with_oids = on}
+Ab v8.0 wird das Verhalten hingegen über den neuen Parameter
+@code{listen_address} gesteuert. Laufen PostgreSQL und Lx-Office auf
+demselben Rechner, so kann dort der Wert @code{localhost} verwendet
+werden. Andernfalls müssen Datenbankverbindungen auch von anderen
+Rechnern aus zugelassen werden, was mit dem Wert \@code{*} geschieht.
In der Datei @code{pg_hba.conf}, die im gleichen Verzeichnis wie die
@code{postgresql.conf} zu finden sein sollte, müssen die
Bitte beachten Sie, dass der Pfad zur Datei @code{plpgsql.so} von
Distribution zu Distribution verschiedlich sein kann. Bei
Debian/Ubuntu befindet sie sich unter
-@code{/usr/lib/postgresql/lib/plpgsql.so}.
+@code{/usr/lib/postgresql/lib/plpgsql.so}, bei Ubuntu 9.10 unter @code{/usr/lib/postgresql/8.4/lib/plpgsql.so}.
@c ---------------------------------------------------------------
@item
@samp{tls} -- Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen
@item
-@samp{attribute'} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server
+@samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server
ist dies meist @samp{sAMAccountName}, für andere LDAP-Server hingegen @samp{uid}. Diese Angabe ist zwingend erforderlich.
@item
@samp{base_dn} -- Der Abschnitt des LDAP-Baumes, der durchsucht werden soll. Diese Angabe ist zwingend erforderlich.
@chapter Benutzer- und Gruppenverwaltung
Nach der Installation müssen Benutzer, Gruppen und Datenbanken
-angelegt werden. Dieses geschieht im Administrationsmenü, dass Sie
+angelegt werden. Dieses geschieht im Administrationsmenü, das Sie
unter folgender URL finden:
@uref{http://localhost/lx-erp/admin.pl}
Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
aber beliebig viele Datenbanken mit Firmendaten.
-Lx-Office lann seinen Benutzern Zugriff auf bestimmte
+Lx-Office kann seinen Benutzern Zugriff auf bestimmte
Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
gestattet, so werden der entsprechenden Menüpunkte auch nicht
angezeigt. Diese Rechte werden ebenfalls in der