Suppression de données orphelines

Vous utilisez l'outil SLCheckerTool pour supprimer des données orphelines de la base de données.

Avant de commencer

Lorsque les ressources du portail sont supprimées, les ressources dépendantes qui sont enregistrées dans un autre domaine de base de données ne sont pas supprimées en même temps. Ces ressources restantes sont toujours disponibles pour les scénarios de sauvegarde ou pour d'autres lignes de production partageant peut-être le domaine de la base de données. Par exemple, lorsqu'un administrateur supprime des pages, la personnalisation de l'utilisateur sur les pages supprimées n'est pas supprimée. L'outil SLCheckerTool permet de détecter les données orphelines qui ne sont plus utiles aux lignes de production partageant le domaine. Vous pouvez utiliser SLCheckerTool pour préparer un script XML en vue de la suppression future des données orphelines à l'aide de l'interface de configuration XML.

L'otuil SLCheckerTool est inclus dans le fichier wp.db.slchecker.jar dans le répertoire suivant :
Pour démarrer SLCheckerTool, utilisez les scripts de shell suivants :

Pour préparer et effectuer la suppression des données orphelines, vous exécutez également quelques étapes à l'aide de l'interface de configuration XML. Pour plus de détails sur l'interface de configuration XML et son utilisation, reportez-vous aux rubriques correspondantes. Un exemple de script XML d'exportation de données orphelines répertoriées permet de préparer ces données pour les utiliser avec SLCheckerTool.

Pourquoi et quand exécuter cette tâche

Notes :
  1. Avant de supprimer les données orphelines avec SLCheckerTool, protégez les bases de données en effectuant une sauvegarde.
  2. Pour supprimer toutes les données orphelines, vous devez inclure chaque ligne de production partageant le domaine de base de données. Sinon, vous risquez de supprimer malencontreusement les ressources encore valides dans une ligne de production.

Pour supprimer les données orphelines, procédez comme indiqué ci-après. Dans chaque étape, reprenez comme fichier source le fichier cible de l'étape précédente.

Procédure

  1. Exécutez le service de nettoyage pour supprimer les ressources qui sont marquées pour une suppression différée. Pour exécuter le service de nettoyage, utilisez l'interface de configuration XML et l'exemple de fichier XML Task.xml comme entrée.
  2. Créez une exportation complète comprenant les données orphelines de chaque ligne de production partageant le domaine particulier. Pour effectuer cette étape, utilisez l'interface de configuration XML et l'exemple de fichier XML ExportIncludingOrphanedData.xml.
  3. A l'aide de SLCheckerTool, créez un fichier script XML pour supprimer les données orphelines. Exécutez cette étape avec les sous-étapes indiquées plus loin.
    Observez les règles suivantes :
    • A chaque étape, démarrez SLCheckerTool en spécifiant les paramètres adéquats comme indiqué.
    • Remplacez toutes les variables de nom de fichier (indiquées en italiques) par le nom de fichier et l'emplacement du chemin du répertoire complet.
    • Dans chaque étape, reprenez comme fichiers source le ou les fichiers cible de l'étape précédente.
    Démarrez l'outil SLCheckerTool à l'aide des scripts de shell suivants :
    1. Localisez les candidats appropriés pour les données orphelines dans chaque ligne de production. Répétez cette étape pour chaque ligne de production, mais spécifiez un autre fichier de sortie pour chaque itération. Faute de quoi, les résultats sont écrasés. Spécifiez les paramètres suivants :
      --find-candidates -s xml_source_file -d cand_target_file -domain domain_identifier
      Servez-vous de ces paramètres pour localiser les candidats pour les données orphelines dans une ligne de production. Remplacez les variables comme suit :
      fichier_source_xml
      Indiquez le fichier d'exportation XML complet créé à l'étape 2, celle où vous avez créé l'exportation XML incluant des données orphelines.
      fichier_cible_cand
      Spécifiez le fichier cible. Les candidats pour les données orphelines sont enregistrés dans ce fichier.
      identificateur_domaine
      Indiquez le domaine de base des documents dans lequel rechercher les candidats. Les valeurs valides sont comm pour le domaine de base de données de communauté, cust pour le domaine de base de données de personnalisation ou all pour les deux domaines de base de données.
    2. Identifiez les données orphelines. Exécutez cette étape une seule fois, mais avec tous les fichiers candidats générés par l'étape précédente simultanément. Cette étape regroupe tous les fichiers de résultats, c'est-à-dire les données orphelines dans toutes les lignes de production. Spécifiez les paramètres suivants :
      --identify-orphans -s cand_source_files_and_directories -d orph_target_file
      Servez-vous de ces paramètres pour identifier les données orphelines correspondant aux informations provenant de tous les fichiers candidats. Remplacez les variables comme suit :
      fichiers_source_cand_et_répertoires
      Indiquez tous les fichiers générés en tant que cand_target_files dans la sous-étape de recherche des candidats. Si vous spécifiez un ou plusieurs répertoires avec les fichiers, vérifiez qu'ils contiennent uniquement des fichiers candidats.
      fichier_cible_orph
      Spécifiez le fichier cible. Les données orphelines identifiées sont enregistrées dans ce fichier.
    3. Créez un fichier script XML. Vous pourrez utiliser ce script ultérieurement pour supprimer les données orphelines. Spécifiez les paramètres suivants :
      --delete-orphans -s orph_source_ file -d xml_target_file
      Servez-vous de ces paramètres pour créer un fichier script XML qui supprime les données orphelines. Remplacez les variables comme suit :
      fichier_source_orph
      Indiquez le fichier généré en tant que orph_target_file au cours de la sous-étape d'identification des données orphelines.
      fichier_cible_xml
      Spécifiez le fichier cible. Il s'agit du fichier script XML qui contient les informations sur les données orphelines. Vous pourrez utiliser ce fichier ultérieurement pour supprimer les données orphelines.
  4. Facultatif : Vous pouvez vérifier si toutes les lignes de production ont été prises en considération pendant la création du fichier script XML. Pour ce faire, étudiez le commentaire se trouvant dans l'en-tête du fichier. Cet en-tête contient des informations sur toutes les exportations complètes qui ont été utilisées.
  5. Supprimez les données orphelines en démarrant l'interface de configuration XML avec le script XML généré en tant que xml_target_file avec les données orphelines lors de la sous-étape de création du script XML. Vous devez démarrer l'interface de configuration XML avec le script XML uniquement sur une ligne de production partageant le domaine de base de données. Cette étape supprime les données orphelines de toutes les lignes de production partageant ce domaine de base de données.

Résultats

Vous avez supprimé toutes les données orphelines de la base de données du portail.