CGI::Ajax entfernt.

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

diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt
index 0518df0..7a9e993 100644 (file)
--- a/doc/INSTALL.txt
+++ b/doc/INSTALL.txt
@@ -1,32 +1,41 @@
-Table of Contents
-*****************
+Inhaltsverzeichnis
+******************

 
 Inhalt der Anleitung
 1 Aktuelle Hinweise
 2 Benötigte Software und Pakete
 
 Inhalt der Anleitung
 1 Aktuelle Hinweise
 2 Benötigte Software und Pakete

-3 Installation des Programmpaketes
+  2.1 Betriebssystem
+  2.2 Pakete
+3 Manuelle Installation des Programmpaketes

 4 Anpassung der PostgreSQL-Konfiguration
   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
 4 Anpassung der PostgreSQL-Konfiguration
   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
-  6.2 Administratorpasswort
-  6.3 Authentifizierungsdatenbank
-  6.4 Passwortüberprüfung
-  6.5 Name des Session-Cookies
-  6.6 Anlegen der Authentifizierungsdatenbank
-7 Benutzer- und Gruppenverwaltung
-  7.1 Zusammenhänge
-  7.2 Datenbanken anlegen
-  7.3 Gruppen anlegen
-  7.4 Benutzer anlegen
-  7.5 Gruppenmitgliedschaften verwalten
-  7.6 Migration alter Installationen
-8 OpenDocument-Vorlagen
-9 Lx-Office ERP verwenden
+6 Der Task-Server
+  6.1 Verfügbare und notwendige Konfigurationsoptionen
+  6.2 Automatisches Starten des Task-Servers beim Booten
+    6.2.1 SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)
+    6.2.2 Upstart-basierende Systeme (z.B. Ubuntu)
+  6.3 Wie der Task-Server gestartet und beendet wird
+7 Benutzerauthentifizierung und Administratorpasswort
+  7.1 Grundlagen zur Benutzerauthentifizierung
+  7.2 Administratorpasswort
+  7.3 Authentifizierungsdatenbank
+  7.4 Passwortüberprüfung
+  7.5 Name des Session-Cookies
+  7.6 Anlegen der Authentifizierungsdatenbank
+8 Benutzer- und Gruppenverwaltung
+  8.1 Zusammenhänge
+  8.2 Datenbanken anlegen
+  8.3 Gruppen anlegen
+  8.4 Benutzer anlegen
+  8.5 Gruppenmitgliedschaften verwalten
+  8.6 Migration alter Installationen
+9 Drucken mit Lx-Office
+10 OpenDocument-Vorlagen
+11 Lx-Office ERP verwenden

 
 
 Inhalt der Anleitung
 
 
 Inhalt der Anleitung


@@ -48,17 +57,83 @@ Aktuelle Installations- und Konfigurationshinweise gibt es:
 2 Benötigte Software und Pakete
 ********************************
 
 2 Benötigte Software und Pakete
 ********************************
 

+2.1 Betriebssystem
+==================
+
+Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden
+Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im
+speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl
+der Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme
+auf den derzeit aktuellen verbreiteten Distributionen läuft.
+
+   Anfang 2011 sind das folgende Systeme:
+
+   * Ubuntu 8.04 LTS Hardy Heron
+
+   * Ubuntu 9.10 Karmic Koala
+
+   * Ubuntu 10.04 Lucid Lynx
+
+   * Ubuntu 10.10 Maverick Meerkat
+
+   * Debian 5.0 Lenny
+
+   * Debian 6.0 Squeeze
+
+   * openSUSE 11.2
+
+   * openSUSE 11.3
+
+   * SuSE Linux Enterprice Server 11
+
+   * Fedora 13
+
+   * Fedora 14
+
+   Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich
+einfacher zu installieren ist.
+
+   Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im
+Archiv recht alt sind, und das viele der benötigten Module nicht
+einfach zu installieren sind. Dafür sollte es kurz nach dem Release ein
+eigenes .deb geben.
+
+   Alternativ dazu kann die normale Installation durchgeführt werden
+(*note Manuelle Installation des Programmpaketes::), wenn vorher ein
+Kompatibilitätspaket installiert wird, das die fehlenden Pakete
+bereitstellt.  Das Paket ist auf Sourceforge
+(https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/)
+unter dem Namen `lx-erp-perl-libs-compat-v2.tar.gz' hinterlegt.
+
+   Zur Installation das Paket in das entpackte Lx-Office Verzeichnis
+entpacken:
+
+   `tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/'
+
+   Zusätzlich müssen dann noch die folgenden Pakete installiert weerden
+
+   `libbit-vector-perl libsub-exporter-perl libclone-perl
+libclass-factory-util-perl'
+
+   Danach sollte der Installationscheck (*note Pakete::) die
+enthaltenen Pakete erkennen.
+
+2.2 Pakete
+==========
+

 Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)
 Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)

-und ein Datenbankserver (PostgreSQL) benötigt.
+und ein Datenbankserver (PostgreSQL, mindestens v8.2) benötigt.

 
    Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht
 Bestandteil einer Standard-Perl-Installation sind:
 
 
    Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht
 Bestandteil einer Standard-Perl-Installation sind:
 

+   * parent
+

    * Archive::Zip
 
    * Class::Accessor
 
    * Archive::Zip
 
    * Class::Accessor
 

-   * CGI::Ajax
+   * Config::Std

 
    * DateTime
 
 
    * DateTime
 


@@ -70,9 +145,9 @@ Bestandteil einer Standard-Perl-Installation sind:
 
    * List::MoreUtils
 
 
    * List::MoreUtils
 

-   * PDF::API2
+   * Params::Validate

 
 

-   * Readonly (benötigt) und Readonly::XS (optional)
+   * PDF::API2

 
    * Rose::Object
 
 
    * Rose::Object
 


@@ -95,6 +170,10 @@ Bestandteil einer Standard-Perl-Installation sind:
    Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete hinzugekommen,
 `URI' und `XML::Writer' sind notwendig. Ohne startet Lx-Office nicht.
 
    Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete hinzugekommen,
 `URI' und `XML::Writer' sind notwendig. Ohne startet Lx-Office nicht.
 

+   Gegenüber Version 2.6.1 sind `parent', `DateTime', `Rose::Object',
+`Rose::DB' und `Rose::DB::Object' neu hinzugekommen. `IO::Wrap' wurde
+entfernt.
+

    `Email::Address' und `List::MoreUtils' sind schon länger feste
 Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert.  Beide
 sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer
    `Email::Address' und `List::MoreUtils' sind schon länger feste
 Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert.  Beide
 sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer


@@ -102,48 +181,52 @@ zukünftigen Version aber aus dem Paket entfernt werden. Es wird
 empfohlen diese Module zusammen mit den anderen als Bibliotheken zu
 installieren.
 
 empfohlen diese Module zusammen mit den anderen als Bibliotheken zu
 installieren.
 

-   `CGI::Ajax' ist nach wie vor in einer modifizierten Version
-mitgeliefert und braucht nicht nachinstalliert werden.
-

    Die zu installierenden Pakete können in den verschiedenen
 Distributionen unterschiedlich heißen.
 
    Für Debian oder Ubuntu benötigen Sie diese Pakete:
 
    Die zu installierenden Pakete können in den verschiedenen
 Distributionen unterschiedlich heißen.
 
    Für Debian oder Ubuntu benötigen Sie diese Pakete:
 

-   `apache2 postgresql libarchive-zip-perl libclass-accessor-perl
-libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl
-libemail-address-perl libio-stringy-perl liblist-moreutils-perl
-libpdf-api2-perl libtemplate-perl libtext-csv-xs-perl
-libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl'
+   `apache2 postgresql libparent-perl libarchive-zip-perl
+libclass-accessor-perl libdatetime-perl libdbi-perl libdbd-pg-perl
+libpg-perl libemail-address-perl liblist-moreutils-perl
+libpdf-api2-perl librose-object-perl librose-db-perl
+librose-db-object-perl libtemplate-perl libtext-csv-xs-perl
+libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl
+libconfig-std-perl libparams-validate-perl'

 
    Für Fedora Core benötigen Sie diese Pakete:
 
 
    Für Fedora Core benötigen Sie diese Pakete:
 

-   `httpd postgresql-server perl-Class-Accessor perl-DateTime perl-DBI
-perl-DBD-Pg perl-Email-Address perl-IO-stringy perl-List-MoreUtils
-perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv
-perl-URI perl-XML-Writer perl-YAML'
+   `httpd postgresql-server perl-parent perl-Class-Accessor
+perl-DateTime perl-DBI perl-DBD-Pg perl-Email-Address
+perl-List-MoreUtils perl-PDF-API2 perl-Rose-Object perl-Rose-DB
+perl-Rose-DB-Object perl-Template-Toolkit perl-Text-CSV_XS
+perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML'

 
    Für OpenSuSE benötigen Sie diese Pakete:
 
    `apache2 postgresql-server perl-Archive-Zip perl-Class-Accessor
 
    Für OpenSuSE benötigen Sie diese Pakete:
 
    `apache2 postgresql-server perl-Archive-Zip perl-Class-Accessor

-perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-IO-stringy
-perl-List-MoreUtils perl-PDF-API2 perl-Template-Toolkit
-perl-Text-CSV_XS perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML'
+perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-List-MoreUtils
+perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv
+perl-URI perl-XML-Writer perl-YAML'
+
+   Bei openSuSE 11 ist `parent' bereits enthalten, und braucht nicht
+nachinstalliert werden. Die `Rose::*' Pakete sind derzeit nicht für
+SuSE gepackt, und müssen anderweitig nachinstalliert werden.

 
    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'
 
 
    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 Manuelle Installation des Programmpaketes
+*******************************************

 
 

-Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.1.tgz) wird im
+Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.2.tgz) wird im

 Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/',
 `/srv/www/htdocs' oder `/var/www/') entpackt:
 
    `cd /var/www
 Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/',
 `/srv/www/htdocs' oder `/var/www/') entpackt:
 
    `cd /var/www

-tar xvzf lxoffice-erp-2.6.1.tgz'
+tar xvzf lxoffice-erp-2.6.2.tgz'

 
    Verändern Sie evtl. noch den Namen des Verzeichnisses mit
 
 
    Verändern Sie evtl. noch den Namen des Verzeichnisses mit
 


@@ -211,16 +294,11 @@ mit ISO-8859-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
 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. 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.
+TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den
+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
 
    In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die
 `postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für


@@ -246,6 +324,13 @@ servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür
 als Benutzer "postgres" an der Datenbank an, und führen Sie die
 folgenden Kommandos aus:
 
 als Benutzer "postgres" an der Datenbank an, und führen Sie die
 folgenden Kommandos aus:
 

+   `create language 'plpgsql';'
+
+   Achtung: In älteren Postgresversionen (vor 8.0) muss der Handler für
+die Sprache manuell anlelegt werden, diese Versionen werden aber nicht
+mehr offiziell von Lx-Office unterstützt. Dafür dann die folgenden
+Kommandos:
+

    `create function plpgsql_call_handler () returns opaque as
 '/usr/lib/pgsql/plpgsql.so' language 'c';
 create language 'plpgsql' handler plpgsql_call_handler lancompiler
    `create function plpgsql_call_handler () returns opaque as
 '/usr/lib/pgsql/plpgsql.so' language 'c';
 create language 'plpgsql' handler plpgsql_call_handler lancompiler


@@ -253,8 +338,7 @@ create language 'plpgsql' handler plpgsql_call_handler lancompiler
 
    Bitte beachten Sie, dass der Pfad zur Datei `plpgsql.so' von
 Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu
 
    Bitte beachten Sie, dass der Pfad zur Datei `plpgsql.so' von
 Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu

-befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so', bei
-Ubuntu 9.10 unter `/usr/lib/postgresql/8.4/lib/plpgsql.so'.
+befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so'.

 
 4.4 Datenbankbenutzer anlegen
 =============================
 
 4.4 Datenbankbenutzer anlegen
 =============================


@@ -273,7 +357,11 @@ hier gewählten Benutzernamen.
 5 Apache-Konfiguration
 **********************
 
 5 Apache-Konfiguration
 **********************
 

