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 Lx-Office ERP verwenden
 113 =======================
 114 Einloggen können Sie sich unter:
 115
 116 http://localhost/lx-erp/login.pl