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