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