Fremdschlüssel für Bearbeiter in gl einführen
[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
8 Upgrade auf v3.x.0
9 ==================
10
11 * Neue Softwarevoraussetzungen: Perl v5.10.1 oder neuer sowie
12   PostgreSQL 8.4 oder neuer werden zwingend vorausgesetzt. Ein Betrieb
13   mit älteren Versionen ist nicht mehr möglich.
14
15 * Neue Perl-Modul-Abhängigkeiten:
16
17   * File::Copy::Recursive
18   * Rose::DB::Object muss v0.788 oder neuer sein (aufgrund eines Bugs
19     in besagtem Modul im Zusammenspiel mit PostgreSQL)
20
21   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
22
23   $ scripts/installation_check.pl -ro
24
25 * Die Datenbank muss zwingend Unicode als Encoding nutzen. Daher wird
26   auch die Konfigurationsvariable "system.dbcharset" nicht mehr
27   unterstützt.
28
29 * Einführung von Mandanten. Früher war die Konfiguration der
30   Datenbanken für jeden Benutzer getrennt vorzunehmen. Mit diesem
31   Release wurden Mandanten eingeführt: ein Mandant bekommt einen Namen
32   sowie die Datenbankkonfiguration, und Benutzer bekommen
33   Zugriffsrechte auf einen oder mehrere Mandanten.
34
35   Um dieses Update durchzuführen, müssen Sie sich einmal im
36   Administrationsbereich anmelden. Vorher ist kein Login im
37   Benutzerbereich möglich.
38
39   Die neue Struktur bedingt, dass viele Scripte, die bisher zur
40   Konfiguration nur einen Benutzer verlangt haben, jetzt auch einen
41   Mandanten verlangen. Die Konfiguration dieser Scripte ist deshalb
42   manuell anzupassen. Dazu gehören:
43
44   - der Task-Server (config/kivitendo.conf)
45   - CSV-Import von der Shell aus (scripts/csv-import-from-shell.sh)
46
47   Die folgenden Scripte sind ebenfalls betroffen, allerdings nur für
48   Entwickler interessant:
49
50   - scripts/dbupgrade2_tool.pl
51   - scripts/rose_auto_create_model.pl
52
53
54 Upgrade auf v3.0.0
55 ==================
56
57 * Neue Abhängigkeiten
58
59   * Clone 1.16
60   * Email::MIME
61   * FCGI jetzt min Version 0.72
62   * Test::Harness 3.00
63   * IO::Socket::SSL
64   * Net::LDAP
65   * Net::SMTP::SSL
66   * Net::SSLGlue
67
68   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
69
70   $ scripts/installation_check.pl -ro
71
72 * Neue Entwicklerabhängigkeiten
73
74   * Test::Deep
75   * GD 2.00
76
77 * Diverse umstrittene Features zum nicht standardkonformen Umgang mit gebuchten
78   Rechnungen sind jetzt standardmässig deaktiviert und müssen unter "System"
79   -> "Mandantenkonfiguration" aktiviert werden.
80
81 * Die Übersetzungen "de_DE" und "fr" für die alternative deutsche Version und
82   französische Version respektive wurden entfernt. Es bleiben offiziell
83   unterstützte Übersetzungen in Deutsch ("de") und English ("en").
84
85 * Dieses ist die letzte Version, die Perl-Versionen vor 5.10.1
86   unterstützen wird.  Ab dem nächsten Release werden Sprachkonstrukte
87   verwendet werden, die nicht mehr in 5.8 kompilieren, und Module, die
88   seit v5.10.1 zu den Coremodulen gehören, werden ab dann nicht mehr
89   als explizite Abhängigkeiten gelistet.
90
91
92 Upgrade auf v2.7.0
93 ==================
94
95 * In der Version 2.7.0 wird das XUL Menü entfernt. Alle Benutzer die das XUL
96   Menü noch eingestellt haben, werden beim ersten Einloggen auf ein
97   Kompatibilitätsmenü gesetzt. Das Javascriptmenü wurde entsprechend erweitert
98   um der Funktionalität nahe zu kommen.
99
100 * Das Lizenzenfeature wurde ersatzlos entfernt.
101
102 * In den LaTeX Vorlagen gilt der Befehl "pagebreak" und die dazugehörigen
103   "sumcarriedforward" und "lastpage" als deprecated und werden in einer
104   kommenden Version komplett entfernt. Die Mechanik ist anfällig gegenüber
105   subtilen Formatierungsfehlern bei bestimmten Zahlenformaten und ist
106   grundsätzlich fehlerhaft in den gemachten Annahmen über den verfügbaren Platz
107   auf einer Seite. Die Standardvorlagen sind entsprechend angepasst worden
108   und müssen in der Administration neu angelegt werden.
109
110 * Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
111   Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
112   benennen Sie ihn um bevor Sie das Update starten.
113
114 * Die Druckvorlagen für USTVA vor 2012 wurden entfernt und das Ausdrucken von
115   USTVA als PDF ist deprecated. Da die Eingabe von Erklärungen als PDF nicht
116   mehr gestattet ist, sollten Archivkopien der USTVA direkt bei Elster bezogen
117   werden, oder auf anderem Wege erstellt werden. Der Prozess dazu wird sich in
118   einer kommenden Version ändern.
119
120 * Die Namen der von LaTeX generierten PDF-Dateien sind jetzt in der
121   eingestellten Dokumentensprache, nicht mehr in der Oberflächensprache des
122   Bearbeiters.
123
124 * Neue Abhängigkeiten
125
126   * JSON
127   * String::ShellQuote
128   * Digest::SHA (optional, empfohlen)
129
130   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
131
132   $ scripts/installation_check.pl -ro
133
134 * CSV-Import wurde neu in Perl implementiert
135
136   Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
137   lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
138   funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
139   benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
140   nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
141
142 * Rechteverwaltung
143
144   * Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei
145     einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.
146   * Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist
147     notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade
148     automatisch allen Benutzern erteilt.
149   * Das Recht "Administration" wurde neu eingeführt, und ist dazu da
150     administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin
151     heraus durchzuführen. Es ist standardmäßig NICHT vergeben.
152   * Der Vorlageneditor wurde unter das Recht Administration gestellt, war
153     vorher Konfiguration.
154
155
156 Upgrade auf v2.6.3
157 ==================
158
159 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
160 authentication.pl und lx-erp.conf, sowie deren Varianten,
161 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
162 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
163 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
164 konfigurieren, dies ist automatisiert zu fehleranfällig.
165
166 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
167 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
168
169 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
170 man lx_office.conf nicht einchecken.
171
172 Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
173 "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
174
175 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
176 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
177 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
178 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
179 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
180 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
181 bekommen. Die Einrichtung des Dämonen wird in der
182 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
183
184 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
185 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
186 den folgenden Befehl im Lx-Office Verzeichnis aus:
187
188 $ scripts/installation_check.pl
189
190 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
191 der Installationsanweisung.
192
193 Zumindest folgende Module sind neu benötigt:
194
195 * Config::Std
196 * Params::Validate
197
198 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
199 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
200 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
201 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
202 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
203 hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
204 FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
205
206
207 Upgrade auf v2.6.2
208 ==================
209
210  Vor dem Einloggen
211  -----------------
212
213 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
214 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
215 Lx-Office Verzeichnis aus:
216
217 $ scripts/installation_check.pl
218
219 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
220 der Installationsanweisung.
221
222 Zumindest folgende Module sind neu benötigt:
223
224 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
225   Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
226   Distribution sollte für die automatische Installation der anderen
227   zwei Pakete sorgen)
228
229  Neue Gruppenrechte
230  ------------------
231
232 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
233 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
234 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
235
236 Für bereits bestehende Gruppen muss es sofern gewünscht vom
237 Administrator manuell gewährt werden.
238
239
240 Upgrade auf v2.6.1
241 ==================
242
243  Vor dem Einloggen
244  -----------------
245
246 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
247 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
248 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
249 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
250 geändert.
251
252 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
253 Lx-Office Verzeichnis aus:
254
255 $ scripts/installation_check.pl
256
257 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
258 der Installationsanweisung.
259
260 Zumindest folgende Module sind neu benötigt:
261
262 * URI
263 * XML::Writer
264
265  Neue Konfigurationsvariablen
266  ----------------------------
267
268 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
269 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
270 standardmäßig deaktiviert.