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