6 2 Benötigte Software und Pakete
7 3 Installation des Programmpaketes
8 4 Anpassung der PostgreSQL-Konfiguration
9 4.1 Zeichensätze/die Verwendung von UTF-8
10 4.2 Änderungen an Konfigurationsdateien
11 4.3 Erweiterung für servergespeicherte Prozeduren
12 4.4 Datenbankbenutzer anlegen
13 5 Apache-Konfiguration
14 6 Benutzerauthentifizierung und Administratorpasswort
15 6.1 Grundlagen zur Benutzerauthentifizierung
16 6.2 Administratorpasswort
17 6.3 Authentifizierungsdatenbank
18 6.4 Passwortüberprüfung
19 6.5 Name des Session-Cookies
20 6.6 Anlegen der Authentifizierungsdatenbank
21 7 Benutzer- und Gruppenverwaltung
23 7.2 Datenbanken anlegen
26 7.5 Gruppenmitgliedschaften verwalten
27 7.6 Migration alter Installationen
28 8 OpenDocument-Vorlagen
29 9 Lx-Office ERP verwenden
38 Aktuelle Installations- und Konfigurationshinweise gibt es:
40 * auf der Lx-Office Homepage unter
41 `http://lx-office.org/index.php?id=dokumentation'
43 * im Lx-Office-Wiki unter Dokumentation
44 (`http://wiki.lx-office.org/index.php/Lx-Office_ERP')
46 * im Lx-Office-Forum: `http://www.lx-office.org/forum/'
48 2 Benötigte Software und Pakete
49 ********************************
51 Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)
52 und ein Datenbankserver (PostgreSQL, mindestens v8.2) benötigt.
54 Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht
55 Bestandteil einer Standard-Perl-Installation sind:
93 Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete hinzugekommen,
94 `URI' und `XML::Writer' sind notwendig. Ohne startet Lx-Office nicht.
96 `Email::Address' und `List::MoreUtils' sind schon länger feste
97 Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert. Beide
98 sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer
99 zukünftigen Version aber aus dem Paket entfernt werden. Es wird
100 empfohlen diese Module zusammen mit den anderen als Bibliotheken zu
103 `CGI::Ajax' ist nach wie vor in einer modifizierten Version
104 mitgeliefert und braucht nicht nachinstalliert werden.
106 Die zu installierenden Pakete können in den verschiedenen
107 Distributionen unterschiedlich heißen.
109 Für Debian oder Ubuntu benötigen Sie diese Pakete:
111 `apache2 postgresql libarchive-zip-perl libclass-accessor-perl
112 libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl
113 libemail-address-perl libio-stringy-perl liblist-moreutils-perl
114 libpdf-api2-perl libtemplate-perl libtext-csv-xs-perl
115 libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl
116 librose-object-perl librose-db-perl librose-db-object-perl'
118 Für Fedora Core benötigen Sie diese Pakete:
120 `httpd postgresql-server perl-Class-Accessor perl-DateTime perl-DBI
121 perl-DBD-Pg perl-Email-Address perl-IO-stringy perl-List-MoreUtils
122 perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv
123 perl-URI perl-XML-Writer perl-YAML'
125 Für OpenSuSE benötigen Sie diese Pakete:
127 `apache2 postgresql-server perl-Archive-Zip perl-Class-Accessor
128 perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-IO-stringy
129 perl-List-MoreUtils perl-PDF-API2 perl-Template-Toolkit
130 perl-Text-CSV_XS perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML'
132 Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle
133 benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:
135 `./scripts/installation_check.pl'
137 3 Installation des Programmpaketes
138 **********************************
140 Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.2.tgz) wird im
141 Dokumentenverzeichnis des Webservers (z.B. `/var/www/html/',
142 `/srv/www/htdocs' oder `/var/www/') entpackt:
145 tar xvzf lxoffice-erp-2.6.2.tgz'
147 Verändern Sie evtl. noch den Namen des Verzeichnisses mit
149 `mv lxoffice-erp/ lx-erp/'
151 Alternativ können Sie auch einen Alias in der Webserverkonfiguration
152 benutzen, um auf das tatsächliche Installationsverzeichnis zu verweisen.
154 Die Verzeichnisse `users', `spool' und `webdav' müssen für den
155 Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
156 restlichen Dateien müssen für diesen Benutzer lesbar sein. Der
157 Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B.
158 bei Debian/Ubuntu `www-data', bei Fedora core `apache' oder bei
161 Der folgende Befehl ändert den Besitzer für die oben genannten
162 Verzeichnisse auf einem Debian/Ubuntu-System:
164 `chown -R www-data lx-office-erp/users lx-office-erp/spool
165 lx-office-erp/webdav'
167 Weiterhin muss der Webserver-Benutzer im Verzeichnis `templates'
168 Verzeichnisse für jeden neuen Benutzer, der in lx-office angelegt wird,
171 `chgrp www-data lx-office-erp/templates; chmod g+w
172 lx-office-erp/templates'
174 4 Anpassung der PostgreSQL-Konfiguration
175 ****************************************
177 PostgreSQL muss auf verschiedene Weisen angepasst werden.
179 4.1 Zeichensätze/die Verwendung von UTF-8
180 ==========================================
182 Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet werden.
183 Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in Version 8.0
184 oder neuer benutzt werden, und der PostgreSQL-Datenbankcluster muss
185 ebenfalls mit UTF-8 als Locale angelegt worden sein.
187 Dieses ist kann überprüft werden: ist das Encoding der Datenbank
188 "template1" "UTF8", so kann auch Lx-Office mit UTF-8 betrieben werden.
189 Andernfalls ist es notwendig, einen neuen Datenbankcluster mit
190 UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und
191 Ubuntu kann dies z.B. mit dem folgenden Befehl getan werden:
193 `pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2
196 Die Datenbankversionsnummer muss an die tatsächlich verwendete
197 Versionsnummer angepasst werden.
199 Unter anderen Distributionen gibt es ähnliche Methoden.
201 Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und ist
202 ein Neuanlegen eines weiteren Clusters nicht möglich, so kann Lx-Office
203 mit ISO-8859-15 als Encoding betrieben werden.
205 Das Encoding einer Datenbank kann in `psql' mit `\l' geprüft werden.
207 4.2 Änderungen an Konfigurationsdateien
208 ========================================
210 In der Datei `postgresql.conf', die je nach Distribution in
211 verschiedenen Verzeichnissen liegen kann (z.B. `/var/lib/pgsql/data/'
212 oder `/etc/postgresql/', muss sichergestellt werden, dass
213 TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den
214 Parameter `listen_address' gesteuert. Laufen PostgreSQL und Lx-Office
215 auf demselben Rechner, so kann dort der Wert `localhost' verwendet
216 werden. Andernfalls müssen Datenbankverbindungen auch von anderen
217 Rechnern aus zugelassen werden, was mit dem Wert \`*' geschieht.
219 In der Datei `pg_hba.conf', die im gleichen Verzeichnis wie die
220 `postgresql.conf' zu finden sein sollte, müssen die Berichtigungen für
221 den Zugriff geändert werden. Hier gibt es mehrere Möglichkeiten. Eine
222 besteht darin, lokale Verbindungen immer zuzulassen
225 host all all 127.0.0.1 255.0.0.0 trust'
227 Besser ist es, für eine bestimmte Datenbank Zugriff nur per Passwort
228 zuzulassen. Beispielsweise:
232 host all lxoffice 127.0.0.1 255.255.255.255
235 4.3 Erweiterung für servergespeicherte Prozeduren
236 ==================================================
238 In der Datenbank `template1' muss die Unterstützung für
239 servergespeicherte Prozeduren eingerichet werden. Melden Sie sich dafür
240 als Benutzer "postgres" an der Datenbank an, und führen Sie die
241 folgenden Kommandos aus:
243 `create language 'plpgsql';'
245 Achtung: In älteren Postgresversionen (vor 8.0) muss der Handler für
246 die Sprache manuell anlelegt werden, diese Versionen werden aber nicht
247 mehr offiziell von Lx-Office unterstützt. Dafür dann die folgenden
250 `create function plpgsql_call_handler () returns opaque as
251 '/usr/lib/pgsql/plpgsql.so' language 'c';
252 create language 'plpgsql' handler plpgsql_call_handler lancompiler
255 Bitte beachten Sie, dass der Pfad zur Datei `plpgsql.so' von
256 Distribution zu Distribution verschiedlich sein kann. Bei Debian/Ubuntu
257 befindet sie sich unter `/usr/lib/postgresql/lib/plpgsql.so'.
259 4.4 Datenbankbenutzer anlegen
260 =============================
262 Wenn Sie nicht den Datenbanksuperuser "postgres" zum Zugriff benutzen
263 wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer anlegen. Ein
264 Beispiel, wie Sie einen neuen Benutzer anlegen können:
267 createuser -d -P lxoffice'
269 Wenn Sie später einen Datenbankzugriff konfigurieren, verändern Sie
270 den evtl. voreingestellten Benutzer "postgres" auf "lxoffice" bzw. den
271 hier gewählten Benutzernamen.
273 5 Apache-Konfiguration
274 **********************
276 Hinweis: Für einen deutlichen Performanceschub sorgt die Ausführung
277 mittels FCGI. Die Einrichtung wird ausführlich in der Datei
278 `INSTALL.fcgi' beschrieben.
280 Der Zugriff auf das Programmverzeichnis muss in der Apache
281 Webserverkonfigurationsdatei `httpd.conf' eingestellt werden. Fügen Sie
282 den folgenden Abschnitt dieser Datei oder einer anderen Datei hinzu,
283 die beim Starten des Webservers eingelesen wird:
286 AddHandler cgi-script .pl
287 Alias /lx-erp/ /var/www/lx-erp/
288 <Directory /var/www/lx-erp>
289 Options ExecCGI Includes FollowSymlinks
291 <Directory /var/www/lx-erp/users>
297 Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher das
298 Lx-Office-Archiv entpacket haben.
300 Achtung: Vor den einzelnen Optionen muss bei einigen Distributionen
301 ein Plus `+' gesetzt werden.
303 Auf einigen Webservern werden manchmal die Grafiken und Style-Sheets
304 nicht ausgeliefert. In solchen Fällen hat es oft geholfen, die folgende
305 Option in die Konfiguration aufzunehmen:
309 6 Benutzerauthentifizierung und Administratorpasswort
310 *****************************************************
312 Informationen über die Einrichtung der Benutzerauthentifizierung, über
313 die Verwaltung von Gruppen und weitere Einstellungen
315 6.1 Grundlagen zur Benutzerauthentifizierung
316 ============================================
318 Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die
319 im folgenden "Authentifizierungsdatenbank" genannt wird. Für jeden
320 Benutzer kann dort eine eigene Datenbank für die eigentlichen
321 Finanzdaten hinterlegt sein. Diese beiden Datenbanken können, müssen
322 aber nicht unterschiedlich sein.
324 Im einfachsten Fall gibt es für Lx-Office nur eine einzige Datenbank,
325 in der sowohl die Benutzerinformationen als auch die Daten abgelegt
328 Zusätzlich ermöglicht es Lx-Office, dass die Benutzerpasswörter
329 entweder gegen die Authentifizierungsdatenbank oder gegen einen
330 LDAP-Server überprüft werden.
332 Welche Art der Passwortüberprüfung Lx-Office benutzt und wie
333 Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der
334 Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss
335 bei der Installation und bei einem Upgrade von einer Version vor v2.6.0
336 angelegt werden. Eine Beispielkonfigurationsdatei
337 `config/authentication.pl.default' existiert, die als Vorlage benutzt
340 6.2 Administratorpasswort
341 =========================
343 Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt
344 wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort
345 und nicht mehr im Administrationsinterface selber geändert werden. Der
346 Parameter dazu heißt `$self->{admin_password}'.
348 6.3 Authentifizierungsdatenbank
349 ===============================
351 Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern
352 in `$self->{DB_config}' konfiguriert. Hier sind die folgenden Parameter
355 * `host' - Der Rechnername oder die IP-Adresse des Datenbankservers
357 * `port' - Die Portnummer des Datenbankservers, meist 5432
359 * `db' - Der Name der Authentifizierungsdatenbank
361 * `user' - Der Benutzername, mit dem sich Lx-Office beim
362 Datenbankserver anmeldet (z.B. "postgres")
364 * `password' - Das Passwort für den Datenbankbenutzer
366 Die Datenbank muss noch nicht existieren. Lx-Office kann sie
367 automatisch anlegen (mehr dazu siehe unten).
369 6.4 Passwortüberprüfung
370 =========================
372 Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen die
373 Authentifizierungsdatenbank und gegen einen externen LDAP- oder
374 Active-Directory-Server. Welche davon benutzt wird, regelt der
375 Parameter `$self->{module}'.
377 Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank
378 gespeichert werden, so muss der Parameter `$self->{module}' den Wert
379 `DB' enthalten. In diesem Fall können sowohl der Administrator als auch
380 die Benutzer selber ihre Psaswörter in Lx-Office ändern.
382 Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt
383 werden, so muss der Parameter `$self->{module}' auf `LDAP' gesetzt
384 werden. In diesem Fall müssen zusätzliche Informationen über den
385 LDAP-Server in `$self->{LDAP_config}' angegeben werden:
387 * `host' - Der Rechnername oder die IP-Adresse des LDAP- oder
388 Active-Directory-Servers. Diese Angabe ist zwingend erforderlich.
390 * `port' - Die Portnummer des LDAP-Servers; meist 389.
392 * `tls' - Wenn Verbindungsverschlüsselung gewünscht ist, so diesen
393 Wert auf `1' setzen, andernfalls auf `0' belassen
395 * `attribute' - Das LDAP-Attribut, in dem der Benutzername steht,
396 den der Benutzer eingegeben hat. Für Active-Directory-Server ist
397 dies meist `sAMAccountName', für andere LDAP-Server hingegen
398 `uid'. Diese Angabe ist zwingend erforderlich.
400 * `base_dn' - Der Abschnitt des LDAP-Baumes, der durchsucht werden
401 soll. Diese Angabe ist zwingend erforderlich.
403 * `filter' - Ein optionaler LDAP-Filter. Enthält dieser Filter das
404 Wort `<%login%>', so wird dieses durch den vom Benutzer
405 eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum
406 nach einem Element durchsucht, bei dem das oben angegebene Attribut
407 mit dem Benutzernamen identisch ist.
409 * `bind_dn' und `bind_password' - Wenn der LDAP-Server eine
410 Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist
411 dies bei Active-Directory-Servern der Fall), so kann diese hier
412 angegeben werden. Für Active-Directory-Server kann als `bind_dn'
413 entweder eine komplette LDAP-DN wie z.B. `cn=Martin
414 Mustermann,cn=Users,dc=firmendomain' auch nur der volle Name des
415 Benutzers eingegeben werden; in diesem Beispiel also `Martin
418 6.5 Name des Session-Cookies
419 ============================
421 Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt
422 werden, so müssen die Namen der Session-Cookies für alle Installationen
423 unterschiedlich sein. Der Name des Cookies wird mit dem Parameter
424 `$self->{cookie_name}' gesetzt.
426 Diese Angabe ist optional, wenn nur eine Installation auf dem Server
429 6.6 Anlegen der Authentifizierungsdatenbank
430 ===========================================
432 Nachdem alle Einstellungen in `config/authentication.pl' vorgenommen
433 wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses
434 geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden,
435 das unter der folgenden URL erreichbar sein sollte:
437 `http://localhost/lx-erp/admin.pl'
439 7 Benutzer- und Gruppenverwaltung
440 *********************************
442 Nach der Installation müssen Benutzer, Gruppen und Datenbanken angelegt
443 werden. Dieses geschieht im Administrationsmenü, das Sie unter
444 folgender URL finden:
446 `http://localhost/lx-erp/admin.pl'
448 Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei
449 `config/authentication.pl' eingetragen haben.
454 Lx-Office verwendet eine Datenbank zum Speichern all seiner
455 Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um
456 mit Lx-Office arbeiten zu können, muss eine Person einen
457 Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine
458 Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist
459 möglich und normal, dass mehreren Benutzern die selbe Datenbank
460 zugewiesen wird, sodass sie alle mit den selben Daten arbeiten können.
462 Die Basisdaten der Benutzer, die in der Administration eingegeben
463 werden können, werden in einer zweiten Datenbank gespeichert, der
464 bereits erwähnten Authentifizierungsdatenbank. Diese ist also den
465 Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro
466 Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,
467 aber beliebig viele Datenbanken mit Firmendaten.
469 Lx-Office kann seinen Benutzern Zugriff auf bestimmte
470 Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht
471 gestattet, so werden der entsprechenden Menüpunkte auch nicht
472 angezeigt. Diese Rechte werden ebenfalls in der
473 Authentifizierungsdatenbank gespeichert.
475 Um Rechte verteilen zu können, verwendet Lx-Office ein
476 Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche
477 erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder
478 mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen
479 Funktionen, die mindestens einer Gruppe erlaubt sind, in der der
480 Benutzer Mitglied ist.
482 Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer
483 angelegt werden sollten, lautet:
491 4. Benutzer den Gruppen zuordnen
493 7.2 Datenbanken anlegen
494 =======================
496 Zuerst muss eine Datenbank angelegt werden. Verwenden Sie für den
497 Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen
498 ist dies `lxoffice').
500 Wenn Sie für die Lx-Office-Installation nicht den europäischen
501 Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so
502 müssen Sie vor dem Anlegen der Datenbank in der Datei
503 `config/lx-erp.conf' die Variable `$dbcharset' auf den Wert `UTF-8'
504 setzen. Zusätzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als
505 Schriftsatz ausgewählt werden.
507 Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz
508 verwenden müssen, da diese Einstellungen momentan global in Lx-Office
509 vorgenommen wird und nicht nach Datenbank unterschieden werden kann.
510 Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz
511 angelegt worden sein.
516 Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name
517 gegeben werden, eine Beschreibung ist hingegen optional. Nach dem
518 Anlegen können Sie die verschiedenen Bereiche wählen, auf die
519 Mitglieder dieser Gruppe Zugriff haben sollen.
521 Benutzergruppen sind unabhängig von Datenbanken, da sie in der
522 Authentifizierungsdatenbank gespeichert werden. Sie gelten für alle
523 Datenbanken, die in dieser Installation verwaltet werden.
528 Beim Anlegen von Benutzern werden für viele Parameter
529 Standardeinstellungen vorgenommen, die den Gepflogenheiten des
530 deutschen Raumes entsprechen.
532 Zwingend anzugeben sind der Loginname sowie die komplette
533 Datenbankkonfiguration. Wenn die Passwortauthentifizierung über die
534 Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort
535 gesetzt bzw. geändert werden. Ist hingegen die LDAP-Authentifizierung
536 aktiv, so ist das Passwort-Feld deaktiviert.
538 In der Datenbankkonfiguration müssen die Zugriffsdaten einer der eben
539 angelegten Datenbanken eingetragen werden.
541 7.5 Gruppenmitgliedschaften verwalten
542 =====================================
544 Nach dem Anlegen von Benutzern und Gruppen müssen Benutzer den Gruppen
545 zugewiesen werden. Dazu gibt es zwei Möglichkeiten:
547 1. In der Gruppenverwaltung wählt man eine Gruppe aus. Im folgenden
548 Dialog kann man dann einzeln die Benutzer der Gruppe hinzufügen.
550 2. In der Gruppenverwaltung wählt man das Tool zur Verwaltung der
551 Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im
552 System angelegten Gruppen und Benutzer enthält. Durch Setzen der
553 Häkchen wird der Benutzer in der ausgewählten Zeile der Gruppe in
554 der ausgewählten Spalte hinzugefügt.
556 7.6 Migration alter Installationen
557 ==================================
559 Wenn Lx-Office 2.6.2 über eine ältere Version installiert wird, in der
560 die Benutzerdaten noch im Dateisystem im Verzeichnis `users' verwaltet
561 wurden, so bietet Lx-Office die Möglichkeit, diese Benutzerdaten
562 automatisch in die Authentifizierungsdatenbank zu übernehmen. Dies
563 geschieht, wenn man sich nach dem Update der Installation das erste Mal
564 im Administrationsbereich anmeldet. Findet Lx-Office die Datei
565 `users/members', so wird der Migrationsprozess gestartet.
567 Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten
568 können übernommen werden. Nach den Benutzerdaten bietet Lx-Office noch
569 die Möglichkeit an, dass automatisch eine Benutzergruppe angelegt wird.
570 Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gewährt.
571 Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird
572 das Verhalten von Lx-Office bis Version 2.4.3 inklusive
573 wiederhergestellt, und die Benutzer können sich sofort wieder anmelden
574 und mit dem System arbeiten.
576 8 OpenDocument-Vorlagen
577 ***********************
579 Lx-Office unterstützt die Verwendung von Vorlagen im
580 OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
581 Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus
582 diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
583 OpenDocument-Vorlagen zu aktivieren muss in der Datei
584 `config/lx-erp.conf' die Variable `$opendocument_templates' auf `1'
585 stehen. Dieses ist die Standardeinstellung.
587 Weiterhin muss in der Datei `config/lx-erp.conf' die Variable
588 `$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der
589 Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den
590 meisten Fällen "UTF-8".
592 Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
593 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
594 OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
595 neben OpenOffice.org ab Version 2 auch der "X virtual frame buffer"
596 (xvfb) installiert werden. Bei Debian ist er im Paket "xvfb"
597 enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
599 Nach der Installation müssen in der Datei `config/lx-erp.conf' zwei
600 weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss
601 den vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
602 `$xvfb_bin' muss den Pfad zum "X virtual frame buffer" enthalten.
604 Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
605 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
606 Variable `$openofficeorg_daemon' gesetzt ist, startet ein OpenOffice,
607 das auch nach der Umwandlung des Dokumentes gestartet bleibt. Bei
608 weiteren Umwandlungen wird dann diese laufende Instanz benutzt. Der
609 Vorteil ist, dass die Zeit zur Umwandlung deutlich reduziert wird, weil
610 nicht für jedes Dokument ein OpenOffice gestartet werden muss. Der
611 Nachteil ist, dass diese Methode Python und die Python-UNO-Bindings
612 benötigt, die Bestandteil von OpenOffice 2 sind.
614 Ist `$openofficeorg_daemon' nicht gesetzt, so wird für jedes
615 Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe eines
616 Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage
617 enthalten sein und "Standard.Conversion.ConvertSelfToPDF()" heißen. Die
618 Beispielvorlage `templates/German-invoice.odt' enthält ein solches
619 Makro, das in jeder anderen Dokumentenvorlage ebenfalls enthalten sein
622 Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
623 Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter Debian
624 ist dies momentan `~/.openoffice.org2'. Sollte der Name bei Ihrer
625 OpenOffice.org-Installation anders sein, so muss das Verzeichnis
626 `users/.openoffice.org2' entsprechend umbenannt werden. Ist der Name
627 z.B. einfach nur `.openoffice', so wäre folgender Befehl auszuführen:
629 `mv users/.openoffice.org2 users/.openoffice'
631 Dieses Verzeichnis, wie auch das komplette `users'-Verzeichnis, muss
632 vom Webserver beschreibbar sein. Dieses wurde in Schritt `Installation
633 des Programmpakets' oben bereits erledigt, kann aber erneut überprüft
634 werden, wenn die Konvertierung nach PDF fehlschlägt.
636 9 Lx-Office ERP verwenden
637 *************************
639 Nach erfolgreicher Installation ist der Loginbildschirm unter folgender
642 `http://localhost/lx-office-erp/login.pl'
644 Die Administrationsseite erreichen Sie unter:
646 `http://localhost/lx-office-erp/admin.pl'