Skip to end of metadata
Go to start of metadata

La migration de vos données et configurations de la version 1.7 à la version 2.0 touche plusieurs modules. Vous trouverez ici tous les éléments essentiels vous permettant de comprendre comment doit se dérouler la migration.

Toutefois, n'hésitez pas à consulter la documentation de chaque module pour avoir plus d'information.

Nous vous conseillons de conserver les sources de vos modules en version 1.7 et de créer un nouveau dossier dans lequel vous rapatrierez les sources de la version 2.0. C'est depuis ce dossier que vous lancerez les différentes procédures.

Conservation des données

Icon

Si vous souhaitez conserver les données de votre précédente version de ORI-OAI-workflow ou ORI-OAI-harvester, la base de données renseignée dans commons-parameters.properties doit être impérativement la même qu'en version 1.7.

Sauvegarde avant migration

Icon

Une migration n'est pas infaillible. Prenez bien soin de sauvegarder vos différentes bases de données et sources de vos configurations de ORI-OAI version 1.7 avant de lancer l'installation de la version 2.0 et la mise à jour des données.

Disparition de la tâche init-build

Icon

En version 1.x de ORI-OAI, il était nécessaire d'appeler la tâche ANT init-build-x après chaque modification du fichier commons-parameters.properties.
Cette tâche est devenue optionnelle car appelée automatiquement lors des tâches init, upgrade, all ...


Évolutions en version 2.0 de ORI-OAI :

Quels modules en version 2.0 ?

Le développement de la version 2.0 est encore en cours. Tous les modules n'ont pas été encore finalisés, mais pour proposer à la communauté le travail déjà abouti et disponible, nous avons réalisé cette version qui comporte certains modules en v2 et d'autres en v1.8.
Les modules en version 2.0 finale sont :

  • ORI-OAI-indexing
  • ORI-OAI-vocabulary
  • ORI-OAI-search
  • ORI-OAI-harvester
  • ORI-OAI-repository

Les autres modules sont pour le moment en version 1.8. Ce sont donc exactement les mêmes versions qu'en 1.7 avec un portage technique permettant de les faire communiquer avec les modules proposés en v2.

Personnalisation et configuration avancée dans ORI-OAI 2.0

Une évolution majeure en v2 de ORI-OAI, c'est la procédure de paramétrage et de customisation des interfaces. Contrairement aux précédentes versions, les modifications ne sont plus à faire dans les sources des modules, mais dans un dossier dédié : [PATH_CUSTOM_CONFIG].
Lors de l'initialisation des modules, l'arborescence des configurations est automatiquement créé. Il faut alors simplement copier les fichiers originaux à partir des sources des modules vers le dossier [PATH_CUSTOM_CONFIG].
Lors du déploiement, les fichiers que vous avez recopié et modifiés écraseront ceux proposés par défaut dans le module.

Aussi, le fichier init-build.properties présent à la racine de chaque module en v1 a disparu. Il n'existe maintenant qu'un seul fichier build.properties.

Gestion des logs en v2

Pour simplifier la gestion et la consultation des logs, tous les fichiers ont été centralisés dans un même dossier : [PATH_LOGS]
Tous les logs des modules passés en v2 sont disponibles dans ce dossier. Pour rappel, dans les versions 1.x de ORI-OAI, ces fichiers étaient stockés dans le dossier "logs" du Tomcat.

Modifications dans les modules

ORI-OAI-repository 2.0

La configuration n'a pas changé dans cette version !
Mais comme signalé ci-haut, les personnalisations que vous aviez apportées en 1.7 sont à reporter dans le dossier [PATH_CUSTOM_CONFIG] pour ne plus modifier les sources.

Aussi, les paramètres modifiés dans le fichier main-config.properties sont à copier dans le fichier custom-config.properties qui lui-même est présent dans le dossier [PATH_CUSTOM_CONFIG].

ORI-OAI-vocabulary 2.0

La configuration existante n'a pas changé dans cette version !
Mais comme signalé ci-haut, les personnalisations que vous aviez apportées en 1.7 sont à reporter dans le dossier [PATH_CUSTOM_CONFIG] pour ne plus modifier les sources.

  • Si vous aviez défini des vocabulaires dynamiques (dossier properties/domain/ en 1.7), ils sont à reporter dans les fichiers [PATH_CUSTOM_CONFIG]/ori-oai-vocabulary/config/properties/dynamic-vocabularies/custom-*.xml
  • ou des vocabulaires statiques (dossier properties/ori_vocabularies/override/ en 1.7), ils sont à reporter dans le dossier [PATH_CUSTOM_CONFIG]/ori-oai-vocabulary/config/properties/static-vocabularies/override/

Aussi, les paramètres modifiés dans le fichier main-config.properties sont à copier dans le fichier custom-config.properties qui lui-même est présent dans le dossier [PATH_CUSTOM_CONFIG].

ORI-OAI-indexing 2.0

Le module ORI-OAI-indexing a complètement été ré-écrit en v2. Il s'appuie maintenant sur le moteur d'indexation SOLR.
Les configurations ont donc changé, il est donc impératif de consulter la documentation du module pour reporter les personnalisations des versions 1.x vers la 2.0.

Aussi, en plus du stockage sur disque d'un index Lucene, le module stocke maintenant des données dans une base SQL.

ORI-OAI-search 2.0

La structure des fichiers de configuration n'a pas changé dans cette version !

Cependant, étant données toutes les nouvelles fonctionnalités proposées en v2, la manière de configurer ces fichiers a évolué. Il est donc impératif de repartir d'une configuration proposée en v2 pour l'adapter en fonction des besoins et se rapprocher des customisations faites en v1.x.

Comme signalé ci-haut, les personnalisations sont à reporter dans le dossier [PATH_CUSTOM_CONFIG]/ori-oai-search pour ne plus modifier les sources.

ORI-OAI-harvester 2.0

La configuration existante n'a pas changé dans cette version !
Aussi, les paramètres modifiés dans le fichier main-config.properties sont à copier dans le fichier custom-config.properties qui lui-même est présent dans le dossier [PATH_CUSTOM_CONFIG].

La base de données a subit une modification du nom de toutes les tables. Aussi, aucun script de migration n'a été prévu.
Il est donc IMPÉRATIF de repartir sur une base de données vierge et de recréer toutes les définitions de moissons et de remoissonner tous les entrepôts.

ORI-OAI-workflow 1.8

Ce module est pour le moment en version 1.8. C'est exactement la même version qu'en 1.7 avec un portage technique permettant de le faire communiquer avec les modules proposés en v2.

La version de l'application stockée en base doit être mise à jour. Il est donc nécessaire de lancer la tâche suivante depuis ORI-OAI-quick-install :

ant upgrade-workflow

Pour la documentation, reportez-vous à la version 1.7.
Note : si vous avez des erreurs sur des fichiers ...-blank.xml, vérifiez que vous avez bien copié le fichier blank dans votre workflow personnalisé.

ORI-OAI-md-editor 1.8

Ce module est pour le moment en version 1.8. C'est exactement la même version qu'en 1.7 avec un portage technique permettant de le faire communiquer avec les modules proposés en v2.
Pour la documentation, reportez-vous à la version 1.7.

  • No labels