/doc/INSTALL - Annotieren - projekt kivitendo - wissen

| Zweig: | Markierung: | Revision:

kivitendo/doc/INSTALL @ 57c4c81a

-d235
+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/
 =======================================
-dbb0995
+            Moritz Bunkus
 Lx-Office ERP
 Installationsanleitung
 Folgende Pakete m?ssen installiert sein:
 ========================================
 Webserver (Apache)
 PostgreSQL - Datenbank
-a280667
+            Moritz Bunkus
 Ben?tigte Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation
 sind:
 * DBI
 * DBD::Pg
 * HTML::Template
 * CGI::Ajax
 * Class::Accessor
 * Archive::Zip
-a8aa81
+* Text::Iconv
-a280667
+            Moritz Bunkus
-dbb0995
+Diese Pakete k?nnen bei den unterschiedlichen Distributionen anders hei?en.
-a8aa81
+(Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl,  libpgperl, libhtml-template-perl, libclass-accessor-perl, libarchive-zip-perl, libtext-iconv-perl)
-dbb0995
+(Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)
 (SuSE: apache2, postgresql-server,  perl-DBI, perl-DBD-Pg)
-c2b2392
+Da Perl-CGI-Ajax nicht als Paket f?r Distributionen bereit steht, mu? es mit der CPAN-Shell installiert werden.
 Leider ist dazu nicht jeder in der Lage. LxO liefert daher das Paket im CGI-Verzeichnis mit. Das sollte als Fall-Back greifen.
-dbb0995
+Die PostgreSQL Konfiguration mu? angepasst werden.
 ==================================================
 In der Datei postgresql.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) mu? folgender Wert ver?ndert werden:
-c2b2392
+TCPIP_SOCKET = 1 #  Nur PostgreSQL < 8.0
 default_with_oids = on # Nur PostgreSQL >= 8.0
-dbb0995
+            Moritz Bunkus
 In der Datei pg_hba.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) m?ssen die Berichtigungen f?r den
 Zugriff ge?ndert werden:
 alte Eintragung:
 ----------------
 local	all all	ident sameuser
 host all all 127.0.0.1 255.0.0.0	ident sameuser
 ?nderung:
 ---------
 local	all all	trust
 host all all 127.0.0.1 255.0.0.0	trust
-c2b2392
+Besser:
 -------
 local   all         lxoffice                                           password
 host    all         lxoffice      127.0.0.1         255.255.255.255    password
-dbb0995
+            Moritz Bunkus
 Installation des Programmpaketes
 ================================
-c2b2392
+Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.4.x.tgz) in den DocumentRoot des Webservers
-dbb0995
+(/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.
-c2b2392
+tar xvzf lxoffice-erp-2.4.x.tgz
-dbb0995
+            Moritz Bunkus
 Ver?ndern Sie evtl. noch den Namen des Verzeichnisses
 mv lxoffice-erp/ lx-erp/
-c2b2392
+oder noch besser, Sie verwenden einen Alias in der Webserverkonfiguration.
-dbb0995
+Das Verzeichnis mu? dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) ?bergeben werden:
-c2b2392
+chown apache: -R lx-office-erp/
-dbb0995
+            Moritz Bunkus
 Datenbankbenutzer anlegen
 =========================
 Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. F?hren Sie dazu
 folgende Befehle nacheinander aus.
 su - postgres
 createuser -d lxoffice (ohne Passwort)
-c2b2392
+oder besser
 createuser -d -P lxoffice (mit Passwort)
-dbb0995
+            Moritz Bunkus
 Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern Sie den evtl. voreingestellten Benutzer
 "postgres" auf "lxoffice".
 PostgreSQL - Datenbank erweitern
 ================================
 In der Datenbank "template1" sollte bevor die restliche Konfiguration von LxOffice ERP erfolgt noch folgende
 Funktion hinzugef?gt werden:
-c2b2392
+su postgres
 psql template1  (Zugriff ?ber Admintool auf die Datenbank)
-dbb0995
+create function plpgsql_call_handler ()
 returns opaque
-c2b2392
+as '/usr/lib/pgsql/plpgsql.so'
-dbb0995
+language 'c';
 create language 'plpgsql' handler plpgsql_call_handler
 lancompiler 'pl/pgsql';
-c2b2392
+!!!! Bitte beachten Sie, das der Pfad zur Datei plpgsql.so und der Name von Distribution zu Distribution verschieden sein kann.
-dbb0995
+Bei z.B. Debian befindet sie sich unter '/usr/lib/postgresql/lib/plpgsql.so'.
 Apache Konfiguration
 ====================
 Der Zugriff auf das Programmverzeichnis mu? in der Apache Webserver- konfiguration httpd.conf
 (/etc/httpd/conf/) [bei SuSE evtl. httpd2.conf] konfiguriert werden:
 AddHandler cgi-script .pl
 Alias /lx-erp/ /var/www/lx-erp/
 <Directory /var/www/lx-erp>
   Options ExecCGI Includes FollowSymlinks
-c2b2392
+  DirectoryIndex login.pl			# nicht mehr unbedingt n?tig, da eine index.html mitgeliefert wird
-dbb0995
+</Directory>
 <Directory /var/www/lx-erp/users>
   Order Deny,Allow
   Deny from All
 </Directory>
-c2b2392
+!!!Vor den einzelnen Optionen mu? bei einigen Distributionen ein Plus "+" gesetzt werden.
 Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets nicht ausgeliefert. Daher die Apache-Konfig um diese Zeile erweitern:
 EnableSendfile Off
-dbb0995
+            Moritz Bunkus
 Datenbank anlegen
 =================
 Das Administrationsmen? finden Sie unter:
 http://localhost/lx-erp/admin.pl
 Zuerst mu? eine Datenbank angelegt werden. Anschlie?end ein Benutzer. Verwenden Sie f?r den
 Datenbankzugriff den eben angelegten Benutzer lxoffice.
-e4131e
+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.
-            d99e15b3
+"$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.
-e4131e
+            Moritz Bunkus
 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.
-dbb0995
+Lx-Office ERP verwenden
 =======================
 Einloggen k?nnen Sie sich unter:
-c2b2392
+http://localhost/lx-office-erp/login.pl

Projekt

Allgemein

Profil

projekt kivitendo