projekt kivitendo

Table of Contents

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

Inhalt der Anleitung

1 Aktuelle Hinweise

2.2 Pakete

3 Manuelle Installation des Programmpaketes

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/'

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

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

Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden

Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im

speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl

der Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme

auf den derzeit aktuellen verbreiteten Distributionen läuft.

Anfang 2011 sind das folgende Systeme:

* Ubuntu 8.04 LTS Hardy Heron

* Ubuntu 9.10 Karmic Koala

* Ubuntu 10.04 Lucid Lynx

* Ubuntu 10.10 Maverick Meerkat

* Debian 5.0 Lenny

* Debian 6.0 Squeeze

* openSUSE 11.2

* openSUSE 11.3

* SuSE Linux Enterprice Server 11

* Fedora 13

* Fedora 14

Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich

einfacher zu installieren ist.

Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im

Archiv recht alt sind, und das viele der benötigten Module nicht

einfach zu installieren sind. Dafür sollte es kurz nach dem Release ein

eigenes .deb geben.

Alternativ dazu kann die normale Installation durchgeführt werden

(*note Manuelle Installation des Programmpaketes::), wenn vorher ein

Kompatibilitätspaket installiert wird, das die fehlenden Pakete

bereitstellt. Das Paket ist auf Sourceforge

(https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/)

unter dem Namen `lx-erp-perl-libs-compat-v2.tar.gz' hinterlegt.

Zur Installation das Paket in das entpackte Lx-Office Verzeichnis

entpacken:

`tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/'

`libbit-vector-perl libsub-exporter-perl libclone-perl

libclass-factory-util-perl'

enthaltenen Pakete erkennen.

2.2 Pakete

==========

* Class::Accessor

* CGI::Ajax

* DBD::Pg

* Rose::DB

* Rose::DB::Object

* Text::CSV_XS

* XML::Writer

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

`Rose::DB' und `Rose::DB::Object' neu hinzugekommen. `IO::Wrap' wurde

entfernt.

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.

libclass-accessor-perl libdatetime-perl libdbi-perl libdbd-pg-perl

libpg-perl libemail-address-perl liblist-moreutils-perl

libpdf-api2-perl librose-object-perl librose-db-perl

librose-db-object-perl libtemplate-perl libtext-csv-xs-perl

libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl'

perl-DateTime perl-DBI perl-DBD-Pg perl-Email-Address

perl-List-MoreUtils perl-PDF-API2 perl-Rose-Object perl-Rose-DB

perl-Rose-DB-Object perl-Template-Toolkit perl-Text-CSV_XS

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

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

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

Bei openSuSE 11 ist `parent' bereits enthalten, und braucht nicht

nachinstalliert werden. Die `Rose::*' Pakete sind derzeit nicht für

SuSE gepackt, und müssen anderweitig nachinstalliert werden.

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

`./scripts/installation_check.pl'

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

`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

Parameter `listen_address' gesteuert. Laufen PostgreSQL und Lx-Office

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

werden. Andernfalls müssen Datenbankverbindungen auch von anderen

Rechnern aus zugelassen werden, was mit dem Wert \`*' geschieht.

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

Achtung: In älteren Postgresversionen (vor 8.0) muss der Handler für

die Sprache manuell anlelegt werden, diese Versionen werden aber nicht

mehr offiziell von Lx-Office unterstützt. Dafür dann die folgenden

Kommandos:

'/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

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

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

mittels FCGI. Die Einrichtung wird ausführlich in der Datei

`INSTALL.fcgi' beschrieben.

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').

auf den Wert `UTF-8' 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

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

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

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

`print_templates' auf `1' stehen. Dieses ist die Standardeinstellung.

`dbcharset' im Abschnitt `system' auf die Zeichenkodierung gesetzt

werden, die auch bei der Speicherung der Daten in der Datenbank

verwendet wird. Diese ist in den meisten Fällen "UTF-8".

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.

zwei weitere Variablen angepasst werden: `openofficeorg_writer' muss

stehen im Abschnitt `applications'.

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

Manuelle Installation des Programmpaketes::), kann aber erneut überprüft

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'



Local Variables:

coding: utf-8

End: