projekt kivitendo

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 ERP

Installationsanleitung

Folgende Pakete m?ssen installiert sein:

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

Webserver (Apache)

PostgreSQL - Datenbank

Ben?tigte Perl-Pakete, die nicht Bestandteil einer

Standard-Perl-Installation sind:

* DBI

* DBD::Pg

* CGI::Ajax

* Class::Accessor

* Archive::Zip

* Text::Iconv

* Text::CSV_XS

* IO::Wrap (aus dem Paket IO::Stringy)

* YAML

* Template

Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders

hei?en.

F?r Debian be?tigen Sie diese Pakete:

  apache, postgresql, libdbi-perl, libdbd-pg-perl, libpgperl,

  libclass-accessor-perl, libarchive-zip-perl,

  libtext-iconv-perl, libyaml-perl, libtext-csv-perl,

  libio-stringy-perl, libtemplate-perl

F?r Fedora Core be?tigen Sie unter anderem diese Pakete:

  httpd, postgresql-server, perl-DBI, perl-DBD-Pg

F?r OpenSuSE be?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

Da Perl-CGI-Ajax nicht als Paket f?r Distributionen bereit steht, mu?

es mit der CPAN-Shell installiert werden.  Leider gibt es F?lle, in

denen das nicht m?glich oder praktikabel ist. LxO liefert daher das

Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.

Die PostgreSQL Konfiguration mu? angepasst werden.

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

In der Datei postgresql.conf (/var/lib/pgsql/data/ oder

/etc/postgresql/) mu? folgender Wert ver?ndert werden:

TCPIP_SOCKET = 1 #  Nur PostgreSQL < 8.0

default_with_oids = on # Nur PostgreSQL >= 8.0

In der Datei pg_hba.conf (/var/lib/pgsql/data/ oder /etc/postgresql/)

m?ssen die Berichtigungen f?r den Zugriff ge?ndert werden:

alte Eintragung:

----------------

local	all all	ident sameuser

host all all 127.0.0.1 255.0.0.0	ident sameuser

?nderung:

---------

local	all all	trust

host all all 127.0.0.1 255.0.0.0	trust

Besser:

-------

local   all         lxoffice                                           password

host    all         lxoffice      127.0.0.1         255.255.255.255    password

Installation des Programmpaketes

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

Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) in den

DocumentRoot des Webservers (/var/www/html/ oder /srv/www/htdocs oder

/var/www/) entpacken.

tar xvzf lxoffice-erp-2.4.x.tgz

Ver?ndern Sie evtl. noch den Namen des Verzeichnisses

mv lxoffice-erp/ lx-erp/

oder noch besser, Sie verwenden einen Alias in der

Webserverkonfiguration.

Das Verzeichnis mu? dem Webserverbenutzer (Debian: www-data, Fedora:

apache, SuSE: wwwrun) ?bergeben werden:

chown apache: -R lx-office-erp/

Datenbankbenutzer anlegen

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

Es sollte zum Zugriff auf die PostgreSQL Datenbank ein

Datenbankbenutzer angelegt werden. F?hren Sie dazu folgende Befehle

nacheinander aus.

su - postgres

createuser -d lxoffice (ohne Passwort)

oder besser

createuser -d -P lxoffice (mit Passwort)

Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie

den evtl. voreingestellten Benutzer "postgres" auf "lxoffice".

PostgreSQL - Datenbank erweitern

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

In der Datenbank "template1" sollte bevor die restliche Konfiguration

von LxOffice ERP erfolgt noch folgende Funktion hinzugef?gt werden:

su postgres

psql template1  (Zugriff ?ber Admintool auf die Datenbank)

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, das der Pfad zur Datei plpgsql.so und der

Name von Distribution zu Distribution verschieden sein kann.  Bei

z.B. Debian befindet sie sich unter

'/usr/lib/postgresql/lib/plpgsql.so'.

Apache Konfiguration

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

Der Zugriff auf das Programmverzeichnis mu? in der Apache Webserver-

konfiguration httpd.conf (/etc/httpd/conf/) [bei SuSE

evtl. httpd2.conf] konfiguriert werden:

AddHandler cgi-script .pl

Alias /lx-erp/ /var/www/lx-erp/

<Directory /var/www/lx-erp>

  Options ExecCGI Includes FollowSymlinks

  DirectoryIndex login.pl			# nicht mehr unbedingt n?tig, da eine index.html mitgeliefert wird

</Directory>

<Directory /var/www/lx-erp/users>

  Order Deny,Allow

  Deny from All

</Directory>

!!!Vor den einzelnen Optionen mu? bei einigen Distributionen ein Plus

"+" gesetzt werden.

Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets

nicht ausgeliefert. Daher die Apache-Konfig um diese Zeile erweitern:

EnableSendfile Off

Datenbank anlegen

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

Das Administrationsmen? finden Sie unter:

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

Zuerst mu? eine Datenbank angelegt werden. Anschlie?end ein

Benutzer. Verwenden Sie f?r den Datenbankzugriff den eben angelegten

Benutzer lxoffice.

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

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

OpenDocument-Vorlagen zu aktivieren muss in der Datei "lx-erp.conf"

die Variable "$opendocument_templates" auf "1" stehen.  Dieses ist die

Standardeinstellung.

Weiterhin muss in der Datei "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".

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 "lx-erp.conf" zwei weitere

Variablen angepasst werden: "$openofficeorg_writer_bin" muss 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

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 Nachteil ist, dass diese Methode Python und die

Python-UNO-Bindings ben?tigt, die Bestandteil von OpenOffice 2 sind.

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

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 "~/.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:

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.

Lx-Office ERP verwenden

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

Einloggen k?nnen Sie sich unter:

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

Die Administrationsseite erreichen Sie unter:

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