From 39807402e4166e71cd51d87fd492d26e58a734f5 Mon Sep 17 00:00:00 2001 From: Moritz Bunkus Date: Fri, 3 Jun 2011 16:23:58 +0200 Subject: [PATCH] =?utf8?q?Dokumentation=20zum=20Task-Server=20und=20Start-?= =?utf8?q?Scripte=20f=C3=BCr=20ihn?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit --- doc/INSTALL.html | 234 ++++++++++++++---- doc/INSTALL.texi | 116 ++++++++- doc/INSTALL.txt | 168 ++++++++++--- doc/Lx-Office_Installation_DE.pdf | Bin 145940 -> 155548 bytes doc/Makefile | 2 +- doc/UPGRADE | 9 + scripts/boot/system-v/lx-office-task-server | 49 ++++ .../boot/upstart/lx-office-task-server.conf | 13 + 8 files changed, 503 insertions(+), 88 deletions(-) create mode 100755 scripts/boot/system-v/lx-office-task-server create mode 100644 scripts/boot/upstart/lx-office-task-server.conf diff --git a/doc/INSTALL.html b/doc/INSTALL.html index 8048a890f..b4433e1ed 100644 --- a/doc/INSTALL.html +++ b/doc/INSTALL.html @@ -40,26 +40,36 @@
  • 4.4 Datenbankbenutzer anlegen
  • 5 Apache-Konfiguration -
  • 6 Benutzerauthentifizierung und Administratorpasswort +
  • 6 Der Task-Server -
  • 7 Benutzer- und Gruppenverwaltung +
  • 7 Benutzerauthentifizierung und Administratorpasswort -
  • 8 OpenDocument-Vorlagen -
  • 9 Lx-Office ERP verwenden +
  • 8 Benutzer- und Gruppenverwaltung + +
  • 9 OpenDocument-Vorlagen +
  • 10 Lx-Office ERP verwenden
    • @@ -81,10 +91,11 @@ aufwärts: (dir)
  • Manuelle Installation des Programmpaketes: Installationsort, Berechtigungen
  • Anpassung der PostgreSQL-Konfiguration: Verschiedene Aspekte der Datenbankkonfiguration
  • Apache-Konfiguration: Einrichtung eines Aliases und Optionen für das Ausführen von CGI-Scripten -
  • Benutzerauthentifizierung und Administratorpasswort: Einrichtung der Authentifizierungsdatenbank und der Passwortüberprüfung -
  • Benutzer- und Gruppenverwaltung: Einrichten von Benutzern, Gruppen und Datenbanken -
  • OpenDocument-Vorlagen: Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen -
  • Lx-Office ERP verwenden: Die URLs zur Anmeldung und Administration +
  • Der Task-Server: Konfiguration und Einrichtung des Task-Server-Dämonen +
  • Benutzerauthentifizierung und Administratorpasswort: Einrichtung der Authentifizierungsdatenbank und der Passwortüberprüfung +
  • Benutzer- und Gruppenverwaltung: Einrichten von Benutzern, Gruppen und Datenbanken +
  • OpenDocument-Vorlagen: Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen +
  • Lx-Office ERP verwenden: Die URLs zur Anmeldung und Administration @@ -460,7 +471,7 @@ bzw. den hier gewählten Benutzernamen.

    -nächstes: , +nächstes: , voriges: Anpassung der PostgreSQL-Konfiguration, aufwärts: Top @@ -511,17 +522,148 @@ folgende Option in die Konfiguration aufzunehmen:

    EnableSendfile Off + +

    + + +

    +nächstes: , +voriges: Apache-Konfiguration, +aufwärts: Top + +
    + +

    6 Der Task-Server

    + +

    Der Task-Server ist ein Dämonen, der im Hintergrund läuft, in +regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese +zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser +Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen +benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen +bekommen. + +

    + +
    + + +

    +nächstes: , +aufwärts: Der Task-Server + +
    + +

    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: + +

    + +
    + + +

    +voriges: Prozesskontrolle, +aufwärts: Der Task-Server + +
    + +

    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: + +

    + +

    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 + +

    + +

    +nächstes: , +voriges: Konfiguration des Task-Servers, +aufwärts: Der Task-Server + +
    + +

    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: + +

    + +

    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). +

    nächstes: , -voriges: Apache-Konfiguration, +voriges: Der Task-Server, aufwärts: Top
    -

    6 Benutzerauthentifizierung und Administratorpasswort

    +

    7 Benutzerauthentifizierung und Administratorpasswort

    Informationen über die Einrichtung der Benutzerauthentifizierung, über die Verwaltung von Gruppen und weitere Einstellungen @@ -544,7 +686,7 @@ aufwärts: 6.1 Grundlagen zur Benutzerauthentifizierung +

    7.1 Grundlagen zur Benutzerauthentifizierung

    Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die im folgenden “Authentifizierungsdatenbank” genannt wird. Für jeden @@ -562,10 +704,10 @@ 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 -Konfigurationsdatei config/lx_office.conf festgelegt. Diese +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 -config/lx_office.conf.default existiert, die als Vorlage +config/lx_office.conf.default existiert, die als Vorlage benutzt werden kann.

    @@ -577,7 +719,7 @@ aufwärts: 6.2 Administratorpasswort +

    7.2 Administratorpasswort

    Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort und nicht @@ -593,7 +735,7 @@ aufwärts: 6.3 Authentifizierungsdatenbank +

    7.3 Authentifizierungsdatenbank

    Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern in $self->{DB_config} konfiguriert. Hier sind die folgenden @@ -620,7 +762,7 @@ aufwärts: 6.4 Passwortüberprüfung +

    7.4 Passwortüberprüfung

    Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die Authentifizierungsdatenbank und gegen einen externen LDAP- oder @@ -664,7 +806,7 @@ aufwärts: 6.5 Name des Session-Cookies +

    7.5 Name des Session-Cookies

    Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt werden, so müssen die Namen der Session-Cookies für alle @@ -682,9 +824,9 @@ aufwärts: 6.6 Anlegen der Authentifizierungsdatenbank +

    7.6 Anlegen der Authentifizierungsdatenbank

    -

    Nachdem alle Einstellungen in config/lx_office.conf +

    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 @@ -703,7 +845,7 @@ aufwärts: Top

    -

    7 Benutzer- und Gruppenverwaltung

    +

    8 Benutzer- und Gruppenverwaltung

    Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt werden. Dieses geschieht im Administrationsmenü, das Sie @@ -712,7 +854,7 @@ unter folgender URL finden:

    http://localhost/lx-erp/admin.pl

    Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei -config/lx_office.conf eingetragen haben. +config/lx_office.conf eingetragen haben.