Outil de migration de domaine

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 Outil de migration de domaine

    Le module d’extension Outil de migration de domaine (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 vouloir migrer vers une instance distincte pour tirer davantage parti des ServiceNow AI Platform fonctionnalités. Bien que le module d’extension Séparation en domaines 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 la séparation des processus sont activées dans l’instance séparée par domaine :
    • La glide.sys.domain.partitioning propriété des données doit être définie sur vrai.
    • La glide.sys.domain.delegated_administration propriété du 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 en domaines 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 (le cas échéant).
    • Réduit les données de processus ou, s’il est impossible de les réduire, les supprime
    • Conserve les enregistrements de processus visibles par le domaine cible
    • Met à jour les tables sys_choice, sys_ui_list et sys_ui_related_list spéciales
    • Nettoie les enregistrements ajoutés par les modules d’extension de séparation de domaine :
      • Règles métier
      • Actions d'interface utilisateur
      • Travaux planifiés
      • Sorties d’installation
      • Modules de navigation
    • Désactive la séparation de domaine et supprime les domaines de l’instance clonée :
      • Définit ces propriétés sur faux 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 autres domaines de données 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. La migration des tables est planifiée, mais la migration n’a pas encore démarré.
      Échec Échec au niveau de la table. Si le processus de migration se termine avec des erreurs, cet état indique quelles tables comportent des erreurs.
      En cours d'exécution État de la table 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 sur 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 de 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 en domaines
    • 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 des 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, tout domaine de données supplémentaire 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 aviez une règle métier qui définissait le champ de domaine sur les enregistrements, vous pourriez vouloir désactiver cette règle métier, car elle ne sert plus à rien.

    Migrer une instance séparée en domaines 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ée.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Élevez-vous au rôle security_admin .
      Consultez Accéder à un rôle privilégié pour en savoir plus.
    2. Accédez à la Tous > Administrateur de domaine > Outil de migration de domaine.
      Accédez é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é, pas 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 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 Envoyer.
    6. Ouvrez le formulaire que vous venez de soumettre.
    7. Accédez à la Tous > 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 tables séparées par domaine sur Actif et affectez un calendrier.
      Il s’agit d’un audit de domaine de précaution visant à vérifier au préalable l’intégrité des tables séparées par domaine du schéma. 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 issue de la vérification du schéma.
    11. Sélectionnez Démarrer la migration.
      • La barre de progression du suivi d’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 en cours s’affiche avec le pourcentage total de tables migrées avec succès.
      • Table où toutes les tables séparées par domaine sont enregistrées avec l’état de la 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 à mesure que l’outil remplit 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 Exécution de la migration sur les tables pour vérifier l’exécution du processus de migration 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 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 de 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 des schémas est répertorié. Localisez les défaillances dans le nombre de tables Revisiter 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 Indique 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 de défaillance, ce nombre est égal à zéro. Dans ce cas, les tables seront revisitées pour retenter la migration. En l’absence d’échec, 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 en cours de migration. Une fois la migration réussie, ce champ est vide.
    12. Sélectionnez le lien Cliquez ici sur la page État de l’outil de migration de domaine pour ouvrir le suivi de l’exécution.Lien pour rouvrir la barre de progression de l’outil de migration de domaine.

      Vous pouvez également accéder à la table sys_execution_tracker et rechercher Exécution de la migration sur les tables pour vérifier l’exécution du processus de migration 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 dans le suivi de l’exécution.

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

      Il y aura des entrées échouées pour chaque table correspondante.

      Affiche les tables qui ont échoué lors de la migration.

      Le reste de la migration se poursuit et un résumé de toutes les tables ayant échoué et 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 nouveau nombre de tables.

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