Reportgeerator: Reportzelle richtig initialisieren.
[kivitendo-erp.git] / doc / INSTALL.txt
index 6f9ef64..475ba9f 100644 (file)
@@ -76,14 +76,19 @@ Bestandteil einer Standard-Perl-Installation sind:
 
    * Template
 
+   * List::MoreUtils
+
+   * Email::Address
+
    Diese Pakete können bei den unterschiedlichen Distributionen anders
 heißen.
 
    Für Debian oder Ubuntu benötigen Sie diese Pakete:
 
-   `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'
+   `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:
 
@@ -95,20 +100,25 @@ libyaml-perl libtext-csv-perl libio-stringy-perl libtemplate-perl'
 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:
+
+   `./scripts/installation_check.pl'
 
 3 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. `/var/www/html/',
 `/srv/www/htdocs' oder `/var/www/') entpackt:
 
    `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
 
@@ -117,12 +127,18 @@ 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 `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/users lx-office-erp/spool
+lx-office-erp/webdav'
 
 4 Anpassung der PostgreSQL-Konfiguration
 ****************************************
@@ -153,7 +169,7 @@ Versionsnummer angepasst werden.
 
    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.
+mit ISO-8859-15 als Encoding betrieben werden.
 
 4.2 Änderungen an Konfigurationsdateien
 =======================================
@@ -161,14 +177,16 @@ mit ISO-8850-15 als Encoding betrieben werden.
 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'
 
-   Bei PostgreSQL-Versionen ab v8.0 und neuer muss zusätzlich der
-folgende Parameter gesetzt werden:
-
-   `default_with_oids = on'
+   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.
 
    In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die
 `postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für
@@ -335,7 +353,7 @@ LDAP-Server in `$self->{LDAP_config}' angegeben werden:
    * `tls' - Wenn Verbindungsverschlüsselung gewünscht ist, so diesen
      Wert auf `1' setzen, andernfalls auf `0' belassen
 
-   * `attribute'' - Das LDAP-Attribut, in dem der Benutzername steht,
+   * `attribute' - Das LDAP-Attribut, in dem der Benutzername steht,
      den der Benutzer eingegeben hat. Für Active-Directory-Server   ist
      dies meist `sAMAccountName', für andere LDAP-Server hingegen
      `uid'. Diese Angabe ist zwingend erforderlich.
@@ -383,7 +401,7 @@ das unter der folgenden URL erreichbar sein sollte:
 *********************************
 
 Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt
-werden.  Dieses geschieht im Administrationsmenü, dass Sie unter
+werden.  Dieses geschieht im Administrationsmenü, das Sie unter
 folgender URL finden:
 
    `http://localhost/lx-erp/admin.pl'
@@ -409,7 +427,7 @@ Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
 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