Versionen im Vergleich

Alte Version 39

changes.mady.by.user Ramin Göttlich

Gespeichert am

verglichen mit

Neue Version 40

changes.mady.by.user Ramin Göttlich

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Hinweis

Migration der Datenbank

Die Aktualisierung einer vorhandenen Nuclos 3 Instanz auf Nuclos 4 führt eine Reihe automatischer Migrationsschritte durch, die unter Umständen manuelle Nacharbeiten erfordern. Das Vorgehen bei der Aktualisierung und die erforderlichen Nacharbeiten werden in den folgenden Abschnitten beschrieben. Bitte berücksichtigen Sie, dass die Nacharbeiten einige Zeit in Anspruch nehmen können. Die Durchführung einer vorherigen Datensicherung sowohl der Nuclos Datenbank als auch des Nuclos Homeverzeichnisses <NUCLOS-HOME> ist zur leichten Wiederherstellung einer funktionsfähigen Installation im Fehlerfalls unabdingbar.

Voraussetzungen für eine Aktualisierung auf Nuclos 4

Folgende Voraussetzung müssen erfüllt sein, bevor eine Aktualisierung durchgeführt werden kann.

  • Jedes Nuclet in Ihrer Instanz muss über einen eindeutigen Namen und ein eindeutiges Package verfügen (siehe MIG-06).
  • Es dürfen keine alten Regeln mehr in Ihrer Instanz existieren, alle Regeln müssen auf die Nuclos API umgestellt sein (siehe Alte Regeln in Nuclos 4.0).
  • Ihre Instanz von Nuclos muss bereits mindestens auf Nuclos 3.12.0 aktualisiert sein, jede Maske muss darin mindestens einmal geöffnet worden sein. Haben Sie Benutzergruppen Arbeitsumgebungen zugewiesen, müssen Sie diese Arbeitsumgebungen mindestens einmal publizieren. Nutzen Sie bereits die seit Nuclos 3.15.0 existierende Matrixkomponente, muss Ihre Instanz von Nuclos bereits mindestens auf Nuclos 3.15.6 aktualisiert sein (siehe MIG-03).

Durchführung der Aktualisierung auf Nuclos 4

Folgende Schritte sind zur Durchführung einer Aktualisierung auf Nuclos 4 vorzunehmen.

  1. Führen Sie, wie ggf. aus früheren Aktualisierungen gewohnt, den Installer aus.
  2. Starten Sie den Nuclos Server, dabei wird die automatische Migration automatisch gestartet. Die Migration protokolliert die Durchführung sämtlicher Schritte in der Datei <NUCLOS-HOME>/logs/migration_04_00_0022_main.log. Die Fertigstellung der Migration erkennen Sie daran, dass die Datei <NUCLOS-HOME>/logs/migration_04_00_0022_finish.log generiert wurde.
  3. Überprüfen Sie die Datei <NUCLOS-HOME>/logs/migration_04_00_0022_main.log, sobald die Migration fertggestellt ist. Diese Datei gibt Aufschluss über ggf. aufgetretene Migrationsfehler und führt insbesondere erkannten manuellen Nacharbeitungsbedarf auf und liefert Ihnen somit wichtige Hinweise über nun noch durchzuführende Nacharbeiten.
  4. Führen Sie die erforderlichen manuellen Nacharbeiten durch, siehe folgende Punkte MIG-01 bis MIG-09.
Info
titleZusammenfassung manuelle Nacharbeiten

Zur erleichterten Übersicht und Einschätzung des Migrationsaufwandes für Ihre Nuclos 3 Instanz folgt eine kurze Auflistung des "typischen" Nacharbeitungsbedarfes. Diese verschafft Ihnen einen Überblick und deckt die in den meisten Fällen erforderlichen Nacharbeiten ab. Bitte lesen Sie in jedem Fall die folgenden Migrationshinweise MIG-01 bis MIG-09 aufmerksam durch.

  1. Sämtliche Datenquellen (Menü Konfiguration | Datenquellen) und Datenbankobjektquelltexte (Menü Konfiguration | Datenbank) müssen überprüft und ggf. angepasst werden. In den meisten Fällen sind keine Anpassung erforderlich, dies kann allerdings dann der Fall sein, wenn z.B. Benutzer, Status oder Aktionen hinzugejoined werden, da diese ab Nuclos 4 eine UID erhalten, d.h. die Spalte INTID ist in T_MD_USER, T_MD_STATE und T_MD_PROCESS durch STRUID ersetzt. Entsprechende Join-Bedingungen müssen angepasst werden. Es kann weitere Einzelfälle geben, in denen Anpassungen zur Wiederherstellung der Funktionsfähigkeit einer Datenquelle erforderlich sind.
Hinweis
titleMIG-01 Einführung eines neuen Primärschlüssel Types UID

System Änderungen

  • System Businessobjekte (Tabellen) werden teilweise auf den neuen Primärschlüssel Typ UID migriert.

Nacharbeiten

  • Datenquellen und Datenbankobjekte müssen ggf. angepasst werden (z.B. verwendete Referenzfelder auf Systembusinessobjekte von Nuclos, z.B. intid_t_md_user wird zu struid_t_md_user, intid_nuclosstate wird zu struid_nuclosstate)

...