--- /dev/null
+\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
--- /dev/null
+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'
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>,
+voriges: <a rel="previous" accesskey="p" href="index.html#Top">Top</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration">Apache-Konfiguration</a>,
+voriges: <a rel="previous" accesskey="p" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen">Benutzer und Datenbanken anlegen</a>,
+voriges: <a rel="previous" accesskey="p" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Installation-des-Programmpaketes.html#Installation-des-Programmpaketes">Installation des Programmpaketes</a>,
+voriges: <a rel="previous" accesskey="p" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen">OpenDocument-Vorlagen</a>,
+voriges: <a rel="previous" accesskey="p" href="Apache_002dKonfiguration.html#Apache_002dKonfiguration">Apache-Konfiguration</a>,
+aufwärts: <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 “UTF-8”
+setzen. Zusätzlich muss beim Anlegen der Datenbank “UTF-8 Unicode”
+als Schriftsatz ausgewählt werden.
+
+<!-- -->
+</body></html>
+
--- /dev/null
+<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: <a rel="previous" accesskey="p" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung für servergespeicherte Prozeduren</a>,
+aufwärts: <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 “postgres” 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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Datenbankbenutzer-anlegen.html#Datenbankbenutzer-anlegen">Datenbankbenutzer anlegen</a>,
+voriges: <a rel="previous" accesskey="p" href="_00c4nderungen-an-Konfigurationsdateien.html#g_t_00c4nderungen-an-Konfigurationsdateien">Änderungen an Konfigurationsdateien</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>,
+voriges: <a rel="previous" accesskey="p" href="Ben_00f6tigte-Software-und-Pakete.html#Ben_00f6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>,
+aufwärts: <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>
+
--- /dev/null
+<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: <a rel="previous" accesskey="p" href="OpenDocument_002dVorlagen.html#OpenDocument_002dVorlagen">OpenDocument-Vorlagen</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden">Lx-Office ERP verwenden</a>,
+voriges: <a rel="previous" accesskey="p" href="Benutzer-und-Datenbanken-anlegen.html#Benutzer-und-Datenbanken-anlegen">Benutzer und Datenbanken anlegen</a>,
+aufwärts: <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 “1” stehen. Dieses
+ist die Standardeinstellung.
+
+ <p>Weiterhin muss in der Datei “lx-erp.conf” 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 “lx-erp.conf” 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 “X virtual frame buffer”
+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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Erweiterung-f_00fcr-servergespeicherte-Prozeduren.html#Erweiterung-f_00fcr-servergespeicherte-Prozeduren">Erweiterung für servergespeicherte Prozeduren</a>,
+aufwärts: <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>
+
--- /dev/null
+<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ächstes: <a rel="next" accesskey="n" href="Aktuelle-Hinweise.html#Aktuelle-Hinweise">Aktuelle Hinweise</a>,
+aufwärts: <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>
+
--- /dev/null
+all:
+ makeinfo --html --document-language=de_DE INSTALL.texi
+ makeinfo --plaintext --document-language=de_DE -o INSTALL.txt INSTALL.texi
projects / kivitendo-erp.git / commitdiff