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 mssen installiert sein:
========================================

Webserver (Apache)
PostgreSQL - Datenbank

Bentigte Perl-Pakete, die nicht Bestandteil einer
Standard-Perl-Installation sind:

* DBI
* DBD::Pg
* HTML::Template
* CGI::Ajax
* Class::Accessor
* Archive::Zip
* Text::Iconv
* Text::CSV_XS
* IO::Wrap (aus dem Paket IO::Stringy)
* YAML
* Template

Diese Pakete knnen bei den unterschiedlichen Distributionen anders
heien.

Fr Debian betigen Sie diese Pakete:

  apache, postgresql, libdbi-perl, libdbd-pg-perl, libpgperl,
  libhtml-template-perl, libclass-accessor-perl, libarchive-zip-perl,
  libtext-iconv-perl, libyaml-perl, libtext-csv-perl,
  libio-stringy-perl, libtemplate-perl

Fr Fedora Core betigen Sie unter anderem diese Pakete:

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

Fr OpenSuSE betigen 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-HTML-Template, perl-IO-stringy, perl-Template-Toolkit


Da Perl-CGI-Ajax nicht als Paket fr Distributionen bereit steht, mu
es mit der CPAN-Shell installiert werden.  Leider gibt es Flle, in
denen das nicht mglich 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 verndert 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/)
mssen die Berichtigungen fr den Zugriff gendert 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

Verndern 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. Fhren Sie dazu folgende Befehle
nacheinander aus.

su - postgres
createuser -d lxoffice (ohne Passwort)
oder besser
createuser -d -P lxoffice (mit Passwort)

Wenn Sie spter einen Datenbankzugriff konfigurieren, verndern 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 hinzugefgt 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 ntig, 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. Anschlieend ein
Benutzer. Verwenden Sie fr den Datenbankzugriff den eben angelegten
Benutzer lxoffice.

Wenn Sie fr die Lx-Office-Installation nicht den europischen
Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
mssen Sie vor dem Anlegen der Datenbank in der Datei 'lx-erp.conf'
die Variable '$dbcharset' auf den Wert 'UTF-8' setzen. Zustzlich muss
beim Anlegen der Datenbank 'UTF-8 Unicode' als Schriftsatz ausgewhlt
werden.


OpenDocument-Vorlagen
=====================

Lx-Office untersttzt 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 Untersttzung 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
Fllen "ISO-8859-15".

Whrend die Erzeugung von reinen OpenDocument-Dateien keinerlei
weitere Software bentigt, wird zur Umwandlung dieser Dateien in PDF
OpenOffice.org bentigt. 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 mssen in der Datei "lx-erp.conf" zwei weitere
Variablen angepasst werden: "$openofficeorg_writer_bin" muss den
vollstndigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
"$xvfb_bin" muss den Pfad zum "X virtual frame buffer" enthalten.

Zustzlich 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 fr jedes Dokument ein OpenOffice gestartet
werden muss. Der Nachteil ist, dass diese Methode Python und die
Python-UNO-Bindings bentigt, die Bestandteil von OpenOffice 2 sind.

Ist "$openofficeorg_daemon" nicht gesetzt, so wird fr jedes Dokument
OpenOffice neu gestartet und die Konvertierung mit Hilfe eines Makros
durchgefhrt. Dieses Makro muss in der Dokumentenvorlage enthalten
sein und "Standard.Conversion.ConvertSelfToPDF()" heien. Die
Beispielvorlage templates/German-invoice.odt enthlt 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 wre folgender Befehl auszufhren:

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 berprft
werden, wenn die Konvertierung nach PDF fehlschlgt.


Lx-Office ERP verwenden
=======================

Einloggen knnen Sie sich unter:

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

Die Administrationsseite erreichen Sie unter:

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