Domänenmigrationstool

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer
  • Verwenden Sie das Domänenmigrationstool, um einen Kunden aus einer domänengetrennten Umgebung in eine eigene dedizierte Instanz zu migrieren.

    Plugin „Domain Migration Tool“

    Das Plugin „Domain Migration Tool“ (com.glide.domain.migration_tool) vereinfacht die Aufgabe, einen Kunden aus einer domänengetrennten Umgebung in eine flexiblere dedizierte Instanz zu migrieren. Kunden möchten möglicherweise zu einer separaten Instanz migrieren, um die Fähigkeiten von Now Platform besser nutzen zu können. Obwohl das Plugin „Domain Separation“ installiert ist, sind die Eigenschaften für die Daten- und Prozesstrennung deaktiviert.
    Hinweis:
    Sie müssen eine geklonte Instanz anfordern und die Aktivierung des Plugins „Domain Migration Tool“ anfordern, bevor Sie es verwenden können.
    Das Domain Migration Tool wird nur ausgeführt, wenn Daten- und Prozesstrennung in der domänengetrennten Instanz aktiviert sind:
    • Die Dateneigenschaft glide.sys.domain.partitioning muss auf truefestgelegt werden.
    • Die Prozesseigenschaft glide.sys.domain.delegated_administration muss auf truefestgelegt werden.

    Funktionsweise des Migrationstools

    • Ein Großteil des Migrationsprozesses wird automatisiert, insbesondere die Bereinigung von Daten.
    • Migriert die domänengetrennte Instanz zu einer neuen dedizierten Instanz.
    • Löscht Daten aus der dedizierten Instanz.
      Hinweis:
      Das Tool löscht keine Daten, die global, in der Zieldomäne oder in zusätzlichen Datendomänen (falls angegeben) sind.
    • Reduziert Prozessdaten oder löscht Prozessdaten, wenn dies nicht möglich ist
    • Behält Prozessdatensätze bei, die für die Zieldomäne sichtbar sind
    • Aktualisiert die Spezialtabellen „sys_choice“, „sys_ui_list“ und „sys_ui_related_list“.
    • Bereinigt Datensätze, die von Domain Separation-Plugins hinzugefügt wurden:
      • Business-Regeln
      • UI-Aktionen
      • Geplante Aufgaben
      • Installations-Exits
      • Navigationsmodule
    • Deaktiviert Domain Separation und entfernt Domänen aus der geklonten Instanz:
      • Legt diese Eigenschaften in der geklonten Instanz auf „false“ fest:
        • glide.sys.domain.partitioning
        • glide.sys.domain.delegated_administration
        • glide.sys.domain.enabled
      • Löscht alle Domänen mit Ausnahme der Zieldomäne und aller zusätzlichen angegebenen Datendomänen.
    • Aktualisiert das Feld „Status“ in der Tabelle „domain_migration_tool_status“.
      Tabelle : 1. Individueller Status der Tabellen
      Status Beschreibung
      Ausstehend Standardstatus von domänengetrennten Tabellen während der Migration. Die Migration der Tabellen ist geplant, die Migration wurde jedoch noch nicht gestartet.
      Fehler Fehler auf Tabellenebene. Wenn der Migrationsprozess mit Fehlern abgeschlossen wird, gibt dieser Status an, welche Tabellen Fehler aufweisen.
      Wird ausgeführt Der Status der Tabelle, die derzeit migriert wird. Nur eine Tabelle kann diesen Status haben und wird derzeit migriert.
      Erfolgreich Der Status der Tabellen, die erfolgreich migriert wurden.
      Erfolgreich beendet Der Migrationsprozess wird ohne Fehler abgeschlossen.
      Mit Fehlern abgeschlossen Der Migrationsprozess wird mit Fehlern abgeschlossen.
    • Protokolliert Fortschritt und Status in „syslog_domain“.

      Die Quelle ist MigrationTool für alle Protokolleinträge, die der Migration zugeordnet sind.

      • Protokolliert jede Datentabelle und wie viele Datentabellen verbleiben
      • Protokolliert jede Prozesstabelle und die Datensätze welcher Domäne derzeit deaktiviert oder gelöscht werden

    Was das Migrationstool nicht kann

    • Klonen Sie die Instanz
    • Erstellen Sie eine weitere domänengetrennte Instanz
    • Migrieren Sie Datensätze (Daten oder Prozess), wenn Daten- oder Prozesstrennungseigenschaften deaktiviert sind, bevor Sie das Tool ausführen
    • Ändern Sie beliebige Daten in der Quellinstanz
    • Globale Daten, Daten in der Zieldomäne oder in zusätzlichen Datendomänen (falls angegeben) löschen

    Was Sie nach dem Ausführen des Tools tun müssen

    Das Domain Migration Tool automatisiert die Entfernung von Daten außerhalb der gewünschten Domänen (Zieldomäne, zusätzliche Datendomänen und globale Domäne). Sie müssen alle verbleibenden Konfigurationen bewerten, um sicherzustellen, dass sie für Ihre dedizierte Instanz geeignet sind und funktionieren. Wenn Sie beispielsweise eine Geschäftsregel hatten, die das Feld „Domäne“ auf Datensätze festlegt, können Sie diese Geschäftsregel deaktivieren, da sie keinen Zweck mehr erfüllt.

    Migrieren Sie eine domänengetrennte Instanz zu einer dedizierten Instanz

    Verschieben Sie einen Kunden aus einer domänengetrennten Umgebung in eine eigene dedizierte Instanzumgebung.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Erhöhen Sie die Berechtigungen auf die Rolle security_admin.
    2. Navigieren zu Alle > Domänenadministrator > Domänenmigrationstool.
      Greifen Sie auch mit „domain_migration_tool_status.list“auf zu.
    3. Klicken Sie auf Neu.
    4. Füllen Sie das Formular aus.
      Feld Beschreibung
      Zieldomäne Geben Sie die Domäne an, die für den Prozess und die Daten verwendet wird, die Sie migrieren möchten. Nur die Zieldomäne wird beibehalten, nicht ihre untergeordneten Elemente, sofern dies nicht im Feld „Zusätzliche Datendomänen“ angegeben ist.
      Zusätzliche Datendomänen Geben Sie optional zusätzliche Datendomänen an, die Sie migrieren möchten. Wenn Sie die Zieldomäne und alle zugehörigen untergeordneten Elemente migrieren möchten, müssen Sie alle untergeordneten Elemente angeben.
    5. Wählen Sie Absenden.
    6. Öffnen Sie das gerade übermittelte Formular.
    7. Navigieren zu Alle > Domain Separation Center > Audits konfigurieren .
      Weitere Informationen finden Sie unter Domain Separation Center.
    8. Setzen Sie den Audit des Validate Domain Separated Table Schema (Domänengetrenntes Tabellenschema validieren) auf Aktiv, und weisen Sie einen Zeitplan zu.
      Dies ist ein vorsorglicher Domänen-Audit, um das Schema für die Integrität von domänengetrennten Tabellen vorab zu überprüfen. Auf diese Weise können Sie Fehler beheben, bevor Sie die Migration ausführen.
    9. Führen Sie den Audit-Zeitplan aus, der das Schema enthält.
    10. Behandeln Sie die vom Audit zurückgegebenen Probleme.
      Fehlerbeispiel aus der Schemaprüfung.
    11. Wählen Sie Migration starten aus.
      • Der Fortschrittsbalken des Ausführungstrackers und das Domänenmigrationstool werden ausgelöst.Fortschrittsbalken für die Domänenmigration.
      • Die aktuell verarbeitete Migrationstabelle wird zusammen mit dem Gesamtprozentsatz der erfolgreich migrierten Tabellen angezeigt.
      • Die Tabelle, in der alle domänengetrennten Tabellen mit dem Migrationsstatus, der Gesamtzahl der Datensätze in jeder Tabelle und der Anzahl der migrierten Datensätze aufgezeichnet werden.
      • Die Anzahl der Tabellen, bei denen die Migration fehlgeschlagen ist, wird ebenfalls aufgezeichnet.
      • Der Status wird aktualisiert, wenn das Tool seine Funktionen ausführt.
      • Die Domänenmigration wird weiterhin im Hintergrund ausgeführt, wenn Sie den Fortschrittsbalken schließen. Greifen Sie auf die Tabelle „sys_execution_tracker“ zu, und suchen Sie in „Tabellen“ nach „Laufende Migration“, um den im Hintergrund ausgeführten Migrationsprozess zu überprüfen.

      Der Status des Domänenmigrationstools zeigt die folgenden Felder an:

      Tabelle : 2. Statusfelder des Domänenmigrationstools
      Feld Beschreibung
      Status Zeigt den Migrationsstatus an.
      • Datentabellen werden migriert...: Status „In Bearbeitung“.
      • Migration erfolgreich: Der aktualisierte Status nach einer erfolgreichen Migration.
      • In einer der domänengetrennten Tabellen wurde eine falsche Konfiguration beobachtet: Gibt einen Fehler bei der Datenmigration an. Ein Schemafehler wurde gefunden, die Migration wird nicht gestartet. Führen Sie das Audit „Domänengetrenntes Tabellenschema validieren“aus. Das Audit schlägt fehl und zeigt die Tabellen an, die nicht dem Schemastandard entsprechen.
      • Abgeschlossen mit Fehlern in Revisit-Tabellen: Die Anzahl der Tabellen für die Schemamigration wird aufgelistet. Suchen Sie die Fehler in Anzahl der Revisit-Tabellen, und beheben Sie Schemaprobleme.
      • Domänenmigration für Tabellen fehlgeschlagen...: Nicht-Zieldatensätze müssen manuell aus fehlgeschlagenen Tabellen gelöscht werden.
      • Erfolgreich abgeschlossen: Wenn alle Tabellen migriert wurden.
      Zieldomäne Die ausgewählte Zieldomäne für die Migration.
      Zusätzliche Datendomänen Wird ausgefüllt, wenn mehrere Migrationsdomänen ausgewählt wurden.
      Anzahl der erneut verarbeiteten Tabellen Dieses Feld wird nur ausgefüllt, wenn eine Tabelle nicht migriert werden kann. Wenn keine Fehler vorliegen, ist diese Anzahl Null. In diesem Fall werden die Tabellen überarbeitet, um die Migration erneut zu versuchen. Wenn keine Fehler auftreten, müssen Sie die Tabellen nicht erneut überprüfen oder die Migration erneut versuchen.
      Aktuell verarbeitete Tabelle Zeigt den Namen der Tabelle an, die derzeit migriert wird. Nach der erfolgreichen Migration ist dieses Feld leer.
    12. Wählen Sie den Link Hier klicken auf der Statusseite des Domänenmigrationstools aus, um den Ausführungstracker zu öffnen.Link zum erneuten Öffnen des Fortschrittsbalkens des Domänenmigrationstools.

      Sie können auch auf die Tabelle „sys_execution_tracker“ zugreifen und nach „Laufende Migration für Tabellen“ suchen, um den im Hintergrund ausgeführten Migrationsprozess zu überprüfen.

    13. Wählen Sie im Abschnitt „Zugehörige Links“ die Option Status anzeigen aus, um während der Migration jederzeit auf den Fortschrittsbalken zuzugreifen.Zeigt den Link Status anzeigen im Ausführungstracker an.

      Falls eine Tabelle die Schemaprüfung nicht bestanden hat, lautet der Gesamtstatus der Migrationsstatustabellen mit Domänentrennung „ Fehlgeschlagen“.Der Gesamtstatus der Migration wird als „fehlgeschlagen“ angezeigt.

      Für jede entsprechende Tabelle sind fehlgeschlagene Einträge vorhanden.

      Zeigt die Tabellen an, bei denen die Migration fehlgeschlagen ist.

      Der Rest der Migration wird fortgesetzt, und eine Zusammenfassung aller fehlgeschlagenen Tabellen und die Gesamtzahl der Anzahl der überarbeiteten Tabellen werden im Status des Domänenmigrationstools ausgefüllt.Zeigt die Anzahl der Tabellen an, die fehlgeschlagen sind und eine erneut verarbeitete Tabellenanzahl erfordern.

      Der Status lautet „Erfolgreich abgeschlossen“, wenn die Migration abgeschlossen ist. Zeigt den Status der erfolgreichen Migration an.