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 perl-HTML-Template
  12 Diese Pakete können bei den unterschiedlichen Distributionen anders heißen.
  13 (Debian: apache, postgresql, libdbi-perl, libdbd-pg-perl,  libpgperl)
  14 (Fedora: httpd, postgresql-server, perl-DBI, perl-DBD-Pg)
  15 (SuSE: apache2, postgresql-server,  perl-DBI, perl-DBD-Pg)
  16
  17
  18 Die PostgreSQL Konfiguration muß angepasst werden.
  19 ==================================================
  20 In der Datei postgresql.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) muß folgender Wert verändert werden:
  21
  22 TCPIP_SOCKET = 1
  23
  24 In der Datei pg_hba.conf (/var/lib/pgsql/data/ oder /etc/postgresql/) müssen die Berichtigungen für den
  25 Zugriff geändert werden:
  26
  27 alte Eintragung:
  28 ----------------
  29 local   all all ident sameuser
  30 host all all 127.0.0.1 255.0.0.0        ident sameuser
  31
  32 Änderung:
  33 ---------
  34 local   all all trust
  35 host all all 127.0.0.1 255.0.0.0        trust
  36
  37
  38 Installation des Programmpaketes
  39 ================================
  40 Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.0.0.tgz) in den DocumentRoot des Webservers
  41 (/var/www/html/ oder /srv/www/htdocs oder /var/www/) entpacken.
  42
  43 tar xvzf lxoffice-erp-2.0.0.tgz
  44
  45 Verändern Sie evtl. noch den Namen des Verzeichnisses
  46
  47 mv lxoffice-erp/ lx-erp/
  48
  49 Das Verzeichnis muß dem Webserverbenutzer (Debian: www-data, Fedora: apache, SuSE: wwwrun) übergeben werden:
  50
  51 chown apache: -R lx-erp/
  52
  53
  54 Datenbankbenutzer anlegen
  55 =========================
  56
  57 Es sollte zum Zugriff auf die PostgreSQL Datenbank ein Datenbankbenutzer angelegt werden. Führen Sie dazu
  58 folgende Befehle nacheinander aus.
  59
  60 su - postgres
  61 createuser -d lxoffice (ohne Passwort)
  62 oder createuser -d -P lxoffice (mit Passwort)
  63
  64 Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie den evtl. voreingestellten Benutzer
  65 "postgres" auf "lxoffice".
  66
  67
  68 PostgreSQL - Datenbank erweitern
  69 ================================
  70 In der Datenbank "template1" sollte bevor die restliche Konfiguration von LxOffice ERP erfolgt noch folgende
  71 Funktion hinzugefügt werden:
  72
  73 psql template1 postgres (Zugriff über Admintool auf die Datenbank)
  74 create function plpgsql_call_handler ()
  75 returns opaque
  76 as '/usr/lib/pgsql/plpgsql.so'
  77 language 'c';
  78
  79 create language 'plpgsql' handler plpgsql_call_handler
  80 lancompiler 'pl/pgsql';
  81
  82 Bitte beachten Sie, das der Pfad zur Datei plpgsql.so von Distribution zu Distribution verschieden sein kann.
  83 Bei z.B. Debian befindet sie sich unter '/usr/lib/postgresql/lib/plpgsql.so'.
  84
  85
  86 Apache Konfiguration
  87 ====================
  88 Der Zugriff auf das Programmverzeichnis muß in der Apache Webserver- konfiguration httpd.conf
  89 (/etc/httpd/conf/) [bei SuSE evtl. httpd2.conf] konfiguriert werden:
  90
  91 AddHandler cgi-script .pl
  92 Alias /lx-erp/ /var/www/lx-erp/
  93 <Directory /var/www/lx-erp>
  94   Options ExecCGI Includes FollowSymlinks
  95 </Directory>
  96
  97 <Directory /var/www/lx-erp/users>
  98   Order Deny,Allow
  99   Deny from All
 100 </Directory>
 101
 102
 103 Datenbank anlegen
 104 =================
 105 Das Administrationsmenü finden Sie unter:
 106
 107 http://localhost/lx-erp/admin.pl
 108
 109 Zuerst muß eine Datenbank angelegt werden. Anschließend ein Benutzer. Verwenden Sie für den
 110 Datenbankzugriff den eben angelegten Benutzer lxoffice.
 111
 112
 113 Lx-Office ERP verwenden
 114 =======================
 115 Einloggen können Sie sich unter:
 116
 117 http://localhost/lx-erp/login.pl