Kurze Beschreibung der Kontomehcanik in der edit_account Maske.

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

diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt
index d4a3ac4..075d483 100644 (file)
--- 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
 
 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
 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)
 
 
    * IO::Wrap (aus dem Paket IO::Stringy)
 

+   * PDF::API2
+

    * YAML
 
    * Template
    * 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.
 
 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
 **********************************
 
 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.
 
    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 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
 =======================================
 
 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'
 
 
    `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:
 
    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'
 
 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
 =================================================
 
 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'.
 
 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
 =============================
 
 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
    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.
 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
 ==================================
 
 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
 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