La migration de vos données et configurations de la version 1.5 à la version 1.6 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.5 et de créer un nouveau dossier dans lequel vous rapatrierez les sources de la version 1.6. C'est depuis ce dossier que vous lancerez les différentes procédures.

Conservation des données

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.5.

Sauvegarde avant migration

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.5 avant de lancer l'installation de la version 1.6 et la mise à jour des données.

ORI-OAI-repository

La structure des fichiers de configuration n'a pas changé dans cette version !
Si vous aviez personnalisé ORI-OAI-repository 1.5, vous avez le choix entre :

mettre à jour en utilisant la commande svn "switch" (voir "Exploitation d'applications avec subversion") ;
installer ORI-OAI-repository 1.6 et reporter manuellement vos configurations de la 1.5 sur la 1.6.

ORI-OAI-vocabulary

La structure des fichiers de configuration n'a pas changé dans cette version !
Si vous aviez défini des vocabulaires dynamiques (dossier properties/domain/) ou des vocabulaires statiques (dossier properties/ori_vocabularies/override/) dans ORI-OAI-vocabulary 1.5, vous avez le choix entre :

mettre à jour en utilisant la commande svn "switch" (voir "Exploitation d'applications avec subversion") ;
installer ORI-OAI-vocabulary 1.6 et reporter manuellement vos configurations de la 1.5 sur la 1.6.

ORI-OAI-indexing

La structure des fichiers de configuration n'a pas changé dans cette version !
Si vous aviez personnalisé ORI-OAI-indexing 1.5, vous avez le choix entre :

mettre à jour en utilisant la commande svn "switch" (voir "Exploitation d'applications avec subversion") ;
installer ORI-OAI-indexing 1.6 et reporter manuellement vos configurations de la 1.5 sur la 1.6.

Par contre, le format de l'index a changé dans la version 1.6 !
Il est donc nécessaire de supprimer l'index et de relancer une restauration depuis les autres modules.
La suppression de l'index se fait depuis ORI-OAI-quick-install via la tâche :

ant init-indexing

Pour la restauration de l'index, vous trouverez plus d'information ici .

ORI-OAI-search

La structure des fichiers de configuration n'a pas changé dans cette version !
Si vous aviez créé vos propres contributions de recherche (dossier conf/properties/search/contrib_xxx/) ou de look (dossier conf/properties/skins/contrib_xxx/), vous avez le choix entre :

mettre à jour en utilisant la commande svn "switch" (voir "Exploitation d'applications avec subversion") ;
installer ORI-OAI-search 1.6 et recopier vos contributions (dossiers contrib_xxx/) de la 1.5 sur la 1.6.

ORI-OAI-harvester

La structure de la base de données de ce module a évolué pour offrir plus de services à l'utilisateur. Il est donc nécessaire de mettre à jour votre base.

Il faut renseigner la propriété HARVESTER_UPGRADE_PREVIOUS_VERSION du fichier commons-parameters.properties avec la valeur 1.5.0 pour que la tâche ant upgrade-harvester fonctionne correctement, sans quoi la mise à jour de la base de donnée n'operera pas :

# Numero de la version depuis laquelle une migration doit etre faite
HARVESTER_UPGRADE_PREVIOUS_VERSION=1.5.0

Ceci fait, lancez les tâches suivantes depuis ORI-OAI-quick-install :

ant init-build-harvester

ant upgrade-harvester

La commande ant upgrade-harvester délivre les informations dans la console qui doivent ressembler à ce qui suit :

 [input] Warning. You're going to upgrade ORI-OAI-Harvester database from 1.5.0 to 1.6.0. You should backup your database before performing changes.  (y, n)
y
     [java] upgrade
     [echo] upgrade sucessfull

