Migration des collections de recherche du portail

Lorsque vous migrez ou mettez à niveau HCL Digital Experience vers une version ultérieure, le format de stockage des données et la structure d'index de Recherche dans le portail ne sont pas compatibles avec une version antérieure. Si vous migrez votre portail vers une version supérieure et souhaitez continuer à utiliser vos collections de recherche, vous devez les conserver avant de migrer le portail et les importer dans le portail mis à niveau après la migration.

Pourquoi et quand exécuter cette tâche

Les collections de recherche demandent une migration manuelle. Pour cela, utilisez l'option Importer ou exporter une collection du portlet Gérer la recherche afin d'exporter et d'importer les collections de recherche. Pour plus d'informations sur ces tâches et le portlet Gérer la recherche, consultez l'aide du portlet.

Procédure

  1. To include the security information when you export the search collection, add the WS_KEY parameter to the search service that contains the source search collection that you want to export. Appliquez la procédure suivante :
    1. To open the Manage Search portlet, click the Administration menu icon. Then, click Search Administration > Manage Search.
    2. Click Search Services.
    3. Cliquez sur l'icône Editer pour le service de recherche qui contient la collection de recherche que vous souhaitez exporter.
    4. Dans la zone Clé de paramètre, entrez WS_KEY.
    5. Dans la zone Nouvelle valeur de paramètre, entrez secret.
    6. Cliquez sur Ajouter le paramètre.
    7. Cliquez sur OK.
    Remarque : Si vous n'exportez pas les informations de sécurité lors de l'exportation d'une collection de recherche, vous devez ajouter manuellement le nom d'utilisateur et le mot de passe à chaque source de contenu après l'importation de la collection de recherche dans le portail cible.
  2. Avant la migration de votre portail vers une version ultérieure, exportez vos collections de recherche. Cette étape exporte les données de configuration de vos collections de recherche.
    1. Cliquez sur Gérer la recherche.
    2. Cliquez sur Collections de recherche.
    3. Cliquez sur l'icône Importer ou exporter une collection pour la collection que vous souhaitez exporter.
    4. Dans la zone Indiquez l'emplacement, entrez le chemin d'accès absolu et le nom du fichier XML vers lequel vous souhaitez exporter la collection de documents et ses données.
    5. Cliquez sur Exporter.
    Notes :
    1. Avant d'exporter une collection, assurez-vous que l'utilisateur qui exécute le processus d'application de portail dispose d'un droit d'accès en écriture sur l'emplacement du répertoire cible. Otherwise, you might get an error message, such as File not found.
    2. Lorsque vous indiquez l'emplacement du répertoire cible pour l'exportation, pensez que les fichiers qui s'y trouvent seront écrasés.
  3. Pour chaque collection, indiquez les données ci-après :
    • les noms des fichiers cible et les emplacements des répertoires où vous exportez la collection,
    • l'emplacement, le nom, la description et la langue,
    • les paramètres pour les options Spécifier la langue de la collection et Retirer les mots communs des requêtes.
  4. Supprimez les collections de recherche de votre portail actuel. Faute de quoi, elles peuvent être corrompues par l'étape d'importation qui intervient ultérieurement.
  5. Mettez à niveau votre produit HCL si nécessaire.
  6. Créez des collections de recherche vides que vous pourrez ensuite utiliser pour y placer la configuration des collections importées.
    Renseignez les zones suivantes et sélectionnez les options qui suivent en fonction des informations indiquées à l'étape 2 :
    Emplacement de la collection
    Vous pouvez utiliser l'ancien emplacement si vous le voulez.
    Nom de la collection
    Vous pouvez utiliser l'ancien nom si vous le voulez.
    Description de la collection
    Vous pouvez utiliser l'ancienne description.
    Spécifiez la langue de la collection
    Sélectionnez cette zone pour respecter l'ancien paramètre indiqué à l'étape 2.
    Sélectionnez le programme de résumé
    La valeur est écrasée par le processus d'importation.
    Retirer les mots vides des requêtes (par exemple, dans, de, sur etc.)
    Cochez ou décochez cette case pour respecter l'ancien paramètre indiqué à l'étape 2.
    Il est inutile d'ajouter des sources de contenu ou des documents, car le processus d'importation s'en charge.
  7. To include the security information when you import the search collection, add the WS_KEY parameter to the search service that contains the target search collection. Appliquez la procédure suivante :
    1. To open the Manage Search portlet, click the Administration menu icon. Then, click Search Administration > Manage Search.
    2. Click Search Services.
    3. Cliquez sur l'icône Editer pour le service de recherche qui contient la collection de recherche cible.
    4. In the Parameter key field, enter WS_KEY.
    5. Dans la zone Nouvelle valeur de paramètre, entrez secret.
    6. Click Add Parameter.
    Remarque : Si vous n'importez pas les informations de sécurité lors de l'importation d'une collection de recherche, vous devez ajouter manuellement le nom d'utilisateur et le mot de passe à chaque source de contenu après l'importation de la collection de recherche dans le portail cible.
  8. Vérifiez que les collections de recherche cible créées à l'étape 6 sont vides.
    N'importez pas de données de collection dans une collection cible qui contient déjà des sources ou des documents.
  9. Importez les données de collection de recherche dans le portail. Pour les informations sur les sources d'importation, prenez les noms des fichiers et les emplacements des répertoires indiqués dans lesquels vous avez exporté les collections avant la mise à niveau du portail.
  10. Passez brièvement en revue les paramètres de configuration de la source de contenu pour vérifier si les informations telles que le nom d'hôte et les données d'identification de sécurité sont encore valables ou doivent être modifiées. Apportez les modifications nécessaires aux paramètres de configuration de la source de contenu.
    Remarque : Lorsque vous importez des données de collection de recherche dans une collection, la plupart des données de configuration, telles que les sources de contenu, les planificateurs, les filtres et les paramètres de langue, sont également importées. Si vous avez configuré ces paramètres lors de la création de la collection, ils sont remplacés par les paramètres importés.