Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 4c24a5f4

Von Sven Schöling vor fast 15 Jahren hinzugefügt

  • ID 4c24a5f44bf065a820ec1a540334ebd48446ac04
  • Vorgänger 32afa3f4
  • Nachfolger 238d4f5f

Dokumentation komplett nach utf8 konvertiert.

Unterschiede anzeigen:

doc/INSTALL.texi
\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
......
@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
......
@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
......
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}
......
@*
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}
......
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
......
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
......
@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
......
@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';
......
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 ---------------------------------------------------------------
......
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{@*
......
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}
......
@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
......
@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
......
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
......
@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
......
@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
......
@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.
......
@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}
......
@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
......
@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.
......
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 ---------------------------------------------------------------
......
@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.
......
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
......
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 ---------------------------------------------------------------
doc/INSTALL.txt
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
......
* 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
......
* 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'
......
`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'
......
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
......
`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
......
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
......
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:
......
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'
......
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
......
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
===============================
......
* `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
......
* `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
......
* `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
......
============================
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.
......
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'
......
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
......
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.
......
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.
......
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.
......
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
*************************
doc/INSTALL/Administratorpasswort.html
<p>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-&gt;{admin_password}</code>.
mehr im Administrationsinterface selber geändert werden. Der Parameter dazu
heißt <code>$self-&gt;{admin_password}</code>.
</body></html>
doc/INSTALL/Aktuelle-Hinweise.html
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="index.html#Top" title="Top">
<link rel="next" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete" title="Ben?tigte Software und Pakete">
<link rel="next" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete" title="Benötigte Software und Pakete">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
......
<div class="node">
<p>
<a name="Aktuelle-Hinweise"></a>
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Ben?tigte Software und Pakete</a>,
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>,
voriges:&nbsp;<a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
doc/INSTALL/Anpassung-der-PostgreSQL_002dKonfiguration.html
<p>PostgreSQL muss auf verschiedene Weisen angepasst werden.
<ul class="menu">
<li><a accesskey="1" href="Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8.html#Zeichens_00e4tze_002fdie-Verwendung-von-UTF_002d8">Zeichens?tze/die Verwendung von UTF-8</a>: Was bei der Verwendung von UTF-8 zu beachten ist
<li><a accesskey="2" href="_00c4nderungen-an-Konfigurationsdateien.html#g_t_00c4nderungen-an-Konfigurationsdateien">?nderungen an Konfigurationsdateien</a>: Anpassungen f?r Anmeldung am Server und Featureunterst?tzung
<li><a accesskey="3" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung f?r servergespeicherte Prozeduren</a>: Lx-Office benutzt servergespeicherte Prozeduren
<li><a accesskey="1" href="Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8.html#Zeichens_00c3_00a4tze_002fdie-Verwendung-von-UTF_002d8">Zeichensätze/die Verwendung von UTF-8</a>: Was bei der Verwendung von UTF-8 zu beachten ist
<li><a accesskey="2" href="_00c3_0084nderungen-an-Konfigurationsdateien.html#g_t_00c3_0084nderungen-an-Konfigurationsdateien">Änderungen an Konfigurationsdateien</a>: Anpassungen für Anmeldung am Server und Featureunterstützung
<li><a accesskey="3" href="Erweiterung-f_00c3_00bcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00c3_00bcr-servergespeicherte-Prozeduren">Erweiterung für servergespeicherte Prozeduren</a>: Lx-Office benutzt servergespeicherte Prozeduren
<li><a accesskey="4" href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen">Datenbankbenutzer anlegen</a>: Um den Zugriff besser zu reglementieren
</ul>
doc/INSTALL/Apache_002dKonfiguration.html
<p>Der Zugriff auf das Programmverzeichnis muss in der Apache
Webserverkonfigurationsdatei <code>httpd.conf</code> 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:
<p><code><br>
......
Plus &lsquo;<samp><span class="samp">+</span></samp>&rsquo; gesetzt werden.
<p>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:
<p><code>EnableSendfile Off</code>
doc/INSTALL/Authentifizierungsdatenbank.html
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Benutzerauthentifizierung-und-Administratorpasswort.html#Benutzerauthentifizierung-und-Administratorpasswort" title="Benutzerauthentifizierung und Administratorpasswort">
<link rel="prev" href="Administratorpasswort.html#Administratorpasswort" title="Administratorpasswort">
<link rel="next" href="Passwort_00fcberpr_00fcfung.html#Passwort_00fcberpr_00fcfung" title="Passwort?berpr?fung">
<link rel="next" href="Passwort_00c3_00bcberpr_00c3_00bcfung.html#Passwort_00c3_00bcberpr_00c3_00bcfung" title="Passwortüberprüfung">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
......
<div class="node">
<p>
<a name="Authentifizierungsdatenbank"></a>
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Passwort_00fcberpr_00fcfung.html#Passwort_00fcberpr_00fcfung">Passwort?berpr?fung</a>,
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Passwort_00c3_00bcberpr_00c3_00bcfung.html#Passwort_00c3_00bcberpr_00c3_00bcfung">Passwortüberprüfung</a>,
voriges:&nbsp;<a rel="previous" accesskey="p" href="Administratorpasswort.html#Administratorpasswort">Administratorpasswort</a>,
aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Benutzerauthentifizierung-und-Administratorpasswort.html#Benutzerauthentifizierung-und-Administratorpasswort">Benutzerauthentifizierung und Administratorpasswort</a>
<hr>
......
<li>&lsquo;<samp><span class="samp">port</span></samp>&rsquo; &ndash; Die Portnummer des Datenbankservers, meist 5432
<li>&lsquo;<samp><span class="samp">db</span></samp>&rsquo; &ndash; Der Name der Authentifizierungsdatenbank
<li>&lsquo;<samp><span class="samp">user</span></samp>&rsquo; &ndash; Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. &ldquo;postgres&rdquo;)
<li>&lsquo;<samp><span class="samp">password</span></samp>&rsquo; &ndash; Das Passwort f?r den Datenbankbenutzer
<li>&lsquo;<samp><span class="samp">password</span></samp>&rsquo; &ndash; Das Passwort für den Datenbankbenutzer
</ul>
<p>Die Datenbank muss noch nicht existieren. Lx-Office kann sie
doc/INSTALL/Ben_00c3_00b6tigte-Software-und-Pakete.html
<html lang="en">
<head>
<title>Benötigte Software und Pakete - Lx-Office Installationsanleitung</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Lx-Office Installationsanleitung">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise" title="Aktuelle Hinweise">
<link rel="next" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes" title="Installation des Programmpaketes">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<p>
<a name="Ben%c3%b6tigte-Software-und-Pakete"></a>
<a name="Ben_00c3_00b6tigte-Software-und-Pakete"></a>
n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,
voriges:&nbsp;<a rel="previous" accesskey="p" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,
aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
</div>
<h2 class="chapter">2 Benötigte Software und Pakete</h2>
<p>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) benötigt.
<p>Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:
<ul>
<li>DBI
<li>DBD::Pg
<li>CGI::Ajax
<li>Class::Accessor
<li>Archive::Zip
<li>Text::Iconv
<li>Text::CSV_XS
<li>IO::Wrap (aus dem Paket IO::Stringy)
<li>PDF::API2
<li>YAML
<li>Template
<li>List::MoreUtils
<li>Email::Address
</ul>
<p>Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
<p>Für Debian oder Ubuntu benötigen Sie diese Pakete:
<p><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</code>
<p>Für Fedora Core benötigen Sie unter anderem diese Pakete:
<p><code>httpd postgresql-server perl-DBI perl-DBD-Pg</code>
<p>Für OpenSuSE benötigen Sie diese Pakete:
<p><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</code>
<p>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.
<p>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:
<p><code>./scripts/installation_check.pl</code>
<!-- -->
</body></html>
doc/INSTALL/Ben_00f6tigte-Software-und-Pakete.html
<html lang="en">
<head>
<title>Ben?tigte Software und Pakete - Lx-Office Installationsanleitung</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Lx-Office Installationsanleitung">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise" title="Aktuelle Hinweise">
<link rel="next" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes" title="Installation des Programmpaketes">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
... Dieser Diff wurde abgeschnitten, weil er die maximale Anzahl anzuzeigender Zeilen überschreitet.

Auch abrufbar als: Unified diff