projekt kivitendo

\input texinfo   @c -*-texinfo-*-

@c %**start of header

@documentencoding ISO-8859-15

@setfilename INSTALL.info

@settitle Lx-Office Installationsanleitung

@c %**end of header

@c @copying

@c Die Lx-Office Installationsanleitung kann beliebig weiter verwendet

@c werden.

@c @end copying

@titlepage

@title Lx-Office Installationsanleitung

@end titlepage

@contents

@ifnottex

@node Top

@top Inhalt der Anleitung

@end ifnottex

@menu

* Aktuelle Hinweise:: Andere Informationsquellen als diese Anleitung

* Ben?tigte Software und Pakete:: Vorraussetzungen zum Betrieb von Lx-Office

* Installation des Programmpaketes:: Installationsort, Berechtigungen

* Anpassung der PostgreSQL-Konfiguration:: Verschiedene Aspekte der Datenbankkonfiguration

* Apache-Konfiguration:: Einrichtung eines Aliases und Optionen f?r das Ausf?hren von CGI-Scripten

* Benutzer und Datenbanken anlegen:: Letzte Schritte vor der Anmeldung

* OpenDocument-Vorlagen:: Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen

* Lx-Office ERP verwenden:: Die URLs zur Anmeldung und Administration

@end menu

@c ---------------------------------------------------------------

@node Aktuelle Hinweise

@chapter Aktuelle Hinweise

Aktuelle Installations- und Konfigurationshinweise gibt es:

@itemize

@item

