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