From: Sven Schöling Date: Tue, 23 Mar 2010 11:07:42 +0000 (+0100) Subject: Dokumentation komplett nach utf8 konvertiert. X-Git-Tag: release-2.6.1~8 X-Git-Url: http://wagnertech.de/git?a=commitdiff_plain;h=4c24a5f44bf065a820ec1a540334ebd48446ac04;p=kivitendo-erp.git Dokumentation komplett nach utf8 konvertiert. --- diff --git a/doc/INSTALL.texi b/doc/INSTALL.texi index c298f03a2..8d06a3ac0 100644 --- a/doc/INSTALL.texi +++ b/doc/INSTALL.texi @@ -1,6 +1,6 @@ \input texinfo @c -*-texinfo-*- @c %**start of header -@documentencoding ISO-8859-15 +@documentencoding UTF-8 @setfilename INSTALL.info @settitle Lx-Office Installationsanleitung @c %**end of header @@ -23,11 +23,11 @@ @menu * Aktuelle Hinweise:: Andere Informationsquellen als diese Anleitung -* Benötigte Software und Pakete:: Vorraussetzungen zum Betrieb von Lx-Office +* Benötigte Software und Pakete:: Vorraussetzungen zum Betrieb von Lx-Office * 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 +* 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 @@ -53,12 +53,12 @@ im Lx-Office-Forum: @uref{http://www.lx-office.org/forum/} @c --------------------------------------------------------------- -@node Benötigte Software und Pakete -@chapter Benötigte Software und Pakete +@node Benötigte Software und Pakete +@chapter Benötigte Software und Pakete -Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt. +Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt. -Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: +Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: @itemize @item @@ -89,26 +89,26 @@ List::MoreUtils Email::Address @end itemize -Diese Pakete können bei den unterschiedlichen Distributionen anders heißen. +Diese Pakete können bei den unterschiedlichen Distributionen anders heißen. -Für Debian oder Ubuntu benötigen Sie diese Pakete: +Für Debian oder Ubuntu benötigen Sie diese Pakete: @code{apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl libtemplate-perl lib-uriperl libxml-simple-perl} -Für Fedora Core benötigen Sie unter anderem diese Pakete: +Für Fedora Core benötigen Sie unter anderem diese Pakete: @code{httpd postgresql-server perl-DBI perl-DBD-Pg} -Für OpenSuSE benötigen Sie diese Pakete: +Für OpenSuSE benötigen Sie diese Pakete: @code{apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy perl-Template-Toolkit perl-URI perl-XML-Writer} -Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als +Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren. -In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback. +In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback. -Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle -benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: +Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle +benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: @code{./scripts/installation_check.pl} @@ -125,28 +125,28 @@ Dokumentenverzeichnis des Webservers (z.B. @code{/var/www/html/}, @* tar xvzf lxoffice-erp-2.6.1beta1.tgz} -Verändern Sie evtl. noch den Namen des Verzeichnisses mit +Verändern Sie evtl. noch den Namen des Verzeichnisses mit @code{mv lxoffice-erp/ lx-erp/} -Alternativ können Sie auch einen Alias in der Webserverkonfiguration -benutzen, um auf das tatsächliche Installationsverzeichnis zu +Alternativ können Sie auch einen Alias in der Webserverkonfiguration +benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen. -Die Verzeichnisse @code{users}, @code{spool} und @code{webdav} müssen -für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die -restlichen Dateien müssen für diesen Benutzer lesbar sein. Der +Die Verzeichnisse @code{users}, @code{spool} und @code{webdav} müssen +für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die +restlichen Dateien müssen für diesen Benutzer lesbar sein. Der Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B. bei Debian/Ubuntu @code{www-data}, bei Fedora core @code{apache} oder bei OpenSuSE @code{wwwrun}). -Der folgende Befehl ändert den Besitzer für die oben genannten +Der folgende Befehl ändert den Besitzer für die oben genannten Verzeichnisse auf einem Debian/Ubuntu-System: @code{chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav} -Weiterhin muss der Webserver-Benutzer im Verzeichnis @code{templates} Verzeichnisse für -jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen: +Weiterhin muss der Webserver-Benutzer im Verzeichnis @code{templates} Verzeichnisse für +jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen: @code{chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates} @@ -159,14 +159,14 @@ jeden neuen Benutzer, der in lx-office angelegt wird, anlegen d PostgreSQL muss auf verschiedene Weisen angepasst werden. @menu -* Zeichensätze/die Verwendung von UTF-8:: Was bei der Verwendung von UTF-8 zu beachten ist -* Änderungen an Konfigurationsdateien:: Anpassungen für Anmeldung am Server und Featureunterstützung -* Erweiterung für servergespeicherte Prozeduren:: Lx-Office benutzt servergespeicherte Prozeduren +* Zeichensätze/die Verwendung von UTF-8:: Was bei der Verwendung von UTF-8 zu beachten ist +* Änderungen an Konfigurationsdateien:: Anpassungen für Anmeldung am Server und Featureunterstützung +* Erweiterung für servergespeicherte Prozeduren:: Lx-Office benutzt servergespeicherte Prozeduren * Datenbankbenutzer anlegen:: Um den Zugriff besser zu reglementieren @end menu -@node Zeichensätze/die Verwendung von UTF-8 -@section Zeichensätze/die Verwendung von UTF-8 +@node Zeichensätze/die Verwendung von UTF-8 +@section Zeichensätze/die Verwendung von UTF-8 Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in @@ -174,7 +174,7 @@ Version 8.0 oder neuer benutzt werden, und der PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale angelegt worden sein. -Dieses ist kann überprüft werden: ist das Encoding der Datenbank +Dieses ist kann überprüft werden: ist das Encoding der Datenbank ``template1'' ``UTF8'', so kann auch Lx-Office mit UTF-8 betrieben werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und @@ -182,45 +182,45 @@ Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden: @code{pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername} -Die Datenbankversionsnummer muss an die tatsächlich verwendete +Die Datenbankversionsnummer muss an die tatsächlich verwendete Versionsnummer angepasst werden. -Unter anderen Distributionen gibt es ähnliche Methoden. +Unter anderen Distributionen gibt es ähnliche Methoden. Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist -ein Neuanlegen eines weiteren Clusters nicht möglich, so kann +ein Neuanlegen eines weiteren Clusters nicht möglich, so kann Lx-Office mit ISO-8859-15 als Encoding betrieben werden. -Das Encoding einer Datenbank kann in @code{psql} mit @code{\l} geprüft werden. +Das Encoding einer Datenbank kann in @code{psql} mit @code{\l} geprüft werden. -@node Änderungen an Konfigurationsdateien -@section Änderungen an Konfigurationsdateien +@node Änderungen an Konfigurationsdateien +@section Änderungen an Konfigurationsdateien In der Datei @code{postgresql.conf}, die je nach Distribution in verschiedenen Verzeichnissen liegen kann (z.B. @code{/var/lib/pgsql/data/} oder @code{/etc/postgresql/}, muss -sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für +sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für PostgreSQL vor Version v8.0 lautete dieser Parameter @code{TCPIP_SOCKET = 1} -Ab v8.0 wird das Verhalten hingegen über den neuen Parameter +Ab v8.0 wird das Verhalten hingegen über den neuen Parameter @code{listen_address} gesteuert. Laufen PostgreSQL und Lx-Office auf demselben Rechner, so kann dort der Wert @code{localhost} verwendet -werden. Andernfalls müssen Datenbankverbindungen auch von anderen +werden. Andernfalls müssen Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden, was mit dem Wert \@code{*} geschieht. In der Datei @code{pg_hba.conf}, die im gleichen Verzeichnis wie die -@code{postgresql.conf} zu finden sein sollte, müssen die -Berichtigungen für den Zugriff geändert werden. Hier gibt es mehrere -Möglichkeiten. Eine besteht darin, lokale Verbindungen immer +@code{postgresql.conf} zu finden sein sollte, müssen die +Berichtigungen für den Zugriff geändert werden. Hier gibt es mehrere +Möglichkeiten. Eine besteht darin, lokale Verbindungen immer zuzulassen @code{local all all trust @* host all all 127.0.0.1 255.0.0.0 trust} -Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort +Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort zuzulassen. Beispielsweise: @code{local all lxoffice password @@ -229,12 +229,12 @@ host all lxoffice 127.0.0.1 255.255.255.255 password} @c --------------------------------------------------------------- -@node Erweiterung für servergespeicherte Prozeduren -@section Erweiterung für servergespeicherte Prozeduren +@node Erweiterung für servergespeicherte Prozeduren +@section Erweiterung für servergespeicherte Prozeduren -In der Datenbank @code{template1} muss die Unterstützung für +In der Datenbank @code{template1} muss die Unterstützung für servergespeicherte Prozeduren eingerichet werden. Melden Sie sich -dafür als Benutzer ``postgres'' an der Datenbank an, und führen Sie +dafür als Benutzer ``postgres'' an der Datenbank an, und führen Sie die folgenden Kommandos aus: @code{create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c'; @@ -255,15 +255,15 @@ Debian/Ubuntu befindet sie sich unter Wenn Sie nicht den Datenbanksuperuser ``postgres'' zum Zugriff benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer -anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen können: +anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen können: @code{su - postgres @* createuser -d -P lxoffice} -Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie +Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer ``postgres'' auf ``lxoffice'' -bzw. den hier gewählten Benutzernamen. +bzw. den hier gewählten Benutzernamen. @c --------------------------------------------------------------- @@ -272,7 +272,7 @@ bzw. den hier gew Der Zugriff auf das Programmverzeichnis muss in der Apache Webserverkonfigurationsdatei @code{httpd.conf} eingestellt -werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer +werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu, die beim Starten des Webservers eingelesen wird: @code{@* @@ -304,7 +304,7 @@ Achtung: Vor den einzelnen Optionen muss bei einigen Distributionen ein Plus @samp{+} gesetzt werden. Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets -nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die +nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die folgende Option in die Konfiguration aufzunehmen: @code{EnableSendfile Off} @@ -314,15 +314,15 @@ folgende Option in die Konfiguration aufzunehmen: @node Benutzerauthentifizierung und Administratorpasswort @chapter Benutzerauthentifizierung und Administratorpasswort -Informationen über die Einrichtung der Benutzerauthentifizierung, über +Informationen über die Einrichtung der Benutzerauthentifizierung, über die Verwaltung von Gruppen und weitere Einstellungen @menu -* Grundlagen zur Benutzerauthentifizierung:: Verfügbare Methoden, Name der Konfigurationsdatei +* Grundlagen zur Benutzerauthentifizierung:: Verfügbare Methoden, Name der Konfigurationsdatei * Administratorpasswort:: Wo das Administratorpasswort gesetzt werden kann * Authentifizierungsdatenbank:: Verbindungseinstellungen zur Authentifizierungsdatenbank -* Passwortüberprüfung:: Einstellungen zur Überprüfung der Benutzerpasswörter -* Name des Session-Cookies:: Ändern des Cookie-Namens bei Verwendung mehrerer Lx-Office-Installationen auf einem Server +* Passwortüberprüfung:: Einstellungen zur Überprüfung der Benutzerpasswörter +* Name des Session-Cookies:: Ändern des Cookie-Namens bei Verwendung mehrerer Lx-Office-Installationen auf einem Server * Anlegen der Authentifizierungsdatenbank:: Wie die Authentifizierungsdatenbank angelegt wird @end menu @@ -332,20 +332,20 @@ die Verwaltung von Gruppen und weitere Einstellungen @section Grundlagen zur Benutzerauthentifizierung Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die -im folgenden ``Authentifizierungsdatenbank'' genannt wird. Für jeden -Benutzer kann dort eine eigene Datenbank für die eigentlichen -Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen +im folgenden ``Authentifizierungsdatenbank'' genannt wird. Für jeden +Benutzer kann dort eine eigene Datenbank für die eigentlichen +Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen aber nicht unterschiedlich sein. -Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank, +Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank, in der sowohl die Benutzerinformationen als auch die Daten abgelegt werden. -Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter +Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter entweder gegen die Authentifizierungsdatenbank oder gegen einen -LDAP-Server überprüft werden. +LDAP-Server überprüft werden. -Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office +Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der Konfigurationsdatei @code{config/authentication.pl} festgelegt. Diese muss bei der Installation und bei einem Upgrade von einer Version vor @@ -358,8 +358,8 @@ benutzt werden kann. Das Passwort, das zum Zugriff auf das Aministrationsinterface 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 @code{$self->@{admin_password@}}. +mehr im Administrationsinterface selber geändert werden. Der Parameter dazu +heißt @code{$self->@{admin_password@}}. @node Authentifizierungsdatenbank @section Authentifizierungsdatenbank @@ -378,29 +378,29 @@ Parameter anzugeben: @item @samp{user} -- Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. ``postgres'') @item -@samp{password} -- Das Passwort für den Datenbankbenutzer +@samp{password} -- Das Passwort für den Datenbankbenutzer @end itemize Die Datenbank muss noch nicht existieren. Lx-Office kann sie automatisch anlegen (mehr dazu siehe unten). -@node Passwortüberprüfung -@section Passwortüberprüfung +@node Passwortüberprüfung +@section Passwortüberprüfung -Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die +Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die Authentifizierungsdatenbank und gegen einen externen LDAP- oder Active-Directory-Server. Welche davon benutzt wird, regelt der Parameter @code{$self->@{module@}}. -Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank +Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank gespeichert werden, so muss der Parameter @code{$self->@{module@}} den -Wert @samp{DB} enthalten. In diesem Fall können sowohl der -Administrator als auch die Benutzer selber ihre Psaswörter in -Lx-Office ändern. +Wert @samp{DB} enthalten. In diesem Fall können sowohl der +Administrator als auch die Benutzer selber ihre Psaswörter in +Lx-Office ändern. Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt werden, so muss der Parameter @code{$self->@{module@}} auf @samp{LDAP} -gesetzt werden. In diesem Fall müssen zusätzliche Informationen über +gesetzt werden. In diesem Fall müssen zusätzliche Informationen über den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden: @itemize @@ -409,19 +409,19 @@ den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden: @item @samp{port} -- Die Portnummer des LDAP-Servers; meist 389. @item -@samp{tls} -- Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen +@samp{tls} -- Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen @item -@samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server - ist dies meist @samp{sAMAccountName}, für andere LDAP-Server hingegen @samp{uid}. Diese Angabe ist zwingend erforderlich. +@samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server + ist dies meist @samp{sAMAccountName}, für andere LDAP-Server hingegen @samp{uid}. Diese Angabe ist zwingend erforderlich. @item @samp{base_dn} -- Der Abschnitt des LDAP-Baumes, der durchsucht werden soll. Diese Angabe ist zwingend erforderlich. @item -@samp{filter} -- Ein optionaler LDAP-Filter. Enthält dieser Filter das Wort @code{<%login%>}, so wird dieses durch den vom Benutzer +@samp{filter} -- Ein optionaler LDAP-Filter. Enthält dieser Filter das Wort @code{<%login%>}, so wird dieses durch den vom Benutzer eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum nach einem Element durchsucht, bei dem das oben angegebene Attribut mit dem Benutzernamen identisch ist. @item @samp{bind_dn} und @samp{bind_password} -- Wenn der LDAP-Server eine Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist dies bei - Active-Directory-Servern der Fall), so kann diese hier angegeben werden. Für Active-Directory-Server kann als @samp{bind_dn} entweder eine + Active-Directory-Servern der Fall), so kann diese hier angegeben werden. Für Active-Directory-Server kann als @samp{bind_dn} entweder eine komplette LDAP-DN wie z.B. @samp{cn=Martin Mustermann,cn=Users,dc=firmendomain} auch nur der volle Name des Benutzers eingegeben werden; in diesem Beispiel also @samp{Martin Mustermann}. @end itemize @@ -430,7 +430,7 @@ den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden: @section 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 +werden, so müssen die Namen der Session-Cookies für alle Installationen unterschiedlich sein. Der Name des Cookies wird mit dem Parameter @code{$self->@{cookie_name@}} gesetzt. @@ -454,8 +454,8 @@ sein sollte: @node Benutzer- und Gruppenverwaltung @chapter Benutzer- und Gruppenverwaltung -Nach der Installation müssen Benutzer, Gruppen und Datenbanken -angelegt werden. Dieses geschieht im Administrationsmenü, das Sie +Nach der Installation müssen Benutzer, Gruppen und Datenbanken +angelegt werden. Dieses geschieht im Administrationsmenü, das Sie unter folgender URL finden: @uref{http://localhost/lx-erp/admin.pl} @@ -464,39 +464,39 @@ Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei @code{config/authentication.pl} eingetragen haben. @menu -* Zusammenhänge:: Übersicht über Benutzer, Gruppen, Berechtigungen und Datenbanken +* Zusammenhänge:: Übersicht über Benutzer, Gruppen, Berechtigungen und Datenbanken * Datenbanken anlegen:: Hinweise zum Anlegen von Datenbanken * Gruppen anlegen:: Hinweise zum Anlegen von Gruppen * Benutzer anlegen:: Hinweise zum Anlegen von Benutzern * Gruppenmitgliedschaften verwalten:: Wie man Gruppen Benutzer zuordnet -* Migration alter Installationen:: Automatische Übernahme bei Update von einer älteren Version +* Migration alter Installationen:: Automatische Übernahme bei Update von einer älteren Version @end menu -@node Zusammenhänge -@section Zusammenhänge +@node Zusammenhänge +@section Zusammenhänge Lx-Office verwendet eine Datenbank zum Speichern all seiner Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um -mit Lx-Office arbeiten zu können, muss eine Person einen +mit Lx-Office arbeiten zu können, muss eine Person einen Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist -möglich und normal, dass mehreren Benutzern die selbe Datenbank -zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können. +möglich und normal, dass mehreren Benutzern die selbe Datenbank +zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können. Die Basisdaten der Benutzer, die in der Administration eingegeben -werden können, werden in einer zweiten Datenbank gespeichert, der -bereits erwähnten Authentifizierungsdatenbank. Diese ist also den +werden können, werden in einer zweiten Datenbank gespeichert, der +bereits erwähnten Authentifizierungsdatenbank. Diese ist also den Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank, aber beliebig viele Datenbanken mit Firmendaten. Lx-Office kann seinen Benutzern Zugriff auf bestimmte Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht -gestattet, so werden der entsprechenden Menüpunkte auch nicht +gestattet, so werden der entsprechenden Menüpunkte auch nicht angezeigt. Diese Rechte werden ebenfalls in der Authentifizierungsdatenbank gespeichert. -Um Rechte verteilen zu können, verwendet Lx-Office ein +Um Rechte verteilen zu können, verwendet Lx-Office ein Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen @@ -520,19 +520,19 @@ Benutzer den Gruppen zuordnen @node Datenbanken anlegen @section Datenbanken anlegen -Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den +Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen ist dies @samp{lxoffice}). -Wenn Sie für die Lx-Office-Installation nicht den europäischen +Wenn Sie für die Lx-Office-Installation nicht den europäischen Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so -müssen Sie vor dem Anlegen der Datenbank in der Datei +müssen Sie vor dem Anlegen der Datenbank in der Datei @code{config/lx-erp.conf} die Variable @code{$dbcharset} auf den Wert -@samp{UTF-8} setzen. Zusätzlich muss beim Anlegen der Datenbank -@samp{UTF-8 Unicode} als Schriftsatz ausgewählt werden. +@samp{UTF-8} setzen. Zusätzlich muss beim Anlegen der Datenbank +@samp{UTF-8 Unicode} als Schriftsatz ausgewählt werden. Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz -verwenden müssen, da diese Einstellungen momentan global in Lx-Office +verwenden müssen, da diese Einstellungen momentan global in Lx-Office vorgenommen wird und nicht nach Datenbank unterschieden werden kann. Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz angelegt worden sein. @@ -542,66 +542,66 @@ angelegt worden sein. Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name gegeben werden, eine Beschreibung ist hingegen optional. Nach dem -Anlegen können Sie die verschiedenen Bereiche wählen, auf die +Anlegen können Sie die verschiedenen Bereiche wählen, auf die Mitglieder dieser Gruppe Zugriff haben sollen. -Benutzergruppen sind unabhängig von Datenbanken, da sie in der -Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle +Benutzergruppen sind unabhängig von Datenbanken, da sie in der +Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle Datenbanken, die in dieser Installation verwaltet werden. @node Benutzer anlegen @section Benutzer anlegen -Beim Anlegen von Benutzern werden für viele Parameter +Beim Anlegen von Benutzern werden für viele Parameter Standardeinstellungen vorgenommen, die den Gepflogenheiten des deutschen Raumes entsprechen. Zwingend anzugeben sind der Loginname sowie die komplette -Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die +Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort -gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung +gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung aktiv, so ist das Passwort-Feld deaktiviert. -In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben +In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben angelegten Datenbanken eingetragen werden. @node Gruppenmitgliedschaften verwalten @section Gruppenmitgliedschaften verwalten -Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen -zugewiesen werden. Dazu gibt es zwei Möglichkeiten: +Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen +zugewiesen werden. Dazu gibt es zwei Möglichkeiten: @enumerate @item -In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden -Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen. +In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden +Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen. @item -In der Gruppenverwaltung wählt man das Tool zur Verwaltung der +In der Gruppenverwaltung wählt man das Tool zur Verwaltung der Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im -System angelegten Gruppen und Benutzer enthält. Durch Setzen der -Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in der -ausgewählten Spalte hinzugefügt. +System angelegten Gruppen und Benutzer enthält. Durch Setzen der +Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in der +ausgewählten Spalte hinzugefügt. @end enumerate @node Migration alter Installationen @section Migration alter Installationen -Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, in der +Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, in der die Benutzerdaten noch im Dateisystem im Verzeichnis @code{users} -verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese +verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten automatisch in die Authentifizierungsdatenbank zu -übernehmen. Dies geschieht, wenn man sich nach dem Update der +übernehmen. Dies geschieht, wenn man sich nach dem Update der Installation das erste Mal im Administrationsbereich anmeldet. Findet Lx-Office die Datei @code{users/members}, so wird der Migrationsprozess gestartet. Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten -können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch -die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt +können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch +die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird. Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office -gewährt. Alle migrierten Benutzern werden Mitglied in dieser +gewährt. Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird das Verhalten von Lx-Office bis Version 2.4.3 -inklusive wiederhergestellt, und die Benutzer können sich sofort +inklusive wiederhergestellt, und die Benutzer können sich sofort wieder anmelden und mit dem System arbeiten. @c --------------------------------------------------------------- @@ -609,10 +609,10 @@ wieder anmelden und mit dem System arbeiten. @node OpenDocument-Vorlagen @chapter OpenDocument-Vorlagen -Lx-Office unterstützt die Verwendung von Vorlagen im +Lx-Office unterstützt die Verwendung von Vorlagen im OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als -auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von +auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren muss in der Datei @code{config/lx-erp.conf} die Variable @code{$opendocument_templates} auf @samp{1} stehen. Dieses ist die Standardeinstellung. @@ -620,37 +620,37 @@ auf @samp{1} stehen. Dieses ist die Standardeinstellung. Weiterhin muss in der Datei @code{config/lx-erp.conf} die Variable @code{$dbcharset} auf die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der Daten in der Datenbank verwendet wird. Diese -ist in den meisten Fällen "ISO-8859-15". +ist in den meisten Fällen "ISO-8859-15". -Während die Erzeugung von reinen OpenDocument-Dateien keinerlei -weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF -OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss +Während die Erzeugung von reinen OpenDocument-Dateien keinerlei +weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF +OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss neben OpenOffice.org ab Version 2 auch der ``X virtual frame buffer'' (xvfb) installiert werden. Bei Debian ist er im Paket ``xvfb'' enthalten. Andere Distributionen enthalten ihn in anderen Paketen. -Nach der Installation müssen in der Datei @code{config/lx-erp.conf} +Nach der Installation müssen in der Datei @code{config/lx-erp.conf} zwei weitere Variablen angepasst werden: -@code{$openofficeorg_writer_bin} muss den vollständigen Pfad zur +@code{$openofficeorg_writer_bin} muss den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. @code{$xvfb_bin} muss den Pfad zum ``X virtual frame buffer'' enthalten. -Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit +Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die Variable @code{$openofficeorg_daemon} gesetzt ist, startet ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich -reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet +reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der Nachteil ist, dass diese Methode Python und die -Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind. +Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind. -Ist @code{$openofficeorg_daemon} nicht gesetzt, so wird für jedes +Ist @code{$openofficeorg_daemon} nicht gesetzt, so wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe -eines Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage +eines Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage enthalten sein und ``Standard.Conversion.ConvertSelfToPDF()'' -heißen. Die Beispielvorlage @samp{templates/German-invoice.odt} -enthält ein solches Makro, das in jeder anderen Dokumentenvorlage +heißen. Die Beispielvorlage @samp{templates/German-invoice.odt} +enthält ein solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein muss. Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org @@ -658,16 +658,16 @@ Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian ist dies momentan @code{~/.openoffice.org2}. Sollte der Name bei Ihrer OpenOffice.org-Installation anders sein, so muss das Verzeichnis @code{users/.openoffice.org2} entsprechend umbenannt -werden. Ist der Name z.B. einfach nur @code{.openoffice}, so wäre -folgender Befehl auszuführen: +werden. Ist der Name z.B. einfach nur @code{.openoffice}, so wäre +folgender Befehl auszuführen: @code{mv users/.openoffice.org2 users/.openoffice} Dieses Verzeichnis, wie auch das komplette @code{users}-Verzeichnis, muss vom Webserver beschreibbar sein. Dieses wurde in Schritt @code{Installation des Programmpakets} oben bereits erledigt, kann -aber erneut überprüft werden, wenn die Konvertierung nach PDF -fehlschlägt. +aber erneut überprüft werden, wenn die Konvertierung nach PDF +fehlschlägt. @c --------------------------------------------------------------- diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt index b34857c7a..ec1e615e1 100644 --- a/doc/INSTALL.txt +++ b/doc/INSTALL.txt @@ -3,23 +3,23 @@ Table of Contents Inhalt der Anleitung 1 Aktuelle Hinweise -2 Benötigte Software und Pakete +2 Benötigte Software und Pakete 3 Installation des Programmpaketes 4 Anpassung der PostgreSQL-Konfiguration - 4.1 Zeichensätze/die Verwendung von UTF-8 - 4.2 Änderungen an Konfigurationsdateien - 4.3 Erweiterung für servergespeicherte Prozeduren + 4.1 Zeichensätze/die Verwendung von UTF-8 + 4.2 Änderungen an Konfigurationsdateien + 4.3 Erweiterung für servergespeicherte Prozeduren 4.4 Datenbankbenutzer anlegen 5 Apache-Konfiguration 6 Benutzerauthentifizierung und Administratorpasswort 6.1 Grundlagen zur Benutzerauthentifizierung 6.2 Administratorpasswort 6.3 Authentifizierungsdatenbank - 6.4 Passwortüberprüfung + 6.4 Passwortüberprüfung 6.5 Name des Session-Cookies 6.6 Anlegen der Authentifizierungsdatenbank 7 Benutzer- und Gruppenverwaltung - 7.1 Zusammenhänge + 7.1 Zusammenhänge 7.2 Datenbanken anlegen 7.3 Gruppen anlegen 7.4 Benutzer anlegen @@ -45,13 +45,13 @@ Aktuelle Installations- und Konfigurationshinweise gibt es: * im Lx-Office-Forum: `http://www.lx-office.org/forum/' -2 Benötigte Software und Pakete -******************************* +2 Benötigte Software und Pakete +******************************** Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) -und ein Datenbankserver (PostgreSQL) benötigt. +und ein Datenbankserver (PostgreSQL) benötigt. - Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht + Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: * DBI @@ -80,33 +80,33 @@ Bestandteil einer Standard-Perl-Installation sind: * Email::Address - Diese Pakete können bei den unterschiedlichen Distributionen anders -heißen. + Diese Pakete können bei den unterschiedlichen Distributionen anders +heißen. - Für Debian oder Ubuntu benötigen Sie diese Pakete: + Für Debian oder Ubuntu benötigen Sie diese Pakete: `apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl -libtext-iconv-perl libyaml-perl libtext-csv-perl libio-stringy-perl -libtemplate-perl' +libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl +libtemplate-perl lib-uriperl libxml-simple-perl' - Für Fedora Core benötigen Sie unter anderem diese Pakete: + Für Fedora Core benötigen Sie unter anderem diese Pakete: `httpd postgresql-server perl-DBI perl-DBD-Pg' - Für OpenSuSE benötigen Sie diese Pakete: + Für OpenSuSE benötigen Sie diese Pakete: `apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy -perl-Template-Toolkit' +perl-Template-Toolkit perl-URI perl-XML-Writer' - Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht + Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als Distributionspakete vorhanden, und/oder nicht praktikabel zu -installieren. In diesen Fällen liefert Lx-Office das Paket mit, und -lädt es als Fallback. +installieren. In diesen Fällen liefert Lx-Office das Paket mit, und +lädt es als Fallback. - Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle -benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: + Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle +benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: `./scripts/installation_check.pl' @@ -120,29 +120,29 @@ im Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/', `cd /var/www tar xvzf lxoffice-erp-2.6.1beta1.tgz' - Verändern Sie evtl. noch den Namen des Verzeichnisses mit + Verändern Sie evtl. noch den Namen des Verzeichnisses mit `mv lxoffice-erp/ lx-erp/' - Alternativ können Sie auch einen Alias in der Webserverkonfiguration -benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen. + Alternativ können Sie auch einen Alias in der Webserverkonfiguration +benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen. - Die Verzeichnisse `users', `spool' und `webdav' müssen für den -Benutzer beschreibbar sein, unter dem der Webserver läuft. Die -restlichen Dateien müssen für diesen Benutzer lesbar sein. Der + Die Verzeichnisse `users', `spool' und `webdav' müssen für den +Benutzer beschreibbar sein, unter dem der Webserver läuft. Die +restlichen Dateien müssen für diesen Benutzer lesbar sein. Der Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B. bei Debian/Ubuntu `www-data', bei Fedora core `apache' oder bei OpenSuSE `wwwrun'). - Der folgende Befehl ändert den Besitzer für die oben genannten + Der folgende Befehl ändert den Besitzer für die oben genannten Verzeichnisse auf einem Debian/Ubuntu-System: `chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav' Weiterhin muss der Webserver-Benutzer im Verzeichnis `templates' -Verzeichnisse für jeden neuen Benutzer, der in lx-office angelegt wird, -anlegen dürfen: +Verzeichnisse für jeden neuen Benutzer, der in lx-office angelegt wird, +anlegen dürfen: `chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates' @@ -152,15 +152,15 @@ lx-office-erp/templates' PostgreSQL muss auf verschiedene Weisen angepasst werden. -4.1 Zeichensätze/die Verwendung von UTF-8 -========================================= +4.1 Zeichensätze/die Verwendung von UTF-8 +========================================== Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in Version 8.0 oder neuer benutzt werden, und der PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale angelegt worden sein. - Dieses ist kann überprüft werden: ist das Encoding der Datenbank + Dieses ist kann überprüft werden: ist das Encoding der Datenbank "template1" "UTF8", so kann auch Lx-Office mit UTF-8 betrieben werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und @@ -169,43 +169,43 @@ Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden: `pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername' - Die Datenbankversionsnummer muss an die tatsächlich verwendete + Die Datenbankversionsnummer muss an die tatsächlich verwendete Versionsnummer angepasst werden. - Unter anderen Distributionen gibt es ähnliche Methoden. + Unter anderen Distributionen gibt es ähnliche Methoden. Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist -ein Neuanlegen eines weiteren Clusters nicht möglich, so kann Lx-Office +ein Neuanlegen eines weiteren Clusters nicht möglich, so kann Lx-Office mit ISO-8859-15 als Encoding betrieben werden. - Das Encoding einer Datenbank kann in `psql' mit `\l' geprüft werden. + Das Encoding einer Datenbank kann in `psql' mit `\l' geprüft werden. -4.2 Änderungen an Konfigurationsdateien -======================================= +4.2 Änderungen an Konfigurationsdateien +======================================== In der Datei `postgresql.conf', die je nach Distribution in verschiedenen Verzeichnissen liegen kann (z.B. `/var/lib/pgsql/data/' oder `/etc/postgresql/', muss sichergestellt werden, dass -TCP/IP-Verbindungen aktiviert sind. Für PostgreSQL vor Version v8.0 +TCP/IP-Verbindungen aktiviert sind. Für PostgreSQL vor Version v8.0 lautete dieser Parameter `TCPIP_SOCKET = 1' - Ab v8.0 wird das Verhalten hingegen über den neuen Parameter + Ab v8.0 wird das Verhalten hingegen über den neuen Parameter `listen_address' gesteuert. Laufen PostgreSQL und Lx-Office auf demselben Rechner, so kann dort der Wert `localhost' verwendet werden. -Andernfalls müssen Datenbankverbindungen auch von anderen Rechnern aus +Andernfalls müssen Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden, was mit dem Wert \`*' geschieht. In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die -`postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für -den Zugriff geändert werden. Hier gibt es mehrere Möglichkeiten. Eine +`postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für +den Zugriff geändert werden. Hier gibt es mehrere Möglichkeiten. Eine besteht darin, lokale Verbindungen immer zuzulassen `local all all trust host all all 127.0.0.1 255.0.0.0 trust' - Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort + Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort zuzulassen. Beispielsweise: `local all lxoffice @@ -213,12 +213,12 @@ zuzulassen. Beispielsweise: host all lxoffice 127.0.0.1 255.255.255.255 password' -4.3 Erweiterung für servergespeicherte Prozeduren -================================================= +4.3 Erweiterung für servergespeicherte Prozeduren +================================================== -In der Datenbank `template1' muss die Unterstützung für -servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür -als Benutzer "postgres" an der Datenbank an, und führen Sie die +In der Datenbank `template1' muss die Unterstützung für +servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür +als Benutzer "postgres" an der Datenbank an, und führen Sie die folgenden Kommandos aus: `create function plpgsql_call_handler () returns opaque as @@ -236,20 +236,20 @@ Ubuntu 9.10 unter `/usr/lib/postgresql/8.4/lib/plpgsql.so'. Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein -Beispiel, wie Sie einen neuen Benutzer anlegen können: +Beispiel, wie Sie einen neuen Benutzer anlegen können: `su - postgres createuser -d -P lxoffice' - Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie + Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer "postgres" auf "lxoffice" bzw. den -hier gewählten Benutzernamen. +hier gewählten Benutzernamen. 5 Apache-Konfiguration ********************** Der Zugriff auf das Programmverzeichnis muss in der Apache -Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie +Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu, die beim Starten des Webservers eingelesen wird: @@ -272,7 +272,7 @@ Lx-Office-Archiv entpacket haben. ein Plus `+' gesetzt werden. Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets -nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die folgende +nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die folgende Option in die Konfiguration aufzunehmen: `EnableSendfile Off' @@ -280,27 +280,27 @@ Option in die Konfiguration aufzunehmen: 6 Benutzerauthentifizierung und Administratorpasswort ***************************************************** -Informationen über die Einrichtung der Benutzerauthentifizierung, über +Informationen über die Einrichtung der Benutzerauthentifizierung, über die Verwaltung von Gruppen und weitere Einstellungen 6.1 Grundlagen zur Benutzerauthentifizierung ============================================ Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die -im folgenden "Authentifizierungsdatenbank" genannt wird. Für jeden -Benutzer kann dort eine eigene Datenbank für die eigentlichen -Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen +im folgenden "Authentifizierungsdatenbank" genannt wird. Für jeden +Benutzer kann dort eine eigene Datenbank für die eigentlichen +Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen aber nicht unterschiedlich sein. - Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank, + Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank, in der sowohl die Benutzerinformationen als auch die Daten abgelegt werden. - Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter + Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter entweder gegen die Authentifizierungsdatenbank oder gegen einen -LDAP-Server überprüft werden. +LDAP-Server überprüft werden. - Welche Art der Passwortüberprüfung Lx-Office benutzt und wie + Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss bei der Installation und bei einem Upgrade von einer Version vor v2.6.0 @@ -313,8 +313,8 @@ werden kann. Das Passwort, das zum Zugriff auf das Aministrationsinterface 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 `$self->{admin_password}'. +und nicht mehr im Administrationsinterface selber geändert werden. Der +Parameter dazu heißt `$self->{admin_password}'. 6.3 Authentifizierungsdatenbank =============================== @@ -332,27 +332,27 @@ anzugeben: * `user' - Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. "postgres") - * `password' - Das Passwort für den Datenbankbenutzer + * `password' - Das Passwort für den Datenbankbenutzer Die Datenbank muss noch nicht existieren. Lx-Office kann sie automatisch anlegen (mehr dazu siehe unten). -6.4 Passwortüberprüfung -======================= +6.4 Passwortüberprüfung +========================= -Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die +Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die Authentifizierungsdatenbank und gegen einen externen LDAP- oder Active-Directory-Server. Welche davon benutzt wird, regelt der Parameter `$self->{module}'. - Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank + Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank gespeichert werden, so muss der Parameter `$self->{module}' den Wert -`DB' enthalten. In diesem Fall können sowohl der Administrator als auch -die Benutzer selber ihre Psaswörter in Lx-Office ändern. +`DB' enthalten. In diesem Fall können sowohl der Administrator als auch +die Benutzer selber ihre Psaswörter in Lx-Office ändern. Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt werden, so muss der Parameter `$self->{module}' auf `LDAP' gesetzt -werden. In diesem Fall müssen zusätzliche Informationen über den +werden. In diesem Fall müssen zusätzliche Informationen über den LDAP-Server in `$self->{LDAP_config}' angegeben werden: * `host' - Der Rechnername oder die IP-Adresse des LDAP- oder @@ -360,18 +360,18 @@ LDAP-Server in `$self->{LDAP_config}' angegeben werden: * `port' - Die Portnummer des LDAP-Servers; meist 389. - * `tls' - Wenn Verbindungsverschlüsselung gewünscht ist, so diesen + * `tls' - Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf `1' setzen, andernfalls auf `0' belassen * `attribute' - Das LDAP-Attribut, in dem der Benutzername steht, - den der Benutzer eingegeben hat. Für Active-Directory-Server ist - dies meist `sAMAccountName', für andere LDAP-Server hingegen + den der Benutzer eingegeben hat. Für Active-Directory-Server ist + dies meist `sAMAccountName', für andere LDAP-Server hingegen `uid'. Diese Angabe ist zwingend erforderlich. * `base_dn' - Der Abschnitt des LDAP-Baumes, der durchsucht werden soll. Diese Angabe ist zwingend erforderlich. - * `filter' - Ein optionaler LDAP-Filter. Enthält dieser Filter das + * `filter' - Ein optionaler LDAP-Filter. Enthält dieser Filter das Wort `<%login%>', so wird dieses durch den vom Benutzer eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum nach einem Element durchsucht, bei dem das oben angegebene Attribut @@ -380,7 +380,7 @@ LDAP-Server in `$self->{LDAP_config}' angegeben werden: * `bind_dn' und `bind_password' - Wenn der LDAP-Server eine Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist dies bei Active-Directory-Servern der Fall), so kann diese hier - angegeben werden. Für Active-Directory-Server kann als `bind_dn' + angegeben werden. Für Active-Directory-Server kann als `bind_dn' entweder eine komplette LDAP-DN wie z.B. `cn=Martin Mustermann,cn=Users,dc=firmendomain' auch nur der volle Name des Benutzers eingegeben werden; in diesem Beispiel also `Martin @@ -390,7 +390,7 @@ LDAP-Server in `$self->{LDAP_config}' angegeben werden: ============================ Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt -werden, so müssen die Namen der Session-Cookies für alle Installationen +werden, so müssen die Namen der Session-Cookies für alle Installationen unterschiedlich sein. Der Name des Cookies wird mit dem Parameter `$self->{cookie_name}' gesetzt. @@ -410,8 +410,8 @@ das unter der folgenden URL erreichbar sein sollte: 7 Benutzer- und Gruppenverwaltung ********************************* -Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt -werden. Dieses geschieht im Administrationsmenü, das Sie unter +Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt +werden. Dieses geschieht im Administrationsmenü, das Sie unter folgender URL finden: `http://localhost/lx-erp/admin.pl' @@ -419,31 +419,31 @@ folgender URL finden: Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei `config/authentication.pl' eingetragen haben. -7.1 Zusammenhänge -================= +7.1 Zusammenhänge +================== Lx-Office verwendet eine Datenbank zum Speichern all seiner Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um -mit Lx-Office arbeiten zu können, muss eine Person einen +mit Lx-Office arbeiten zu können, muss eine Person einen Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist -möglich und normal, dass mehreren Benutzern die selbe Datenbank -zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können. +möglich und normal, dass mehreren Benutzern die selbe Datenbank +zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können. Die Basisdaten der Benutzer, die in der Administration eingegeben -werden können, werden in einer zweiten Datenbank gespeichert, der -bereits erwähnten Authentifizierungsdatenbank. Diese ist also den +werden können, werden in einer zweiten Datenbank gespeichert, der +bereits erwähnten Authentifizierungsdatenbank. Diese ist also den Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank, aber beliebig viele Datenbanken mit Firmendaten. Lx-Office kann seinen Benutzern Zugriff auf bestimmte Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht -gestattet, so werden der entsprechenden Menüpunkte auch nicht +gestattet, so werden der entsprechenden Menüpunkte auch nicht angezeigt. Diese Rechte werden ebenfalls in der Authentifizierungsdatenbank gespeichert. - Um Rechte verteilen zu können, verwendet Lx-Office ein + Um Rechte verteilen zu können, verwendet Lx-Office ein Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen @@ -464,19 +464,19 @@ angelegt werden sollten, lautet: 7.2 Datenbanken anlegen ======================= -Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den +Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen ist dies `lxoffice'). - Wenn Sie für die Lx-Office-Installation nicht den europäischen + Wenn Sie für die Lx-Office-Installation nicht den europäischen Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so -müssen Sie vor dem Anlegen der Datenbank in der Datei +müssen Sie vor dem Anlegen der Datenbank in der Datei `config/lx-erp.conf' die Variable `$dbcharset' auf den Wert `UTF-8' -setzen. Zusätzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als -Schriftsatz ausgewählt werden. +setzen. Zusätzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als +Schriftsatz ausgewählt werden. Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz -verwenden müssen, da diese Einstellungen momentan global in Lx-Office +verwenden müssen, da diese Einstellungen momentan global in Lx-Office vorgenommen wird und nicht nach Datenbank unterschieden werden kann. Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz angelegt worden sein. @@ -486,72 +486,72 @@ angelegt worden sein. Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name gegeben werden, eine Beschreibung ist hingegen optional. Nach dem -Anlegen können Sie die verschiedenen Bereiche wählen, auf die +Anlegen können Sie die verschiedenen Bereiche wählen, auf die Mitglieder dieser Gruppe Zugriff haben sollen. - Benutzergruppen sind unabhängig von Datenbanken, da sie in der -Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle + Benutzergruppen sind unabhängig von Datenbanken, da sie in der +Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle Datenbanken, die in dieser Installation verwaltet werden. 7.4 Benutzer anlegen ==================== -Beim Anlegen von Benutzern werden für viele Parameter +Beim Anlegen von Benutzern werden für viele Parameter Standardeinstellungen vorgenommen, die den Gepflogenheiten des deutschen Raumes entsprechen. Zwingend anzugeben sind der Loginname sowie die komplette -Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die +Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort -gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung +gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung aktiv, so ist das Passwort-Feld deaktiviert. - In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben + In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben angelegten Datenbanken eingetragen werden. 7.5 Gruppenmitgliedschaften verwalten ===================================== -Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen -zugewiesen werden. Dazu gibt es zwei Möglichkeiten: +Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen +zugewiesen werden. Dazu gibt es zwei Möglichkeiten: - 1. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden - Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen. + 1. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden + Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen. - 2. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der + 2. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im - System angelegten Gruppen und Benutzer enthält. Durch Setzen der - Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in - der ausgewählten Spalte hinzugefügt. + System angelegten Gruppen und Benutzer enthält. Durch Setzen der + Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in + der ausgewählten Spalte hinzugefügt. 7.6 Migration alter Installationen ================================== -Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, +Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, in der die Benutzerdaten noch im Dateisystem im Verzeichnis `users' -verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese +verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten automatisch in die Authentifizierungsdatenbank zu -übernehmen. Dies geschieht, wenn man sich nach dem Update der +übernehmen. Dies geschieht, wenn man sich nach dem Update der Installation das erste Mal im Administrationsbereich anmeldet. Findet Lx-Office die Datei `users/members', so wird der Migrationsprozess gestartet. Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten -können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch -die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird. -Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gewährt. +können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch +die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird. +Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gewährt. Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird das Verhalten von Lx-Office bis Version 2.4.3 inklusive -wiederhergestellt, und die Benutzer können sich sofort wieder anmelden +wiederhergestellt, und die Benutzer können sich sofort wieder anmelden und mit dem System arbeiten. 8 OpenDocument-Vorlagen *********************** -Lx-Office unterstützt die Verwendung von Vorlagen im +Lx-Office unterstützt die Verwendung von Vorlagen im OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus -diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von +diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren muss in der Datei `config/lx-erp.conf' die Variable `$opendocument_templates' auf `1' stehen. Dieses ist die Standardeinstellung. @@ -559,35 +559,35 @@ stehen. Dieses ist die Standardeinstellung. Weiterhin muss in der Datei `config/lx-erp.conf' die Variable `$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den -meisten Fällen "ISO-8859-15". +meisten Fällen "ISO-8859-15". - Während die Erzeugung von reinen OpenDocument-Dateien keinerlei -weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF -OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss + Während die Erzeugung von reinen OpenDocument-Dateien keinerlei +weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF +OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer" (xvfb) installiert werden. Bei Debian ist er im Paket "xvfb" enthalten. Andere Distributionen enthalten ihn in anderen Paketen. - Nach der Installation müssen in der Datei `config/lx-erp.conf' zwei + Nach der Installation müssen in der Datei `config/lx-erp.conf' zwei weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss -den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. +den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. `$xvfb_bin' muss den Pfad zum "X virtual frame buffer" enthalten. - Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit + Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die Variable `$openofficeorg_daemon' gesetzt ist, startet ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich reduziert wird, weil -nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der +nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der Nachteil ist, dass diese Methode Python und die Python-UNO-Bindings -benötigt, die Bestandteil von OpenOffice 2 sind. +benötigt, die Bestandteil von OpenOffice 2 sind. - Ist `$openofficeorg_daemon' nicht gesetzt, so wird für jedes + Ist `$openofficeorg_daemon' nicht gesetzt, so wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe eines -Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage -enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die -Beispielvorlage `templates/German-invoice.odt' enthält ein solches +Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage +enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die +Beispielvorlage `templates/German-invoice.odt' enthält ein solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein muss. @@ -596,14 +596,14 @@ Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian ist dies momentan `~/.openoffice.org2'. Sollte der Name bei Ihrer OpenOffice.org-Installation anders sein, so muss das Verzeichnis `users/.openoffice.org2' entsprechend umbenannt werden. Ist der Name -z.B. einfach nur `.openoffice', so wäre folgender Befehl auszuführen: +z.B. einfach nur `.openoffice', so wäre folgender Befehl auszuführen: `mv users/.openoffice.org2 users/.openoffice' Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss vom Webserver beschreibbar sein. Dieses wurde in Schritt `Installation -des Programmpakets' oben bereits erledigt, kann aber erneut überprüft -werden, wenn die Konvertierung nach PDF fehlschlägt. +des Programmpakets' oben bereits erledigt, kann aber erneut überprüft +werden, wenn die Konvertierung nach PDF fehlschlägt. 9 Lx-Office ERP verwenden ************************* diff --git a/doc/INSTALL/Administratorpasswort.html b/doc/INSTALL/Administratorpasswort.html index 8a20b0809..a527f3c88 100644 --- a/doc/INSTALL/Administratorpasswort.html +++ b/doc/INSTALL/Administratorpasswort.html @@ -36,8 +36,8 @@ aufwärts:  - + + + +
+

