Indexing - Configuration avancée

1ère étape : préparer la configuration

Depuis le module ORI-OAI-quick-install, lancez la commande suivante :

ant init-config-indexing

Ceci va créer l'arborescence des dossiers et fichiers servant à personnaliser le module dans le dossier [PATH_CUSTOM_CONFIG]/ori-oai-indexing.

Attention

C'est au sein de ce dossier, et uniquement dans ce dossier que vous devrez personnaliser le module.

Le dossier a été créé avec les propriétés et les fichiers de configuration couramment modifiés par les exploitants. Si d'autres fichiers devaient être modifiés pour une configuration encore plus poussée, il suffit de copier le fichier de configuration d'origine depuis les sources du module vers le dossier config en respectant la même arborescence. Lors du déploiement, le fichier du dossier [PATH_CUSTOM_CONFIG] écrasera celui fourni par défaut dans les sources.

Structure du dossier [PATH_CUSTOM_CONFIG]/ori-oai-indexing

Depuis la version 2.0 de ORI-OAI, toutes les configurations et la personnalisation se font depuis le dossier [PATH_CUSTOM_CONFIG] (avec 1 sous-dossier par module).
Voyons la structure du module qui nous concerne ici :

  • ori-oai-indexing
    • config : dans ce dossier sont placés les fichiers de configuration à surcharger de la configuration par défaut (Exemples : configIndexing.xml, fieldsConfig.xml)
      • custom-config.properties : permet de définir les propriétés modifiables par l'exploitant
      • properties : dans ce dossier sont placés les fichiers de configuration à surcharger de la configuration par défaut
      • solr_home
        • prod-public
          • conf : c'est dans ce dossier qu'il est nécessaire de recopier le fichier schema.xml fourni par défaut pour modifier les champs de l'index SOLR
      • xsl : c'est ici que l'on peut surcharger les XSL fournies par défaut servant par exemple à générer le format RIS
    • webapp
      • css : dossier permettant de surcharger les CSS fournies par défaut dans le module
      • media : images nécessaires à l'affichage
      • views : pour une personnalisation plus poussée, vous pouvez surcharger ici les fichiers JSP servant à générer l'interface web

 

Configurations avancées

Recopie des fichiers de configuration

Pour procéder à la configuration avancée, il sera nécessaire de modifier potentiellement ces fichiers :

  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing/config/custom-config.properties
  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing/config/configIndexing.xml
  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing/config/fieldsConfig.xml
  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing/config/solr_home/prod-public/conf/schema.xml
  • [PATH_CUSTOM_CONFIG]/ori-oai-indexing/config/properties/cache/ehcache.xml

Par défaut, lors de l'initialisation de la configuration, seul le fichier custom-config.properties est présent. Les autres fichiers doivent être recopiés manuellement depuis les sources du module vers le dossier cité ci-dessus.
Une fois le fichier recopié, vous pourrez le modifier et redéployer le module. Le fichier présent dans [PATH_CUSTOM_CONFIG]/ori-oai-indexing sera alors prioritaire sur celui fourni par défaut et votre configuration tiendra compte de vos modifications.

Les fichiers sont à recopier à partir des dossiers suivants en fonction du fichier :

  • configIndexing.xml : [ORI_HOME]/src/ori-oai-indexing-svn/indexingCore/src/main/resources/configIndexing.xml
  • fieldsConfig.xml : [ORI_HOME]/src/ori-oai-indexing-svn/indexingCore/src/main/resources/fieldsConfig.xml
  • schema.xml : [ORI_HOME]/src/ori-oai-indexing-svn/indexingCore/src/main/resources/solr_home/prod-public/conf/schema.xml
  • ehcache.xml : [ORI_HOME]/src/ori-oai-indexing-svn/indexingCore/src/main/resources/properties/cache/ehcache.xml

Voici les différentes étapes par lesquelles passe la configuration avancée du module :

  • No labels