projekt kivitendo

<li><a name="toc_Der-Task_002dServer" href="#Der-Task_002dServer">6 Der Task-Server</a>

<li><a href="#Konfiguration-des-Task_002dServers">6.1 Verfügbare und notwendige Konfigurationsoptionen</a>

<li><a href="#Einbinden-in-den-Boot_002dProzess">6.2 Automatisches Starten des Task-Servers beim Booten</a>

<ul>

<li><a href="#Einbinden-in-den-Boot_002dProzess">6.2.1 SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)</a>

<li><a href="#Einbinden-in-den-Boot_002dProzess">6.2.2 Upstart-basierende Systeme (z.B. Ubuntu)</a>

</li></ul>

<li><a href="#Prozesskontrolle">6.3 Wie der Task-Server gestartet und beendet wird</a>

<li><a name="toc_Benutzerauthentifizierung-und-Administratorpasswort" href="#Benutzerauthentifizierung-und-Administratorpasswort">7 Benutzerauthentifizierung und Administratorpasswort</a>

<li><a href="#Grundlagen-zur-Benutzerauthentifizierung">7.1 Grundlagen zur Benutzerauthentifizierung</a>

<li><a href="#Administratorpasswort">7.2 Administratorpasswort</a>

<li><a href="#Authentifizierungsdatenbank">7.3 Authentifizierungsdatenbank</a>

<li><a href="#Passwort_00c3_00bcberpr_00c3_00bcfung">7.4 Passwortüberprüfung</a>

<li><a href="#Name-des-Session_002dCookies">7.5 Name des Session-Cookies</a>

<li><a href="#Anlegen-der-Authentifizierungsdatenbank">7.6 Anlegen der Authentifizierungsdatenbank</a>

<li><a name="toc_Benutzer_002d-und-Gruppenverwaltung" href="#Benutzer_002d-und-Gruppenverwaltung">8 Benutzer- und Gruppenverwaltung</a>

<ul>

<li><a href="#Zusammenh_00c3_00a4nge">8.1 Zusammenhänge</a>

<li><a href="#Datenbanken-anlegen">8.2 Datenbanken anlegen</a>

<li><a href="#Gruppen-anlegen">8.3 Gruppen anlegen</a>

<li><a href="#Benutzer-anlegen">8.4 Benutzer anlegen</a>

<li><a href="#Gruppenmitgliedschaften-verwalten">8.5 Gruppenmitgliedschaften verwalten</a>

<li><a href="#Migration-alter-Installationen">8.6 Migration alter Installationen</a>

</li></ul>

<li><a name="toc_OpenDocument_002dVorlagen" href="#OpenDocument_002dVorlagen">9 OpenDocument-Vorlagen</a>

<li><a name="toc_Lx_002dOffice-ERP-verwenden" href="#Lx_002dOffice-ERP-verwenden">10 Lx-Office ERP verwenden</a>

<li><a accesskey="6" href="#Der-Task_002dServer">Der Task-Server</a>:  Konfiguration und Einrichtung des Task-Server-Dämonen

<li><a accesskey="7" href="#Benutzerauthentifizierung-und-Administratorpasswort">Benutzerauthentifizierung und Administratorpasswort</a>:  Einrichtung der Authentifizierungsdatenbank und der Passwortüberprüfung

<li><a accesskey="8" href="#Benutzer_002d-und-Gruppenverwaltung">Benutzer- und Gruppenverwaltung</a>:  Einrichten von Benutzern, Gruppen und Datenbanken

<li><a accesskey="9" href="#OpenDocument_002dVorlagen">OpenDocument-Vorlagen</a>:  Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen

<li><a href="#Lx_002dOffice-ERP-verwenden">Lx-Office ERP verwenden</a>:  Die URLs zur Anmeldung und Administration

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="#Der-Task_002dServer">Der Task-Server</a>,

<!--  -->

<div class="node">

<a name="Der-Task-Server"></a>

<a name="Der-Task_002dServer"></a>

<p><hr>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="#Benutzerauthentifizierung-und-Administratorpasswort">Benutzerauthentifizierung und Administratorpasswort</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="#Apache_002dKonfiguration">Apache-Konfiguration</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>

</div>

<h2 class="chapter">6 Der Task-Server</h2>

<p>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.

<ul class="menu">

<li><a accesskey="1" href="#Konfiguration-des-Task_002dServers">Konfiguration des Task-Servers</a>:  Verfügbare und notwendige Konfigurationsoptionen

<li><a accesskey="2" href="#Prozesskontrolle">Prozesskontrolle</a>:  Wie der Task-Server gestartet und beendet wird

<li><a accesskey="3" href="#Einbinden-in-den-Boot_002dProzess">Einbinden in den Boot-Prozess</a>:  Automatisches Starten des Task-Servers beim Booten

</ul>

<div class="node">

<a name="Konfiguration-des-Task-Servers"></a>

<a name="Konfiguration-des-Task_002dServers"></a>

<p><hr>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="#Prozesskontrolle">Prozesskontrolle</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="#Der-Task_002dServer">Der Task-Server</a>

</div>

<h3 class="section">6.1 Verfügbare und notwendige Konfigurationsoptionen</h3>

<p>Die Konfiguration erfolgt über den Abschnitt <code>[task_server]</code> in

der Datei <samp><span class="file">config/lx_office.conf</span></samp>. Die dort verfügbaren Optionen

sind:

     <ul>

<li><code>login</code>: Benutzername, der benutzt wird, um die zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss in der Administration angelegt werden. Diese Option muss angegeben werden. 