+ + +nächstes: , +voriges: Aktuelle Hinweise, +aufwärts: Top +

+
+ +

2 Benötigte Software und Pakete

+ +

Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt. + +

Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: + +

+ +

Diese Pakete können bei den unterschiedlichen Distributionen anders heißen. + +

Für Debian oder Ubuntu benötigen Sie diese Pakete: + +

apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl libyaml-perl libtext-csv-xs-perl libio-stringy-perl libtemplate-perl lib-uriperl libxml-simple-perl + +

Für Fedora Core benötigen Sie unter anderem diese Pakete: + +

httpd postgresql-server perl-DBI perl-DBD-Pg + +

Für OpenSuSE benötigen Sie diese Pakete: + +

apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy perl-Template-Toolkit perl-URI perl-XML-Writer + +

Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als +Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren. +In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback. + +

Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle +benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: + +

./scripts/installation_check.pl + + + + diff --git a/doc/INSTALL/Ben_00f6tigte-Software-und-Pakete.html b/doc/INSTALL/Ben_00f6tigte-Software-und-Pakete.html deleted file mode 100644 index 813fb6e8b..000000000 --- a/doc/INSTALL/Ben_00f6tigte-Software-und-Pakete.html +++ /dev/null @@ -1,82 +0,0 @@ - - -Benötigte Software und Pakete - Lx-Office Installationsanleitung - - - - - - - - - - - -

