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.