Die Hinweise auf dieser Seite weisen auf besondere Veränderungen hin, die über die Release Notes hinaus einer gesonderten Erwähnung bedürfen. Dies ist insbesondere dann der Fall, wenn die Aktualisierung auf ein neues Release von Nuclos gewisse zusätzliche vorhergehende oder nachfolgende Massnahmen erfordert, die beachtet werden müssen, um keine unerwünschten Verhaltensänderungen oder Seiteneffekte, bedingt durch Neuerungen, zu verursachen.
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 eines Backups sowohl der Nuclos Datenbank als auch des Nuclos Homeverzeichnisses 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 existierende Matrixkomponente, muss Ihre Instanz von Nuclos bereits mindestens auf Nucloer 3.15.6 aktualisiert sein (siehe MIG-03).
Optional gibt es auch weitere Themen zur Vermeidung von Konfigurationsverlusten, die allerdings nicht eine Voraussetzung für eine erfolgreiche Migration sind. (z.B. MIG-03)
Bitte gehen Sie daher alle Punkte dieser Seite genau durch.
Nacharbeiten
Einige Punkte erfordern möglicherweise eine Nacharbeit. Um diese im Vorfeld für eine spätere Migration einer z.B. Produktionsumgebung vorzubeireiten empfiehlt sich folgendes Vorgehen.
MIG-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)
MIG-02 Entfall der automatisch erzeugten Views
System Änderungen
- Für Businessobjekte, Dynamische Businessobjekte und Diagramme werden nicht länger Views erzeugt.
Nacharbeiten
- Dynamische Businessobjekte und Diagramme müssen erneut gespeichert werden und im Anschluss neu in den Layouts und Baumansichten (Businessobjektwizard) eingepflegt werden.
- Wenn die Migration etwas nicht automatisch finden und ersetzten konnte muss bei den Datenquellen und Datenbankobjekten manuell nachgebessert werden. Diese sollten also auf Funktionsfähigkeit geprüft werden.
- Unterformular Listen Ansichten für Dynamische Businessobjekte müssen neu erstellt werden.
- Lese Berechtigungen auf Dynamische Businessobjekte im Statusmodell müssen erneut vergeben werden.
MIG-03 Entfall der alten Spaltenkofigurationen
System Änderungen
- Die Spalteneinstellungen in den Arbeitsumgebungen werden nur noch im neuen Listen Ansichten Format (ab Nuclos v3.12) unterstützt. Daten der vorherigen Spaltenkonfigurationen werden nicht übernommen.
- Die Einstellungen einer Matrix sind ebenfalls betroffen.
Vermeidung
- Mit einer Nuclos v3.12+ genügt es schon eine Ergebnisliste bzw. ein betroffenes Unterformular, um eine Konvertierung anzustoßen. Mit dem Beenden des Clients werden diese dann in der Datenbank gespeichert. Bei Freigegebenen Arbeitsumgebungen das Publizieren nicht vergessen!
- Für die Matrix ist eine Nuclos v3.15.6+ erforderlich.
MIG-04 Einführung eines Lokalen Identifizierers (Local Identifier) für Nuclets
System Änderungen
- Jedes Nuclet bekommt einen zufälligen Lokalen Identifizierer (4-stellig). Dieser wird sich von Instanz zu Instanz unterscheiden.
- Ersetzt T_EO bei den Tabellen Namen.
- Datenbankobjekt Namen werden mit diesem Identifizierer beginnen müssen.
- Die automatische Migration wird Tabellen umbenennen.
- Datenbank Constraints & Indizes werden gelöscht und mit einem neuen zentralen Namen anlegen.
- Nuclet Bestandteilzuweisung und ein Nuclet Import wird Identifizierer entsprechend austauschen.
Nacharbeiten
- Wenn die Migration etwas nicht automatisch finden und ersetzten konnte muss bei den Datenquellen und Datenbankobjekten manuell nachgebessert werden. Diese sollten also auf Funktionsfähigkeit geprüft werden.
MIG-05 User Preferences
User Preferences (nicht die Arbeitsumgebungen) werden zurückgesetzt. Hierzu zählen u.a.:
- Zuletzt verwendete Arbeitsumgebung
- Reihenfolge der Arbeitsumgebungen in der Leiste
- Einstellungen für die LiveSearch
- Spalteneinstellungen für die persönlichen Aufgaben und anderer Aufgabenlisten
- Splitpane Einstellung auf den Masken (nicht die Arbeitsumgebung Aufteilung)
MIG-06 Nuclet Voraussetzungen
System Änderungen
- Nuclets müssen ein eindeutiges Package und einen eindeutigen Namen haben.
Vorbereitung
- Fehlende Namen und Package Angaben in Nuclets nachtragen.
- Alle Nuclets müssen auf Eindeutigkeit bezüglich des Package und des Namens geprüft werden, und ggf. geändert werden.
MIG-07 Arbeitsumgebungen
Arbeitsumgebungen werden weitestgehend migriert. Ausnahmen sind:
- Zuletzt geöffnete Explorer Tabs.
- Die Suchbedingung eines zuletzt geöffneten Businessobjekts Tabs.
MIG-08 Ressourcenplanungen
Ressourcenplanungen werden weitestgehend migriert. Ausnahmen sind:
- Gewisse Sondereinstellungen wie "Stufenanordnung" oder "Fest Breite".
MIG-09 Layout der Statusmodelle
Darstellung von Statusmodellen werden zurückgesetzt
Hier möchten wir Ihnen ein Vorgehen beschreiben, mit dem Sie in der Lage sind diese Nacharbeiten schon im Vorfeld zu leisten. Dies ist dann wertvoll, wenn Sie z.B. die Downtime Ihrer Produktionsumgebung möglichst gering halten wollen.
Zum Vorgehen
- Migration auf einer Test- / Konfigurationsumgebung erfolgreich durchführen.
- Nacharbeiten mit Hilfe des Migrationslogs (migration_04_00_0016_main.log) identifizieren und bearbeiten. Diese finden Sie am schnellsten mit den entsprechenden Suchen auf die MIG-XX Themen.
- Exportieren Sie Ihr Nuclet wie gewohnt mit Hilfe des Nuclet Managements. Achtung, der Instanztransfer wurde entfernt. Sollte Ihr System über mehrere einzelne Nuclets verfügen bietet es sich an, ein neues übergeordnetes Nuclet anzulegen, und mit den Abhängigkeiten auf die anderen Nuclets auszustatten.
- Auf der Produktionsumgebung installieren Sie dann ebenfalls die neue Nuclos 4.0 Version und führen die Migration mit dem ersten Start des Servers aus.
- Ist die Migration erfolgreich durchgelaufen können Sie das Nuclet mit den nötigen Nacharbeiten importieren.
Vorbereitungen können ebenfalls über ein ähnliches Vorgehen bearbeitet werden, in dem mit der alten Nuclos Version vor dem Update und der Migration ein Nuclet importiert wird, welches die nötigen Vorbereitungen enthält. Zum Beispiel für den Entfall der alten Regeln.
Überblick
Inhalte