projekt kivitendo

Table of Contents

*****************

Inhalt der Anleitung

1 Aktuelle Hinweise

4 Anpassung der PostgreSQL-Konfiguration

4.2 Änderungen an Konfigurationsdateien

4.3 Erweiterung für servergespeicherte Prozeduren

6.1 Grundlagen zur Benutzerauthentifizierung

6.2 Administratorpasswort

6.3 Authentifizierungsdatenbank

6.6 Anlegen der Authentifizierungsdatenbank

7 Benutzer- und Gruppenverwaltung

7.3 Gruppen anlegen

7.4 Benutzer anlegen

7.5 Gruppenmitgliedschaften verwalten

7.6 Migration alter Installationen

8 OpenDocument-Vorlagen

9 Lx-Office ERP verwenden

Inhalt der Anleitung

********************

1 Aktuelle Hinweise

*******************

Aktuelle Installations- und Konfigurationshinweise gibt es:

* auf der Lx-Office Homepage unter

`http://lx-office.org/index.php?id=dokumentation'

* im Lx-Office-Wiki unter Dokumentation

(`http://wiki.lx-office.org/index.php/Lx-Office_ERP')

* im Lx-Office-Forum: `http://www.lx-office.org/forum/'

********************************

Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)

* Class::Accessor

* CGI::Ajax

* DBD::Pg

* Rose::Object

* Rose::DB

* Rose::DB::Object

* Text::CSV_XS

* XML::Writer

`URI' und `XML::Writer' sind notwendig. Ohne startet Lx-Office nicht.

Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert. Beide

sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer

zukünftigen Version aber aus dem Paket entfernt werden. Es wird

empfohlen diese Module zusammen mit den anderen als Bibliotheken zu

installieren.

mitgeliefert und braucht nicht nachinstalliert werden.

Distributionen unterschiedlich heißen.

libemail-address-perl libio-stringy-perl liblist-moreutils-perl

libpdf-api2-perl libtemplate-perl libtext-csv-xs-perl

librose-object-perl librose-db-perl librose-db-object-perl

libreadonly-xs-perl'

perl-DBD-Pg perl-Email-Address perl-IO-stringy perl-List-MoreUtils

perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv

perl-URI perl-XML-Writer perl-YAML'

perl-List-MoreUtils perl-PDF-API2 perl-Template-Toolkit

perl-Text-CSV_XS perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML'

benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:

`./scripts/installation_check.pl'

**********************************

Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/',

`cd /var/www

`mv lxoffice-erp/ lx-erp/'

benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen.

Benutzer beschreibbar sein, unter dem der Webserver läuft. Die

restlichen Dateien müssen für diesen Benutzer lesbar sein. Der

bei Debian/Ubuntu `www-data', bei Fedora core `apache' oder bei

OpenSuSE `wwwrun').

lx-office-erp/webdav'

anlegen dürfen:

`chgrp www-data lx-office-erp/templates; chmod g+w

lx-office-erp/templates'

****************************************

PostgreSQL muss auf verschiedene Weisen angepasst werden.

==========================================

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.

Andernfalls ist es notwendig, einen neuen Datenbankcluster mit

UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und

Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden:

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

clustername'

Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist

========================================

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

`TCPIP_SOCKET = 1'

demselben Rechner, so kann dort der Wert `localhost' verwendet werden.

den Zugriff geändert werden. Hier gibt es mehrere Möglichkeiten. Eine

`local all all trust

host all all 127.0.0.1 255.0.0.0 trust'

`local all lxoffice

password

host all lxoffice 127.0.0.1 255.255.255.255

password'

==================================================

servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür

als Benutzer "postgres" an der Datenbank an, und führen Sie die

`create function plpgsql_call_handler () returns opaque as

'/usr/lib/pgsql/plpgsql.so' language 'c';

create language 'plpgsql' handler plpgsql_call_handler lancompiler

'pl/pgsql';'

Bitte beachten Sie, dass der Pfad zur Datei `plpgsql.so' von

Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu

Ubuntu 9.10 unter `/usr/lib/postgresql/8.4/lib/plpgsql.so'.

Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen

wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein

`su - postgres

createuser -d -P lxoffice'

5 Apache-Konfiguration

**********************

Der Zugriff auf das Programmverzeichnis muss in der Apache

die beim Starten des Webservers eingelesen wird:

`

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 `+' gesetzt werden.

Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets

`EnableSendfile Off'

*****************************************************

6.1 Grundlagen zur Benutzerauthentifizierung

============================================

Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die

Benutzer kann dort eine eigene Datenbank für die eigentlichen

Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen

werden.

Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss

`config/authentication.pl.default' existiert, die als Vorlage benutzt

werden kann.

6.2 Administratorpasswort

=========================

Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt

wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort

Parameter dazu heißt `$self->{admin_password}'.

6.3 Authentifizierungsdatenbank

===============================

Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern

in `$self->{DB_config}' konfiguriert. Hier sind die folgenden Parameter

anzugeben:

* `host' - Der Rechnername oder die IP-Adresse des Datenbankservers

* `port' - Die Portnummer des Datenbankservers, meist 5432

* `db' - Der Name der Authentifizierungsdatenbank

* `user' - Der Benutzername, mit dem sich Lx-Office beim

Datenbankserver anmeldet (z.B. "postgres")

Die Datenbank muss noch nicht existieren. Lx-Office kann sie

automatisch anlegen (mehr dazu siehe unten).

=========================

Active-Directory-Server. Welche davon benutzt wird, regelt der

Parameter `$self->{module}'.

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

* `host' - Der Rechnername oder die IP-Adresse des LDAP- oder

Active-Directory-Servers. Diese Angabe ist zwingend erforderlich.

* `port' - Die Portnummer des LDAP-Servers; meist 389.

dies meist `sAMAccountName', für andere LDAP-Server hingegen

soll. Diese Angabe ist zwingend erforderlich.

eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum

nach einem Element durchsucht, bei dem das oben angegebene Attribut

mit dem Benutzernamen identisch ist.

* `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

Mustermann,cn=Users,dc=firmendomain' auch nur der volle Name des

Benutzers eingegeben werden; in diesem Beispiel also `Martin

Mustermann'.

6.5 Name des Session-Cookies

============================

Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt

`$self->{cookie_name}' gesetzt.

Diese Angabe ist optional, wenn nur eine Installation auf dem Server

existiert.

6.6 Anlegen der Authentifizierungsdatenbank

===========================================

Nachdem alle Einstellungen in `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:

`http://localhost/lx-erp/admin.pl'

7 Benutzer- und Gruppenverwaltung

*********************************

werden. Dieses geschieht im Administrationsmenü, das Sie unter

`http://localhost/lx-erp/admin.pl'

`config/authentication.pl' eingetragen haben.

==================

Lx-Office verwendet eine Datenbank zum Speichern all seiner

Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um

Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist

zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können.

Die Basisdaten der Benutzer, die in der Administration eingegeben

bereits erwähnten Authentifizierungsdatenbank. Diese ist also den

Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,

aber beliebig viele Datenbanken mit Firmendaten.

Authentifizierungsdatenbank gespeichert.

erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder

mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen

Funktionen, die mindestens einer Gruppe erlaubt sind, in der der

Benutzer Mitglied ist.

Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer

angelegt werden sollten, lautet:

1. Datenbank anlegen

2. Gruppen anlegen

3. Benutzer anlegen

4. Benutzer den Gruppen zuordnen

7.2 Datenbanken anlegen

=======================

ist dies `lxoffice').

Schriftsatz ausgewählt werden.

Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz

Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz

angelegt worden sein.

7.3 Gruppen anlegen

===================

Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name

gegeben werden, eine Beschreibung ist hingegen optional. Nach dem

Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle

7.4 Benutzer anlegen

====================

deutschen Raumes entsprechen.

Zwingend anzugeben sind der Loginname sowie die komplette

7.5 Gruppenmitgliedschaften verwalten

=====================================

zugewiesen werden. Dazu gibt es zwei Möglichkeiten:

Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen.

Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in

der ausgewählten Spalte hinzugefügt.

7.6 Migration alter Installationen

==================================

die Benutzerdaten noch im Dateisystem im Verzeichnis `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

`users/members', so wird der Migrationsprozess gestartet.

Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten

die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird.

Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gewährt.

das Verhalten von Lx-Office bis Version 2.4.3 inklusive

8 OpenDocument-Vorlagen

Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus

`config/lx-erp.conf' die Variable `$opendocument_templates' auf `1'

stehen. Dieses ist die Standardeinstellung.

`$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der

Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den

weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF

OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss

(xvfb) installiert werden. Bei Debian ist er im Paket "xvfb"

enthalten. Andere Distributionen enthalten ihn in anderen Paketen.

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

enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die

Beispielvorlage `templates/German-invoice.odt' enthält ein solches

muss.

Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org

Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian

ist dies momentan `~/.openoffice.org2'. Sollte der Name bei Ihrer

OpenOffice.org-Installation anders sein, so muss das Verzeichnis

`users/.openoffice.org2' entsprechend umbenannt werden. Ist der Name

`mv users/.openoffice.org2 users/.openoffice'

Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss

vom Webserver beschreibbar sein. Dieses wurde in Schritt `Installation

werden, wenn die Konvertierung nach PDF fehlschlägt.

Nach erfolgreicher Installation ist der Loginbildschirm unter folgender

URL erreichbar:

`http://localhost/lx-office-erp/login.pl'

Die Administrationsseite erreichen Sie unter:

`http://localhost/lx-office-erp/admin.pl'