doc/INSTALL

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