Revision e035119f
Von Moritz Bunkus vor etwa 17 Jahren hinzugefügt
| doc/INSTALL | ||
|---|---|---|
|
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
|
||
Auch abrufbar als: Unified diff
Umstellung der Installationsanweisung auf texinfo -- Schritt 1/2