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

(Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl, libpgperl)

(Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)

(SuSE: apache2, postgresql-server, perl-DBI, perl-DBD-Pg)

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

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

Installation des Programmpaketes

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

Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.0.0.tgz) in den DocumentRoot des Webservers

(/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.

tar xvzf lxoffice-erp-2.0.0.tgz

Ver?ndern Sie evtl. noch den Namen des Verzeichnisses

mv lxoffice-erp/ lx-erp/

Das Verzeichnis mu? dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) ?bergeben werden:

chown apache: -R lx-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 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:

psql template1 postgres (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 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

</Directory>

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

Order Deny,Allow

Deny from All

</Directory>

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.

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

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_run_bin" muss den Pfad zu einem Script enthalten, dass den "X

virtual frame buffer" startet und direkt danach ein Programm in ihm

startet, das dem Script als Parameter ?bergeben wird. Lx-Office

enth?lt bereits ein solches Script namens "xvfb-run", das

standardm??ig verwendet wird. Es handelt sich dabei um eine gestutzte

Version des Scripts "xvfb-run" aus dem Debian-Paket "xvfb".

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.

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

Einloggen k?nnen Sie sich unter:

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