-Der Zugriff auf das Programmverzeichnis muss in der Apache
+Hinweis: Für einen deutlichen Performanceschub sorgt die Ausführung
+mittels FCGI. Die Einrichtung wird ausführlich in der Datei
+`INSTALL.fcgi' beschrieben.
+
+   Der Zugriff auf das Programmverzeichnis muss in der Apache

 Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie
 den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu,
 die beim Starten des Webservers eingelesen wird:
 Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie
 den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu,
 die beim Starten des Webservers eingelesen wird:


@@ -302,13 +390,110 @@ Option in die Konfiguration aufzunehmen:
 
    `EnableSendfile Off'
 
 
    `EnableSendfile Off'
 

-6 Benutzerauthentifizierung und Administratorpasswort
+6 Der Task-Server
+*****************
+
+Der Task-Server ist ein Prozess, der im Hintergrund läuft, in
+regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese zu
+festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser Prozess
+wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
+benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
+bekommen.
+
+6.1 Verfügbare und notwendige Konfigurationsoptionen
+=====================================================
+
+Die Konfiguration erfolgt über den Abschnitt `[task_server]' in der
+Datei `config/lx_office.conf'. Die dort verfügbaren Optionen sind:
+
+   * `login': gültiger Lx-Office-Benutzername, der benutzt wird, um die
+     zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss
+     in der Administration angelegt werden. Diese Option muss angegeben
+     werden.
+
+   * `run_as': Wird der Server vom Systembenutzer `root' gestartet, so
+     wechselt er auf den mit `run_as' angegebenen Systembenutzer. Der
+     Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie
+     auch der Webserverbenutzer (siehe *note Manuelle Installation des
+     Programmpaketes::). Daher ist es sinnvoll, hier denselben
+     Systembenutzer einzutragen, unter dem auch der Webserver läuft.
+
+   * `debug': Schaltet Debug-Informationen an und aus.
+
+6.2 Automatisches Starten des Task-Servers beim Booten
+======================================================
+
+Der Task-Server verhält sich von seinen Optionen her wie ein reguläres
+SystemV-kompatibles Boot-Script. Außerdem wechselt er beim Starten
+automatisch in das Lx-Office-Installationsverzeichnis.
+
+   Deshalb ist es möglich, ihn durch Setzen eines symbolischen Links aus
+einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess
+einzubinden. Da das bei neueren Linux-Distributionen aber nicht
+zwangsläufig funktioniert, werden auch Start-Scripte mitgeliefert, die
+anstelle eines symbolischen Links verwendet werden können.
+
+6.2.1 SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)
+---------------------------------------------------------------------
+
+Kopieren Sie die Datei `scripts/boot/system-v/lx-office-task-server'
+nach `/etc/init.d/lx-office-task-server'. Passen Sie in der kopierten
+Datei den Pfad zum Task-Server an (Zeile `DAEMON=....'). Binden Sie das
+Script in den Boot-Prozess ein. Dies ist distributionsabhängig:
+
+   * Debian-basierende Systeme:
+     `update-rc.d lx-office-task-server defaults
+     # Nur bei Debian Squeeze und neuer:
+     insserv lx-office-task-server'
+
+   * OpenSuSE und Fedora Core:
+     `chkconfig --add lx-office-task-server'
+
+   Danach kann der Task-Server mit dem folgenden Befehl gestartet
+werden: `/etc/init.d/lx-office-task-server start'
+
+6.2.2 Upstart-basierende Systeme (z.B. Ubuntu)
+----------------------------------------------
+
+Kopieren Sie die Datei
+`scripts/boot/upstart/lx-office-task-server.conf' nach
+`/etc/init/lx-office-task-server.conf'. Passen Sie in der kopierten
+Datei den Pfad zum Task-Server an (Zeile `exec ....').
+
+   Danach kann der Task-Server mit dem folgenden Befehl gestartet
+werden: `service lx-office-task-server start'
+
+6.3 Wie der Task-Server gestartet und beendet wird
+==================================================
+
+Der Task-Server wird wie folgt kontrolliert:
+
+   `./scripts/task_server.pl Befehl'
+
+   `Befehl' ist dabei eine der folgenden Optionen:
+
+   * `start' startet eine neue Instanz des Task-Servers. Die Prozess-ID
+     wird innerhalb des `users'-Verzeichnisses abgelegt.
+
+   * `stop' beendet einen laufenden Task-Server.
+
+   * `restart' beendet und startet ihn neu.
+
+   * `status' berichtet, ob der Task-Server läuft.
+
+   Der Task-Server wechselt beim Starten automatisch in das
+Lx-Office-Installationsverzeichnis.
+
+   Dieselben Optionen können auch für die SystemV-basierenden
+Runlevel-Scripte benutzt werden (siehe oben).
+
+7 Benutzerauthentifizierung und Administratorpasswort

 *****************************************************
 
 Informationen über die Einrichtung der Benutzerauthentifizierung, über
 die Verwaltung von Gruppen und weitere Einstellungen
 
 *****************************************************
 
 Informationen über die Einrichtung der Benutzerauthentifizierung, über
 die Verwaltung von Gruppen und weitere Einstellungen
 

-6.1 Grundlagen zur Benutzerauthentifizierung
+7.1 Grundlagen zur Benutzerauthentifizierung

 ============================================
 
 Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die
 ============================================
 
 Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die


@@ -327,13 +512,13 @@ LDAP-Server überprüft werden.
 
    Welche Art der Passwortüberprüfung Lx-Office benutzt und wie
 Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der
 
    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.6.0
+Konfigurationsdatei `config/lx_office.conf' festgelegt. Diese muss bei
+der Installation und bei einem Upgrade von einer Version vor v2.6.0

 angelegt werden. Eine Beispielkonfigurationsdatei
 angelegt werden. Eine Beispielkonfigurationsdatei

-`config/authentication.pl.default' existiert, die als Vorlage benutzt
+`config/lx_office.conf.default' existiert, die als Vorlage benutzt

 werden kann.
 
 werden kann.
 

-6.2 Administratorpasswort
+7.2 Administratorpasswort

 =========================
 
 Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt
 =========================
 
 Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt


@@ -341,7 +526,7 @@ wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort
 und nicht mehr im Administrationsinterface selber geändert werden. Der
 Parameter dazu heißt `$self->{admin_password}'.
 
 und nicht mehr im Administrationsinterface selber geändert werden. Der
 Parameter dazu heißt `$self->{admin_password}'.
 

-6.3 Authentifizierungsdatenbank
+7.3 Authentifizierungsdatenbank

 ===============================
 
 Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern
 ===============================
 
 Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern


@@ -362,7 +547,7 @@ anzugeben:
    Die Datenbank muss noch nicht existieren. Lx-Office kann sie
 automatisch anlegen (mehr dazu siehe unten).
 
    Die Datenbank muss noch nicht existieren. Lx-Office kann sie
 automatisch anlegen (mehr dazu siehe unten).
 

-6.4 Passwortüberprüfung
+7.4 Passwortüberprüfung

 =========================
 
 Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die
 =========================
 
 Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die


@@ -411,7 +596,7 @@ LDAP-Server in `$self->{LDAP_config}' angegeben werden:
      Benutzers   eingegeben werden; in diesem Beispiel also `Martin
      Mustermann'.
 
      Benutzers   eingegeben werden; in diesem Beispiel also `Martin
      Mustermann'.
 

-6.5 Name des Session-Cookies
+7.5 Name des Session-Cookies

 ============================
 
 Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt
 ============================
 
 Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt


@@ -422,17 +607,17 @@ unterschiedlich sein. Der Name des Cookies wird mit dem Parameter
    Diese Angabe ist optional, wenn nur eine Installation auf dem Server
 existiert.
 
    Diese Angabe ist optional, wenn nur eine Installation auf dem Server
 existiert.
 

-6.6 Anlegen der Authentifizierungsdatenbank
+7.6 Anlegen der Authentifizierungsdatenbank

 ===========================================
 
 ===========================================
 

-Nachdem alle Einstellungen in `config/authentication.pl' vorgenommen
+Nachdem alle Einstellungen in `config/lx_office.conf' vorgenommen

 wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses
 geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden,
 das unter der folgenden URL erreichbar sein sollte:
 
    `http://localhost/lx-erp/admin.pl'
 
 wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses
 geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden,
 das unter der folgenden URL erreichbar sein sollte:
 
    `http://localhost/lx-erp/admin.pl'
 

-7 Benutzer- und Gruppenverwaltung
+8 Benutzer- und Gruppenverwaltung

 *********************************
 
 Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt
 *********************************
 
 Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt


@@ -442,9 +627,9 @@ folgender URL finden:
    `http://localhost/lx-erp/admin.pl'
 
    Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei
    `http://localhost/lx-erp/admin.pl'
 
    Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei

-`config/authentication.pl' eingetragen haben.
+`config/lx_office.conf' eingetragen haben.

 
 

-7.1 Zusammenhänge
+8.1 Zusammenhänge

 ==================
 
 Lx-Office verwendet eine Datenbank zum Speichern all seiner
 ==================
 
 Lx-Office verwendet eine Datenbank zum Speichern all seiner


@@ -486,7 +671,7 @@ angelegt werden sollten, lautet:
 
   4. Benutzer den Gruppen zuordnen
 
 
   4. Benutzer den Gruppen zuordnen
 

-7.2 Datenbanken anlegen
+8.2 Datenbanken anlegen

 =======================
 
 Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den
 =======================
 
 Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den


@@ -496,9 +681,9 @@ ist dies `lxoffice').
    Wenn Sie für die Lx-Office-Installation nicht den europäischen
 Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
 müssen Sie vor dem Anlegen der Datenbank in der Datei
    Wenn Sie für die Lx-Office-Installation nicht den europäischen
 Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
 müssen Sie vor dem Anlegen der Datenbank in der Datei

-`config/lx-erp.conf' die Variable `$dbcharset' auf den Wert `UTF-8'
-setzen. Zusätzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als
-Schriftsatz ausgewählt werden.
+`config/lx_office.conf' die Variable `dbcharset' im Abschnitt `system'
+auf den Wert `UTF-8' setzen. Zusätzlich muss beim Anlegen der Datenbank
+`UTF-8 Unicode' als Schriftsatz ausgewählt werden.

 
    Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
 verwenden müssen, da diese Einstellungen momentan global in Lx-Office
 
    Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
 verwenden müssen, da diese Einstellungen momentan global in Lx-Office


@@ -506,7 +691,7 @@ vorgenommen wird und nicht nach Datenbank unterschieden werden kann.
 Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
 angelegt worden sein.
 
 Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
 angelegt worden sein.
 

-7.3 Gruppen anlegen
+8.3 Gruppen anlegen

 ===================
 
 Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name
 ===================
 
 Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name


@@ -518,7 +703,7 @@ Mitglieder dieser Gruppe Zugriff haben sollen.
 Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle
 Datenbanken, die in dieser Installation verwaltet werden.
 
 Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle
 Datenbanken, die in dieser Installation verwaltet werden.
 

-7.4 Benutzer anlegen
+8.4 Benutzer anlegen

 ====================
 
 Beim Anlegen von Benutzern werden für viele Parameter
 ====================
 
 Beim Anlegen von Benutzern werden für viele Parameter


@@ -534,7 +719,7 @@ aktiv, so ist das Passwort-Feld deaktiviert.
    In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben
 angelegten Datenbanken eingetragen werden.
 
    In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben
 angelegten Datenbanken eingetragen werden.
 

-7.5 Gruppenmitgliedschaften verwalten
+8.5 Gruppenmitgliedschaften verwalten

 =====================================
 
 Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen
 =====================================
 
 Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen


@@ -549,10 +734,10 @@ zugewiesen werden. Dazu gibt es zwei Möglichkeiten:
      Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in
      der ausgewählten Spalte hinzugefügt.
 
      Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in
      der ausgewählten Spalte hinzugefügt.
 

-7.6 Migration alter Installationen
+8.6 Migration alter Installationen

 ==================================
 
 ==================================
 

-Wenn Lx-Office 2.6.1 über eine ältere Version installiert wird, in der
+Wenn Lx-Office 2.6.2 ü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


@@ -569,21 +754,60 @@ das Verhalten von Lx-Office bis Version 2.4.3 inklusive
 wiederhergestellt, und die Benutzer können sich sofort wieder anmelden
 und mit dem System arbeiten.
 
 wiederhergestellt, und die Benutzer können sich sofort wieder anmelden
 und mit dem System arbeiten.
 

-8 OpenDocument-Vorlagen
+9 Drucken mit Lx-Office

 ***********************
 
 ***********************
 

+Das Drucksystem von Lx-Office benutzt von Haus aus LaTeX Vorlagen. Um
+drucken zu können, braucht der Server ein geeignetes LaTeX System. Am
+einfachsten ist dazu eine `texlive' Installation. Unter Debianoiden
+Betriebssystemen sind das die Pakete:
+
+   `texlive-latex-base texlive-latex-extra texlive-fonts-recommended'
+
+   Diese hinteren beiden enthalten Bibliotheken und Schriftarten die
+von den Standardvorlagen verwendet werden.
+
+   TODO: rpm Pakete.
+
+   In den allermeisten Installationen sollte drucken jetzt schon
+funktionieren.  Sollte ein Fehler auftreten wirft TeX sehr lange
+Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeite
+die mit einem Ausrufezeichen anfängt. Häufig auftretende Fehler sind
+zum Beispiel:
+
+   * ! LaTeX Error: File `eurosym.sty' not found.  Die entsprechende
+     LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor allem bei
+     Vorlagen aus der Community auf. Installieren Sie die
+     entsprechenden Pakete.
+
+   * ! Package inputenc Error: Unicode char \u8:æ¡\9c not set up for use
+     with LaTeX.  Dieser Fehler tritt auf, wenn sie versuchen mit einer
+     Standardinstallation exotische utf8 Zeichen zu drucken. TeXLive
+     unterstützt von Haus nur romanische Schriften und muss mit
+     diversen Tricks dazu gebracht werden andere Zeichen zu
+     akzeptieren. Adere TeX Systeme wie XeTeX schaffen hier Abhilfe.
+
+   Wird garkein Fehler angezeigt sondern nur der Name des Templates,
+heißt das normalerweise, dass das LaTeX Binary nicht gefunden wurde.
+Prüfen Sie den Namen in der Konfiguration (Standard: `pdflatex'), und
+stellen Sie sicher, dass pdflatex (oder das von Ihnen verwendete
+System) vom Webserver ausgeführt werden darf.
+
+10 OpenDocument-Vorlagen
+************************
+

 Lx-Office unterstützt die Verwendung von Vorlagen im
 OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
 Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus
 diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
 OpenDocument-Vorlagen zu aktivieren muss in der Datei
 Lx-Office unterstützt die Verwendung von Vorlagen im
 OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
 Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus
 diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
 OpenDocument-Vorlagen zu aktivieren muss in der Datei

-`config/lx-erp.conf' die Variable `$opendocument_templates' auf `1'
-stehen.  Dieses ist die Standardeinstellung.
+`config/lx_office.conf' die Variable `opendocument' im Abschnitt
+`print_templates' auf `1' stehen.  Dieses ist die Standardeinstellung.

 
 

-   Weiterhin muss in der Datei `config/lx-erp.conf' die Variable
-`$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der
-Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den
-meisten Fällen "UTF-8".
+   Weiterhin muss in der Datei `config/lx_office.conf' die Variable
+`dbcharset' im Abschnitt `system' auf die Zeichenkodierung gesetzt
+werden, die auch bei der Speicherung der Daten in der Datenbank
+verwendet wird. Diese ist in den meisten Fällen "UTF-8".

 
    Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
 
    Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF


@@ -592,10 +816,11 @@ neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer"
 (xvfb) installiert werden.  Bei Debian ist er im Paket "xvfb"
 enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
 
 (xvfb) installiert werden.  Bei Debian ist er im Paket "xvfb"
 enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
 

-   Nach der Installation müssen in der Datei `config/lx-erp.conf' zwei
-weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss
+   Nach der Installation müssen in der Datei `config/lx_config.conf'
+zwei weitere Variablen angepasst werden: `openofficeorg_writer' muss

 den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
 den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.

-`$xvfb_bin' muss den Pfad zum "X virtual frame buffer" enthalten.
+`xvfb' muss den Pfad zum "X virtual frame buffer" enthalten. Beide
+stehen im Abschnitt `applications'.

 
    Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
 
    Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die


@@ -625,12 +850,12 @@ z.B. einfach nur `.openoffice', so wäre folgender Befehl auszuführen:
    `mv users/.openoffice.org2 users/.openoffice'
 
    Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss
    `mv users/.openoffice.org2 users/.openoffice'
 
    Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss

-vom Webserver beschreibbar sein. Dieses wurde in Schritt `Installation
-des Programmpakets' oben bereits erledigt, kann aber erneut überprüft
+vom Webserver beschreibbar sein. Dieses wurde bereits erledigt (*note
+Manuelle Installation des Programmpaketes::), kann aber erneut überprüft

 werden, wenn die Konvertierung nach PDF fehlschlägt.
 
 werden, wenn die Konvertierung nach PDF fehlschlägt.
 

-9 Lx-Office ERP verwenden
-*************************
+11 Lx-Office ERP verwenden
+**************************

 
 Nach erfolgreicher Installation ist der Loginbildschirm unter folgender
 URL erreichbar:
 
 Nach erfolgreicher Installation ist der Loginbildschirm unter folgender
 URL erreichbar:


@@ -641,3 +866,8 @@ URL erreichbar:
 
    `http://localhost/lx-office-erp/admin.pl'
 
 
    `http://localhost/lx-office-erp/admin.pl'
 

+
+\1f
+Local Variables:
+coding: utf-8
+End: