Création et indexation des fragments

Vous pouvez configurer et indexer un nombre spécifié de noyaux de fragmentation en les définissant dans un fichier de propriétés d'entrée et en exécutant l'utilitaire parallel-process dans le conteneur Docker du serveur d'utilitaire.

Avant de commencer

  1. Décidez de la configuration de fragmentation que vous souhaitez utiliser. Par exemple, vous pouvez sélectionner un noyau spécifique à la langue à fragmenter.
  2. Déterminez le nombre de fragments à créer.

Pourquoi et quand exécuter cette tâche

Au cours de cette tâche, vous effectuez les étapes de haut niveau suivante  :
  1. Créez et remplissez le fichier de propriétés d'entrée utilisé pour traiter les fragments d'indexation.
  2. Exécutez l'utilitaire di-parallel-process pour indexer les fragments.

Procédure

Préparer le fichier des propriétés d'entrée
  1. Créez ou mettez à jour le fichier de propriétés d'entrée qui sera utilisé pour l'indexation, en fonction de votre environnement et de vos exigences.
    Le fichier des propriétés d'entrée de fragmentation est utilisé par l'utilitaire di-parallel-process pour traiter les fragments d'indexation. Il contient les sections suivantes des propriétés :
    • Propriétés système telles que le chemin d'accès de fichier des propriétés de mot de passe.
    • Les propriétés de base de données, qui sont utilisées pour établir des connexions de base de données avec le serveur de base de données.
    • Les propriétés globales de prétraitement et d'indexation, qui sont utilisées pour le prétraitement et l'indexation par tous les fragments.
    • Les propriétés du serveur de recherche maître, qui spécifient les noyaux d'index maître où toutes les données de fragments sont fusionnées.
    • Les propriétés de fragment horizontales, qui spécifient les propriétés horizontales du fragment.
    L'image de l'utilitaire Docker contient deux exemples de fichiers de propriétés. L'exemple de fichier di-parallel-process.properties utilise le paramètre régional en_US et contient des définitions commentées pour les fragments A, B, C et V (V désignant la fragmentation verticale). Vous pouvez trouver les fichiers suivants dans le répertoire /opt/WebSphere/CommerceServer90/properties/parallelprocess/.
    di-parallel-process.properties
    L'exemple de fichier de propriétés d'entrée de fragment pour un système d'exploitation Linux qui utilise DB2. Reportez-vous au dernier fichier de configuration di-parallel-process.properties dans le conteneur Docker d'utilitaire HCL Commerce si vous utilisez la base de données Oracle.
    password.properties
    L'exemple de fichier de propriétés de mot de passe, référencé par l'exemple de fichier de propriétés d'entrée de fragment. Il contient des mots de passe chiffrés par l'utilitaire wcs_encrypt.

    Pour plus d'informations sur le fichier de propriétés et les valeurs attendues, reportez-vous à Fichier des propriétés d'entrée de fragmentation.

Exécuter l'utilitaire d'indexation des fragments
  1. Accédez au répertoire suivant :
    • HCL Commerce DeveloperWCDE_installdir\bin
    • HCL Commerce runtime environment/opt/WebSphere/CommerceServer90/bin dans le conteneur Docker du serveur d'utilitaire.
  2. Exécutez l'utilitaire :
    • HCL Commerce Developer di-parallel-process.bat input_properties_file
    • HCL Commerce runtime environmentdi-parallel-process.sh input_properties_file [-dbuser dbuser] [-dbuserpwd dbuserpwd] [-searchuser searchuser] [-searchuserpwd searchuserpwd]

    Où :

    input_properties_file
    Le chemin d'accès du fichier de propriétés d'entrée de l'utilitaire peut être relatif ou absolu. Par exemple, ../../di-parallel-process-linux-oracle.properties. Le chemin d'accès par défaut dans le conteneur Docker du serveur d'utilitaire est /opt/WebSphere/CommerceServer90/properties/parallelprocess/di-parallel-process.properties.
    dbuser
    Facultatif : Le nom de l'utilisateur qui se connecte à la base de données.
    dbuserpwd
    Facultatif : Mot de passe de l'utilisateur qui se connecte à la base de données.
    searchuser
    Facultatif : Le nom de l'utilisateur administratif de l'application de recherche.
    searchuserpwd
    Facultatif : Le mot de passe de l'utilisateur administratif de l'application de recherche.
  3. Assurez-vous que l'utilitaire s'exécute correctement. Vérifiez le code de sortie ou le fichier wc-dataimport-parallel-processor.log pour plus d'informations. Le chemin d'accès à wc-dataimport-parallel-processor.log est :
    • HCL Commerce DeveloperWCDE_installdir\logs.
    • HCL Commerce runtime environment/opt/WebSphere/CommerceServer90/logs/.
    Si vous souhaitez que le journal fournisse plus de détails, définissez le niveau du journal sur FINEST dans le fichier de propriétés /opt/WebSphere/AppServer/profiles/default/installedApps/localhost/ts.ear/xml/config/dataimport/parallel-processor-logging.properties.
    Conseil : Les niveaux de journalisation autorisés diffèrent entre les environnements de développement et d'exécution. Les niveaux de consignation sont les suivants :
  4. Si vous utilisez des prix des contrats indexés, vous devez effectuer les étapes suivantes :
    1. Ouvrez le fichier suivant pour tous les fragments : WC_installdir/instances/instance_name/search/solr/home/MC_masterCatalogId/Shards/locale/CatalogEntry_#Shard-Tag#/conf/wc-data-config.xml.
    2. Rechercher toutes les instances du nom de tableau suivant TI_CNTRPRICE _0_#Shard-Tag#.
    3. Remplacez-les par le nom de table suivant : TI_CNTRPRICE _0. Cette mise à jour permet aux utilitaires de rechercher les prix des contrats dans la table TI_CNTRPRICE_0, plutôt que dans les tables spécifiques aux fragments.
    4. Sauvegardez vos modifications.
    5. Pour une utilisation spécifique, voir Indexation des prix des contrats dans HCL Commerce Search

Que faire ensuite

Répliquez l'index fusionné dans le répéteur, puis dans les autres nœuds.