<li><code>run_as</code>: Wird der Server von <code>root</code> gestartet, so wechselt er auf diesen Systembenutzer. Der Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie auch der Webserverbenutzer (siehe see <a href="#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>). Daher ist es sinnvoll, hier denselben Systembenutzer einzutragen, unter dem auch der Webserver läuft. 

<li><code>debug</code>: Schaltet Debug-Informationen an und aus. 

</ul>

<div class="node">

<a name="Einbinden-in-den-Boot-Prozess"></a>

<a name="Einbinden-in-den-Boot_002dProzess"></a>

<p><hr>

voriges:&nbsp;<a rel="previous" accesskey="p" href="#Prozesskontrolle">Prozesskontrolle</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="#Der-Task_002dServer">Der Task-Server</a>

</div>

<h3 class="section">6.2 Automatisches Starten des Task-Servers beim Booten</h3>

<p>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.

   <p>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.

<h4 class="subsection">6.2.1 SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)</h4>

<p>Kopieren Sie die Datei

<samp><span class="file">scripts/boot/system-v/lx-office-task-server</span></samp> nach

<samp><span class="file">/etc/init.d/lx-office-task-server</span></samp>. Passen Sie in der kopierten

Datei den Pfad zum Task-Server an (Zeile <code>DAEMON=....</code>). Binden

Sie das Script in den Boot-Prozess ein. Dies ist distributionsabhängig:

     <ul>

<li>Debian-basierende Systeme:

<br>

<code>update-rc.d lx-office-task-server defaults

<br>

# Nur bei Debian Squeeze und neuer:

<br>

insserv lx-office-task-server</code>

<li>OpenSuSE und Fedora Core:

<br>

<code>chkconfig --add lx-office-task-server</code>

</ul>

   <p>Danach kann der Task-Server mit dem folgenden Befehl gestartet werden:

<code>/etc/init.d/lx-office-task-server start</code>

<h4 class="subsection">6.2.2 Upstart-basierende Systeme (z.B. Ubuntu)</h4>

<p>Kopieren Sie die Datei

<samp><span class="file">scripts/boot/upstart/lx-office-task-server.conf</span></samp> nach

<samp><span class="file">/etc/init/lx-office-task-server.conf</span></samp>. Passen Sie in der kopierten

Datei den Pfad zum Task-Server an (Zeile <code>exec ....</code>).

   <p>Danach kann der Task-Server mit dem folgenden Befehl gestartet werden:

<code>service lx-office-task-server start</code>

<div class="node">

<a name="Prozesskontrolle"></a>

<p><hr>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="#Einbinden-in-den-Boot_002dProzess">Einbinden in den Boot-Prozess</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="#Konfiguration-des-Task_002dServers">Konfiguration des Task-Servers</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="#Der-Task_002dServer">Der Task-Server</a>

</div>

<h3 class="section">6.3 Wie der Task-Server gestartet und beendet wird</h3>

<p>Der Task-Server wird wie folgt kontrolliert:

   <p><code>./scripts/task_server.pl Befehl</code>

   <p><code>Befehl</code> ist dabei eine der folgenden Optionen:

     <ul>

<li><code>start</code> startet eine neue Instanz des Task-Servers. Die Prozess-ID wird innerhalb des <samp><span class="file">users</span></samp>-Verzeichnisses abgelegt. 

<li><code>stop</code> beendet einen laufenden Task-Server. 

<li><code>restart</code> beendet und startet ihn neu. 

<li><code>status</code> berichtet, ob der Task-Server läuft. 

</ul>

   <p>Der Task-Server wechselt beim Starten automatisch in das Lx-Office-Installationsverzeichnis.

   <p>Dieselben Optionen können auch für die SystemV-basierenden

Runlevel-Scripte benutzt werden (siehe oben).

voriges:&nbsp;<a rel="previous" accesskey="p" href="#Der-Task_002dServer">Der Task-Server</a>,

<h2 class="chapter">7 Benutzerauthentifizierung und Administratorpasswort</h2>

<h3 class="section">7.1 Grundlagen zur Benutzerauthentifizierung</h3>

Konfigurationsdatei <samp><span class="file">config/lx_office.conf</span></samp> festgelegt. Diese

<samp><span class="file">config/lx_office.conf.default</span></samp> existiert, die als Vorlage

<h3 class="section">7.2 Administratorpasswort</h3>

<h3 class="section">7.3 Authentifizierungsdatenbank</h3>

<h3 class="section">7.4 Passwortüberprüfung</h3>

<h3 class="section">7.5 Name des Session-Cookies</h3>

<h3 class="section">7.6 Anlegen der Authentifizierungsdatenbank</h3>

<p>Nachdem alle Einstellungen in <samp><span class="file">config/lx_office.conf</span></samp>

<h2 class="chapter">8 Benutzer- und Gruppenverwaltung</h2>

<samp><span class="file">config/lx_office.conf</span></samp> eingetragen haben.

<h3 class="section">8.1 Zusammenhänge</h3>

<h3 class="section">8.2 Datenbanken anlegen</h3>

<samp><span class="file">config/lx_office.conf</span></samp> die Variable <code>dbcharset</code> im

<h3 class="section">8.3 Gruppen anlegen</h3>

<h3 class="section">8.4 Benutzer anlegen</h3>

<h3 class="section">8.5 Gruppenmitgliedschaften verwalten</h3>

<h3 class="section">8.6 Migration alter Installationen</h3>

<h2 class="chapter">9 OpenDocument-Vorlagen</h2>

<samp><span class="file">config/lx_office.conf</span></samp> die Variable <code>opendocument</code> im

   <p>Weiterhin muss in der Datei <samp><span class="file">config/lx_office.conf</span></samp> die Variable

   <p>Nach der Installation müssen in der Datei <samp><span class="file">config/lx_config.conf</span></samp>

<h2 class="chapter">10 Lx-Office ERP verwenden</h2>