kivitendo/doc/INSTALL.texi @ 35b8018a
| 7b642ce6 | Moritz Bunkus | \input texinfo @c -*-texinfo-*-
|
||
@c %**start of header
|
||||
@documentencoding ISO-8859-15
|
||||
@setfilename INSTALL.info
|
||||
@settitle Lx-Office Installationsanleitung
|
||||
@c %**end of header
|
||||
@c @copying
|
||||
@c Die Lx-Office Installationsanleitung kann beliebig weiter verwendet
|
||||
@c werden.
|
||||
@c @end copying
|
||||
@titlepage
|
||||
@title Lx-Office Installationsanleitung
|
||||
@end titlepage
|
||||
@contents
|
||||
@ifnottex
|
||||
@node Top
|
||||
@top Inhalt der Anleitung
|
||||
@end ifnottex
|
||||
@menu
|
||||
* Aktuelle Hinweise:: Andere Informationsquellen als diese Anleitung
|
||||
* 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
|
||||
| 8c7e4493 | Moritz Bunkus | * Benutzerauthentifizierung und Administratorpasswort:: Einrichtung der Authentifizierungsdatenbank und der Passwort?berpr?fung
|
||
* Benutzer- und Gruppenverwaltung:: Einrichten von Benutzern, Gruppen und Datenbanken
|
||||
| 7b642ce6 | Moritz Bunkus | * OpenDocument-Vorlagen:: Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen
|
||
* Lx-Office ERP verwenden:: Die URLs zur Anmeldung und Administration
|
||||
@end menu
|
||||
@c ---------------------------------------------------------------
|
||||
@node Aktuelle Hinweise
|
||||
@chapter Aktuelle Hinweise
|
||||
Aktuelle Installations- und Konfigurationshinweise gibt es:
|
||||
@itemize
|
||||
@item
|
||||
auf der Lx-Office Homepage unter @uref{http://lx-office.org/index.php?id=dokumentation}
|
||||
@item
|
||||
im Lx-Office-Wiki unter Dokumentation (@uref{http://wiki.lx-office.org/index.php/Lx-Office_ERP})
|
||||
@item
|
||||
im Lx-Office-Forum: @uref{http://www.lx-office.org/forum/}
|
||||
@end itemize
|
||||
@c ---------------------------------------------------------------
|
||||
@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.
|
||||
Zus?tzlich ben?tigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:
|
||||
@itemize
|
||||
@item
|
||||
DBI
|
||||
@item
|
||||
DBD::Pg
|
||||
@item
|
||||
CGI::Ajax
|
||||
@item
|
||||
Class::Accessor
|
||||
@item
|
||||
Archive::Zip
|
||||
@item
|
||||
Text::Iconv
|
||||
@item
|
||||
Text::CSV_XS
|
||||
@item
|
||||
IO::Wrap (aus dem Paket IO::Stringy)
|
||||
@item
|
||||
| 0603f8f1 | Moritz Bunkus | PDF::API2
|
||
@item
|
||||
| 7b642ce6 | Moritz Bunkus | YAML
|
||
@item
|
||||
Template
|
||||
| b02fc29a | Sven Schöling | @item
|
||
List::MoreUtils
|
||||
@item
|
||||
Email::Address
|
||||
| 7b642ce6 | Moritz Bunkus | @end itemize
|
||
Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders hei?en.
|
||||
F?r Debian oder Ubuntu ben?tigen Sie diese Pakete:
|
||||
| efa178c8 | Moritz Bunkus | @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-perl libio-stringy-perl libtemplate-perl}
|
||
| 7b642ce6 | Moritz Bunkus | |||
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:
|
||||
@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}
|
||||
| b02fc29a | Sven Schöling | 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.
|
||||
| 7b642ce6 | Moritz Bunkus | |||
| be180538 | Moritz Bunkus | 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}
|
||||
| 7b642ce6 | Moritz Bunkus | @c ---------------------------------------------------------------
|
||
@node Installation des Programmpaketes
|
||||
@chapter Installation des Programmpaketes
|
||||
| 72831aef | Moritz Bunkus | Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.0.tgz) wird im
|
||
| 7b642ce6 | Moritz Bunkus | Dokumentenverzeichnis des Webservers (z.B. @code{/var/www/html/},
|
||
@code{/srv/www/htdocs} oder @code{/var/www/}) entpackt:
|
||||
@code{cd /var/www
|
||||
@*
|
||||
| 72831aef | Moritz Bunkus | tar xvzf lxoffice-erp-2.6.0.tgz}
|
||
| 7b642ce6 | Moritz Bunkus | |||
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
|
||||
verweisen.
|
||||
| efa178c8 | Moritz Bunkus | 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}).
|
||||
| 7b642ce6 | Moritz Bunkus | |||
| 76b009b0 | Moritz Bunkus | Der folgende Befehl ?ndert den Besitzer f?r die oben genannten
|
||
Verzeichnisse auf einem Debian/Ubuntu-System:
|
||||
| efa178c8 | Moritz Bunkus | @code{chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav}
|
||
| 7b642ce6 | Moritz Bunkus | |||
@c ---------------------------------------------------------------
|
||||
@node Anpassung der PostgreSQL-Konfiguration
|
||||
@chapter Anpassung der PostgreSQL-Konfiguration
|
||||
PostgreSQL muss auf verschiedene Weisen angepasst werden.
|
||||
@menu
|
||||
| 3acaa523 | Moritz Bunkus | * Zeichens?tze/die Verwendung von UTF-8:: Was bei der Verwendung von UTF-8 zu beachten ist
|
||
| 7b642ce6 | Moritz Bunkus | * ?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
|
||||
| 3acaa523 | Moritz Bunkus | @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
|
||||
Version 8.0 oder neuer benutzt werden, und der
|
||||
PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale
|
||||
angelegt worden sein.
|
||||
Dieses ist kann ?berpr?ft werden: ist das Encoding der Datenbank
|
||||
``template1'' ``UTF8'', so kann auch Lx-Office mit UTF-8 betrieben
|
||||
werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit
|
||||
UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und
|
||||
Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden:
|
||||
@code{pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername}
|
||||
Die Datenbankversionsnummer muss an die tats?chlich verwendete
|
||||
Versionsnummer angepasst werden.
|
||||
Unter anderen Distributionen gibt es ?hnliche Methoden.
|
||||
Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist
|
||||
ein Neuanlegen eines weiteren Clusters nicht m?glich, so kann
|
||||
| b02fc29a | Sven Schöling | Lx-Office mit ISO-8859-15 als Encoding betrieben werden.
|
||
| 3acaa523 | Moritz Bunkus | |||
| 7b642ce6 | Moritz Bunkus | @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
|
||||
| 2b5da843 | Moritz Bunkus | sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. F?r
|
||
PostgreSQL vor Version v8.0 lautete dieser Parameter
|
||||
| 7b642ce6 | Moritz Bunkus | |||
@code{TCPIP_SOCKET = 1}
|
||||
| 2b5da843 | Moritz Bunkus | 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
|
||||
Rechnern aus zugelassen werden, was mit dem Wert \@code{*} geschieht.
|
||||
| 7b642ce6 | Moritz Bunkus | 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
|
||||
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
|
||||
zuzulassen. Beispielsweise:
|
||||
@code{local all lxoffice password
|
||||
@*
|
||||
host all lxoffice 127.0.0.1 255.255.255.255 password}
|
||||
@c ---------------------------------------------------------------
|
||||
@node Erweiterung f?r servergespeicherte Prozeduren
|
||||
@section Erweiterung f?r servergespeicherte Prozeduren
|
||||
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
|
||||
die folgenden Kommandos aus:
|
||||
@code{create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c';
|
||||
@*
|
||||
create language 'plpgsql' handler plpgsql_call_handler
|
||||
lancompiler 'pl/pgsql';}
|
||||
Bitte beachten Sie, dass der Pfad zur Datei @code{plpgsql.so} von
|
||||
Distribution zu Distribution verschiedlich sein kann. Bei
|
||||
Debian/Ubuntu befindet sie sich unter
|
||||
@code{/usr/lib/postgresql/lib/plpgsql.so}.
|
||||
@c ---------------------------------------------------------------
|
||||
@node Datenbankbenutzer anlegen
|
||||
@section Datenbankbenutzer anlegen
|
||||
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:
|
||||
@code{su - postgres
|
||||
@*
|
||||
createuser -d -P lxoffice}
|
||||
Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie
|
||||
den evtl. voreingestellten Benutzer ``postgres'' auf ``lxoffice''
|
||||
bzw. den hier gew?hlten Benutzernamen.
|
||||
@c ---------------------------------------------------------------
|
||||
@node Apache-Konfiguration
|
||||
@chapter Apache-Konfiguration
|
||||
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
|
||||
anderen Datei hinzu, die beim Starten des Webservers eingelesen wird:
|
||||
@code{@*
|
||||
AddHandler cgi-script .pl
|
||||
@*
|
||||
Alias /lx-erp/ /var/www/lx-erp/
|
||||
@*
|
||||
<Directory /var/www/lx-erp>
|
||||
@*
|
||||
Options ExecCGI Includes FollowSymlinks
|
||||
@*
|
||||
</Directory>
|
||||
@*
|
||||
@*
|
||||
<Directory /var/www/lx-erp/users>
|
||||
@*
|
||||
Order Deny,Allow
|
||||
@*
|
||||
Deny from All
|
||||
@*
|
||||
</Directory>
|
||||
@*
|
||||
}
|
||||
Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher das
|
||||
Lx-Office-Archiv entpacket haben.
|
||||
Achtung: Vor den einzelnen Optionen muss bei einigen Distributionen ein
|
||||
Plus @samp{+} gesetzt werden.
|
||||
Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets
|
||||
nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die
|
||||
folgende Option in die Konfiguration aufzunehmen:
|
||||
@code{EnableSendfile Off}
|
||||
@c ---------------------------------------------------------------
|
||||
| 8c7e4493 | Moritz Bunkus | @node Benutzerauthentifizierung und Administratorpasswort
|
||
@chapter Benutzerauthentifizierung und Administratorpasswort
|
||||
| 7b642ce6 | Moritz Bunkus | |||
| 8c7e4493 | Moritz Bunkus | Informationen ?ber die Einrichtung der Benutzerauthentifizierung, ?ber
|
||
die Verwaltung von Gruppen und weitere Einstellungen
|
||||
| 7b642ce6 | Moritz Bunkus | |||
| 8c7e4493 | Moritz Bunkus | @menu
|
||
* 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
|
||||
* Anlegen der Authentifizierungsdatenbank:: Wie die Authentifizierungsdatenbank angelegt wird
|
||||
@end menu
|
||||
@c ---------------------------------------------------------------
|
||||
@node Grundlagen zur Benutzerauthentifizierung
|
||||
@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
|
||||
aber nicht unterschiedlich sein.
|
||||
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
|
||||
entweder gegen die Authentifizierungsdatenbank oder gegen einen
|
||||
LDAP-Server ?berpr?ft werden.
|
||||
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
|
||||
| 3001e127 | Moritz Bunkus | v2.6.0 angelegt werden. Eine Beispielkonfigurationsdatei
|
||
| 8c7e4493 | Moritz Bunkus | @code{config/authentication.pl.default} existiert, die als Vorlage
|
||
benutzt werden kann.
|
||||
@node Administratorpasswort
|
||||
@section Administratorpasswort
|
||||
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@}}.
|
||||
@node Authentifizierungsdatenbank
|
||||
@section Authentifizierungsdatenbank
|
||||
Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern
|
||||
in @code{$self->@{DB_config@}} konfiguriert. Hier sind die folgenden
|
||||
Parameter anzugeben:
|
||||
@itemize
|
||||
@item
|
||||
@samp{host} -- Der Rechnername oder die IP-Adresse des Datenbankservers
|
||||
@item
|
||||
@samp{port} -- Die Portnummer des Datenbankservers, meist 5432
|
||||
@item
|
||||
@samp{db} -- Der Name der 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
|
||||
@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
|
||||
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
|
||||
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.
|
||||
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
|
||||
den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden:
|
||||
@itemize
|
||||
@item
|
||||
@samp{host} -- Der Rechnername oder die IP-Adresse des LDAP- oder Active-Directory-Servers. Diese Angabe ist zwingend erforderlich.
|
||||
@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
|
||||
@item
|
||||
| b02fc29a | Sven Schöling | @samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. F?r Active-Directory-Server
|
||
| 8c7e4493 | Moritz Bunkus | 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
|
||||
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
|
||||
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
|
||||
| 7b642ce6 | Moritz Bunkus | |||
| 8c7e4493 | Moritz Bunkus | @node Name des Session-Cookies
|
||
@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
|
||||
Installationen unterschiedlich sein. Der Name des Cookies wird mit dem
|
||||
Parameter @code{$self->@{cookie_name@}} gesetzt.
|
||||
Diese Angabe ist optional, wenn nur eine Installation auf dem Server
|
||||
existiert.
|
||||
@node Anlegen der Authentifizierungsdatenbank
|
||||
@section Anlegen der Authentifizierungsdatenbank
|
||||
Nachdem alle Einstellungen in @code{config/authentication.pl}
|
||||
vorgenommen wurden, muss Lx-Office die Authentifizierungsdatenbank
|
||||
anlegen. Dieses geschieht automatisch, wenn Sie sich im
|
||||
Administrationsmodul anmelden, das unter der folgenden URL erreichbar
|
||||
sein sollte:
|
||||
@uref{http://localhost/lx-erp/admin.pl}
|
||||
@c ---------------------------------------------------------------
|
||||
@node Benutzer- und Gruppenverwaltung
|
||||
@chapter Benutzer- und Gruppenverwaltung
|
||||
Nach der Installation m?ssen Benutzer, Gruppen und Datenbanken
|
||||
| b02fc29a | Sven Schöling | angelegt werden. Dieses geschieht im Administrationsmen?, das Sie
|
||
| 8c7e4493 | Moritz Bunkus | unter folgender URL finden:
|
||
@uref{http://localhost/lx-erp/admin.pl}
|
||||
Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei
|
||||
@code{config/authentication.pl} eingetragen haben.
|
||||
@menu
|
||||
* Zusammenh?nge:: ?bersicht ?ber Benutzer, Gruppen, Berechtigungen und Datenbanken
|
||||
* 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
|
||||
@end menu
|
||||
@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
|
||||
Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine
|
||||
Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist
|
||||
m?glich und normal, dass mehreren Benutzern die selbe Datenbank
|
||||
zugewiesen wird, sodass sie alle mit den selben Daten arbeiten k?nnen.
|
||||
Die Basisdaten der Benutzer, die in der Administration eingegeben
|
||||
werden k?nnen, werden in einer zweiten Datenbank gespeichert, der
|
||||
bereits erw?hnten Authentifizierungsdatenbank. Diese ist also den
|
||||
Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
|
||||
Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
|
||||
aber beliebig viele Datenbanken mit Firmendaten.
|
||||
| b02fc29a | Sven Schöling | Lx-Office kann seinen Benutzern Zugriff auf bestimmte
|
||
| 8c7e4493 | Moritz Bunkus | Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
|
||
gestattet, so werden der entsprechenden Men?punkte auch nicht
|
||||
angezeigt. Diese Rechte werden ebenfalls in der
|
||||
Authentifizierungsdatenbank gespeichert.
|
||||
Um Rechte verteilen zu k?nnen, verwendet Lx-Office ein
|
||||
Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche
|
||||
erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder
|
||||
mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen
|
||||
Funktionen, die mindestens einer Gruppe erlaubt sind, in der der
|
||||
Benutzer Mitglied ist.
|
||||
Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer
|
||||
angelegt werden sollten, lautet:
|
||||
@enumerate
|
||||
@item
|
||||
Datenbank anlegen
|
||||
@item
|
||||
Gruppen anlegen
|
||||
@item
|
||||
Benutzer anlegen
|
||||
@item
|
||||
Benutzer den Gruppen zuordnen
|
||||
@end enumerate
|
||||
@node Datenbanken anlegen
|
||||
@section Datenbanken anlegen
|
||||
Zuerst muss eine Datenbank angelegt werden. Verwenden Sie f?r den
|
||||
Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen
|
||||
ist dies @samp{lxoffice}).
|
||||
| 7b642ce6 | Moritz Bunkus | |||
Wenn Sie f?r die Lx-Office-Installation nicht den europ?ischen
|
||||
Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
|
||||
| 8c7e4493 | Moritz Bunkus | 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.
|
||||
Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
|
||||
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.
|
||||
@node Gruppen anlegen
|
||||
@section Gruppen anlegen
|
||||
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
|
||||
Mitglieder dieser Gruppe Zugriff haben sollen.
|
||||
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
|
||||
Standardeinstellungen vorgenommen, die den Gepflogenheiten des
|
||||
deutschen Raumes entsprechen.
|
||||
Zwingend anzugeben sind der Loginname sowie die komplette
|
||||
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
|
||||
aktiv, so ist das Passwort-Feld deaktiviert.
|
||||
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:
|
||||
@enumerate
|
||||
@item
|
||||
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
|
||||
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.
|
||||
@end enumerate
|
||||
@node Migration alter Installationen
|
||||
@section Migration alter Installationen
|
||||
| 3001e127 | Moritz Bunkus | Wenn Lx-Office 2.6.0 ?ber eine ?ltere Version installiert wird, in der
|
||
| 8c7e4493 | Moritz Bunkus | die Benutzerdaten noch im Dateisystem im Verzeichnis @code{users}
|
||
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
|
||||
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
|
||||
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 und mit dem System arbeiten.
|
||||
| 7b642ce6 | Moritz Bunkus | |||
@c ---------------------------------------------------------------
|
||||
@node OpenDocument-Vorlagen
|
||||
@chapter OpenDocument-Vorlagen
|
||||
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
|
||||
| 8c7e4493 | Moritz Bunkus | 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.
|
||||
| 7b642ce6 | Moritz Bunkus | |||
| 8c7e4493 | Moritz Bunkus | Weiterhin muss in der Datei @code{config/lx-erp.conf} die Variable
|
||
| 7b642ce6 | Moritz Bunkus | @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".
|
||||
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.
|
||||
| 8c7e4493 | Moritz Bunkus | 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
|
||||
OpenOffice.org Writer-Anwendung enthalten. @code{$xvfb_bin} muss den
|
||||
Pfad zum ``X virtual frame buffer'' enthalten.
|
||||
| 7b642ce6 | Moritz Bunkus | |||
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
|
||||
werden muss. Der Nachteil ist, dass diese Methode Python und die
|
||||
Python-UNO-Bindings ben?tigt, die Bestandteil von OpenOffice 2 sind.
|
||||
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
|
||||
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
|
||||
ebenfalls enthalten sein muss.
|
||||
Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
|
||||
Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter
|
||||
Debian ist dies momentan @code{~/.openoffice.org2}. Sollte der Name
|
||||
bei Ihrer OpenOffice.org-Installation anders sein, so muss das
|
||||
Verzeichnis @code{users/.openoffice.org2} entsprechend umbenannt
|
||||
werden. Ist der Name z.B. einfach nur @code{.openoffice}, so w?re
|
||||
folgender Befehl auszuf?hren:
|
||||
@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.
|
||||
@c ---------------------------------------------------------------
|
||||
@node Lx-Office ERP verwenden
|
||||
@chapter Lx-Office ERP verwenden
|
||||
Nach erfolgreicher Installation ist der Loginbildschirm unter
|
||||
folgender URL erreichbar:
|
||||
@uref{http://localhost/lx-office-erp/login.pl}
|
||||
Die Administrationsseite erreichen Sie unter:
|
||||
@uref{http://localhost/lx-office-erp/admin.pl}
|
||||
@bye
|