Outil de migration de domaine

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture

    • Utilisez l’outil de migration de domaine pour déplacer un client d’un environnement séparé par domaine vers sa propre instance dédiée.

    Module d’extension Domain Migration Tool

    Le module d’extension Domain Migration Tool (com.glide.domain.migration_tool) simplifie la tâche de déplacement d’un client d’un environnement séparé par domaine vers une instance dédiée plus flexible. Les clients peuvent souhaiter migrer vers une instance distincte pour tirer davantage parti des Now Platform options. Bien que le module d’extension Séparation de domaine soit installé, les propriétés de séparation des données et des processus sont désactivées.
    Remarque :
    Vous devez demander une instance clonée et demander l’activation du module d’extension Outil de migration de domaine avant de pouvoir l’utiliser.
    L’outil de migration de domaine s’exécute uniquement si la séparation des données et des processus est activée dans l’instance séparée par domaine :
    • La glide.sys.domain.partitioning propriété de données doit être définie sur true.
    • La glide.sys.domain.delegated_administration propriété de processus doit être définie sur true.

    Fonction de l’outil de migration

    • Automatise une grande partie du processus de migration, en particulier le nettoyage des données.
    • Migre l’instance séparée par domaine vers une nouvelle instance dédiée.
    • Supprime les données de l’instance dédiée.
      Remarque :
      L’outil ne supprime pas les données globales, dans le domaine cible ou dans des domaines de données supplémentaires (si spécifié).
    • Réduit les données de processus ou, s’il ne peut pas les réduire, supprime les données de processus
    • Conserve les enregistrements de processus visibles par le domaine cible
    • Met à jour les tables spéciales sys_choice, sys_ui_list et sys_ui_related_list
    • Nettoie les enregistrements ajoutés par les modules d’extension Domain Separation :
      • Règles métier
      • Actions d'interface utilisateur
      • Travaux planifiés
      • Sorties d’installation
      • Modules de navigation
    • Désactive Séparation de domaine et supprime les domaines de l’instance clonée :
      • Définit ces propriétés sur false dans l’instance clonée :
        • glide.sys.domain.partitioning
        • glide.sys.domain.delegated_administration
        • glide.sys.domain.enabled
      • Supprime tous les domaines, à l’exception du domaine cible et de tous les domaines de données supplémentaires spécifiés.
    • Met à jour le champ État dans la table domain_migration_tool_status.
      Tableau 1. État individuel des tables
      Statut Description
      En attente État par défaut des tables séparées par domaine pendant la migration. Les tables doivent être migrées, mais la migration n’a pas encore démarré.
      Échec Défaillance du niveau de la table. Si le processus de migration s’est terminé avec des erreurs, cet état indique quelles tables présentent des erreurs.
      En cours d'exécution État de la table actuellement en cours de migration. Une seule table peut avoir cet état et est en cours de migration.
      Réussi État des tables qui ont migré avec succès.
      Terminé avec succès Le processus de migration s’est terminé sans erreur.
      Terminé avec erreurs Le processus de migration s’est terminé avec des erreurs.
    • Consigne la progression et l’état à syslog_domain

      La source est MigrationTool pour toutes les entrées de journal associées à la migration.

      • Consigne chaque table de données et le nombre de tables de données restantes
      • Consigne chaque table de processus et les enregistrements du domaine qui sont actuellement désactivés ou supprimés

    Ce que l’outil de migration ne fait pas

    • Cloner l’instance
    • Créer une autre instance séparée par domaine
    • Migrer les enregistrements (données ou processus) si les propriétés de séparation des données ou des processus sont désactivées avant d’exécuter l’outil
    • Modifier les données sur l’instance source
    • Supprimer les données globales, dans le domaine cible ou dans des domaines de données supplémentaires (si spécifié)

    Ce que vous devez faire après avoir exécuté l’outil

    L’outil de migration de domaine automatise la suppression des données en dehors des domaines souhaités (le domaine cible, tous les domaines de données supplémentaires et le domaine global). Vous devez évaluer toutes les configurations restantes pour vous assurer qu’elles sont appropriées et qu’elles fonctionnent pour votre instance dédiée. Par exemple, si vous avez une règle métier qui définit le champ Domaine sur les enregistrements, vous pouvez désactiver cette règle métier, car elle n’a plus d’utilité.

    Migrer une instance séparée par domaine vers une instance dédiée

    Déplacez un client d’un environnement séparé par domaine vers son propre environnement d’instance dédié.

    Avant de commencer

    Rôle requis : security_admin et admin

    Procédure

    1. Élever au rôle de security_admin.
      Consultez Élever à un rôle privilégié pour en savoir plus.
    2. Accédez à la Tout > Administrateur de domaine > Outil de migration de domaine.
      Accès également avec domain_migration_tool_status.list.
    3. Cliquez sur Nouveau.
    4. Complétez le formulaire.
      Champ Description
      Domaine cible Spécifiez le domaine utilisé pour le processus et les données que vous souhaitez migrer. Seul le domaine cible est conservé, aucun de ses enfants, sauf indication contraire dans le champ Domaines de données supplémentaires .
      Domaines de données supplémentaires Vous pouvez également spécifier tous les domaines de données supplémentaires que vous souhaitez migrer. Si vous souhaitez migrer le domaine cible et tous ses enfants, vous devez spécifier tous les enfants.
    5. Sélectionnez Soumettre.
    6. Ouvrez le formulaire que vous venez de soumettre.
    7. Accédez à la Tout > Centre Séparation en domaines > Configurer des audits .
      Consultez Centre Séparation en domaines pour plus d'informations.
    8. Définissez l’audit Valider le schéma de table séparée par domaine sur Actif et affectez un calendrier.
      Il s’agit d’un audit de domaine de précaution visant à prévérifier l’intégrité du schéma des tables séparées par domaine. Cela vous permet de corriger les erreurs avant d’exécuter la migration.
    9. Exécutez le calendrier d’audit qui inclut le schéma.
      Consultez Exécuter les audits immédiatement pour en savoir plus.
    10. Résoudre les problèmes renvoyés par l’audit.
      Exemple d’erreur issu de la vérification du schéma.
    11. Sélectionnez Démarrer la migration.
      • La barre de progression du suivi de l’exécution et l’outil de migration de domaine sont déclenchés.Barre de progression de la migration de domaine.
      • La table de migration progressive actuelle s’affiche avec le pourcentage total de tables correctement migrées.
      • Table dans laquelle toutes les tables séparées par domaine sont enregistrées avec l’état de migration, le nombre total d’enregistrements dans chaque table et le nombre d’enregistrements migrés.
      • Le nombre de tables où la migration a échoué est également enregistré.
      • L’état est mis à jour au fur et à mesure que l’outil exécute ses fonctions.
      • La migration de domaine est toujours en cours d’exécution en arrière-plan si vous fermez la barre de progression. Accédez à la table sys_execution_tracker et recherchez Migration en cours d’exécution sur les tables pour vérifier que le processus de migration s’exécute en arrière-plan.

      L’état de l’outil de migration de domaine affiche les champs suivants :

      Tableau 2. Champs d’état de l’outil de migration de domaine
      Champ Description
      Statut Affiche l’état de la migration.
      • Migration des tables de données... : état en cours.
      • Migration réussie : état mis à jour après une migration réussie.
      • Une mauvaise configuration est observée sur l’une des tables séparées par domaine : Indique un échec de la migration des données. Une erreur de schéma a été trouvée, la migration ne démarre pas. Exécuter l’audit Valider le schéma de table séparée par domaine. L’audit échouera et affichera les tables qui ne suivent pas la norme de schéma.
      • Terminé avec des erreurs dans les tables de revisite : le nombre de tables pour traiter la migration de schéma est répertorié. Localisez les défaillances dans le nombre de tables de revisite et résolvez les problèmes de schéma.
      • Échec de la migration de domaine pour les tables... : les enregistrements non cibles doivent être supprimés manuellement des tables ayant échoué.
      • Terminé avec succès : lorsque toutes les tables ont migré.
      Domaine cible Domaine cible sélectionné pour la migration.
      Domaines de données supplémentaires Renseigné si plusieurs domaines de migration ont été sélectionnés.
      Nombre des tables de revisite Ce champ est renseigné uniquement si la migration d’une table échoue. S’il n’y a pas d’échecs, ce nombre est égal à zéro. Dans ce cas, les tables seront revisitées pour retenter la migration. En l’absence d’échecs, il n’est pas nécessaire de revoir les tables ou de retenter la migration.
      Table de progression actuelle Affiche le nom de la table actuellement en cours de migration. Une fois la migration réussie, ce champ sera vide.
    12. Sélectionnez le lien Cliquez ici sur la page État de l’outil de migration de domaine pour ouvrir le suivi des exécutions.Lien pour rouvrir la barre de progression de l’outil Migration de domaine.

      Vous pouvez également accéder à la table sys_execution_tracker et rechercher Migration en cours d’exécution sur les tables pour vérifier que le processus de migration s’exécute en arrière-plan.

    13. Sélectionnez Afficher l’état dans la section Liens connexes pour accéder à la barre de progression à tout moment pendant la migration.Affiche le lien Afficher l’état sur le suivi des exécutions.

      En cas d’échec de la vérification du schéma d’une table, l’état global de la migration des tables séparées par domaine est défini sur Échec.L’état global de la migration indique un échec.

      Il y aura des entrées d’échec pour chaque table correspondante.

      Affiche les tables qui ont échoué à la migration.

      Le reste de la migration se poursuit et un résumé de toutes les tables ayant échoué ainsi que le nombre total de tables de revisite sont renseignés dans l’état de l’outil de migration de domaine.Affiche le nombre de tables qui ont échoué et qui nécessitent un nombre de revisites.

      L’état est Terminé avec succès lorsque la migration est terminée. Affiche l’état de migration réussi.