Merge branch 'master' of git@vc.linet-services.de:public/lx-office-erp
[kivitendo-erp.git] / doc / UPGRADE
1 Wichtige Hinweise zum Upgrade von älteren Versionen
2 ===================================================
3
4
5 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
6
7 Upgrade auf v2.7.0
8 ==================
9
10 1. Templateumstellungen
11
12 Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
13 Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
14 benennen Sie ihn um bevor Sie das Update starten.
15
16 2. Neue Abhängigkeiten
17
18 Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
19
20 $ scripts/installation_check.pl
21
22 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
23 der Installationsanweisung.
24
25 Es sind zwei neue Abhängigkeiten dazugekommen.
26
27 * JSON
28 * String::ShellQuote
29
30 3. CSV-Import wurde neu in Perl implementiert
31
32 Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
33 lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
34 funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
35 benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
36 nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
37
38
39 Upgrade auf v2.6.3
40 ==================
41
42 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
43 authentication.pl und lx-erp.conf, sowie deren Varianten,
44 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
45 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
46 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
47 konfigurieren, dies ist automatisiert zu fehleranfällig.
48
49 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
50 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
51
52 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
53 man lx_office.conf nicht einchecken.
54
55 Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
56 "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
57
58 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
59 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
60 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
61 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
62 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
63 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
64 bekommen. Die Einrichtung des Dämonen wird in der
65 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
66
67 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
68 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
69 den folgenden Befehl im Lx-Office Verzeichnis aus:
70
71 $ scripts/installation_check.pl
72
73 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
74 der Installationsanweisung.
75
76 Zumindest folgende Module sind neu benötigt:
77
78 * Config::Std
79 * Params::Validate
80
81 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
82 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
83 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
84 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
85 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
86 hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
87 FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
88
89
90 Upgrade auf v2.6.2
91 ==================
92
93  Vor dem Einloggen
94  -----------------
95
96 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
97 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
98 Lx-Office Verzeichnis aus:
99
100 $ scripts/installation_check.pl
101
102 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
103 der Installationsanweisung.
104
105 Zumindest folgende Module sind neu benötigt:
106
107 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
108   Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
109   Distribution sollte für die automatische Installation der anderen
110   zwei Pakete sorgen)
111
112  Neue Gruppenrechte
113  ------------------
114
115 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
116 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
117 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
118
119 Für bereits bestehende Gruppen muss es sofern gewünscht vom
120 Administrator manuell gewährt werden.
121
122
123 Upgrade auf v2.6.1
124 ==================
125
126  Vor dem Einloggen
127  -----------------
128
129 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
130 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
131 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
132 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
133 geändert.
134
135 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
136 Lx-Office Verzeichnis aus:
137
138 $ scripts/installation_check.pl
139
140 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
141 der Installationsanweisung.
142
143 Zumindest folgende Module sind neu benötigt:
144
145 * URI
146 * XML::Writer
147
148  Neue Konfigurationsvariablen
149  ----------------------------
150
151 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
152 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
153 standardmäßig deaktiviert.