X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2FINSTALL.texi;h=43eeda94ee4ec92468fab2afc932049911d95cbf;hb=aa88143332a85c1048fcf02d4e2ea53751d7778e;hp=44065f49b725f608b8942dbba605e8ef12ac8d07;hpb=3acaa5235c3a699a5c12cb6be054c2b15743f89f;p=kivitendo-erp.git diff --git a/doc/INSTALL.texi b/doc/INSTALL.texi index 44065f49b..43eeda94e 100644 --- a/doc/INSTALL.texi +++ b/doc/INSTALL.texi @@ -83,13 +83,17 @@ PDF::API2 YAML @item Template +@item +List::MoreUtils +@item +Email::Address @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} +@code{apache postgresql libdbi-perl libdbd-pg-perl libpg-perl libpdf-api2-perl 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: @@ -99,23 +103,27 @@ F @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. +Einige Module werden von Lx-Office benötigt, sind aber evtl. nicht als +Distributionspakete vorhanden, und/oder nicht praktikabel zu installieren. +In diesen Fällen liefert Lx-Office das Paket mit, und lädt es als Fallback. + +Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle +benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt: + +@code{./scripts/installation_check.pl} @c --------------------------------------------------------------- @node Installation des Programmpaketes @chapter Installation des Programmpaketes -Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) wird im +Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.0.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} +tar xvzf lxoffice-erp-2.6.0.tgz} Verändern Sie evtl. noch den Namen des Verzeichnisses mit @@ -125,12 +133,23 @@ Alternativ k 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}). +Die Verzeichnisse @code{users}, @code{spool} und @code{webdav} müssen +für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die +restlichen Dateien müssen für diesen Benutzer lesbar sein. Der +Benutzername ist bei verschiedenen Distributionen unterschiedlich +(z.B. bei Debian/Ubuntu @code{www-data}, bei Fedora core @code{apache} +oder bei OpenSuSE @code{wwwrun}). + +Der folgende Befehl ändert den Besitzer für die oben genannten +Verzeichnisse auf einem Debian/Ubuntu-System: + +@code{chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav} + +Weiterhin muss der Webserver-Benutzer im Verzeichnis @code{templates} Verzeichnisse für +jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen: + +@code{chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates} -@code{chown -R www-data: lx-office-erp/} @c --------------------------------------------------------------- @@ -170,7 +189,9 @@ Unter anderen Distributionen gibt es Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist ein Neuanlegen eines weiteren Clusters nicht möglich, so kann -Lx-Office mit ISO-8850-15 als Encoding betrieben werden. +Lx-Office mit ISO-8859-15 als Encoding betrieben werden. + +Das Encoding einer Datenbank kann in @code{psql} mit @code{\l} geprüft werden. @node Änderungen an Konfigurationsdateien @section Änderungen an Konfigurationsdateien @@ -178,15 +199,16 @@ Lx-Office mit ISO-8850-15 als Encoding betrieben werden. 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 +sichergestellt werden, dass TCP/IP-Verbindungen aktiviert sind. Für +PostgreSQL vor Version v8.0 lautete dieser Parameter @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} +Ab v8.0 wird das Verhalten hingegen über den neuen Parameter +@code{listen_address} gesteuert. Laufen PostgreSQL und Lx-Office auf +demselben Rechner, so kann dort der Wert @code{localhost} verwendet +werden. Andernfalls müssen Datenbankverbindungen auch von anderen +Rechnern aus zugelassen werden, was mit dem Wert \@code{*} geschieht. In der Datei @code{pg_hba.conf}, die im gleichen Verzeichnis wie die @code{postgresql.conf} zu finden sein sollte, müssen die @@ -223,7 +245,7 @@ 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}. +@code{/usr/lib/postgresql/lib/plpgsql.so}, bei Ubuntu 9.10 unter @code{/usr/lib/postgresql/8.4/lib/plpgsql.so}. @c --------------------------------------------------------------- @@ -389,7 +411,7 @@ den LDAP-Server in @code{$self->@{LDAP_config@}} angegeben werden: @item @samp{tls} -- Wenn Verbindungsverschlüsselung gewünscht ist, so diesen Wert auf @samp{1} setzen, andernfalls auf @samp{0} belassen @item -@samp{attribute'} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server +@samp{attribute} -- Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. Für Active-Directory-Server ist dies meist @samp{sAMAccountName}, für andere LDAP-Server hingegen @samp{uid}. Diese Angabe ist zwingend erforderlich. @item @samp{base_dn} -- Der Abschnitt des LDAP-Baumes, der durchsucht werden soll. Diese Angabe ist zwingend erforderlich. @@ -433,7 +455,7 @@ sein sollte: @chapter Benutzer- und Gruppenverwaltung Nach der Installation müssen Benutzer, Gruppen und Datenbanken -angelegt werden. Dieses geschieht im Administrationsmenü, dass Sie +angelegt werden. Dieses geschieht im Administrationsmenü, das Sie unter folgender URL finden: @uref{http://localhost/lx-erp/admin.pl} @@ -468,7 +490,7 @@ Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank, aber beliebig viele Datenbanken mit Firmendaten. -Lx-Office lann seinen Benutzern Zugriff auf bestimmte +Lx-Office kann seinen Benutzern Zugriff auf bestimmte Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht gestattet, so werden der entsprechenden Menüpunkte auch nicht angezeigt. Diese Rechte werden ebenfalls in der