Merge branch 'master' of ssh://git-mbunkus@lx-office.linet-services.de/~/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.6.1
8 ==================
9
10  Vor dem Einloggen
11  -----------------
12
13 Mit Version 2.6.1 wurden die Listen der benötigten Perl Module überarbeitet.
14 Einige der vorher in den Abhängigkeiten gelisteten Module waren Coremodules
15 (und damit in jeder Perldistribution vorhanden), oder ihrerseits Abhängigkeiten
16 anderer benötigter Module. Durch die Überarbeitung hat sich die Liste deutlich
17 geändert.
18
19 Bitte führen sie vor dem ersten Aufrufen der einmal den folgenden Befehl im
20 Lx-Office Verzeichnis aus:
21
22 $ scripts/installation_check.pl
23
24 Sollten Module als fehlend markiert sein, folgen Sie bitte den Anweisungen in
25 der Installationsanweisung.
26
27 Zumindest folgende Module sind neu benötigt:
28
29 * URI
30 * XML::Writer
31
32  Neue Konfigurationsvariablen
33  ----------------------------
34
35 In der config/lx-erp.conf ist als neue Option $show_best_before hinzugekommen.
36 Die Variable kontrolliert die Anzeige von Mindesthaltbarkeitsdaten. Sie ist
37 standardmäßig deaktiviert.
38
39
40 Upgrade auf v2.6.0
41 ==================
42
43 Mit Version 2.6.0 wurde der Code zur Benutzerauthentifizierung neu
44 geschrieben. Die Umstellung erfordert eine manuelle
45 Konfiguration. Bestehende Benutzeraccounts können aber von Lx-Office
46 automatisch übernommen werden.
47
48  Bevor Sie sich das erste mal einloggen
49  --------------------------------------
50
51 Kopieren Sie bitte die Datei "lx-erp.conf" und
52 ggfs. "lx-erp-local.conf" in das neue Unterverzeichnis "config/". Die
53 alte Datei im Lx-Office-Stammverzeichnis kann daraufhin gelöscht
54 werdern.
55
56 Als nächstes muss die neue datenbankgestützte Benutzerverwaltung
57 konfiguriert werden. Die dafür notwendigen Einstellungen werden in der
58 Datei "config/authentification.pl" vorgenommen, für die eine
59 kommentierte Vorlage in "config/authentication.pl.default"
60 bereitliegt.
61
62 Weitere Informationen zu dieser Datei finden Sie in der Dokumentation
63 "doc/INSTALL/index.html" und dort in den Kapiteln
64 "Benutzerauthentifizierung und Administratorpasswort" sowie "Benutzer-
65 und Gruppenverwaltung".
66
67 Nach der Einrichtung der Datei "config/authentication.pl" muss im
68 Webbrowser das Administrationsinterface aufgerufen werden. Nach
69 erfolgter Anmeldung werden Sie durch den Upgradeprozess geleitet.
70
71 Die weiteren erforderlichen Datenbankupgrades werden erst vorgenommen,
72 wenn sich ein Benutzer erfolgreich anmeldet.
73
74  Neue Perl-Module
75  ----------------
76
77 Mit Version 2.6.0 werden zusätzlich die folgenden Perl-Module benötigt,
78 die bis Version 2.4.3 inklusive noch keine Voraussetzung waren:
79
80 * PDF::API2
81
82
83 Upgrade von v2.4.0 und neuer auf v2.4.3
84 =======================================
85
86 Ein Upgrade von v2.4.0 oder neuer auf v2.4.3 aus zwei Teilen: den
87 Dateien (einfaches Entpacken und Kopieren in das
88 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
89
90  Neue Variablen in der Datei lx-erp.conf
91  ---------------------------------------
92
93 Wenn Sie eine eigene Version der Konfigurationsdatei "lx-erp.conf"
94 einsetzen und diese nicht mit der Standardkonfigurationsdatei
95 überschreiben, so beachten Sie bitte, dass die folgenden neuen
96 Variablen hinzugekommen sind und von Ihnen manuell ergänzt werden
97 sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und
98 $pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt
99 werden, da sie nicht mehr benötigt wird.
100
101 Die Standardwerte für diese Variablen finden Sie in der Datei
102 "lx-erp.conf.default".
103
104  Neue Abhängigkeiten von Perl-Modulen
105  ------------------------------------
106
107 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
108 der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module
109 neu hinzugekommen:
110
111 - Achive::Zip
112 - IO::Wrap (aus dem Paket "IO::Stringy")
113 - Template
114 - Text::CSV_XS
115 - Text::Iconv
116 - Time::HiRes
117 - YAML
118
119 Nach Möglichkeit sollten auch die aktuellen Versionen der
120 Datenbankpakete "DBI" und "DBD::Pg" installiert werden.
121
122  Datenbankupgrade
123  ----------------
124
125 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
126 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
127
128 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
129
130
131 Upgrade von v2.4.0 auf 2.4.1 sowie von 2.4.1 auf 2.4.2
132 ======================================================
133
134 Ein Upgrade von v2.4.0 auf v2.4.1 oder von v2.4.1 auf v2.4.2 besteht
135 aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das
136 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
137
138 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
139 der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss
140 sichergestellt werden, dass das Modul "YAML" installiert ist.
141
142 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
143 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
144
145 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
146
147 Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades
148 auf 2.4.1 und 2.4.2 nur um automatisch ablaufende Scripte, die keine
149 Benutzereingaben erfordern.
150
151
152 Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0
153 ======================================
154
155 Ein direktes Upgrade von den unmodifizierten Versionen 2.2.0, 2.2.1
156 und 2.2.2 auf 2.4.0 ist möglich. Ein solches Upgrade besteht aus zwei
157 Teilen: den Dateien (einfaches Entpacken und Kopieren in das
158 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
159
160 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
161 der Datei "doc/INSTALL".
162
163 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
164 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
165
166 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
167
168 Das Datenbankupgrade enthält zwei interaktive Upgradepfade für neue
169 Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.
170
171
172
173 Einführung von Einheiten
174 ------------------------
175
176 In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
177 Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
178 Texte als "Einheit" angeben. Lx-Office 2.4.0 ändert dies nun. Der
179 Administrator kann unter "System -> Einheiten -> Maßeinheiten" die bei
180 Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
181 Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
182 Einheiten festlegen. Lx-Office 2.4.0 bringt bereits für beide Typen
183 einige Standardeinheiten mit.
184
185 Einheiten können wiederum auf anderen Einheiten basieren. So ist
186 z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
187 muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
188 einer Drop-Down-Liste auswählen. In den Einkaufs- und Verkaufsmasken
189 werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
190 angeboten, die sich in die in den Stammdaten hinterlegte Einheit
191 umrechnen lassen. So würden z.B. für eine Ware, deren
192 Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
193 Auswahl aufgelistet, nicht aber "Stück" oder "Tag", "Stunde".
194
195 Das Datenbankupgrade muss nun alle im System verwendeten Einheiten in
196 den Stammdaten sowie in den Einkaufs- und Verkaufsdaten so anpassen,
197 dass dort nur noch Einheiten auftreten, die im System verwendet werden
198 können. Da dies nur eingeschränkt automatisch möglich ist, werden dem
199 Benutzer, der das Datenbankupgrade nach dem Login durchführt, einige
200 Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
201 kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
202 lassen kann.
203
204 Zuletzt muss er noch für all die Waren, für die früher gar keine
205 Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
206 Erzeugnissen und Dienstleistungen festlegen, die statt dessen
207 eingesetzt wird.
208
209
210 Einführung von Steuerzonen und Buchungsgruppen
211 ----------------------------------------------
212
213 In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
214 Dienstleistungen jeweils ein Konto für Erlöse und ein Konto für den
215 Aufwand hinterlegt. Über diese Konten wurde dann auch definiert
216 welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
217 und mal ohne Steuer verkaufen (Inland, Ausland), waren hierfür zwei
218 Artikel notwendig.
219
220 In der Version 2.4.0 können nun bei jedem Artikel für die
221 verschiedenen Fälle
222 - Inland
223 - EU mit UStId
224 - EU ohne UStId
225 - Außerhalb EU
226 verschiedene Erlös- und Aufwandskonten definiert werden. Dadurch
227 werden dann auch jeweils die richtigen Steuersätze berechnet.
228
229 Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
230 müssen, werden alle Konten, die zu einer bestimmten Warengruppe
231 gehören, in einer Buchungsgruppe zusammengefasst. Diese
232 Buchungsgruppen werden zunächst unter "System" definiert und können
233 dann den Artikeln und Dienstleistungen zugewiesen werden.
234
235 Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
236 Erlös- und Aufwandskonten geholt, die bereits verwendet wurden. Für
237 diese Kombinationen müssen im Upgradeprozess Buchungsgruppen angelegt
238 werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
239 Konten für nicht Inland sind mit den Standardkonten vorbelegt, können
240 aber vor dem Speichern geändert werden.
241
242 Diese neu angelegten Buchungsgruppen werden automatisch den
243 vorhandenen Artikeln und Dienstleistungen zugewiesen.  Buchungsgruppen
244 können genau wie vorher die Kontenzuordnung nachträglich nicht mehr
245 geändert werden.
246
247 Möchte man in der Buchhaltung eine neue Kombination von Erlös- und
248 Aufwandskonten für bestimmte Artikel und Waren verwenden, legt man
249 zunächst die entsprechenden konnten (z.B. 8401 und 3401) an und
250 erstellt dann eine neue Buchungsgruppe mit diesen Konten.  Die
251 Benennung der Buchungsgruppe kann frei erfolgen.
252
253 Beim Anlegen einer neuen Waren oder Dienstleistung werden dann durch
254 Auswahl dieser Buchungsgruppe automatisch alle Konten auf einen Schlag
255 korrekt zugeordnet.
256
257 Wird in einer Verkaufs- oder Einkaufsmaske eine andere Steuerzone als
258 Inland ausgewählt, werden bei den Artikeln auch automatisch die
259 anderen Erlös- und Aufwandskonten der Buchungsgruppe verwendet.
260
261 Dokumentenvorlagen, Umbennante Vorlagenvariablen
262 ------------------------------------------------
263
264 Einige Variablen, die in Dokumentenvorlagen verwendet werden, mussten
265 aufgrund von Namenskonflikten umbenannt werden. Dazu gehören:
266
267 * Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
268   Variablen "company", "address" und "businessnumber" haben alle einen
269   Präfix "employee_" bekommen und heißen nun "employee_company",
270   "employee_address" und "employee_businessnumber".
271
272 Zu beachten ist außerdem, dass der Befehl <%include ...%> in
273 Dokumentenvorlagen nicht mehr zur Verfügung steht.