Revision 4c24a5f4
Von Sven Schöling vor fast 15 Jahren hinzugefügt
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->{admin_password}</code>.
|
||
mehr im Administrationsinterface selber geändert werden. Der Parameter dazu
|
||
heißt <code>$self->{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ächstes: <a rel="next" accesskey="n" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Ben?tigte Software und Pakete</a>,
|
||
nächstes: <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: <a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
|
||
aufwärts: <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 ‘<samp><span class="samp">+</span></samp>’ 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ächstes: <a rel="next" accesskey="n" href="Passwort_00fcberpr_00fcfung.html#Passwort_00fcberpr_00fcfung">Passwort?berpr?fung</a>,
|
||
nächstes: <a rel="next" accesskey="n" href="Passwort_00c3_00bcberpr_00c3_00bcfung.html#Passwort_00c3_00bcberpr_00c3_00bcfung">Passwortüberprüfung</a>,
|
||
voriges: <a rel="previous" accesskey="p" href="Administratorpasswort.html#Administratorpasswort">Administratorpasswort</a>,
|
||
aufwärts: <a rel="up" accesskey="u" href="Benutzerauthentifizierung-und-Administratorpasswort.html#Benutzerauthentifizierung-und-Administratorpasswort">Benutzerauthentifizierung und Administratorpasswort</a>
|
||
<hr>
|
||
... | ... | |
<li>‘<samp><span class="samp">port</span></samp>’ – Die Portnummer des Datenbankservers, meist 5432
|
||
<li>‘<samp><span class="samp">db</span></samp>’ – Der Name der Authentifizierungsdatenbank
|
||
<li>‘<samp><span class="samp">user</span></samp>’ – Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. “postgres”)
|
||
<li>‘<samp><span class="samp">password</span></samp>’ – Das Passwort f?r den Datenbankbenutzer
|
||
<li>‘<samp><span class="samp">password</span></samp>’ – 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ächstes: <a rel="next" accesskey="n" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,
|
||
voriges: <a rel="previous" accesskey="p" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,
|
||
aufwärts: <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">
|
Auch abrufbar als: Unified diff
Dokumentation komplett nach utf8 konvertiert.