upgrade-db-data:
     [java] fromVersion=1.5.0
     [java] toVersion=1.6.0
     [java] fromVersion=1.5.0
     [java] toVersion=1.6.0
     [java] oriharvester: 0 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:120)  - migrating config INP Toulouse Theses to SQL database
     [java]  oriharvester: 84 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:129)  - migrate ok for INP Toulouse Theses
     [java]  oriharvester: 84 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:120)  - migrating config le serveur des th&#xE8;ses en ligne de l'INSA de Toulouse to SQL database
     [java]  oriharvester: 118 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:129)  - migrate ok for le serveur des th&#xE8;ses en ligne de l'INSA de Toulouse
     [java]  oriharvester: 121 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:120)  - migrating config oatao to SQL database
     [java]  oriharvester: 299 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:129)  - migrate ok for oatao
     [java]  oriharvester: 300 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:120)  - migrating config thesesups to SQL database
     [java]  oriharvester: 345 org.orioai.harvesting.domain.service.MigrationService.migrate15to16(MigrationService.java:129)  - migrate ok for thesesups
     [java]  oriharvester: 26147 org.orioai.harvesting.domain.service.MigrationService.migrate(MigrationService.java:110)  - migration achieved from 1.5.0 to 1.6.0
     [java]

Note : en fonction du nombre de fiches que vous avez moissonnées, cette tâche peut durer assez longtemps (jusqu'à plusieurs minutes).

Suppression des récoltes

Cette mise à jour de la base de données supprime automatiquement vos précédentes récoltes. Vous gardez en revanche les définitions précédemment enregistrées en version 1.5.
Vous devrez donc relancer vos moissons (manuellement ou par programmation) afin de récupérer toutes les fiches. Cette moisson devra se faire après l'étape de réinitialisation de l'index de ORI-OAI-indexing décrite précédemment. Vous trouverez plus d'information sur la gestion de l'index ici.

ORI-OAI-workflow et ORI-OAI-md-editor

Ces 2 modules sont ceux qui ont le plus été modifiés en version 1.6.
En effet, afin d'offrir plus de souplesse de configuration et permettre les échanges faciles de personnalisation ou encore une transposition simple des configurations d'une version à l'autre, l'arborescence des dossiers et fichiers de configuration a été retouchée.

Contrairement aux précédentes versions, TOUS les fichiers de configuration propres à un workflow ont été regroupés dans un seul répertoire, spécifique. Même chose pour les fichiers de configuration d'un formulaire donné. Il devient donc plus aisé de créer son propre workflow ou d'en modifier un. En revanche, vous devrez transposer manuellement vos précédentes configurations dans ce nouveau format.

Le passage de la 1.5 à la 1.6 (ORI-OAI-workflow et ORI-OAI-md-editor) sera un peu coûteux par rapport aux autres versions, mais vous vous rendrez vite compte que la configuration se fait et se maintiendra plus simplement.

ORI-OAI-workflow

Pour configurer vos workflows en version 1.6 et créer vos propres contributions, reportez-vous à la documentation du module ou à la rubrique Ajouter une étape au Workflow.

Si vous aviez personnalisé ORI-OAI-workflow 1.5, la première étape consiste à reporter manuellement vos configurations de la 1.5 sur la 1.6. Vous pouvez vous reporter à la documentation suivante pour plus de précision.

Une fois votre contribution correctement définie en 1.6, vous pouvez procéder à l'étape suivante : la migration de vos données.
En effet, comme des paramètres du workflow ont changé entre la version 1.5 et la version 1.6 (noms de workflows, de type de métadonnées ; syntaxe de description des rôles et permissions), il est nécessaire de construire une table de correspondance entre les anciens et les nouveaux paramètres.
Reportez-vous à la documentation spécifique suivante avant de lancer la tâche qui mettra à jour vos données en base :

ant upgrade-workflow

Une fois la mise à jour faite, vous constaterez que vos données ont correctement été migrées et qu'elles sont à nouveau disponibles dans l'IHM du module.

Il ne vous reste plus qu'à réindexer toutes vos fiches en état publié vers le module ORI-OAI-indexing via le bouton "Réindexer tout" en mode Administrateur.
Vous trouverez plus d'information ici.

ORI-OAI-md-editor

Pour configurer vos éditeurs en version 1.6 et créer vos propres contributions, reportez-vous à la documentation du module ou à la rubrique Ajouter une métadonnée dans ORI-OAI

La version 1.6 de ORI-OAI-md-editor offre aussi la possibilité de configurer chaque formulaire dans un répertoire spécifique.

Si vous aviez personnalisé ORI-OAI-md-editor 1.5, le travail consiste à reporter manuellement vos configurations de la 1.5 sur la 1.6, en vous basant sur la nouvelle architecture du module, et sur la procédure de migration proposée .

Migration de la version 1.5 à 1.6