X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.texi;h=807873fc06c5794d371a853ff83381a2cb58c546;hb=22ce5b071e9c536a03f298138f201b442cdbc92f;hp=a4a209f56d765332d11ed5a841432104cae32180;hpb=50b606454a09e9f7ed7017144984d6000d92649f;p=kivitendo-erp.git diff --git a/doc/INSTALL.texi b/doc/INSTALL.texi index a4a209f56..807873fc0 100644 --- a/doc/INSTALL.texi +++ b/doc/INSTALL.texi @@ -2,6 +2,7 @@ @c %**start of header @setfilename INSTALL.info @documentencoding UTF-8 +@afourpaper @settitle Lx-Office Installationsanleitung @c %**end of header @@ -24,7 +25,7 @@ @menu * Aktuelle Hinweise:: Andere Informationsquellen als diese Anleitung * Benötigte Software und Pakete:: Vorraussetzungen zum Betrieb von Lx-Office -* Installation des Programmpaketes:: Installationsort, Berechtigungen +* Manuelle 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 * Benutzerauthentifizierung und Administratorpasswort:: Einrichtung der Authentifizierungsdatenbank und der Passwortüberprüfung @@ -56,10 +57,78 @@ im Lx-Office-Forum: @uref{http://www.lx-office.org/forum/} @node Benötigte Software und Pakete @chapter Benötigte Software und Pakete +@menu +* Betriebssystem:: Unterstützte Betriebsysteme und Hinweise für ältere Systeme +* Pakete:: Benötigte Software und Perlpakete sowie deren Quellen +@end menu + +@node Betriebssystem +@section Betriebssystem + +Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden +Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im +speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl der +Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme auf den +derzeit aktuellen verbreiteten Distributionen läuft. + +Anfang 2011 sind das folgende Systeme: + +@itemize +@item +Ubuntu 8.04 LTS Hardy Heron +@item +Ubuntu 9.10 Karmic Koala +@item +Ubuntu 10.04 Lucid Lynx +@item +Ubuntu 10.10 Maverick Meerkat +@item +Debian 5.0 Lenny +@item +Debian 6.0 Squeeze +@item +openSUSE 11.2 +@item +openSUSE 11.3 +@item +SuSE Linux Enterprice Server 11 +@item +Fedora 13 +@item +Fedora 14 +@end itemize + +Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich einfacher +zu installieren ist. + +Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im Archiv +recht alt sind, und das viele der benötigten Module nicht einfach zu +installieren sind. Dafür sollte es kurz nach dem Release ein eigenes .deb +geben. + +Alternativ dazu kann die normale Installation durchgeführt werden +(@pxref{Manuelle Installation des Programmpaketes}), wenn vorher ein +Kompatibilitätspaket installiert wird, das die fehlenden Pakete bereitstellt. +Das Paket ist auf @uref{https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/, Sourceforge} unter dem Namen @code{lx-erp-perl-libs-compat-v2.tar.gz} hinterlegt. + +Zur Installation das Paket in das entpackte Lx-Office Verzeichnis entpacken: + +@code{tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/} + +Zusätzlich müssen dann noch die folgenden Pakete installiert weerden + +@code{libbit-vector-perl libsub-exporter-perl libclone-perl libclass-factory-util-perl} + +Danach sollte der Installationscheck (@pxref{Pakete}) die enthaltenen Pakete erkennen. + +@node Pakete +@section Pakete + Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.2) benötigt. -Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind: +Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil +einer Standard-Perl-Installation sind: @itemize @item @@ -71,6 +140,8 @@ Class::Accessor @item CGI::Ajax @item +Config::Std +@item DateTime @item DBI @@ -81,6 +152,8 @@ Email::Address @item List::MoreUtils @item +Params::Validate +@item PDF::API2 @item Rose::Object @@ -122,7 +195,7 @@ Die zu installierenden Pakete können in den verschiedenen Distributionen unters Für Debian oder Ubuntu benötigen Sie diese Pakete: -@code{apache2 postgresql libparent-perl libarchive-zip-perl libclass-accessor-perl libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl libemail-address-perl liblist-moreutils-perl libpdf-api2-perl librose-object-perl librose-db-perl librose-db-object-perl libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl} +@code{apache2 postgresql libparent-perl libarchive-zip-perl libclass-accessor-perl libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl libemail-address-perl liblist-moreutils-perl libpdf-api2-perl librose-object-perl librose-db-perl librose-db-object-perl libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl libconfig-std-perl libparams-validate-perl} Für Fedora Core benötigen Sie diese Pakete: @@ -141,8 +214,8 @@ benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: @c --------------------------------------------------------------- -@node Installation des Programmpaketes -@chapter Installation des Programmpaketes +@node Manuelle Installation des Programmpaketes +@chapter Manuelle Installation des Programmpaketes Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.2.tgz) wird im Dokumentenverzeichnis des Webservers (z.B. @code{/var/www/html/}, @@ -376,10 +449,10 @@ LDAP-Server überprüft werden. Welche Art der Passwortüberprüfung Lx-Office benutzt und wie Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der -Konfigurationsdatei @code{config/authentication.pl} festgelegt. Diese +Konfigurationsdatei @code{config/lx_office.conf} festgelegt. Diese muss bei der Installation und bei einem Upgrade von einer Version vor v2.6.0 angelegt werden. Eine Beispielkonfigurationsdatei -@code{config/authentication.pl.default} existiert, die als Vorlage +@code{config/lx_office.conf.default} existiert, die als Vorlage benutzt werden kann. @node Administratorpasswort @@ -469,7 +542,7 @@ existiert. @node Anlegen der Authentifizierungsdatenbank @section Anlegen der Authentifizierungsdatenbank -Nachdem alle Einstellungen in @code{config/authentication.pl} +Nachdem alle Einstellungen in @code{config/lx_office.conf} vorgenommen wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden, das unter der folgenden URL erreichbar @@ -490,7 +563,7 @@ unter folgender URL finden: @uref{http://localhost/lx-erp/admin.pl} Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei -@code{config/authentication.pl} eingetragen haben. +@code{config/lx_office.conf} eingetragen haben. @menu * Zusammenhänge:: Übersicht über Benutzer, Gruppen, Berechtigungen und Datenbanken @@ -556,9 +629,10 @@ ist dies @samp{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 -@code{config/lx-erp.conf} die Variable @code{$dbcharset} auf den Wert -@samp{UTF-8} setzen. Zusätzlich muss beim Anlegen der Datenbank -@samp{UTF-8 Unicode} als Schriftsatz ausgewählt werden. +@code{config/lx_office.conf} die Variable @code{dbcharset} im +Abschnitt @code{system} auf den Wert @samp{UTF-8} setzen. Zusätzlich +muss beim Anlegen der Datenbank @samp{UTF-8 Unicode} als Schriftsatz +ausgewählt werden. Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz verwenden müssen, da diese Einstellungen momentan global in Lx-Office @@ -643,13 +717,14 @@ 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 -@code{config/lx-erp.conf} die Variable @code{$opendocument_templates} -auf @samp{1} stehen. Dieses ist die Standardeinstellung. +@code{config/lx_office.conf} die Variable @code{opendocument} im +Abschnitt @code{print_templates} auf @samp{1} stehen. Dieses ist die +Standardeinstellung. -Weiterhin muss in der Datei @code{config/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 "UTF-8". +Weiterhin muss in der Datei @code{config/lx_office.conf} die Variable +@code{dbcharset} im Abschnitt @code{system} auf die Zeichenkodierung +gesetzt werden, die auch bei der Speicherung der Daten in der +Datenbank verwendet wird. Diese ist in den meisten Fällen "UTF-8". Während die Erzeugung von reinen OpenDocument-Dateien keinerlei weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF @@ -658,11 +733,11 @@ 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 @code{config/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. +Nach der Installation müssen in der Datei @code{config/lx_config.conf} +zwei weitere Variablen angepasst werden: @code{openofficeorg_writer} +muss den vollständigen Pfad zur OpenOffice.org Writer-Anwendung +enthalten. @code{xvfb} muss den Pfad zum ``X virtual frame buffer'' +enthalten. Beide stehen im Abschnitt @code{applications}. Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn @@ -692,11 +767,10 @@ 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. +Dieses Verzeichnis, wie auch das komplette @code{users}-Verzeichnis, muss vom +Webserver beschreibbar sein. Dieses wurde bereits erledigt +(@pxref{Manuelle Installation des Programmpaketes}), kann aber erneut überprüft +werden, wenn die Konvertierung nach PDF fehlschlägt. @c ---------------------------------------------------------------