From: Moritz Bunkus Date: Fri, 3 Jun 2011 14:23:58 +0000 (+0200) Subject: Dokumentation zum Task-Server und Start-Scripte für ihn X-Git-Tag: release-2.6.3~25^2~1 X-Git-Url: http://wagnertech.de/git?a=commitdiff_plain;h=39807402e4166e71cd51d87fd492d26e58a734f5;p=kivitendo-erp.git Dokumentation zum Task-Server und Start-Scripte für ihn --- 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.

    -

    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.