-

- - -nächstes: , -voriges: Aktuelle Hinweise, -aufwärts: Top -

-
- -

2 Benötigte Software und Pakete

- -

Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt. - -

Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: - -

- -

Diese Pakete können bei den unterschiedlichen Distributionen anders heißen. - -

Für Debian oder Ubuntu benötigen Sie diese Pakete: - -

apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl libclass-accessor-perl libarchive-zip-perl libtext-iconv-perl libyaml-perl libtext-csv-perl libio-stringy-perl libtemplate-perl - -

Für Fedora Core benötigen Sie unter anderem diese Pakete: - -

httpd postgresql-server perl-DBI perl-DBD-Pg - -

Für OpenSuSE benötigen Sie diese Pakete: - -

apache2 postgresql-server perl-DBI perl-DBD-Pg perl-Archive-Zip perl-Class-Accessor perl-Text-Iconv perl-Text-CSV_XS perl-IO-stringy perl-Template-Toolkit - -

Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als -Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren. -In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback. - -

Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle -benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: - -

./scripts/installation_check.pl - - - - diff --git a/doc/INSTALL/Benutzer-anlegen.html b/doc/INSTALL/Benutzer-anlegen.html index e677dc68b..176e4d992 100644 --- a/doc/INSTALL/Benutzer-anlegen.html +++ b/doc/INSTALL/Benutzer-anlegen.html @@ -34,17 +34,17 @@ aufwärts: 7.4 Benutzer anlegen -

