Date: Fri, 29 Mar 2024 12:19:16 +0100 (CET) Message-ID: <656709542.39.1711711156626@orioai-1.uphf.fr> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_38_2033211898.1711711156625" ------=_Part_38_2033211898.1711711156625 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
La migration de vos donn=C3=A9es et configurations de la version= 1.5 =C3=A0 la version 1.6 touche plusieurs modules. Vous trouverez ici tou= s les =C3=A9l=C3=A9ments essentiels vous permettant de comprendre comment d= oit se d=C3=A9rouler la migration.
Toutefois, n'h=C3=A9sitez pas =C3=A0 consulter la documentation de chaque module pour a= voir plus d'information.
Nous vous conseillons de conserver les sources de vos modules en version= 1.5 et de cr=C3=A9er un nouveau dossier dans lequel vous rapatrierez les s= ources de la version 1.6. C'est depuis ce dossier que vous lancerez les dif= f=C3=A9rentes proc=C3=A9dures.
Conservation des donn=C3=A9es
Si vous souhaitez conserver les donn=C3=A9es de votre pr=C3=A9c=C3=A9den= te version de ORI-OAI-workflow ou ORI-OAI-harvester, la base de donn=C3=A9e= s renseign=C3=A9e dans commons-parameters.properties doit =C3=AAtre imp=C3= =A9rativement la m=C3=AAme qu'en version 1.5.
Sauvegarde avant migration
Une migration n'est pas infaillible. Prenez bien soin de sauvegarder vos= diff=C3=A9rentes bases de donn=C3=A9es et sources de vos configurations de= ORI-OAI version 1.5 avant de lancer l'installation de la version 1.6 et la= mise =C3=A0 jour des donn=C3=A9es.
La structure des fichiers de configuration n'a pas chang=C3=A9 dans cett=
e version !
Si vous aviez personnalis=C3=A9 ORI-OAI-repository 1.5, vous avez le choix=
entre :
La structure des fichiers de configuration n'a pas chang=C3=A9 dans cett=
e version !
Si vous aviez d=C3=A9fini des vocabulaires dynamiques (dossier pro=
perties/domain/) ou des vocabulaires statiques (dossier pr=
operties/ori_vocabularies/override/) dans ORI-OAI-vocabulary 1.5, =
vous avez le choix entre :
La structure des fichiers de configuration n'a pas chang=C3=A9 dans cett=
e version !
Si vous aviez personnalis=C3=A9 ORI-OAI-indexing 1.5, vous avez le choix e=
ntre :
Par contre, le format de l'index a chang=C3=A9 dans la version 1.6 !
Il est donc n=C3=A9cessaire de supprimer l'index et de relancer une restau=
ration depuis les autres modules.
La suppression de l'index se fait depuis ORI-OAI-quick-install via la t=C3=
=A2che :
ant init-indexing
Pour la restauration de l'index, vous trouverez plus d'information ici .
La structure des fichiers de configuration n'a pas chang=C3=A9 dans cett=
e version !
Si vous aviez cr=C3=A9=C3=A9 vos propres contributions de recherche (dossi=
er conf/properties/search/contrib_xxx/) ou de look (dossie=
r conf/properties/skins/contrib_xxx/), vous avez le choix =
entre :
La structure de la base de donn=C3=A9es de ce module a =C3=A9volu=C3=A9 = pour offrir plus de services =C3=A0 l'utilisateur. Il est donc n=C3=A9cessa= ire de mettre =C3=A0 jour votre base.
Il faut renseigner la propri=C3=A9t=C3=A9 HARVESTER_UPGRADE_PREVIOUS_VER= SION du fichier commons-parameters.properties avec la valeur 1.5.0= pour que la t=C3=A2che ant upgrade-harvester fonctionne c= orrectement, sans quoi la mise =C3=A0 jour de la base de donn=C3=A9e n'oper= era pas :
# Numer= o de la version depuis laquelle une migration doit etre faite HARVESTER_UPGRADE_PREVIOUS_VERSION=3D1.5.0
Ceci fait, lancez les t=C3=A2ches suivantes depuis ORI-OAI-quick-install= :
ant init-build-harvester
ant upgrade-harvester
La commande ant upgrade-harvester d=C3=A9livre les info= rmations dans la console qui doivent ressembler =C3=A0 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=3D1.5.0 [java] toVersion=3D1.6.0 [java] fromVersion=3D1.5.0 [java] toVersion=3D1.6.0 [java] oriharvester: 0 org.orioai.harvesting.domain.service.MigrationS= ervice.migrate15to16(MigrationService.java:120) - migrating config INP Tou= louse Theses to SQL database [java] oriharvester: 84 org.orioai.harvesting.domain.service.Migratio= nService.migrate15to16(MigrationService.java:129) - migrate ok for INP Tou= louse Theses [java] oriharvester: 84 org.orioai.harvesting.domain.service.Migratio= nService.migrate15to16(MigrationService.java:120) - migrating config le se= rveur des thèses en ligne de l'INSA de Toulouse to SQL database [java] oriharvester: 118 org.orioai.harvesting.domain.service.Migrati= onService.migrate15to16(MigrationService.java:129) - migrate ok for le ser= veur des thèses en ligne de l'INSA de Toulouse [java] oriharvester: 121 org.orioai.harvesting.domain.service.Migrati= onService.migrate15to16(MigrationService.java:120) - migrating config oata= o to SQL database [java] oriharvester: 299 org.orioai.harvesting.domain.service.Migrati= onService.migrate15to16(MigrationService.java:129) - migrate ok for oatao [java] oriharvester: 300 org.orioai.harvesting.domain.service.Migrati= onService.migrate15to16(MigrationService.java:120) - migrating config thes= esups to SQL database [java] oriharvester: 345 org.orioai.harvesting.domain.service.Migrati= onService.migrate15to16(MigrationService.java:129) - migrate ok for theses= ups [java] oriharvester: 26147 org.orioai.harvesting.domain.service.Migra= tionService.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 mo= issonn=C3=A9es, cette t=C3=A2che peut durer assez longtemps (jusqu'=C3=A0 p= lusieurs minutes).
Suppression des r=C3=A9coltes
Cette mise =C3=A0 jour de la base de donn=C3=A9es supprime automatiqueme=
nt vos pr=C3=A9c=C3=A9dentes r=C3=A9coltes. Vous gardez en revanche les d=
=C3=A9finitions pr=C3=A9c=C3=A9demment enregistr=C3=A9es en version 1.5.
Vous devrez donc relancer vos moissons (manuellement ou par programmation)=
afin de r=C3=A9cup=C3=A9rer toutes les fiches. Cette moisson devra se fair=
e apr=C3=A8s l'=C3=A9tape de r=C3=A9initialisation de l'index de ORI-OAI-in=
dexing d=C3=A9crite pr=C3=A9c=C3=A9demment. Vous trouverez plus d'informati=
on sur la gestion de =
l'index ici.
Ces 2 modules sont ceux qui ont le plus =C3=A9t=C3=A9 modifi=C3=A9s en v=
ersion 1.6.
En effet, afin d'offrir plus de souplesse de configuration et permettre le=
s =C3=A9changes faciles de personnalisation ou encore une transposition sim=
ple des configurations d'une version =C3=A0 l'autre, l'arborescence des dos=
siers et fichiers de configuration a =C3=A9t=C3=A9 retouch=C3=A9e.
Contrairement aux pr=C3=A9c=C3=A9dentes versions, TOUS = les fichiers de configuration propres =C3=A0 un workflow ont =C3=A9t=C3=A9 = regroup=C3=A9s dans un seul r=C3=A9pertoire, sp=C3=A9cifique. M=C3=AAme cho= se pour les fichiers de configuration d'un formulaire donn=C3=A9. Il devien= t donc plus ais=C3=A9 de cr=C3=A9er son propre workflow ou d'en modifier un= . En revanche, vous devrez transposer manuellement vos pr=C3=A9c=C3=A9dente= s configurations dans ce nouveau format.
Le passage de la 1.5 =C3=A0 la 1.6 (ORI-OAI-workflow et ORI-OAI-md-edito= r) sera un peu co=C3=BBteux par rapport aux autres versions, mais vous vous= rendrez vite compte que la configuration se fait et se maintiendra plus si= mplement.
Pour configurer vos workflows en version 1.6 et cr=C3=A9er vos propres c= ontributions, reportez-vous =C3=A0 la documentation du module ou =C3=A0 la rubrique Ajouter une =C3=A9tape au Wo= rkflow.
Si vous aviez personnalis=C3=A9 ORI-OAI-workflow 1.5, la premi=C3=A8re = =C3=A9tape consiste =C3=A0 reporter manuellement vos configurations de la 1= .5 sur la 1.6. Vous pouvez vous reporter =C3=A0 la documentation suivant= e pour plus de pr=C3=A9cision.
Une fois votre contribution correctement d=C3=A9finie en 1.6, vous pouve=
z proc=C3=A9der =C3=A0 l'=C3=A9tape suivante : la migration de vos donn=C3=
=A9es.
En effet, comme des param=C3=A8tres du workflow ont chang=C3=A9 entre la v=
ersion 1.5 et la version 1.6 (noms de workflows, de type de m=C3=A9tadonn=
=C3=A9es ; syntaxe de description des r=C3=B4les et permissions), il est n=
=C3=A9cessaire de construire une table de correspondance entre les anciens =
et les nouveaux param=C3=A8tres.
Reportez-vous =C3=A0 la documentation sp=C3=A9cifique suivante avant de lancer la t=C3=A2=
che qui mettra =C3=A0 jour vos donn=C3=A9es en base :
ant upgrade-workflow
Une fois la mise =C3=A0 jour faite, vous constaterez que vos donn=C3=A9e= s ont correctement =C3=A9t=C3=A9 migr=C3=A9es et qu'elles sont =C3=A0 nouve= au disponibles dans l'IHM du module.
Il ne vous reste plus qu'=C3=A0 r=C3=A9indexer toutes vos fiches en =C3=
=A9tat publi=C3=A9 vers le module ORI-OAI-indexing via le bouton "R=C3=A9in=
dexer tout" en mode Administrateur.
Vous trouverez plus =
d'information ici.
Pour configurer vos =C3=A9diteurs en version 1.6 et cr=C3=A9er vos propr= es contributions, reportez-vous =C3=A0 la documentation du module ou =C3=A0 la rubrique Ajouter une m=C3=A9tadonn= =C3=A9e dans ORI-OAI
La version 1.6 de ORI-OAI-md-editor offre aussi la possibilit=C3=A9 de c= onfigurer chaque formulaire dans un r=C3=A9pertoire sp=C3=A9cifique.
Si vous aviez personnalis=C3=A9 ORI-OAI-md-editor 1.5, le travail consis= te =C3=A0 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=C3=A9dure de migration propos=C3=A9e= .