Exécution du chargement initial et actualisation de l'index et des données sur le serveur de recherche

Cet article contient les rubriques suivantes :
casm173
Cet article contient les rubriques suivantes :
Configuration des objets
Avant d’effectuer le chargement initial ou d'actualiser les données et l'index sur le serveur de recherche, vous pouvez configurer les objets que vous souhaitez charger ou actualiser. La recherche prend actuellement en charge les objets suivants :
  • cnt
    (utilisateurs)
  • kd
    (document de connaissance)
  • nr
    (éléments de configuration)
  • cr
    (incidents et demandes)
  • kdlinks
    (solutions suggérées)
  • pcat
    (catégorie)
  • service_offering
  • service_request
Par défaut, la valeur
dataload_limit
est définie sur un an. Vous pouvez utiliser ce paramètre pour limiter les données de chargement initial à un nombre d'années spécifique.
Par défaut, tous ces objets sont configurés.
Vous ne pouvez pas ajouter d'objets nouveaux ou personnalisés autres que les huit objets actuellement pris en charge par la recherche.
Procédez comme suit :
  1. En tant qu’administrateur, connectez-vous au serveur de recherche, accédez au dossier
    <es_install>\config
    et modifiez le fichier
    config.yml
    .
  2. Dans la propriété sdm_index, supprimez l'objet que vous ne souhaitez pas configurer :
    • cnt
    • kd
    • nr
    • cr
    • kdlinks
    • pcat
    Par exemple, si vous souhaitez effectuer le chargement initial uniquement pour les tickets (cr) et les utilisateurs (cnt), vous pouvez définir la valeur
    sdm_index
    comme suit :
    objects:
    sdm_index: cnt, cr
    #Limit the initial load to number of years
    dataload_limit: 1y
  3. Dans la propriété catalog_index, supprimez l'objet que vous ne souhaitez pas configurer :
    • serive_offering
    • service_request
  4. Par défaut, la valeur
    dataload_limit
    est définie sur un an. Vous pouvez utiliser ce paramètre pour limiter les données de chargement initial à un nombre d'années spécifique.
    dataload_limit: 1y
  5. Enregistrez et fermez le fichier, puis effectuez le chargement initial.
Vérification des données
Exécutez la requête sur la base de données MDB pour vérifier les données :
  • Oracle
    :
    select * from usm_offering where (date_available <= to_date('1901-12-13','yyyy-mm-dd')
    or date_available >= to_date('2038-01-19','yyyy-mm-dd'))
    or (date_unavailable <= to_date('1901-12-13','yyyy-mm-dd')
    or date_unavailable >= to_date('2038-01-19','yyyy-mm-dd'))
    or (date_cancelled <= to_date('1901-12-13','yyyy-mm-dd')
    or date_cancelled >= to_date('2038-01-19','yyyy-mm-dd'))
  • SQL
    :
    select * from usm_offering where (date_available <= CONVERT(DATETIME, '1901-12-13', 102)
    or date_available >= CONVERT(DATETIME, '2038-01-19', 102))
    or (date_unavailable <= CONVERT(DATETIME, '1901-12-13', 102)
    or date_unavailable >= CONVERT(DATETIME, '2038-01-19', 102))
    or (date_cancelled <= CONVERT(DATETIME, '1901-12-13', 102)
    or date_cancelled >= CONVERT(DATETIME, '2038-01-19', 102))
    Nous vous recommandons de mettre à jour les données et d'exécuter l'index de reconstruction si la requête renvoie des résultats.
Exécution du chargement initial sur le serveur de recherche
Le chargement initial est une activité généralement effectuée lors de l'installation du serveur de recherche à l’aide du programme d’installation. Le chargement initial prépare le serveur de recherche avec les données et l'index importés à partir de la base de données CA SDM et CA Service Catalog qui est utilisée par la fonctionnalité de recherche dans l'
Interface xFlow
.
Nous vous recommandons d’effectuer la tâche de chargement initial pendant les heures creuses, car cela affecte les performances du serveur CA SDM.
Si vous effectuez l’action de chargement initial après l’installation, exécutez l'un des fichiers en fonction de votre système d’exploitation :
  • $ES_HOME/search/bin/pdm_es_initial_load.bat (Windows)
  • $ES_HOME/search/bin/pdm_es_initial_load.sh (Linux)
