Merge branch 'master' of 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 * In der Version 2.7.0 wird das XUL Menü entfernt. Alle Benutzer die das XUL
11   Menü noch eingestellt haben, werden beim ersten Einloggen auf ein anderes
12   Menü gesetzt.
13
14 * Das Lizenzenfeature wurde ersatzlos entfernt.
15
16 * In den LaTeX Vorlagen wird der Befehl "pagebreak" und die dazugehörigen
17   "sumcarriedforward" und "lastpage" nicht mehr offiziell unterstuetzt. Diese
18   Methoden gelten als "deprecated" und werden in der naechsten Version gaenzlich
19   entfernt. Sie sollten bereitss jetzt nicht mehr verwendet werden da sie mehrere
20   Fehler beinhalten. Die Standardvorlagen sind entsprechend angepasst worden
21   und müssen in der Administration neu angelegt werden.
22
23 * Das Druckvorlagensystem wurde umgestellt, dadurch ist der Name "print" für
24   Druckvorlagen jetzt reserviert. Wenn eine Ihrer Vorlagensätze "print" heisst,
25   benennen Sie ihn um bevor Sie das Update starten.
26
27 * Neue Abhängigkeiten
28
29   * JSON
30   * String::ShellQuote
31   * Digest::SHA (optional, empfohlen)
32
33   Wie immer bitte vor dem ersten Aufrufen einmal die Pakete überprüfen:
34
35   $ scripts/installation_check.pl -ro
36
37 * CSV-Import wurde neu in Perl implementiert
38
39   Der PHP-Code wurde entfernt. Automatische Skripte, die per Aufruf von
40   lxo-import/partsB.php?cron=1 die Datei parts.csv importiert haben,
41   funktionieren nicht mehr.  Stattdessen kann scripts/csv-import-from-shell.sh
42   benutzt werden. Im Unterschied zur PHP-Version werden unbekannte Warengruppen
43   nicht mehr automatisch angelegt, stattdessen bricht das Skript ab.
44
45 * Rechteverwaltung
46
47   * Das Recht "Kunden und Lieferanten bearbeiten" wurde aufgespalten in zwei
48     einzelne Rechte. Ein Updatescript passt bestehende Gruppenaentsprechend an.
49   * Das Recht "Preise nd Rabatte bearbeiten" wurde neu eingeführt und ist
50     notwendig um in Belegen Preise ändern zu können. Es wird beim Upgrade
51     automatisch allen Benutzern erteilt.
52   * Das Recht "Administration" wurde neu eingeführt, und ist dazu da
53     administrative Tätigkeiten an der Mandantendatenbank aus einm Benutzerlogin
54     heraus durchzuführen. Es ist standardmäßig NICHT vergeben.
55   * Der Vorlageneditor wurde unter das Recht Administration gestellt, warvorher
56     Konfiguration.
57
58
59 Upgrade auf v2.6.3
60 ==================
61
62 1. Mit Version 2.6.3. wurden die beiden Konfigurationsdateien
63 authentication.pl und lx-erp.conf, sowie deren Varianten,
64 abgeschafft. Stattdessen gibt es nun die Datei lx_office.conf, die
65 aber erst neu angelegt werden muß. Als Vorlage dient hierfür die Datei
66 lx_office.conf.default. Die entsprechenden Werte muß man selber neu
67 konfigurieren, dies ist automatisiert zu fehleranfällig.
68
69 Nach dem Upgrade kann man sich so lange nicht anmelden, bis lx_office.conf
70 angelegt und authentication.pl und lx-erp.conf gelöscht oder verschoben wurden.
71
72 Es gibt keine local-Variante der lx_office.conf, arbeitet man mit git sollte
73 man lx_office.conf nicht einchecken.
74
75 Eine etwas ausführlichere Beschreibung findet sich in Kapitel 2.3
76 "Lx-Office-Konfigurationsdatei" in doc/Lx-Office-Dokumentation.pdf
77
78 2. Eine neu hinzugekommene Komponente ist der Task-Server. Hierbei
79 handelt es sich um einen Dämonen, der im Hintergrund läuft, in
80 regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese
81 zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser
82 Dämon wird bisher nur für die Erzeugung der wiederkehrenden Rechnungen
83 benutzt, wird aber in Zukunft deutlich mehr Aufgaben übertragen
84 bekommen. Die Einrichtung des Dämonen wird in der
85 Installationsdokumentation im Abschnitt "Der Task-Server" beschrieben.
86
87 3. Mit Version 2.6.3 sind einige Abhängigkeiten von Perl-Modulen
88 hinzugekommen. Bitte führen sie vor dem ersten Aufrufen der einmal
89 den folgenden Befehl im Lx-Office Verzeichnis aus:
90
91 $ scripts/installation_check.pl
92
93 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
94 der Installationsanweisung.
95
96 Zumindest folgende Module sind neu benötigt:
97
98 * Config::Std
99 * Params::Validate
100
101 4. Sollten Sie die FCGI-Version einsetzen, das Apache-Modul
102 "mod_fcgid" (nicht "mod_fastcgi") benutzen und von diesem Modul die
103 Version v2.6.3 oder später installiert haben, so ist außerdem wichtig,
104 seinen Parameter "FcgidMaxRequestLen" deutlich zu erhöhen, weil sich
105 dieser im Release mod_fcgid-Release v2.6.3 deutlich geändert
106 hat. Details dazu finden sich in Kapitel 2.5.2 "Konfiguration für
107 FastCGI/FCGI" in doc/Lx-Office-Dokumentation.pdf
108
109
110 Upgrade auf v2.6.2
111 ==================
112
113  Vor dem Einloggen
114  -----------------
115
116 Mit Version 2.6.2 sind einige Abhängigkeiten von Perl-Modulen hinzugekommen.
117 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
118 Lx-Office Verzeichnis aus:
119
120 $ scripts/installation_check.pl
121
122 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
123 der Installationsanweisung.
124
125 Zumindest folgende Module sind neu benötigt:
126
127 * Rose::Object, Rose::DB und Rose::DB::Object (die Installation von
128   Rose::DB::Object via CPAN oder den Paketmechanismus Ihrer
129   Distribution sollte für die automatische Installation der anderen
130   zwei Pakete sorgen)
131
132  Neue Gruppenrechte
133  ------------------
134
135 Es wurde ein neues Recht "Druck" eingeführt. Dieses bestimmt, ob die
136 Benutzerin das Menü "Druck" zu Gesicht bekommt oder nicht, unabhängig
137 davon, wie die Rechte für die einzelnen Unterpunkte gesetzt sind.
138
139 Für bereits bestehende Gruppen muss es sofern gewünscht vom
140 Administrator manuell gewährt werden.
141
142
143 Upgrade auf v2.6.1
144 ==================
145
146  Vor dem Einloggen
147  -----------------
148
149 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
150 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
151 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
152 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
153 geändert.
154
155 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
156 Lx-Office Verzeichnis aus:
157
158 $ scripts/installation_check.pl
159
160 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
161 der Installationsanweisung.
162
163 Zumindest folgende Module sind neu benötigt:
164
165 * URI
166 * XML::Writer
167
168  Neue Konfigurationsvariablen
169  ----------------------------
170
171 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
172 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
173 standardmäßig deaktiviert.