X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;ds=inline;f=doc%2FINSTALL.html;h=50a65764b889cfafb72ed890d343854cb93d1f3a;hb=6833aa9af01409d28ba7cf605357850f81b85682;hp=8048a890fb5417156e6d88238be61b382d9e3eef;hpb=e08c98d4006bb77bedec2f7922631bef8f4bef24;p=kivitendo-erp.git diff --git a/doc/INSTALL.html b/doc/INSTALL.html index 8048a890f..50a65764b 100644 --- a/doc/INSTALL.html +++ b/doc/INSTALL.html @@ -40,26 +40,36 @@
EnableSendfile Off
+
+
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. + +
+ + + +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 see 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.
+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. + +
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:
+
+
update-rc.d lx-office-task-server defaults
+
+# Nur bei Debian Squeeze und neuer:
+
+insserv lx-office-task-server
+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
+
+
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
+
+
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). +
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
+ 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 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
+ Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern
in 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
+ 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
+ Nachdem alle Einstellungen in 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
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
-7.1 Grundlagen zur Benutzerauthentifizierung
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.2 Administratorpasswort
7.3 Authentifizierungsdatenbank
$self->{DB_config}
konfiguriert. Hier sind die folgenden
@@ -620,7 +762,7 @@ aufwärts: 6.4 Passwortüberprüfung
+7.4 Passwortüberprüfung
7.5 Name des Session-Cookies
7.6 Anlegen der Authentifizierungsdatenbank
-config/lx_office.conf
+7 Benutzer- und Gruppenverwaltung
+8 Benutzer- und Gruppenverwaltung
config/lx_office.conf
eingetragen haben.
+config/lx_office.conf eingetragen haben.