Ce fichier permet de créer un index et de charger les données dans le serveur de recherche.
Lorsque vous exécutez le fichier à partir de l’invite de commande, vous pouvez utiliser les options suivantes :
  • $ES_HOME/search/bin/pdm_es_initial_load.bat [v, V] [h, help] (Windows)
  • $ES_HOME/search/bin/pdm_es_initial_load.sh [v, V] [h, help] (Linux)
Où,
v, V
: cette option affiche la version du chargement de données. Vous pouvez utiliser l'option de votre choix avec le fichier de commandes.
h, help
: cette option affiche l’aide dans le fichier de commandes. Vous pouvez utiliser l'option de votre choix avec le fichier de commandes.
Pour effectuer le chargement initial dans un index spécifique sous Windows, exécutez la commande
$ES_HOME/search/bin/pdm_es_initial_load.bat index=<nom_index>
.
Par exemple, pour effectuer le chargement initial dans
sdm_index
, exécutez la commande
$ES_HOME/search/bin/pdm_es_initial_load.bat index=sdm_index
.
Actualisation de l'index et des données sur le serveur de recherche
Scénarios typiques d'actualisation des données et de l'index :
  • Exécution de la commande
    pdm_load
    pour des données d'utilisateurs, d'actifs, de base de connaissances ou de tickets (incidents et demandes)
  • Actualisation des modifications apportées aux objets dépendants tels qu'un emplacement ou le nom de classe d'un actif
  • Activation ou désactivation de l’hébergement multiclient
Si vous décidez d'exécuter le chargement initial pendant la configuration des détails du serveur de recherche à partir du programme d'installation commun, la commande pdm_es_rebuild est exécutée par défaut. Lorsque le chargement initial n'est pas activé lors de la configuration des détails du serveur de recherche, vous devez exécuter manuellement la commande
pdm_es_rebuild
.
  • $ES_HOME/search/bin/pdm_es_rebuild_index.bat (Windows)
  • $ES_HOME/search/bin/pdm_es_rebuild_index.sh (Linux)
Lorsque vous exécutez le fichier de commandes à partir de l’invite de commande, vous pouvez utiliser les options suivantes :
  • $ES_HOME/search/bin/pdm_es_rebuild_index.bat [v, V] [h, help] (Windows)
  • $ES_HOME/search/bin/pdm_es_rebuild_index.sh [v, V] [h, help] (Linux)
