Outil de migration de domaine

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 vouloir migrer vers une instance distincte pour tirer davantage parti des Now Platform options. Bien que le module d’extension Domain Separation 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 Domain Migration Tool 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 vrai.
    • La glide.sys.domain.delegated_administration propriété du processus doit être définie sur vrai.

    Fonctionnalités 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 (le cas échéant).
    • Réduit les données de processus ou, s’il n’est pas possible de 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 Domain Separation 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 ont un calendrier de migration, mais la migration n’a pas encore démarré.
      Échec Défaillance au niveau de la table. Si le processus de migration est terminé 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 L’é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 du domaine en cours d’inactivation ou de suppression.

    Ce que l’outil de migration ne fait pas

    • Cloner l’instance
    • Créer une autre instance séparée par domaine
    • Migrez 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 toutes les données de l’instance source
    • Supprimer les données globales, dans le domaine cible ou dans des domaines de données supplémentaires (le cas échéant)

    Procédure à suivre après l’exécution de 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 aviez une règle métier qui définissait le champ de domaine sur les enregistrements, vous souhaiterez peut-être 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 Tous > 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 Envoyer.
    6. Ouvrez le formulaire que vous venez d’envoyer.
    7. Accédez à la Tous > Centre Séparation de domaine > Configurer des audits .
      Consultez Centre Séparation de domaine 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ésolvez les problèmes renvoyés par l’audit.
      Exemple d’erreur provenant de la vérification du schéma.
    11. Sélectionnez Démarrer la migration.
      • La barre de progression du suivi des exécutions 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 de progression actuelle 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 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 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 de sys_execution_tracker et recherchez Migration en cours d’exécution sur les tables pour vérifier si 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 : statut 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 Validez le schéma de table séparée par domaine. L’audit échouera et affichera les tables qui ne respectent 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 échecs 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 Le domaine cible sélectionné pour la migration.
      Domaines de données supplémentaires Se remplit si plusieurs domaines de migration ont été sélectionnés.
      Nombre des tables de revisite Ce champ n’est rempli que 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 migrée. 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 si 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.

      Dans le cas où une table a échoué à la vérification du schéma, l’état global de l’état de migration des tables séparées par domaine est Échec.L’état global de la migration indique l’échec.

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

      Affiche les tables dont la migration a échoué.

      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 tables revisitées.

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