Fichier des propriétés d'entrée de fragmentation

Le fichier des propriétés d'entrée de fragmentation est un fichier que vous créez qui est transmis à l'utilitaire di-parallel-process lors de l'indexation des fragments.

Le fichier des propriétés d'entrée de fragmentation contient les sections et propriétés suivantes :

Propriétés système

Les propriétés système sont partagées par d'autres utilitaires. Par exemple, les mots de passe communs aux utilitaires.

PasswordFileDir: Emplacement d'un fichier password.properties que vous créez qui contient des mots de passe chiffrés par l'utilitaire wcs_encrypt.

Propriétés de base de données

Les propriétés des bases de données sont utilisées pour établir des connexions de base de données avec le serveur de base de données. Toutes les propriétés des bases de données commencent par le mot clé Database, suivi du nom de la propriété, qui est séparé par un point.

La liste suivante affiche les propriétés de la base de données :

Database.dbType: Type de base de données. Les valeurs admises sont db2 ou oracle.
Database.dbName: Nom de la base de données.
Database.dbHost: Le nom d'hôte d'une base de données à distance.
Database.dbServerPort: Le numéro de port d'une base de données à distance.
Database.dbUser: Nom d'utilisateur de la base de données.
Database.dbSchemaName: Nom du schéma de la base de données . Cette valeur est généralement la version majuscule du nom d'utilisateur de la base de données.
Database.jdbcURL: L'URL JDBC de la base de données.
Database.jdbcDriverLocation: L'emplacement du pilote JDBC de la base de données.
Database.jdbcDriverType: Le type de pilote JDBC de la base de données.

Propriétés globales de prétraitement et d'indexation

Les propriétés globales sont utilisées pour le prétraitement et l'indexation par tous les fragments, si elles ne sont pas autrement écrasées par le fragment lui-même. Toutes les propriétés globales commencent par le mot clé Global, suivi du nom de la propriété, qui est séparé par un point.

Les propriétés globales peuvent être regroupées dans les catégories suivantes : propriétés du serveur, propriétés de prétraitement et propriétés d'indexation.

La liste suivante affiche les propriétés globales du serveur :

Global.index-server-name: Le nom d'hôte du serveur de recherche.
Global.index-server-port: Le numéro de port du serveur de recherche.
Global.index-server-user: Le nom d'utilisateur du serveur de recherche.

La liste suivante affiche les propriétés globales de prétraitement :

Global.preprocessing-locale

Une valeur de paramètre régional de prétraitement unique à prétraiter. La valeur par défaut est All, où tous les paramètres régionaux sont prétraités.

Une liste de paramètres régionaux séparés par des virgules est autorisée.

Global.auto-preprocess

Prétraite automatiquement tous les fragments.

Global.preprocessing-drop-temp-table

Indique s'il faut abandonner des tables lors du prétraitement de l'index de recherche.

Le passage à une valeur false utilise une instruction TRONCATE sur les tables.

La valeur par défaut est true, qui utilise une instruction DROP sur les tables.

Remarque : Ce paramètre prend en charge uniquement les bases de données DB2 9.7 ou ultérieures, ou Oracle.

Global.preprocessing-deepSequence

Facultatif : Active le prétraitement de la fonction de séquençage de recherche approfondie.

La valeur par défaut est false.

Global.preprocessing-truncate-table-sql

Remplace l'instruction de table TRONCATE par défaut.

Global.preprocessing-dir

Le chemin d'accès aux fichiers XML de prétraitement dans l'utilitaire de conteneur Docker HCL Commerce.

Global.preprocessing-initial-global-table-dir

Le fichier XML de prétraitement sous ce chemin d'accès n'est traité qu'une seule fois avant la fragmentation. Ce chemin d'accès est l'emplacement préféré pour les configurations de prétraitement des tables temporaires initiales qui n'ont pas besoin d'être fragmentées ou créées plusieurs fois.

Pour réduire les efforts de configuration du client, la fragmentation automatique est prise en charge dans HCL Commerce version 9.0.0.5+ et activé par défaut dans la version 9.0.0.7+. Lorsque cette fonction est activée, l'utilitaire de processus parallèle peut automatiquement diviser la table d'entrée CATENTRY en parties égales par numéro de ligne, et créer des tables temporaires à partir de ces parties. Les noms des fragments sont générés automatiquement en fonction de la valeur number-of-shards, à partir de A. Par exemple, si number-of-shards est égal à 3, les fragments seront nommés A, B et C.

