1 Wichtige Hinweise zum Upgrade von älteren Versionen
2 ===================================================
5 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
10 * Der in der Dokumentation beschriebene Mechanismus für die CGI-Anbindung
11 (2.6.1 Grundkonfiguration mittels CGI) wurde geändert. Ein einfacher Alias
12 auf das Programmverzeichnis funktioniert nicht mehr, und es muss immer ein
13 AliasMatch auf einen dispatcher eingerichtet werden. Die Dokumentation wurde
14 aktualisiert. Für Benutzer der empfohlenen FastCGI Anbindung ändert sich
20 * Bei Upgrade von Versionen vor v.3.2.x wie immer erst die dortigen
21 Upgradehinweise beachten.
23 * Es gibt keine neuen Perl-Modul-Abhängigkeiten.
25 * Die alte ungepflegte Druckvorlagenvariante "Standard" wurde entfernt.
26 Bereits verwendete Druckvorlagen, die darauf aufbauen, funktionieren
29 * Für die Verwendung des MT940 Import Features der Bankerweiterung muß
30 aqbanking installiert werden. Dies wird nur für die Konvertierung vom MT940
31 ins CSV Format benötigt, das Kommandozeilentool "aqbanking-cli" befindet sich
32 z.B. unter Ubuntu im Paket aqbanking-tools.
37 * Neue Perl-Modul-Abhängigkeiten:
43 Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
45 $ scripts/installation_check.pl -ro
47 Sofern das Upgrade von einer früheren Version als 3.1.0 geschieht auch die
48 Upgradehinweise der Vorversionen beachten.
50 * Druckvorlagen auf shipto-Verwendung prüfen
52 Hier hat sich das Standardverhalten geändert und ggf. werden shipto* nicht mehr
53 ausgedruckt, hier müssten die Druckvorlagen individuell angepasst werden, s.a.
54 Changelog -> Verkaufsbeleg-Ausdruck.
60 * BEVOR ein Aufruf im Administrationsbereich erfolgt, muss zwingend der
61 webdav Ordner im Installationspfad vorhanden sein!
63 - Rechte für webserver setzen ($ chmod www-data webdav/)
64 Dieses "Feature" war in vorhergehenden Versionen optional, wird aber
65 für das Upgrade auf Mandantenfähigkeit vorausgesetzt.
67 * Neue Softwarevoraussetzungen: Perl v5.10.1 oder neuer sowie
68 PostgreSQL 8.4 oder neuer werden zwingend vorausgesetzt. Ein Betrieb
69 mit älteren Versionen ist nicht mehr möglich.
71 * Neue Perl-Modul-Abhängigkeiten:
73 * File::Copy::Recursive
74 * Rose::DB::Object muss v0.788 oder neuer sein (aufgrund eines Bugs
75 in besagtem Modul im Zusammenspiel mit PostgreSQL)
77 Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
79 $ scripts/installation_check.pl -ro
81 * Die Datenbank muss zwingend Unicode als Encoding nutzen. Daher wird
82 auch die Konfigurationsvariable "system.dbcharset" nicht mehr
85 * Einführung von Mandanten. Früher war die Konfiguration der
86 Datenbanken für jeden Benutzer getrennt vorzunehmen. Mit diesem
87 Release wurden Mandanten eingeführt: ein Mandant bekommt einen Namen
88 sowie die Datenbankkonfiguration, und Benutzer bekommen
89 Zugriffsrechte auf einen oder mehrere Mandanten.
91 Um dieses Update durchzuführen, müssen Sie sich einmal im
92 Administrationsbereich anmelden. Vorher ist kein Login im
93 Benutzerbereich möglich.
95 Die neue Struktur bedingt, dass viele Scripte, die bisher zur
96 Konfiguration nur einen Benutzer verlangt haben, jetzt auch einen
97 Mandanten verlangen. Die Konfiguration dieser Scripte ist deshalb
98 manuell anzupassen. Dazu gehören:
100 - der Task-Server (config/kivitendo.conf)
101 - CSV-Import von der Shell aus (scripts/csv-import-from-shell.sh)
103 Die folgenden Scripte sind ebenfalls betroffen, allerdings nur für
104 Entwickler interessant:
106 - scripts/dbupgrade2_tool.pl
107 - scripts/rose_auto_create_model.pl
109 * Neue Benutzerrechte
111 Diese müssen bei vorhandenen Gruppen eventuell nachgepflegt werden. Z.B. bei
112 der Gruppe Vollzugriff
114 - Stammdaten -> Kunden und Lieferanten erfassen. Alle Lieferanten bearbeiten.
115 Alle Kunden bearbeiten
116 - Konfiguration -> Verändern der kivitendo-Installationseinstellungen (die
117 meisten Menüpunkte unterhalb von 'System')
119 * Die alten ungepflegten Druckvorlagenvarianten French und Service
122 * Die HTML-Druckvorlagen der Berichte (GuV, Bilanz, SuSa, BWA, UStVA) werden
123 jetzt alle zentral in den Webvorlagen verwaltet, es werden keine
124 benutzerangepasste Versionen der Druckvorlagen im Druckvorlagenverzeichnis
130 * Neue Abhängigkeiten
134 * FCGI jetzt min Version 0.72
141 Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
143 $ scripts/installation_check.pl -ro
145 * Neue Entwicklerabhängigkeiten
150 * Diverse umstrittene Features zum nicht standardkonformen Umgang mit gebuchten
151 Rechnungen sind jetzt standardmässig deaktiviert und müssen unter "System" ->
152 "Mandantenkonfiguration" aktiviert werden.
154 * Die Übersetzungen "de_DE" und "fr" für die alternative deutsche Version und
155 französische Version respektive wurden entfernt. Es bleiben offiziell
156 unterstützte Übersetzungen in Deutsch ("de") und English ("en").
158 * Dieses ist die letzte Version, die Perl-Versionen vor 5.10.1
159 unterstützen wird. Ab dem nächsten Release werden Sprachkonstrukte
160 verwendet werden, die nicht mehr in 5.8 kompilieren, und Module, die
161 seit v5.10.1 zu den Coremodulen gehören, werden ab dann nicht mehr
162 als explizite Abhängigkeiten gelistet.
168 * In der Version 2.7.0 wird das XUL Menü entfernt. Alle Benutzer die das XUL
169 Menü noch eingestellt haben, werden beim ersten Einloggen auf ein
170 Kompatibilitätsmenü gesetzt. Das Javascriptmenü wurde entsprechend erweitert
171 um der Funktionalität nahe zu kommen.
173 * Das Lizenzenfeature wurde ersatzlos entfernt.
175 * In den LaTeX Vorlagen gilt der Befehl "pagebreak" und die dazugehörigen
176 "sumcarriedforward" und "lastpage" als deprecated und werden in einer
177 kommenden Version komplett entfernt. Die Mechanik ist anfällig gegenüber
178 subtilen Formatierungsfehlern bei bestimmten Zahlenformaten und ist
179 grundsätzlich fehlerhaft in den gemachten Annahmen über den verfügbaren Platz
180 auf einer Seite. Die Standardvorlagen sind entsprechend angepasst worden
181 und müssen in der Administration neu angelegt werden.
183 * Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
184 Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
185 benennen Sie ihn um bevor Sie das Update starten.
187 * Die Druckvorlagen für USTVA vor 2012 wurden entfernt und das Ausdrucken von
188 USTVA als PDF ist deprecated. Da die Eingabe von Erklärungen als PDF nicht
189 mehr gestattet ist, sollten Archivkopien der USTVA direkt bei Elster bezogen
190 werden, oder auf anderem Wege erstellt werden. Der Prozess dazu wird sich in
191 einer kommenden Version ändern.
193 * Die Namen der von LaTeX generierten PDF-Dateien sind jetzt in der
194 eingestellten Dokumentensprache, nicht mehr in der Oberflächensprache des
197 * Neue Abhängigkeiten
201 * Digest::SHA (optional, empfohlen)
203 Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
205 $ scripts/installation_check.pl -ro
207 * CSV-Import wurde neu in Perl implementiert
209 Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
210 lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
211 funktionieren nicht mehr. Stattdessen kann scripts/csv-import-from-shell.sh
212 benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
213 nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
217 * Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei
218 einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.
219 * Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist
220 notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade
221 automatisch allen Benutzern erteilt.
222 * Das Recht "Administration" wurde neu eingeführt, und ist dazu da
223 administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin
224 heraus durchzuführen. Es ist standardmäßig NICHT vergeben.
225 * Der Vorlageneditor wurde unter das Recht Administration gestellt, war
226 vorher Konfiguration.
232 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
233 authentication.pl und lx-erp.conf, sowie deren Varianten,
234 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
235 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
236 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
237 konfigurieren, dies ist automatisiert zu fehleranfällig.
239 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
240 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
242 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
243 man lx_office.conf nicht einchecken.
245 Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
246 "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
248 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
249 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
250 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
251 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
252 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
253 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
254 bekommen. Die Einrichtung des Dämonen wird in der
255 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
257 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
258 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
259 den folgenden Befehl im Lx-Office Verzeichnis aus:
261 $ scripts/installation_check.pl
263 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
264 der Installationsanweisung.
266 Zumindest folgende Module sind neu benötigt:
271 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
272 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
273 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
274 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
275 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
276 hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
277 FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
286 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
287 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
288 Lx-Office Verzeichnis aus:
290 $ scripts/installation_check.pl
292 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
293 der Installationsanweisung.
295 Zumindest folgende Module sind neu benötigt:
297 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
298 Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
299 Distribution sollte für die automatische Installation der anderen
305 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
306 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
307 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
309 Für bereits bestehende Gruppen muss es sofern gewünscht vom
310 Administrator manuell gewährt werden.
319 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
320 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
321 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
322 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
325 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
326 Lx-Office Verzeichnis aus:
328 $ scripts/installation_check.pl
330 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
331 der Installationsanweisung.
333 Zumindest folgende Module sind neu benötigt:
338 Neue Konfigurationsvariablen
339 ----------------------------
341 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
342 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
343 standardmäßig deaktiviert.