X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentation.xml;h=1103e84dd1467752132bc5552438a3d4c8c27c03;hb=31e6d33a8e4ec4cf11a25ad63696948bc55f63bc;hp=b45f13ab12860b8e2164d930875dad4685be99a2;hpb=dd75cbf32d9238944731b2fb059bddce03bb64eb;p=kivitendo-erp.git diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index b45f13ab1..1103e84dd 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -11,8 +11,12 @@ - im kivitendo-Forum: https://forum.kivitendo.org:32443 + im Community-Forum: https://forum.kivitendo.de:32443 + + + im Kunden-Forum: http://redmine.kivitendo-premium.de/projects/forum/boards/ in der doc/UPGRADE Datei im doc-Verzeichnis der Installation @@ -415,10 +419,8 @@ password = kivitendo bringt eine eigene Komponente zur zeitgesteuerten Ausführung bestimmter Aufgaben mit, den Taskserver. Er wird u.a. für Features wie die wiederkehrenden Rechnungen benötigt, erledigt aber auch andere erforderliche Aufgaben - und muss daher in Betrieb genommen werden. Der Taskserver benötigt zwei Konfigurationseinstellungen, die unter - [task_server] anzugeben sind: ein Mandant (entweder der Mandantenname oder eine Datenbank-ID, Variable - client), aus dem die Datenbankkonfiguration entnommen wird, sowie ein Login (Variable login) - eines Benutzers, der für gewisse Dinge wie die Rechnungserstellung als Verkäufer eingetragen wird. + und muss daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt Task-Server + genauer beschrieben. Für Entwickler finden sich unter [debug] wichtige Funktionen, um die Fehlersuche zu erleichtern. @@ -513,8 +515,15 @@ psql template1 führen Sie die folgenden Kommandos aus: - create language 'plpgsql'; + CREATE EXTENSION IF NOT EXISTS plpgsql; +\q + + + CREATE EXTENSION ist seit Version 9.1 die bevorzugte Syntax um die Sprache plpgsql anzulegen. In diesen Versionen ist die Extension meist auch schon vorhanden. Sollten Sie eine ältere Version von Postgres haben, benutzen Sie stattdessen den folgenden Befehl. + CREATE LANGUAGE 'plpgsql'; \q + + @@ -556,10 +565,11 @@ exit anderen Datei hinzu, die beim Starten des Webservers eingelesen wird: - AddHandler cgi-script .pl + AliasMatch ^/kivitendo-erp/[^/]+\.pl /var/www/kivitendo-erp/dispatcher.pl Alias /kivitendo-erp/ /var/www/kivitendo-erp/ <Directory /var/www/kivitendo-erp> + AddHandler cgi-script .pl Options ExecCGI Includes FollowSymlinks </Directory> @@ -574,6 +584,9 @@ Alias /kivitendo-erp/ /var/www/kivitendo-erp/ Vor den einzelnen Optionen muss bei einigen Distributionen ein Plus ‘+’ gesetzt werden. + Bei einigen Distribution (Ubuntu ab 14.04, Debian ab 8.2) muss noch explizit + das cgi-Modul mittels a2enmod cgi aktiviert + werden. Auf einigen Webservern werden manchmal die Grafiken und @@ -756,6 +769,15 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/ + + Weitergehende Konfiguration + Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung von kivitendo + nur über https-verschlüsselten Verbindungen, sowie weiteren Zusatzmassnahmen, + wie beispielsweise Basic Authenticate. + Die Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser Anleitung, hier ein + Hinweis auf einen entsprechenden Foreneintrag (Stand Sept. 2015) + @@ -765,6 +787,12 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/ + Der Task-Server muss einmalig global in der Konfigurationsdatei konfiguriert werden. Danach wird er für jeden Mandanten, für den + er laufen soll, in der Adminsitrationsmaske eingeschaltet. + + Beachten Sie, dass der Task-Server in den Boot-Vorgang Ihres Servers integriert werden muss, damit er automatisch gestartet + wird. Dies kann kivitendo nicht für Sie erledigen. + Verfügbare und notwendige Konfigurationsoptionen @@ -774,28 +802,6 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/ - - client - - - Name oder Datenbank-ID eines vorhandenen kivitendo-Mandanten, der benutzt wird, um die zu verwendende - Datenbankverbindung auszulesen. Der Mandant muss in der Administration angelegt werden. Diese Option muss angegeben - werden. - - Diese Option kam mit Release v3.x.0 hinzu und muss daher in Konfigurationen, die von älteren Versionen aktualisiert - wurden, ergänzt werden. - - - - - login - - - gültiger kivitendo-Benutzername, der z.B. als Verkäufer beim Erzeugen wiederkehrender Rechnungen benötigt wird. Der - Benutzer muss in der Administration angelegt werden. Diese Option muss angegeben werden. - - - run_as @@ -806,7 +812,7 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/). Daher - ist es sinnvoll, hier denselben Systembenutzer einzutragen, + ist es erforderlich, hier denselben Systembenutzer einzutragen, unter dem auch der Webserver läuft. @@ -821,6 +827,17 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/ + + Konfiguration der Mandanten für den Task-Server + + Ist der Task-Server grundlegend konfiguriert, so muss anschließend jeder Mandant, für den der Task-Server laufen soll, + einmalig konfiguriert werden. Dazu kann in der Maske zum Bearbeiten von Mandanten im Administrationsbereich eine + kivitendo-Benutzerkennung ausgewählt werden, unter der der Task-Server seine Arbeit verrichtet. + + Ist in dieser Einstellung keine Benutzerkennung ausgewählt, so wird der Task-Server für diesen Mandanten keine Aufgaben + ausführen. + + Automatisches Starten des Task-Servers beim Booten @@ -992,7 +1009,7 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/ Administratorpasswort - Das Passwort, das zum Zugriff auf das Aministrationsinterface + Das Passwort, das zum Zugriff auf das Administrationsinterface von kivitendo benutzt 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 admin_password im @@ -1067,7 +1084,7 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/ Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank gespeichert werden, so muss der Parameter module den Wert DB enthalten. In diesem Fall können sowohl - der Administrator als auch die Benutzer selber ihre Psaswörter in + der Administrator als auch die Benutzer selber ihre Passwörter in kivitendo ändern. Soll hingegen ein externer LDAP- oder Active-Directory-Server @@ -1646,7 +1663,7 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/ - + Der Druckvorlagensatz rev-odt @@ -2909,7 +2926,7 @@ empfang@revamp-it.ch template_meta.language.template_code - Vorlagenürzel der verwendeten Sprache, identisch mit dem + Vorlagenkürzel der verwendeten Sprache, identisch mit dem Kürzel das im Dateinamen verwendetet wird. @@ -3303,7 +3320,7 @@ empfang@revamp-it.ch - shiptodepartment1 + shiptodepartment_1 Abteilung 1 (Lieferadresse) - shiptodepartment2 + shiptodepartment_2 Abteilung 2 (Lieferadresse) - - A stub version of French is included but not functunal at this - point. want to keep this safe somewhere. + + more/all + + + This subdir and file is not a part of the language package + itself. + + If the directory more exists and contains a file called all + it will be parsed in addition to the mandatory all (see above). + The file is useful if you want to change some translations for + the current installation without conflicting further upgrades. + The file is not autogenerated and has the same format as the all, + but needs another key (more_texts). See the german translation + for an example or copy the following code: + +#!/usr/bin/perl +# -*- coding: utf-8; -*- +# vim: fenc=utf-8 + +use utf8; + +# These are additional texts for custom translations. +# The format is the same as for the normal file all, only +# with another key (more_texts instead of texts). +# The file has the form of 'english text' => 'foreign text', + +$self->{more_texts} = { + + 'Ship via' => 'Terms of delivery', + 'Shipping Point' => 'Delivery time', +} + + + + + +