Merge branch 'master' of ssh://lx-office/~/lx-office-erp

[kivitendo-erp.git] / doc / INSTALL.texi

diff --git a/doc/INSTALL.texi b/doc/INSTALL.texi
index f98dba9..43eeda9 100644 (file)
--- a/doc/INSTALL.texi
+++ b/doc/INSTALL.texi
@@ -83,13 +83,17 @@ PDF::API2
 YAML
 @item
 Template
 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:
 
 @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:
 
 
 Für Fedora Core benötigen Sie unter anderem diese Pakete:
 


@@ -99,23 +103,27 @@ F
 
 @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}
 
 
 @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
 
 
 @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
 @*
 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
 
 
 Verändern Sie evtl. noch den Namen des Verzeichnisses mit
 


@@ -125,12 +133,23 @@ Alternativ k
 benutzen, um auf das tatsächliche Installationsverzeichnis zu
 verweisen.
 
 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 ---------------------------------------------------------------
 
 
 @c ---------------------------------------------------------------
 


@@ -140,26 +159,56 @@ core @code{apache} oder bei OpenSuSE @code{wwwrun}).
 PostgreSQL muss auf verschiedene Weisen angepasst werden.
 
 @menu
 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
 
 * Ä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
 @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}
 
 
 @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
 
 In der Datei @code{pg_hba.conf}, die im gleichen Verzeichnis wie die
 @code{postgresql.conf} zu finden sein sollte, müssen die


@@ -196,7 +245,7 @@ lancompiler 'pl/pgsql';}
 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
 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 ---------------------------------------------------------------
 
 
 @c ---------------------------------------------------------------


@@ -362,7 +411,7 @@ den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden:
 @item
 @samp{tls} -- Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen
 @item
 @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.
   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.


@@ -406,7 +455,7 @@ sein sollte:
 @chapter Benutzer- und Gruppenverwaltung
 
 Nach der Installation müssen Benutzer, Gruppen und Datenbanken
 @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}
 unter folgender URL finden:
 
 @uref{http://localhost/lx-erp/admin.pl}


@@ -441,7 +490,7 @@ Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
 Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
 aber beliebig viele Datenbanken mit Firmendaten.
 
 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
 Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
 gestattet, so werden der entsprechenden Menüpunkte auch nicht
 angezeigt. Diese Rechte werden ebenfalls in der