auf der Lx-Office Homepage unter @uref{http://lx-office.org/index.php?id=dokumentation}

@item

im Lx-Office-Wiki unter Dokumentation (@uref{http://wiki.lx-office.org/index.php/Lx-Office_ERP})

@item

im Lx-Office-Forum: @uref{http://www.lx-office.org/forum/}

@end itemize

@c ---------------------------------------------------------------

@node Ben?tigte Software und Pakete

@chapter Ben?tigte Software und Pakete

Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) ben?tigt.

Zus?tzlich ben?tigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:

@itemize

@item

DBI

@item

DBD::Pg

@item

CGI::Ajax

@item

Class::Accessor

@item

Archive::Zip

@item

Text::Iconv

@item

Text::CSV_XS

@item

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

@item

YAML

@item

Template

@end itemize

Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders hei?en.

F?r Debian oder Ubuntu ben?tigen Sie diese Pakete:

@code{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 ben?tigen Sie unter anderem diese Pakete:

@code{httpd postgresql-server perl-DBI perl-DBD-Pg}

F?r OpenSuSE ben?tigen Sie diese Pakete:

@code{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. Lx-Office liefert daher

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

@c ---------------------------------------------------------------

@node Installation des Programmpaketes

@chapter Installation des Programmpaketes

Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) wird im

Dokumentenverzeichnis des Webservers (z.B. @code{/var/www/html/},

@code{/srv/www/htdocs} oder @code{/var/www/}) entpackt:

@code{cd /var/www

@*

tar xvzf lxoffice-erp-2.4.x.tgz}

Ver?ndern Sie evtl. noch den Namen des Verzeichnisses mit

@code{mv lxoffice-erp/ lx-erp/}

Alternativ k?nnen Sie auch einen Alias in der Webserverkonfiguration

benutzen, um auf das tats?chliche Installationsverzeichnis zu

verweisen.

Das Verzeichnis mu? f?r den Benutzer beschreibbar sein, unter dem der

Webserver l?uft. Dieser ist bei verschiedenen Distributionen

unterschiedlich (z.B. bei Debian/Ubuntu @code{www-data}, bei Fedora

core @code{apache} oder bei OpenSuSE @code{wwwrun}).

@code{chown -R www-data: lx-office-erp/}

@c ---------------------------------------------------------------

@node Anpassung der PostgreSQL-Konfiguration

@chapter Anpassung der PostgreSQL-Konfiguration

PostgreSQL muss auf verschiedene Weisen angepasst werden.

@menu

* ?nderungen an Konfigurationsdateien:: Anpassungen f?r Anmeldung am Server und Featureunterst?tzung

* Erweiterung f?r servergespeicherte Prozeduren:: Lx-Office benutzt servergespeicherte Prozeduren

* Datenbankbenutzer anlegen:: Um den Zugriff besser zu reglementieren

@end menu

@node ?nderungen an Konfigurationsdateien

@section ?nderungen an Konfigurationsdateien

In der Datei @code{postgresql.conf}, die je nach Distribution in

verschiedenen Verzeichnissen liegen kann

(z.B. @code{/var/lib/pgsql/data/} oder @code{/etc/postgresql/}, muss

sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Dieser

Parameter lautet

@code{TCPIP_SOCKET = 1}

Bei PostgreSQL-Versionen ab v8.0 und neuer muss zus?tzlich der

folgende Parameter gesetzt werden:

@code{default_with_oids = on}

In der Datei @code{pg_hba.conf}, die im gleichen Verzeichnis wie die

@code{postgresql.conf} zu finden sein sollte, m?ssen die

Berichtigungen f?r den Zugriff ge?ndert werden. Hier gibt es mehrere

M?glichkeiten. Eine besteht darin, lokale Verbindungen immer

zuzulassen

@code{local all all trust

@*

host all all 127.0.0.1 255.0.0.0 trust}

Besser ist es, f?r eine bestimmte Datenbank Zugriff nur per Passwort

zuzulassen. Beispielsweise:

@code{local   all         lxoffice                                           password

@*

host    all         lxoffice      127.0.0.1         255.255.255.255    password}

@c ---------------------------------------------------------------

@node Erweiterung f?r servergespeicherte Prozeduren

@section Erweiterung f?r servergespeicherte Prozeduren

In der Datenbank @code{template1} muss die Unterst?tzung f?r

servergespeicherte Prozeduren eingerichet werden. Melden Sie sich

daf?r als Benutzer ``postgres'' an der Datenbank an, und f?hren Sie

die folgenden Kommandos aus:

@code{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, dass der Pfad zur Datei @code{plpgsql.so} von

Distribution zu Distribution verschiedlich sein kann. Bei

Debian/Ubuntu befindet sie sich unter

@code{/usr/lib/postgresql/lib/plpgsql.so}.

@c ---------------------------------------------------------------

@node Datenbankbenutzer anlegen

@section Datenbankbenutzer anlegen

Wenn Sie nicht den Datenbanksuperuser ``postgres'' zum Zugriff

benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer

anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen k?nnen:

@code{su - postgres

@*

createuser -d -P lxoffice}

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

den evtl. voreingestellten Benutzer ``postgres'' auf ``lxoffice''

bzw. den hier gew?hlten Benutzernamen.

@c ---------------------------------------------------------------

@node Apache-Konfiguration

@chapter Apache-Konfiguration

Der Zugriff auf das Programmverzeichnis muss in der Apache

Webserverkonfigurationsdatei @code{httpd.conf} eingestellt

werden. F?gen Sie den folgenden Abschnitt dieser Datei oder einer

anderen Datei hinzu, die beim Starten des Webservers eingelesen wird:

@code{@*

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 @samp{+} gesetzt werden.

Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets

nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die

folgende Option in die Konfiguration aufzunehmen:

@code{EnableSendfile Off}

@c ---------------------------------------------------------------

@node Benutzer und Datenbanken anlegen

@chapter Benutzer und Datenbanken anlegen

Nach der Installation m?ssen Benutzer und Datenbanken angelegt werden.

Dieses geschieht im Administrationsmen?, dass Sie unter folgender URL

finden:

@code{http://localhost/lx-erp/admin.pl}

Zuerst muss 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 @code{$dbcharset} auf den Wert ``UTF-8''

setzen. Zus?tzlich muss beim Anlegen der Datenbank ``UTF-8 Unicode''

als Schriftsatz ausgew?hlt werden.

@c ---------------------------------------------------------------

@node OpenDocument-Vorlagen

@chapter 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 @code{$opendocument_templates} auf ``1'' stehen.  Dieses

ist die Standardeinstellung.

Weiterhin muss in der Datei ``lx-erp.conf'' die Variable

@code{$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: @code{$openofficeorg_writer_bin} muss den

vollst?ndigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.

@code{$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 @code{$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 @code{$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 @samp{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 @code{~/.openoffice.org2}. Sollte der Name

bei Ihrer OpenOffice.org-Installation anders sein, so muss das

Verzeichnis @code{users/.openoffice.org2} entsprechend umbenannt

werden. Ist der Name z.B. einfach nur @code{.openoffice}, so w?re

folgender Befehl auszuf?hren:

@code{mv users/.openoffice.org2 users/.openoffice}

Dieses Verzeichnis, wie auch das komplette @code{users}-Verzeichnis,

muss vom Webserver beschreibbar sein. Dieses wurde in Schritt

@code{Installation des Programmpakets} oben bereits erledigt, kann

aber erneut ?berpr?ft werden, wenn die Konvertierung nach PDF

fehlschl?gt.

@c ---------------------------------------------------------------

@node Lx-Office ERP verwenden

@chapter Lx-Office ERP verwenden

Nach erfolgreicher Installation ist der Loginbildschirm unter

folgender URL erreichbar:

@uref{http://localhost/lx-office-erp/login.pl}

Die Administrationsseite erreichen Sie unter:

@uref{http://localhost/lx-office-erp/admin.pl}

@bye

Inhaltsverzeichnis

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

Inhalt der Anleitung

1 Aktuelle Hinweise

2 Ben?tigte Software und Pakete

3 Installation des Programmpaketes

4 Anpassung der PostgreSQL-Konfiguration

  4.1 ?nderungen an Konfigurationsdateien

  4.2 Erweiterung f?r servergespeicherte Prozeduren

  4.3 Datenbankbenutzer anlegen

5 Apache-Konfiguration

6 Benutzer und Datenbanken anlegen

7 OpenDocument-Vorlagen

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

2 Ben?tigte Software und Pakete

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

Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)

und ein Datenbankserver (PostgreSQL) ben?tigt.

   Zus?tzlich ben?tigt Lx-Office die folgenden 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 oder Ubuntu ben?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 ben?tigen Sie unter anderem diese Pakete:

   `httpd postgresql-server perl-DBI perl-DBD-Pg'

   F?r OpenSuSE ben?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. Lx-Office liefert daher

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

3 Installation des Programmpaketes

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

Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) wird im

Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/',

`/srv/www/htdocs' oder `/var/www/') entpackt:

   `cd /var/www

tar xvzf lxoffice-erp-2.4.x.tgz'

   Ver?ndern Sie evtl. noch den Namen des Verzeichnisses mit

   `mv lxoffice-erp/ lx-erp/'

   Alternativ k?nnen Sie auch einen Alias in der Webserverkonfiguration

benutzen, um auf das tats?chliche Installationsverzeichnis zu verweisen.

   Das Verzeichnis mu? f?r den Benutzer beschreibbar sein, unter dem der

Webserver l?uft. Dieser ist bei verschiedenen Distributionen

unterschiedlich (z.B. bei Debian/Ubuntu `www-data', bei Fedora core

`apache' oder bei OpenSuSE `wwwrun').

   `chown -R www-data: lx-office-erp/'

4 Anpassung der PostgreSQL-Konfiguration

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

PostgreSQL muss auf verschiedene Weisen angepasst werden.

4.1 ?nderungen an Konfigurationsdateien

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

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

TCP/IP-Verbindungen aktiviert sind. Dieser Parameter lautet

   `TCPIP_SOCKET = 1'

   Bei PostgreSQL-Versionen ab v8.0 und neuer muss zus?tzlich der

folgende Parameter gesetzt werden:

   `default_with_oids = on'

   In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die

`postgresql.conf' zu finden sein sollte, m?ssen die Berichtigungen f?r

den Zugriff ge?ndert werden. Hier gibt es mehrere M?glichkeiten. Eine

besteht darin, lokale Verbindungen immer zuzulassen

   `local all all trust

host all all 127.0.0.1 255.0.0.0 trust'

   Besser ist es, f?r eine bestimmte Datenbank Zugriff nur per Passwort

zuzulassen. Beispielsweise:

   `local   all         lxoffice

  password

host    all         lxoffice      127.0.0.1         255.255.255.255

password'

4.2 Erweiterung f?r servergespeicherte Prozeduren

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

In der Datenbank `template1' muss die Unterst?tzung f?r

servergespeicherte Prozeduren eingerichet werden. Melden Sie sich daf?r

als Benutzer "postgres" an der Datenbank an, und f?hren Sie die

folgenden Kommandos aus:

   `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, dass der Pfad zur Datei `plpgsql.so' von

Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu

befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so'.

4.3 Datenbankbenutzer anlegen

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

Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen

wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein

Beispiel, wie Sie einen neuen Benutzer anlegen k?nnen:

   `su - postgres

createuser -d -P lxoffice'

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

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

hier gew?hlten Benutzernamen.

5 Apache-Konfiguration

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

Der Zugriff auf das Programmverzeichnis muss in der Apache

Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. F?gen Sie

den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu,

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

nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die folgende

Option in die Konfiguration aufzunehmen:

   `EnableSendfile Off'

6 Benutzer und Datenbanken anlegen

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

Nach der Installation m?ssen Benutzer und Datenbanken angelegt werden.

Dieses geschieht im Administrationsmen?, dass Sie unter folgender URL

finden:

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

   Zuerst muss 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.

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

8 Lx-Office ERP verwenden

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

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'

<html lang="en">

<head>

<title>Aktuelle Hinweise - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="index.html#Top" title="Top">

<link rel="next" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete" title="Ben?tigte Software und Pakete">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Aktuelle-Hinweise"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Ben?tigte Software und Pakete</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="index.html#Top">Top</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">1 Aktuelle Hinweise</h2>

<p>Aktuelle Installations- und Konfigurationshinweise gibt es:

     <ul>

<li>auf der Lx-Office Homepage unter <a href="http://lx-office.org/index.php?id=dokumentation">http://lx-office.org/index.php?id=dokumentation</a>

     <li>im Lx-Office-Wiki unter Dokumentation (<a href="http://wiki.lx-office.org/index.php/Lx-Office_ERP">http://wiki.lx-office.org/index.php/Lx-Office_ERP</a>)

     <li>im Lx-Office-Forum: <a href="http://www.lx-office.org/forum/">http://www.lx-office.org/forum/</a>

</ul>

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Anpassung der PostgreSQL-Konfiguration - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes" title="Installation des Programmpaketes">

<link rel="next" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration" title="Apache-Konfiguration">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Anpassung-der-PostgreSQL-Konfiguration"></a>

<a name="Anpassung-der-PostgreSQL_002dKonfiguration"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration">Apache-Konfiguration</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">4 Anpassung der PostgreSQL-Konfiguration</h2>

<p>PostgreSQL muss auf verschiedene Weisen angepasst werden.

<ul class="menu">

<li><a accesskey="1" href="_00c4nderungen-an-Konfigurationsdateien.html#g_t_00c4nderungen-an-Konfigurationsdateien">?nderungen an Konfigurationsdateien</a>:  Anpassungen f?r Anmeldung am Server und Featureunterst?tzung

<li><a accesskey="2" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung f?r servergespeicherte Prozeduren</a>:  Lx-Office benutzt servergespeicherte Prozeduren

<li><a accesskey="3" href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen">Datenbankbenutzer anlegen</a>:  Um den Zugriff besser zu reglementieren

</ul>

   </body></html>

<html lang="en">

<head>

<title>Apache-Konfiguration - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration" title="Anpassung der PostgreSQL-Konfiguration">

<link rel="next" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen" title="Benutzer und Datenbanken anlegen">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Apache-Konfiguration"></a>

<a name="Apache_002dKonfiguration"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen">Benutzer und Datenbanken anlegen</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">5 Apache-Konfiguration</h2>

<p>Der Zugriff auf das Programmverzeichnis muss in der Apache

Webserverkonfigurationsdatei <code>httpd.conf</code> eingestellt

werden. F?gen Sie den folgenden Abschnitt dieser Datei oder einer

anderen Datei hinzu, die beim Starten des Webservers eingelesen wird:

   <p><code><br>

AddHandler cgi-script .pl

<br>

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

<br>

<Directory /var/www/lx-erp>

<br>

  Options ExecCGI Includes FollowSymlinks

<br>

</Directory>

<br>

<br>

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

<br>

  Order Deny,Allow

<br>

  Deny from All

<br>

</Directory>

<br>

</code>

   <p>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher das

Lx-Office-Archiv entpacket haben.

   <p>Achtung: Vor den einzelnen Optionen muss bei einigen Distributionen ein

Plus `<samp><span class="samp">+</span></samp>' gesetzt werden.

   <p>Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets

nicht ausgeliefert. In solchen F?llen hat es oft geholfen, die

folgende Option in die Konfiguration aufzunehmen:

   <p><code>EnableSendfile Off</code>

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Ben?tigte Software und Pakete - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise" title="Aktuelle Hinweise">

<link rel="next" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes" title="Installation des Programmpaketes">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Ben%f6tigte-Software-und-Pakete"></a>

<a name="Ben_00f6tigte-Software-und-Pakete"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">2 Ben?tigte Software und Pakete</h2>

<p>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) ben?tigt.

   <p>Zus?tzlich ben?tigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind:

     <ul>

<li>DBI

<li>DBD::Pg

<li>CGI::Ajax

<li>Class::Accessor

<li>Archive::Zip

<li>Text::Iconv

<li>Text::CSV_XS

<li>IO::Wrap (aus dem Paket IO::Stringy)

<li>YAML

<li>Template

</ul>

   <p>Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders hei?en.

   <p>F?r Debian oder Ubuntu ben?tigen Sie diese Pakete:

   <p><code>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</code>

   <p>F?r Fedora Core ben?tigen Sie unter anderem diese Pakete:

   <p><code>httpd postgresql-server perl-DBI perl-DBD-Pg</code>

   <p>F?r OpenSuSE ben?tigen Sie diese Pakete:

   <p><code>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</code>

   <p>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. Lx-Office liefert daher

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

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Benutzer und Datenbanken anlegen - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration" title="Apache-Konfiguration">

<link rel="next" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen" title="OpenDocument-Vorlagen">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Benutzer-und-Datenbanken-anlegen"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen">OpenDocument-Vorlagen</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration">Apache-Konfiguration</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">6 Benutzer und Datenbanken anlegen</h2>

<p>Nach der Installation m?ssen Benutzer und Datenbanken angelegt werden. 

Dieses geschieht im Administrationsmen?, dass Sie unter folgender URL

finden:

   <p><code>http://localhost/lx-erp/admin.pl</code>

   <p>Zuerst muss eine Datenbank angelegt werden, anschlie?end ein

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

Benutzer “lxoffice”.

   <p>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 <code>$dbcharset</code> auf den Wert &ldquo;UTF-8&rdquo;

setzen. Zus?tzlich muss beim Anlegen der Datenbank “UTF-8 Unicode”

als Schriftsatz ausgew?hlt werden.

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Datenbankbenutzer anlegen - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="up" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration" title="Anpassung der PostgreSQL-Konfiguration">

<link rel="prev" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren" title="Erweiterung f?r servergespeicherte Prozeduren">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Datenbankbenutzer-anlegen"></a>

voriges:&nbsp;<a rel="previous" accesskey="p" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung f?r servergespeicherte Prozeduren</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>

<hr>

</div>

<h3 class="section">4.3 Datenbankbenutzer anlegen</h3>

<p>Wenn Sie nicht den Datenbanksuperuser &ldquo;postgres&rdquo; zum Zugriff

benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer

anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen k?nnen:

   <p><code>su - postgres

<br>

createuser -d -P lxoffice</code>

   <p>Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie

den evtl. voreingestellten Benutzer “postgres” auf “lxoffice”

bzw. den hier gew?hlten Benutzernamen.

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Erweiterung f?r servergespeicherte Prozeduren - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="up" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration" title="Anpassung der PostgreSQL-Konfiguration">

<link rel="prev" href="_00c4nderungen-an-Konfigurationsdateien.html#g_t_00c4nderungen-an-Konfigurationsdateien" title="?nderungen an Konfigurationsdateien">

<link rel="next" href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen" title="Datenbankbenutzer anlegen">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Erweiterung-f%fcr-servergespeicherte-Prozeduren"></a>

<a name="Erweiterung-f_00fcr-servergespeicherte-Prozeduren"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen">Datenbankbenutzer anlegen</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="_00c4nderungen-an-Konfigurationsdateien.html#g_t_00c4nderungen-an-Konfigurationsdateien">?nderungen an Konfigurationsdateien</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>

<hr>

</div>

<h3 class="section">4.2 Erweiterung f?r servergespeicherte Prozeduren</h3>

<p>In der Datenbank <code>template1</code> muss die Unterst?tzung f?r

servergespeicherte Prozeduren eingerichet werden. Melden Sie sich

daf?r als Benutzer “postgres” an der Datenbank an, und f?hren Sie

die folgenden Kommandos aus:

   <p><code>create function plpgsql_call_handler () returns opaque as '/usr/lib/pgsql/plpgsql.so' language 'c';

<br>

create language 'plpgsql' handler plpgsql_call_handler

lancompiler 'pl/pgsql';</code>

   <p>Bitte beachten Sie, dass der Pfad zur Datei <code>plpgsql.so</code> von

Distribution zu Distribution verschiedlich sein kann. Bei

Debian/Ubuntu befindet sie sich unter

<code>/usr/lib/postgresql/lib/plpgsql.so</code>.

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Installation des Programmpaketes - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete" title="Ben?tigte Software und Pakete">

<link rel="next" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration" title="Anpassung der PostgreSQL-Konfiguration">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Installation-des-Programmpaketes"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Ben?tigte Software und Pakete</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">3 Installation des Programmpaketes</h2>

<p>Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) wird im

Dokumentenverzeichnis des Webservers (z.B. <code>/var/www/html/</code>,

<code>/srv/www/htdocs</code> oder <code>/var/www/</code>) entpackt:

   <p><code>cd /var/www

<br>

tar xvzf lxoffice-erp-2.4.x.tgz</code>

   <p>Ver?ndern Sie evtl. noch den Namen des Verzeichnisses mit

   <p><code>mv lxoffice-erp/ lx-erp/</code>

   <p>Alternativ k?nnen Sie auch einen Alias in der Webserverkonfiguration

benutzen, um auf das tats?chliche Installationsverzeichnis zu

verweisen.

   <p>Das Verzeichnis mu? f?r den Benutzer beschreibbar sein, unter dem der

Webserver l?uft. Dieser ist bei verschiedenen Distributionen

unterschiedlich (z.B. bei Debian/Ubuntu <code>www-data</code>, bei Fedora

core <code>apache</code> oder bei OpenSuSE <code>wwwrun</code>).

   <p><code>chown -R www-data: lx-office-erp/</code>

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Lx-Office ERP verwenden - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen" title="OpenDocument-Vorlagen">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Lx-Office-ERP-verwenden"></a>

<a name="Lx_002dOffice-ERP-verwenden"></a>

voriges:&nbsp;<a rel="previous" accesskey="p" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen">OpenDocument-Vorlagen</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">8 Lx-Office ERP verwenden</h2>

<p>Nach erfolgreicher Installation ist der Loginbildschirm unter

folgender URL erreichbar:

   <p><a href="http://localhost/lx-office-erp/login.pl">http://localhost/lx-office-erp/login.pl</a>

   <p>Die Administrationsseite erreichen Sie unter:

   <p><a href="http://localhost/lx-office-erp/admin.pl">http://localhost/lx-office-erp/admin.pl</a>

</body></html>

<html lang="en">

<head>

<title>OpenDocument-Vorlagen - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen" title="Benutzer und Datenbanken anlegen">

<link rel="next" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden" title="Lx-Office ERP verwenden">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="OpenDocument-Vorlagen"></a>

<a name="OpenDocument_002dVorlagen"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden">Lx-Office ERP verwenden</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen">Benutzer und Datenbanken anlegen</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">7 OpenDocument-Vorlagen</h2>

<p>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 <code>$opendocument_templates</code> auf &ldquo;1&rdquo; stehen.  Dieses

ist die Standardeinstellung.

   <p>Weiterhin muss in der Datei &ldquo;lx-erp.conf&rdquo; die Variable

<code>$dbcharset</code> 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".

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

   <p>Nach der Installation m?ssen in der Datei &ldquo;lx-erp.conf&rdquo; zwei weitere

Variablen angepasst werden: <code>$openofficeorg_writer_bin</code> muss den

vollst?ndigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. 

<code>$xvfb_bin</code> muss den Pfad zum &ldquo;X virtual frame buffer&rdquo;

enthalten.

   <p>Zus?tzlich gibt es zwei verschiedene Arten, wie Lx-Office mit

OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn

die Variable <code>$openofficeorg_daemon</code> 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.

   <p>Ist <code>$openofficeorg_daemon</code> 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 `<samp><span class="samp">templates/German-invoice.odt</span></samp>'

enth?lt ein solches Makro, das in jeder anderen Dokumentenvorlage

ebenfalls enthalten sein muss.

   <p>Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org

Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter

Debian ist dies momentan <code>~/.openoffice.org2</code>. Sollte der Name

bei Ihrer OpenOffice.org-Installation anders sein, so muss das

Verzeichnis <code>users/.openoffice.org2</code> entsprechend umbenannt

werden. Ist der Name z.B. einfach nur <code>.openoffice</code>, so w?re

folgender Befehl auszuf?hren:

   <p><code>mv users/.openoffice.org2 users/.openoffice</code>

   <p>Dieses Verzeichnis, wie auch das komplette <code>users</code>-Verzeichnis,

muss vom Webserver beschreibbar sein. Dieses wurde in Schritt

<code>Installation des Programmpakets</code> oben bereits erledigt, kann

aber erneut ?berpr?ft werden, wenn die Konvertierung nach PDF

fehlschl?gt.

<!--  -->

</body></html>

<html lang="en">

<head>

<title>?nderungen an Konfigurationsdateien - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="index.html#Top">

<link rel="up" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration" title="Anpassung der PostgreSQL-Konfiguration">

<link rel="next" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren" title="Erweiterung f?r servergespeicherte Prozeduren">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="%c4nderungen-an-Konfigurationsdateien"></a>

<a name="g_t_00c4nderungen-an-Konfigurationsdateien"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung f?r servergespeicherte Prozeduren</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>

<hr>

</div>

<h3 class="section">4.1 ?nderungen an Konfigurationsdateien</h3>

<p>In der Datei <code>postgresql.conf</code>, die je nach Distribution in

verschiedenen Verzeichnissen liegen kann

(z.B. <code>/var/lib/pgsql/data/</code> oder <code>/etc/postgresql/</code>, muss

sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Dieser

Parameter lautet

   <p><code>TCPIP_SOCKET = 1</code>

   <p>Bei PostgreSQL-Versionen ab v8.0 und neuer muss zus?tzlich der

folgende Parameter gesetzt werden:

   <p><code>default_with_oids = on</code>

   <p>In der Datei <code>pg_hba.conf</code>, die im gleichen Verzeichnis wie die

<code>postgresql.conf</code> zu finden sein sollte, m?ssen die

Berichtigungen f?r den Zugriff ge?ndert werden. Hier gibt es mehrere

M?glichkeiten. Eine besteht darin, lokale Verbindungen immer

zuzulassen

   <p><code>local all all trust

<br>

host all all 127.0.0.1 255.0.0.0 trust</code>

   <p>Besser ist es, f?r eine bestimmte Datenbank Zugriff nur per Passwort

zuzulassen. Beispielsweise:

   <p><code>local   all         lxoffice                                           password

<br>

host    all         lxoffice      127.0.0.1         255.255.255.255    password</code>

<!--  -->

</body></html>

<html lang="en">

<head>

<title>Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.8">

<link title="Top" rel="start" href="#Top">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<h1 class="settitle">Lx-Office Installationsanleitung</h1>

   <div class="contents">

<h2>Inhaltsverzeichnis</h2>

<ul>

<li><a name="toc_Top" href="index.html#Top">Inhalt der Anleitung</a>

<li><a name="toc_Aktuelle-Hinweise" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">1 Aktuelle Hinweise</a>

<li><a name="toc_Ben_00f6tigte-Software-und-Pakete" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">2 Ben?tigte Software und Pakete</a>

<li><a name="toc_Installation-des-Programmpaketes" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">3 Installation des Programmpaketes</a>

<li><a name="toc_Anpassung-der-PostgreSQL_002dKonfiguration" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">4 Anpassung der PostgreSQL-Konfiguration</a>

<ul>

<li><a href="_00c4nderungen-an-Konfigurationsdateien.html#_00c4nderungen-an-Konfigurationsdateien">4.1 ?nderungen an Konfigurationsdateien</a>

<li><a href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">4.2 Erweiterung f?r servergespeicherte Prozeduren</a>

<li><a href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen">4.3 Datenbankbenutzer anlegen</a>

</li></ul>

<li><a name="toc_Apache_002dKonfiguration" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration">5 Apache-Konfiguration</a>

<li><a name="toc_Benutzer-und-Datenbanken-anlegen" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen">6 Benutzer und Datenbanken anlegen</a>

<li><a name="toc_OpenDocument_002dVorlagen" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen">7 OpenDocument-Vorlagen</a>

<li><a name="toc_Lx_002dOffice-ERP-verwenden" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden">8 Lx-Office ERP verwenden</a>

</li></ul>

</div>

<div class="node">

<p>

<a name="Top"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="../index.html#dir">(dir)</a>

<hr>

</div>

<h2 class="unnumbered">Inhalt der Anleitung</h2>

<ul class="menu">

<li><a accesskey="1" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>:  Andere Informationsquellen als diese Anleitung

<li><a accesskey="2" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Ben?tigte Software und Pakete</a>:  Vorraussetzungen zum Betrieb von Lx-Office

<li><a accesskey="3" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>:  Installationsort, Berechtigungen

<li><a accesskey="4" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>:  Verschiedene Aspekte der Datenbankkonfiguration

<li><a accesskey="5" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration">Apache-Konfiguration</a>:  Einrichtung eines Aliases und Optionen f?r das Ausf?hren von CGI-Scripten

<li><a accesskey="6" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen">Benutzer und Datenbanken anlegen</a>:  Letzte Schritte vor der Anmeldung

<li><a accesskey="7" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen">OpenDocument-Vorlagen</a>:  Wichtige Hinweise zum Erstellen und zur Verwendung von Dokumentenvorlagen

<li><a accesskey="8" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden">Lx-Office ERP verwenden</a>:  Die URLs zur Anmeldung und Administration

</ul>

<!--  -->

</body></html>