Où,
v, V
: vous pouvez utiliser l'option de votre choix avec le fichier. Cette option affiche la version du chargement de données.
h, help
: vous pouvez utiliser l'option de votre choix avec le fichier. Cette option affiche l’aide dans le fichier.
Pour actualiser un index spécifique sous Windows, exécutez la commande
$ES_HOME/search/bin/pdm_es_rebuild_index.bat index
=<nom_index>
.
Par exemple, pour actualiser l'index
catalog_index
, exécutez la commande
$ES_HOME/search/bin/pdm_es_rebuild_index.bat index=catalog_index
.
Pour charger les offres de services spécifiques locales, exécutez la commande
$ES_HOME/search/bin/pdm_es_rebuild_index locale=local_name
.
Par exemple, pour charger les données des offres de services en japonais, exécutez la commande
$ES_HOME/search/bin/pdm_es_rebuild_index locale=ja_JP
.
Actualisation des mots intelligents pour la barre de commandes dans le serveur de recherche
Les mots intelligents créés dans CA SDM ne sont pas automatiquement mis à jour dans le serveur de recherche. Par conséquent, lorsque vous saisissez un nouveau mot intelligent dans la barre de commandes, les catégories et modèles associés ne s’affichent pas, car le serveur de recherche n’est pas mis à jour avec les derniers mots intelligents.
Nous vous recommandons de planifier une réindexation à intervalles réguliers afin de conserver les derniers mots intelligents et les catégories et modèles associés dans le serveur de recherche.
Planification d'une actualisation sous Windows
L’exemple dans la procédure suivante permet de planifier l’actualisation une fois par semaine.
Procédez comme suit :
  1. Dans le menu
    Démarrer
    sur le serveur
    CA Search Server
    , ouvrez le
    planificateur de tâches Windows
    .
  2. Par exemple, sous Windows Server 2012, sélectionnez
    Panneau de configuration
    ,
    Système et sécurité
    ,
    Outils d'administration
    ,
    Planificateur de tâches
    .
  3. Cliquez sur
    Créer une tâche
    .
  4. Dans l'onglet
    Général
    , entrez un nom pour la tâche.
    • Cochez la case
      Exécuter
      même si aucun utilisateur n’a ouvert de session.
  5. Accédez à l’onglet
    Actions
    et cliquez sur
    Nouveau
    .
    • Dans le champ
      Action
      , sélectionnez
      Démarrer
      un programme.
    • Dans le champ
      Programme/script
      , saisissez le nom du script d’exécution comme
      pdm_es_rebuild_index.bat = sdm_autocat_index
      .
    • Dans le champ
      Commencer dans (facultatif)
      , définissez le chemin d’accès racine du script
      pdm_es_rebuild_index.bat index=sdm_autocat_index
      et cliquez sur
      OK
      .
      Par exemple : C:\es\bin\
  6. Accédez à l'onglet
    Déclencheurs
    et cliquez sur
    Nouveau
    .
    • Dans le champ
      Paramètres
      , sélectionnez
      Hebdomadaire
      .
    • Dans le champ
      Démarrer
      , sélectionnez
      12:00:00 AM
      .
    • Dans le champ
      Fréquence de récurrence
      , saisissez
      1
      et sélectionnez un jour dans la liste, puis cliquez sur
      OK
      .
  7. Dans la boîte de dialogue
    Créer une tâche
    , cliquez sur
    OK
    .
    Vous avez terminé la planification de tâches Windows pour actualiser l’index de catégorisation automatique.
Planification d'une réindexation sous des environnements autres que Windows
Définissez un job cron pour planifier une réindexation sous Linux.
Condition préalable
Activez l’autorisation d’exécution pour l’utilisateur exécutant le script de réindexation.
Procédez comme suit :
  1. En tant qu’administrateur, connectez-vous au serveur de recherche.
  2. Accédez au dossier
    <installation_serveur_recherche>
    /search/bin.
  3. Exécutez la commande suivante pour ouvrir le fichier de job cron et le modifier.
    crontab –e
  4. Définissez la planification du job cron.
    Crontab job scheduling pattern:
    # Minute Hour Day of Month Month Day of Week Command
    # (0-59) (0-23) (1-31) (1-12 or Jan-Dec) (0-6 or Sun-Sat) path_to_script
    Cron job command examples:
    # execute every minute
    * * * * * cd /root/<search_server>/search/bin && ./pdm_es_rebuild_index.sh index=sdm_autocat_index
    # execute every 5 minutes
    */5 * * * * cd /root/<search_server>/search/bin && ./pdm_es_rebuild_index.sh index=sdm_autocat_index
    # execute every Friday 1AM
    0 1 * * 5 cd /root/<search_server>/search/bin && ./pdm_es_rebuild_index.sh index=sdm_autocat_index
    # execute on workdays 1AM
    0 1 * * 1-5 cd /root/<search_server>/search/bin && ./pdm_es_rebuild_index.sh index=sdm_autocat_index
    # execute 10 past after every hour on the 1st of every month
    10 * 1 * * cd /root/<search_server>/search/bin && ./pdm_es_rebuild_index.sh index=sdm_autocat_index
    Vous pouvez définir un job cron basé sur le modèle de planification ou activer le job cron à partir des exemples.
  5. Enregistrez et fermez le fichier.
    Pour afficher le job cron, exécutez la commande suivante:
    $ crontab -l
    .
select * from usm_offering where (date_available <= to_date('1901-12-13','yyyy-mm-dd') or date_available >= to_date('2038-01-19','yyyy-mm-dd')) or (date_unavailable <= to_date('1901-12-13','yyyy-mm-dd') or date_unavailable >= to_date('2038-01-19','yyyy-mm-dd')) or (date_cancelled <= to_date('1901-12-13','yyyy-mm-dd') or date_cancelled >= to_date('2038-01-19','yyyy-mm-dd'))