ATTENTION : Vous ne pouvez pas utiliser la fragmentation automatique et les fragments spécifiés manuellement en même temps. Si vous le faites, Global.locale ne sera pas en mesure de remplacer les valeurs index-core-name et index-core-dir de chaque fragment pour le processus de fragmentation automatique, ce qui entraîne un comportement imprévisible.

La liste suivante affiche les propriétés de fragmentation automatique.

Remarque : La fragmentation automatique est compatible avec la fragmentation verticale et la combinaison est recommandée.

Global.auto-shard

Indicateur pour fragmenter automatiquement. Dans HCL Commerce version 9.0.07+ cette propriété est activée par défaut.

Global.number-of-shards

Nombre de fragments en lesquels il faut diviser l'index. La plage de valeurs autorisée est de 1 à 26. Dans la version 9.0.0.7+, la valeur par défaut est 3.

Global.preprocessing-shard-entry-table

Table d'entrée ou vue du fragment. Si cette valeur n'est pas définie, la table CATENTRY est traitée comme table d'entrée par défaut.

Global.locale.unstructured-index-core-name

Nom à utiliser pour remplacer la valeur unstructured-index-core-name.

Global.locale.unstructured-index-core-dir

Répertoire à utiliser pour remplacer la valeur unstructured-index-core-dir.

Global.locale.structured-index-core-name

Nom à utiliser pour remplacer la valeur structured-index-core-name.

Global.locale.structured-index-core-dir

Si Global.auto-index est défini sur true, les configurations Global.locale… remplacent les configurations index-core-name et index-core-dirr de chaque fragment dans les propriétés du fragment vertical. locale est un paramètre régional pris en charge, par exemple en_US ou fr_FR. Les valeurs index-core-name et index-core-dir ci-dessus peuvent être automatiquement ajoutées avec le nom du fragment.

Par exemple, si le client définit la valeur number-of-shards sur 3 avec les configurations suivantes :

 Global.en_US.unstructured-index-core-name=MC_10001_CatalogEntry_Unstructured_en_US
Global.en_US.unstructured-index-core-dir=/search/index/solr/MC_10001/en_US/Unstructured
Global.en_US.structured-index-core-name=MC_10001_CatalogEntry_en_US
Global.en_US.structured-index-core-dir=/search/index/solr/MC_10001/en_US/CatalogEntry

Ensuite, les fragments A, B et C sont créés automatiquement. Pour l'indexation automatique, les valeurs sont les suivantes.

La valeur unstructured-index-core-name du fragment A est MC_10001_CatalogEntry_Unstructured_en_US_A. Sa valeur unstructured-index-core-dir est /search/index/solr/MC_10001/en_US/Unstructured_A/. Sa valeur structured-index-core-name est MC_10001_CatalogEntry_en_US_A, et sa valeur structured-index-core-dir est /search/index/solr/MC_10001/en_US/CatalogEntry_A/.
La valeur unstructured-index-core-name du fragment B est MC_10001_CatalogEntry_Unstructured_en_US_B. Sa valeur unstructured-index-core-dir est /search/index/solr/MC_10001/en_US/Unstructured_B/. Sa valeur structured-index-core-name est MC_10001_CatalogEntry_en_US_B, et sa valeur structured-index-core-dir est /search/index/solr/MC_10001/en_US/CatalogEntry_B/.
La valeur unstructured-index-core-name du fragment C est MC_10001_CatalogEntry_Unstructured_en_US_C. Sa valeur unstructured-index-core-dir est /search/index/solr/MC_10001/en_US/Unstructured_C/. Sa valeur structured-index-core-name est MC_10001_CatalogEntry_en_US_C, et sa valeur structured-index-core-dir est /search/index/solr/MC_10001/en_US/CatalogEntry_C/.

La liste suivante affiche les propriétés d'indexation globale :

Global.auto-index: Démarrez automatiquement l'indexation des fragments après leur prétraitement.
Global.create-core: Créez le noyau de fragment dans le fichier solr.xml, s'il n'existe pas.
Global.unload-core: Supprimez le noyau de fragment du fichier solr.xml, s'il n'existe pas.
Gloabl.index-status-Interval: L'intervalle de temps pour surveiller le processus d'indexation. La valeur par défaut est 10000.
Global.auto-merge-index: Fusionne automatiquement l'index dans le serveur principal une fois que toutes les indexations de fragments sont terminées.

Propriétés du serveur de recherche maître

Il n'y a généralement qu'un seul ensemble de propriétés principales. Elles commencent par le mot clé Master, suivi du mot clé common ou du nom du paramètre régional (par exemple, en_US), suivi du nom de la propriété, qui est séparé par un point.

