doc/INSTALL

   1
   2 Lx-Office ERP
   3 Installationsanleitung
   4
   5
   6 Folgende Pakete müssen installiert sein:
   7 ========================================
   8 Webserver (Apache)
   9 PostgreSQL - Datenbank
  10 Perl - DBI und Perl - DBD
  11 Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
  12 (Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl,  libpgperl)
  13 (Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)
  14 (SuSE: apache2, postgresql-server,  perl-DBI, perl-DBD-Pg)
  15
  16
  17 Die PostgreSQL Konfiguration muß angepasst werden.
  18 ==================================================
  19 In der Datei postgresql.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) muß folgender Wert verändert werden:
  20
  21 TCPIP_SOCKET = 1
  22
  23 In der Datei pg_hba.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) müssen die Berichtigungen für den
  24 Zugriff geändert werden:
  25
  26 alte Eintragung:
  27 ----------------
  28 local   all all ident sameuser
  29 host all all 127.0.0.1 255.0.0.0        ident sameuser
  30
  31 Änderung:
  32 ---------
  33 local   all all trust
  34 host all all 127.0.0.1 255.0.0.0        trust
  35
  36
  37 Installation des Programmpaketes
  38 ================================
  39 Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.0.0.tgz) in den DocumentRoot des Webservers
  40 (/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.
  41
  42 tar xvzf lxoffice-erp-2.0.0.tgz
  43
  44 Verändern Sie evtl. noch den Namen des Verzeichnisses
  45
  46 mv lxoffice-erp/ lx-erp/
  47
  48 Das Verzeichnis muß dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) übergeben werden:
  49
  50 chown apache: -R lx-erp/
  51
  52
  53 Datenbankbenutzer anlegen
  54 =========================
  55
  56 Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. Führen Sie dazu
  57 folgende Befehle nacheinander aus.
  58
  59 su - postgres
  60 createuser -d lxoffice (ohne Passwort)
  61 oder createuser -d -P lxoffice (mit Passwort)
  62
  63 Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer
  64 "postgres" auf "lxoffice".
  65
  66
  67 PostgreSQL - Datenbank erweitern
  68 ================================
  69 In der Datenbank "template1" sollte bevor die restliche Konfiguration von LxOffice ERP erfolgt noch folgende
  70 Funktion hinzugefügt werden:
  71
  72 psql template1 postgres (Zugriff über Admintool auf die Datenbank)
  73 create function plpgsql_call_handler ()
  74 returns opaque
  75 as '/usr/lib/pgsql/plpgsql.so'
  76 language 'c';
  77
  78 create language 'plpgsql' handler plpgsql_call_handler
  79 lancompiler 'pl/pgsql';
  80
  81 Bitte beachten Sie, das der Pfad zur Datei plpgsql.so von Distribution zu Distribution verschieden sein kann.
  82 Bei z.B. Debian befindet sie sich unter '/usr/lib/postgresql/lib/plpgsql.so'.
  83
  84
  85 Apache Konfiguration
  86 ====================
  87 Der Zugriff auf das Programmverzeichnis muß in der Apache Webserver- konfiguration httpd.conf
  88 (/etc/httpd/conf/) [bei SuSE evtl. httpd2.conf] konfiguriert werden:
  89
  90 AddHandler cgi-script .pl
  91 Alias /lx-erp/ /var/www/lx-erp/
  92 <Directory /var/www/lx-erp>
  93   Options ExecCGI Includes FollowSymlinks
  94 </Directory>
  95
  96 <Directory /var/www/lx-erp/users>
  97   Order Deny,Allow
  98   Deny from All
  99 </Directory>
 100
 101
 102 Datenbank anlegen
 103 =================
 104 Das Administrationsmenü finden Sie unter:
 105
 106 http://localhost/lx-erp/admin.pl
 107
 108 Zuerst muß eine Datenbank angelegt werden. Anschließend ein Benutzer. Verwenden Sie für den
 109 Datenbankzugriff den eben angelegten Benutzer lxoffice.
 110
 111
 112 OpenDocument-Vorlagen
 113 =====================
 114 Lx-Office unterstützt die Verwendung von Vorlagen im
 115 OpenDocument-Format, wie es OpenOffice.org ab Version 2
 116 erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als
 117 auch aus diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
 118 OpenDocument-Vorlagen zu aktivieren muss in der Datei "lx-erp.conf"
 119 die Variable "$opendocument_templates" auf "1" stehen.  Dieses ist die
 120 Standardeinstellung.
 121
 122 Weiterhin muss in der Datei "lx-erp.conf" die Variable "$dbcharset"
 123 auf die Zeichenkodierung gesetzt werden, die auch bei der Speicherung
 124 der Daten in der Datenbank verwendet wird. Diese ist in den meisten
 125 Fällen "ISO-8859-15".
 126
 127 Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
 128 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
 129 OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
 130 neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer"
 131 (xvfb) installiert werden.  Bei Debian ist er im Paket "xvfb"
 132 enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
 133
 134 Nach der Installation müssen in der Datei "lx-erp.conf" zwei weitere
 135 Variablen angepasst werden: "$openofficeorg_writer_bin" muss den
 136 vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
 137 "$xvfb_run_bin" muss den Pfad zu einem Script enthalten, dass den "X
 138 virtual frame buffer" startet und direkt danach ein Programm in ihm
 139 startet, das dem Script als Parameter übergeben wird. Lx-Office
 140 enthält bereits ein solches Script namens "xvfb-run", das
 141 standardmäßig verwendet wird. Es handelt sich dabei um eine gestutzte
 142 Version des Scripts "xvfb-run" aus dem Debian-Paket "xvfb".
 143
 144 Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
 145 Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter
 146 Debian ist dies momentan "~/.openoffice.org2". Sollte der Name bei
 147 Ihrer OpenOffice.org-Installation anders sein, so muss das Verzeichnis
 148 "users/.openoffice.org2" entsprechend umbenannt werden. Ist der Name
 149 z.B. einfach nur ".openoffice", so wäre folgender Befehl auszuführen:
 150
 151 mv users/.openoffice.org2 users/.openoffice
 152
 153 Dieses Verzeichnis, wie auch das komplette "users"-Verzeichnis, muss
 154 vom Webserver beschreibbar sein. Dieses wurde in Schritt "Installation
 155 des Programmpakets" oben bereits erledigt, kann aber erneut überprüft
 156 werden, wenn die Konvertierung nach PDF fehlschlägt.
 157
 158
 159 Lx-Office ERP verwenden
 160 =======================
 161 Einloggen können Sie sich unter:
 162
 163 http://localhost/lx-erp/login.pl