simple_save darf nach edit nicht gesetzt sein, weil edit die Daten aus der Datenbank...
[kivitendo-erp.git] / 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