Les propriétés principales doivent inclure au moins les propriétés spécifiques au maître. Seules les propriétés globales du serveur peuvent être remplacées dans les propriétés principales. Sinon, si elles ne sont pas redéfinies, les propriétés globales sont utilisées.

Remarque : Les propriétés suivantes utilisent les paramètres régionaux en_US avec des fragments A et C comme exemple. Configurez votre fichier de propriétés d'entrée de fragment en fonction des types de paramètres régionaux et fragments.

Master.en_US.structured-index-core-name
Master.en_US.unstructured-index-core-name: Les noyaux d'index maître où toutes les données de fragments sont fusionnées.

Propriétés des fragments horizontaux

Il existe généralement un ensemble de propriétés des fragments horizontaux pour chaque fragment horizontal. Les propriétés des fragments horizontaux commencent par le mot clé Shard, suivi du nom du fragment, suivi du nom du paramètre régional ou du mot clé common, suivi du nom de la propriété, tous séparés par des points.

Les propriétés des fragments horizontaux doivent inclure au moins les propriétés spécifiques des fragments horizontaux. Toutes les propriétés globales peuvent être remplacées dans le fragment horizontal, à l'exception de auto-merge-index. Si aucune propriété n'est redéfinie, les propriétés globales sont utilisées.

La liste suivante affiche les propriétés spécifiques aux fragments horizontaux, en utilisant le fragment A comme exemple :

Shard.A.common.preprocessing-dir: Le chemin d'accès aux fichiers XML de prétraitement dans le conteneur de l'utilitaire Docker HCL Commerce. Cette propriété est commune et ne peut pas être remplacée.
Shard.A.common.preprocessing-start-range-value
Shard.A.common.preprocessing-end-range-value: Les valeurs de début et de fin de la plage de fragments horizontaux.
Shard.A.common.configuration-type: Le type de fragment à configurer. Par exemple, horizontal ou vertical. Lorsqu'il existe une combinaison de types de fragments horizontaux et verticaux, cette propriété doit être définie comme telle. Dans ce cas, il s'agit d'un type horizontal.
Shard.A.en_US.unstructured-index-core-name
Shard.A.en_US.unstructured-index-core-dir
Shard.A.en_US.structured-index-core-name
Shard.A.en_US.structured-index-core-dir: Les noms et répertoires de base non structurés et structurés du fragment.

Propriétés des fragments verticaux

Il existe généralement un ensemble de propriétés des fragments verticaux pour chaque fragment vertical. Les propriétés des fragments verticaux commencent par le mot clé Shard, suivi du nom du fragment, du nom du paramètre régional ou du mot clé common, suivi du nom de la propriété, tous séparés par des points.

Les propriétés des fragments verticaux doivent inclure au moins les propriétés spécifiques des fragments verticaux. Seules les propriétés de prétraitement globales peuvent être remplacées dans le fragment vertical. Sinon, si elles ne sont pas redéfinies, les propriétés globales sont utilisées.

La liste suivante affiche les propriétés spécifiques aux fragments verticaux, en utilisant le fragment V comme exemple :

Shard.V.common.preprocessing-dir: Le chemin d'accès aux fichiers XML de prétraitement dans le conteneur de l'utilitaire Docker HCL Commerce. Cette propriété est commune et ne peut pas être remplacée.
Shard.V.common.configuration-type: Le type de fragment à configurer. Par exemple, horizontal ou vertical. Lorsqu'il existe une combinaison de types de fragments horizontaux et verticaux, cette propriété doit être définie comme telle. Dans ce cas, vertical.

Remplacement des propriétés

Pour remplacer un fragment ou une propriété globale principale, utilisez la convention suivante pour procéder à un remplacement au niveau commun :


Master.common.index-server-name=localhost
Shard.A.common.index-server-name=localhost

Pour remplacer un fragment ou une propriété globale principale, utilisez la convention suivante pour procéder à un remplacement au niveau des paramètres régionaux :


Master.en_US.index-server-name=localhost
Shard.A.en_US.index-server-name=localhost

Exemples de fichiers de propriétés

L'image de l'utilitaire Docker contient deux exemples de fichiers de propriétés. L'exemple de fichier di-parallel-process.properties utilise les paramètres régionaux en_US avec des fragments A, B et C. Ces définitions de fragments sont commentées en faveur de la fragmentation automatique, mais ont été conservées comme exemples parce que le fragment manuel est toujours pris en charge.

Vous pouvez trouver les fichiers exemple 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.