Beim Anlegen von Benutzern werden für viele Parameter +

Beim Anlegen von Benutzern werden für viele Parameter Standardeinstellungen vorgenommen, die den Gepflogenheiten des deutschen Raumes entsprechen.

Zwingend anzugeben sind der Loginname sowie die komplette -Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die +Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort -gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung +gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung aktiv, so ist das Passwort-Feld deaktiviert. -

In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben +

In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben angelegten Datenbanken eingetragen werden. diff --git a/doc/INSTALL/Benutzer_002d-und-Gruppenverwaltung.html b/doc/INSTALL/Benutzer_002d-und-Gruppenverwaltung.html index dfa8e06c1..e9d126ec4 100644 --- a/doc/INSTALL/Benutzer_002d-und-Gruppenverwaltung.html +++ b/doc/INSTALL/Benutzer_002d-und-Gruppenverwaltung.html @@ -34,8 +34,8 @@ aufwärts: Top

7 Benutzer- und Gruppenverwaltung

-

Nach der Installation müssen Benutzer, Gruppen und Datenbanken -angelegt werden. Dieses geschieht im Administrationsmenü, das Sie +

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

http://localhost/lx-erp/admin.pl @@ -44,12 +44,12 @@ unter folgender URL finden: config/authentication.pl eingetragen haben.

diff --git a/doc/INSTALL/Benutzerauthentifizierung-und-Administratorpasswort.html b/doc/INSTALL/Benutzerauthentifizierung-und-Administratorpasswort.html index af329a278..c430bb838 100644 --- a/doc/INSTALL/Benutzerauthentifizierung-und-Administratorpasswort.html +++ b/doc/INSTALL/Benutzerauthentifizierung-und-Administratorpasswort.html @@ -33,15 +33,15 @@ aufwärts: Top

6 Benutzerauthentifizierung und Administratorpasswort

-

Informationen über die Einrichtung der Benutzerauthentifizierung, über +

Informationen über die Einrichtung der Benutzerauthentifizierung, über die Verwaltung von Gruppen und weitere Einstellungen

diff --git a/doc/INSTALL/Datenbankbenutzer-anlegen.html b/doc/INSTALL/Datenbankbenutzer-anlegen.html index 1a3042db4..f389fdf74 100644 --- a/doc/INSTALL/Datenbankbenutzer-anlegen.html +++ b/doc/INSTALL/Datenbankbenutzer-anlegen.html @@ -6,7 +6,7 @@ - + + + +
+

+ + +nächstes: , +voriges: Ã„nderungen an Konfigurationsdateien, +aufwärts: Anpassung der PostgreSQL-Konfiguration +

+
+ +

4.3 Erweiterung für servergespeicherte Prozeduren

+ +

In der Datenbank template1 muss die Unterstützung für +servergespeicherte Prozeduren eingerichet werden. Melden Sie sich +dafür als Benutzer “postgres” an der Datenbank an, und führen Sie +die folgenden Kommandos aus: + +

create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c'; +
+create language 'plpgsql' handler plpgsql_call_handler +lancompiler 'pl/pgsql'; + +

Bitte beachten Sie, dass der Pfad zur Datei plpgsql.so von +Distribution zu Distribution verschiedlich sein kann. Bei +Debian/Ubuntu befindet sie sich unter +/usr/lib/postgresql/lib/plpgsql.so, bei Ubuntu 9.10 unter /usr/lib/postgresql/8.4/lib/plpgsql.so. + + + + diff --git a/doc/INSTALL/Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html b/doc/INSTALL/Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html deleted file mode 100644 index 91bac5970..000000000 --- a/doc/INSTALL/Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html +++ /dev/null @@ -1,55 +0,0 @@ - - -Erweiterung für servergespeicherte Prozeduren - Lx-Office Installationsanleitung - - - - - - - - - - - - -

-

- - -nächstes: , -voriges: Änderungen an Konfigurationsdateien, -aufwärts: Anpassung der PostgreSQL-Konfiguration -

-
- -

4.3 Erweiterung für servergespeicherte Prozeduren

- -

In der Datenbank template1 muss die Unterstützung für -servergespeicherte Prozeduren eingerichet werden. Melden Sie sich -dafür als Benutzer “postgres” an der Datenbank an, und führen Sie -die folgenden Kommandos aus: - -

create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c'; -
-create language 'plpgsql' handler plpgsql_call_handler -lancompiler 'pl/pgsql'; - -

Bitte beachten Sie, dass der Pfad zur Datei plpgsql.so von -Distribution zu Distribution verschiedlich sein kann. Bei -Debian/Ubuntu befindet sie sich unter -/usr/lib/postgresql/lib/plpgsql.so, bei Ubuntu 9.10 unter /usr/lib/postgresql/8.4/lib/plpgsql.so. - - - - diff --git a/doc/INSTALL/Grundlagen-zur-Benutzerauthentifizierung.html b/doc/INSTALL/Grundlagen-zur-Benutzerauthentifizierung.html index f3b937524..f3ed47e79 100644 --- a/doc/INSTALL/Grundlagen-zur-Benutzerauthentifizierung.html +++ b/doc/INSTALL/Grundlagen-zur-Benutzerauthentifizierung.html @@ -33,20 +33,20 @@ aufwärts: 6.1 Grundlagen zur Benutzerauthentifizierung

Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die -im folgenden “Authentifizierungsdatenbank” genannt wird. Für jeden -Benutzer kann dort eine eigene Datenbank für die eigentlichen -Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen +im folgenden “Authentifizierungsdatenbank” genannt wird. Für jeden +Benutzer kann dort eine eigene Datenbank für die eigentlichen +Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen aber nicht unterschiedlich sein. -

Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank, +

Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank, in der sowohl die Benutzerinformationen als auch die Daten abgelegt werden. -

Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter +

Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter entweder gegen die Authentifizierungsdatenbank oder gegen einen -LDAP-Server überprüft werden. +LDAP-Server überprüft werden. -

Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office +

Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der Konfigurationsdatei config/authentication.pl festgelegt. Diese muss bei der Installation und bei einem Upgrade von einer Version vor diff --git a/doc/INSTALL/Gruppen-anlegen.html b/doc/INSTALL/Gruppen-anlegen.html index 757f3b299..5c7c32b5a 100644 --- a/doc/INSTALL/Gruppen-anlegen.html +++ b/doc/INSTALL/Gruppen-anlegen.html @@ -36,11 +36,11 @@ aufwärts: 7.5 Gruppenmitgliedschaften verwalten -

Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen -zugewiesen werden. Dazu gibt es zwei Möglichkeiten: +

Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen +zugewiesen werden. Dazu gibt es zwei Möglichkeiten:

    -
  1. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden -Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen. -
  2. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der +
  3. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden +Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen. +
  4. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im -System angelegten Gruppen und Benutzer enthält. Durch Setzen der -Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in der -ausgewählten Spalte hinzugefügt. +System angelegten Gruppen und Benutzer enthält. Durch Setzen der +Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in der +ausgewählten Spalte hinzugefügt.
diff --git a/doc/INSTALL/Installation-des-Programmpaketes.html b/doc/INSTALL/Installation-des-Programmpaketes.html index a9b308c40..ab54f94db 100644 --- a/doc/INSTALL/Installation-des-Programmpaketes.html +++ b/doc/INSTALL/Installation-des-Programmpaketes.html @@ -5,7 +5,7 @@ - + @@ -26,7 +26,7 @@

nächstes: , -voriges: Benötigte Software und Pakete, +voriges: Benötigte Software und Pakete, aufwärts: Top

@@ -41,28 +41,28 @@ Dokumentenverzeichnis des Webservers (z.B. /var/www/html/,
tar xvzf lxoffice-erp-2.6.1beta1.tgz -

Verändern Sie evtl. noch den Namen des Verzeichnisses mit +

Verändern Sie evtl. noch den Namen des Verzeichnisses mit

mv lxoffice-erp/ lx-erp/ -

Alternativ können Sie auch einen Alias in der Webserverkonfiguration -benutzen, um auf das tatsächliche Installationsverzeichnis zu +

Alternativ können Sie auch einen Alias in der Webserverkonfiguration +benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen. -

Die Verzeichnisse users, spool und webdav müssen -für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die -restlichen Dateien müssen für diesen Benutzer lesbar sein. Der +

Die Verzeichnisse users, spool und webdav müssen +für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die +restlichen Dateien müssen für diesen Benutzer lesbar sein. Der Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B. bei Debian/Ubuntu www-data, bei Fedora core apache oder bei OpenSuSE wwwrun). -

Der folgende Befehl ändert den Besitzer für die oben genannten +

Der folgende Befehl ändert den Besitzer für die oben genannten Verzeichnisse auf einem Debian/Ubuntu-System:

chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav -

Weiterhin muss der Webserver-Benutzer im Verzeichnis templates Verzeichnisse für -jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen: +

Weiterhin muss der Webserver-Benutzer im Verzeichnis templates Verzeichnisse für +jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen:

chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates diff --git a/doc/INSTALL/Migration-alter-Installationen.html b/doc/INSTALL/Migration-alter-Installationen.html index d1f12a88f..81cc23900 100644 --- a/doc/INSTALL/Migration-alter-Installationen.html +++ b/doc/INSTALL/Migration-alter-Installationen.html @@ -32,22 +32,22 @@ aufwärts: 7.6 Migration alter Installationen -

Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, in der +

Wenn Lx-Office 2.6.1 Beta 1 über eine ältere Version installiert wird, in der die Benutzerdaten noch im Dateisystem im Verzeichnis users -verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese +verwaltet wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten automatisch in die Authentifizierungsdatenbank zu -übernehmen. Dies geschieht, wenn man sich nach dem Update der +übernehmen. Dies geschieht, wenn man sich nach dem Update der Installation das erste Mal im Administrationsbereich anmeldet. Findet Lx-Office die Datei users/members, so wird der Migrationsprozess gestartet.

Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten -können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch -die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt +können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch +die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird. Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office -gewährt. Alle migrierten Benutzern werden Mitglied in dieser +gewährt. Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird das Verhalten von Lx-Office bis Version 2.4.3 -inklusive wiederhergestellt, und die Benutzer können sich sofort +inklusive wiederhergestellt, und die Benutzer können sich sofort wieder anmelden und mit dem System arbeiten. diff --git a/doc/INSTALL/Name-des-Session_002dCookies.html b/doc/INSTALL/Name-des-Session_002dCookies.html index 353df4817..6b3b2ba61 100644 --- a/doc/INSTALL/Name-des-Session_002dCookies.html +++ b/doc/INSTALL/Name-des-Session_002dCookies.html @@ -6,7 +6,7 @@ - + @@ -28,7 +28,7 @@ nächstes: , -voriges: Passwortüberprüfung, +voriges: Passwortüberprüfung, aufwärts: Benutzerauthentifizierung und Administratorpasswort

@@ -36,7 +36,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 +werden, so müssen die Namen der Session-Cookies für alle Installationen unterschiedlich sein. Der Name des Cookies wird mit dem Parameter $self->{cookie_name} gesetzt. diff --git a/doc/INSTALL/OpenDocument_002dVorlagen.html b/doc/INSTALL/OpenDocument_002dVorlagen.html index 466bdf2ee..06c001f2b 100644 --- a/doc/INSTALL/OpenDocument_002dVorlagen.html +++ b/doc/INSTALL/OpenDocument_002dVorlagen.html @@ -34,10 +34,10 @@ aufwärts: Top

8 OpenDocument-Vorlagen

-

Lx-Office unterstützt die Verwendung von Vorlagen im +

Lx-Office unterstützt die Verwendung von Vorlagen im OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als -auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von +auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren muss in der Datei config/lx-erp.conf die Variable $opendocument_templates auf ‘1’ stehen. Dieses ist die Standardeinstellung. @@ -45,37 +45,37 @@ auf ‘1’ stehen. Dieses ist d

Weiterhin muss in der Datei config/lx-erp.conf die Variable $dbcharset auf die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der Daten in der Datenbank verwendet wird. Diese -ist in den meisten Fällen "ISO-8859-15". +ist in den meisten Fällen "ISO-8859-15". -

Während die Erzeugung von reinen OpenDocument-Dateien keinerlei -weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF -OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss +

Während die Erzeugung von reinen OpenDocument-Dateien keinerlei +weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF +OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss neben OpenOffice.org ab Version 2 auch der “X virtual frame buffer” (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten. Andere Distributionen enthalten ihn in anderen Paketen. -

Nach der Installation müssen in der Datei config/lx-erp.conf +

Nach der Installation müssen in der Datei config/lx-erp.conf zwei weitere Variablen angepasst werden: -$openofficeorg_writer_bin muss den vollständigen Pfad zur +$openofficeorg_writer_bin muss den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. $xvfb_bin muss den Pfad zum “X virtual frame buffer” enthalten. -

Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit +

Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die Variable $openofficeorg_daemon gesetzt ist, startet ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich -reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet +reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der Nachteil ist, dass diese Methode Python und die -Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind. +Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind. -

Ist $openofficeorg_daemon nicht gesetzt, so wird für jedes +

Ist $openofficeorg_daemon nicht gesetzt, so wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe -eines Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage +eines Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage enthalten sein und “Standard.Conversion.ConvertSelfToPDF()” -heißen. Die Beispielvorlage ‘templates/German-invoice.odt’ -enthält ein solches Makro, das in jeder anderen Dokumentenvorlage +heißen. Die Beispielvorlage ‘templates/German-invoice.odt’ +enthält ein solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein muss.

Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org @@ -83,16 +83,16 @@ Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian ist dies momentan ~/.openoffice.org2. Sollte der Name bei Ihrer OpenOffice.org-Installation anders sein, so muss das Verzeichnis users/.openoffice.org2 entsprechend umbenannt -werden. Ist der Name z.B. einfach nur .openoffice, so wäre -folgender Befehl auszuführen: +werden. Ist der Name z.B. einfach nur .openoffice, so wäre +folgender Befehl auszuführen:

mv users/.openoffice.org2 users/.openoffice

Dieses Verzeichnis, wie auch das komplette users-Verzeichnis, muss vom Webserver beschreibbar sein. Dieses wurde in Schritt Installation des Programmpakets oben bereits erledigt, kann -aber erneut überprüft werden, wenn die Konvertierung nach PDF -fehlschlägt. +aber erneut überprüft werden, wenn die Konvertierung nach PDF +fehlschlägt. diff --git a/doc/INSTALL/Passwort_00c3_00bcberpr_00c3_00bcfung.html b/doc/INSTALL/Passwort_00c3_00bcberpr_00c3_00bcfung.html new file mode 100644 index 000000000..83e634c6c --- /dev/null +++ b/doc/INSTALL/Passwort_00c3_00bcberpr_00c3_00bcfung.html @@ -0,0 +1,71 @@ + + +Passwortüberprüfung - Lx-Office Installationsanleitung + + + + + + + + + + + + +

+

+ + +nächstes: , +voriges: Authentifizierungsdatenbank, +aufwärts: Benutzerauthentifizierung und Administratorpasswort +

+
+ +

6.4 Passwortüberprüfung

+ +

Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die +Authentifizierungsdatenbank und gegen einen externen LDAP- oder +Active-Directory-Server. Welche davon benutzt wird, regelt der +Parameter $self->{module}. + +

Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank +gespeichert werden, so muss der Parameter $self->{module} den +Wert ‘DB’ enthalten. In diesem Fall können sowohl der +Administrator als auch die Benutzer selber ihre Psaswörter in +Lx-Office ändern. + +

Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt +werden, so muss der Parameter $self->{module} auf ‘LDAP’ +gesetzt werden. In diesem Fall müssen zusätzliche Informationen über +den LDAP-Server in $self->{LDAP_config} angegeben werden: + +

+ + + diff --git a/doc/INSTALL/Passwort_00fcberpr_00fcfung.html b/doc/INSTALL/Passwort_00fcberpr_00fcfung.html deleted file mode 100644 index 034ad6096..000000000 --- a/doc/INSTALL/Passwort_00fcberpr_00fcfung.html +++ /dev/null @@ -1,71 +0,0 @@ - - -Passwortüberprüfung - Lx-Office Installationsanleitung - - - - - - - - - - - - -
-

- - -nächstes: , -voriges: Authentifizierungsdatenbank, -aufwärts: Benutzerauthentifizierung und Administratorpasswort -

-
- -

6.4 Passwortüberprüfung

- -

Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die -Authentifizierungsdatenbank und gegen einen externen LDAP- oder -Active-Directory-Server. Welche davon benutzt wird, regelt der -Parameter $self->{module}. - -

Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank -gespeichert werden, so muss der Parameter $self->{module} den -Wert ‘DB’ enthalten. In diesem Fall können sowohl der -Administrator als auch die Benutzer selber ihre Psaswörter in -Lx-Office ändern. - -

Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt -werden, so muss der Parameter $self->{module} auf ‘LDAP’ -gesetzt werden. In diesem Fall müssen zusätzliche Informationen über -den LDAP-Server in $self->{LDAP_config} angegeben werden: - -

- - - diff --git a/doc/INSTALL/Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8.html b/doc/INSTALL/Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8.html new file mode 100644 index 000000000..df9f9cc45 --- /dev/null +++ b/doc/INSTALL/Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8.html @@ -0,0 +1,62 @@ + + +Zeichensätze/die Verwendung von UTF-8 - Lx-Office Installationsanleitung + + + + + + + + + + + +
+

+ + +nächstes: , +aufwärts: Anpassung der PostgreSQL-Konfiguration +

+
+ +

4.1 Zeichensätze/die Verwendung von UTF-8

+ +

Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet +werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in +Version 8.0 oder neuer benutzt werden, und der +PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale +angelegt worden sein. + +

Dieses ist kann überprüft werden: ist das Encoding der Datenbank +“template1” “UTF8”, so kann auch Lx-Office mit UTF-8 betrieben +werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit +UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und +Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden: + +

pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername + +

Die Datenbankversionsnummer muss an die tatsächlich verwendete +Versionsnummer angepasst werden. + +

Unter anderen Distributionen gibt es ähnliche Methoden. + +

Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist +ein Neuanlegen eines weiteren Clusters nicht möglich, so kann +Lx-Office mit ISO-8859-15 als Encoding betrieben werden. + +

Das Encoding einer Datenbank kann in psql mit \l geprüft werden. + + + diff --git a/doc/INSTALL/Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8.html b/doc/INSTALL/Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8.html deleted file mode 100644 index 45243902e..000000000 --- a/doc/INSTALL/Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8.html +++ /dev/null @@ -1,62 +0,0 @@ - - -Zeichensätze/die Verwendung von UTF-8 - Lx-Office Installationsanleitung - - - - - - - - - - - -

-

- - -nächstes: , -aufwärts: Anpassung der PostgreSQL-Konfiguration -

-
- -

4.1 Zeichensätze/die Verwendung von UTF-8

- -

Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet -werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in -Version 8.0 oder neuer benutzt werden, und der -PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale -angelegt worden sein. - -

Dieses ist kann überprüft werden: ist das Encoding der Datenbank -“template1” “UTF8”, so kann auch Lx-Office mit UTF-8 betrieben -werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit -UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und -Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden: - -

pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername - -

Die Datenbankversionsnummer muss an die tatsächlich verwendete -Versionsnummer angepasst werden. - -

Unter anderen Distributionen gibt es ähnliche Methoden. - -

Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist -ein Neuanlegen eines weiteren Clusters nicht möglich, so kann -Lx-Office mit ISO-8859-15 als Encoding betrieben werden. - -

Das Encoding einer Datenbank kann in psql mit \l geprüft werden. - - - diff --git a/doc/INSTALL/Zusammenh_00c3_00a4nge.html b/doc/INSTALL/Zusammenh_00c3_00a4nge.html new file mode 100644 index 000000000..62f3d3254 --- /dev/null +++ b/doc/INSTALL/Zusammenh_00c3_00a4nge.html @@ -0,0 +1,75 @@ + + +Zusammenhänge - Lx-Office Installationsanleitung + + + + + + + + + + + +

+

+ + +nächstes: , +aufwärts: Benutzer- und Gruppenverwaltung +

+
+ +

7.1 Zusammenhänge

+ +

Lx-Office verwendet eine Datenbank zum Speichern all seiner +Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um +mit Lx-Office arbeiten zu können, muss eine Person einen +Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine +Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist +möglich und normal, dass mehreren Benutzern die selbe Datenbank +zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können. + +

Die Basisdaten der Benutzer, die in der Administration eingegeben +werden können, werden in einer zweiten Datenbank gespeichert, der +bereits erwähnten Authentifizierungsdatenbank. Diese ist also den +Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro +Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank, +aber beliebig viele Datenbanken mit Firmendaten. + +

Lx-Office kann seinen Benutzern Zugriff auf bestimmte +Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht +gestattet, so werden der entsprechenden Menüpunkte auch nicht +angezeigt. Diese Rechte werden ebenfalls in der +Authentifizierungsdatenbank gespeichert. + +

Um Rechte verteilen zu können, verwendet Lx-Office ein +Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche +erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder +mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen +Funktionen, die mindestens einer Gruppe erlaubt sind, in der der +Benutzer Mitglied ist. + +

Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer +angelegt werden sollten, lautet: + +

    +
  1. Datenbank anlegen +
  2. Gruppen anlegen +
  3. Benutzer anlegen +
  4. Benutzer den Gruppen zuordnen +
+ + + diff --git a/doc/INSTALL/Zusammenh_00e4nge.html b/doc/INSTALL/Zusammenh_00e4nge.html deleted file mode 100644 index 01e657ef9..000000000 --- a/doc/INSTALL/Zusammenh_00e4nge.html +++ /dev/null @@ -1,75 +0,0 @@ - - -Zusammenhänge - Lx-Office Installationsanleitung - - - - - - - - - - - -
-

- - -nächstes: , -aufwärts: Benutzer- und Gruppenverwaltung -

-
- -

7.1 Zusammenhänge

- -

Lx-Office verwendet eine Datenbank zum Speichern all seiner -Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um -mit Lx-Office arbeiten zu können, muss eine Person einen -Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine -Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist -möglich und normal, dass mehreren Benutzern die selbe Datenbank -zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können. - -

Die Basisdaten der Benutzer, die in der Administration eingegeben -werden können, werden in einer zweiten Datenbank gespeichert, der -bereits erwähnten Authentifizierungsdatenbank. Diese ist also den -Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro -Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank, -aber beliebig viele Datenbanken mit Firmendaten. - -

Lx-Office kann seinen Benutzern Zugriff auf bestimmte -Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht -gestattet, so werden der entsprechenden Menüpunkte auch nicht -angezeigt. Diese Rechte werden ebenfalls in der -Authentifizierungsdatenbank gespeichert. - -

Um Rechte verteilen zu können, verwendet Lx-Office ein -Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche -erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder -mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen -Funktionen, die mindestens einer Gruppe erlaubt sind, in der der -Benutzer Mitglied ist. - -

Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer -angelegt werden sollten, lautet: - -

    -
  1. Datenbank anlegen -
  2. Gruppen anlegen -
  3. Benutzer anlegen -
  4. Benutzer den Gruppen zuordnen -
- - - diff --git a/doc/INSTALL/_00c3_0084nderungen-an-Konfigurationsdateien.html b/doc/INSTALL/_00c3_0084nderungen-an-Konfigurationsdateien.html new file mode 100644 index 000000000..30079c65e --- /dev/null +++ b/doc/INSTALL/_00c3_0084nderungen-an-Konfigurationsdateien.html @@ -0,0 +1,71 @@ + + +Änderungen an Konfigurationsdateien - Lx-Office Installationsanleitung + + + + + + + + + + + + +
+

+ + +nächstes: , +voriges: Zeichensätze/die Verwendung von UTF-8, +aufwärts: Anpassung der PostgreSQL-Konfiguration +

+
+ +

4.2 Änderungen an Konfigurationsdateien

+ +

In der Datei postgresql.conf, die je nach Distribution in +verschiedenen Verzeichnissen liegen kann +(z.B. /var/lib/pgsql/data/ oder /etc/postgresql/, muss +sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für +PostgreSQL vor Version v8.0 lautete dieser Parameter + +

TCPIP_SOCKET = 1 + +

Ab v8.0 wird das Verhalten hingegen über den neuen Parameter +listen_address gesteuert. Laufen PostgreSQL und Lx-Office auf +demselben Rechner, so kann dort der Wert localhost verwendet +werden. Andernfalls müssen Datenbankverbindungen auch von anderen +Rechnern aus zugelassen werden, was mit dem Wert \* geschieht. + +

In der Datei pg_hba.conf, die im gleichen Verzeichnis wie die +postgresql.conf zu finden sein sollte, müssen die +Berichtigungen für den Zugriff geändert werden. Hier gibt es mehrere +Möglichkeiten. Eine besteht darin, lokale Verbindungen immer +zuzulassen + +

local all all trust +
+host all all 127.0.0.1 255.0.0.0 trust + +

Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort +zuzulassen. Beispielsweise: + +

local all lxoffice password +
+host all lxoffice 127.0.0.1 255.255.255.255 password + + + + diff --git a/doc/INSTALL/_00c4nderungen-an-Konfigurationsdateien.html b/doc/INSTALL/_00c4nderungen-an-Konfigurationsdateien.html deleted file mode 100644 index a7b686551..000000000 --- a/doc/INSTALL/_00c4nderungen-an-Konfigurationsdateien.html +++ /dev/null @@ -1,71 +0,0 @@ - - -Änderungen an Konfigurationsdateien - Lx-Office Installationsanleitung - - - - - - - - - - - - -

-

- - -nächstes: , -voriges: Zeichensätze/die Verwendung von UTF-8, -aufwärts: Anpassung der PostgreSQL-Konfiguration -

-
- -

4.2 Änderungen an Konfigurationsdateien

- -

In der Datei postgresql.conf, die je nach Distribution in -verschiedenen Verzeichnissen liegen kann -(z.B. /var/lib/pgsql/data/ oder /etc/postgresql/, muss -sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für -PostgreSQL vor Version v8.0 lautete dieser Parameter - -

TCPIP_SOCKET = 1 - -

Ab v8.0 wird das Verhalten hingegen über den neuen Parameter -listen_address gesteuert. Laufen PostgreSQL und Lx-Office auf -demselben Rechner, so kann dort der Wert localhost verwendet -werden. Andernfalls müssen Datenbankverbindungen auch von anderen -Rechnern aus zugelassen werden, was mit dem Wert \* geschieht. - -

In der Datei pg_hba.conf, die im gleichen Verzeichnis wie die -postgresql.conf zu finden sein sollte, müssen die -Berichtigungen für den Zugriff geändert werden. Hier gibt es mehrere -Möglichkeiten. Eine besteht darin, lokale Verbindungen immer -zuzulassen - -

local all all trust -
-host all all 127.0.0.1 255.0.0.0 trust - -

Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort -zuzulassen. Beispielsweise: - -

local all lxoffice password -
-host all lxoffice 127.0.0.1 255.255.255.255 password - - - - diff --git a/doc/INSTALL/index.html b/doc/INSTALL/index.html index c2facf57e..530e496a0 100644 --- a/doc/INSTALL/index.html +++ b/doc/INSTALL/index.html @@ -26,13 +26,13 @@

  • 7 Benutzer- und Gruppenverwaltung