== Procédure de migration de la version 2.2 à la version 2.3 ==

=== Migration de la base de données ===
La structure de la base de données a été légèrement modifiée entre les 2 versions.


Le script suivant permet d'ajouter les nouvelles colonnes :
{{{
ALTER TABLE Users ADD city varchar(128);
ALTER TABLE Metadata ADD displayorder int;
}}}



Le script suivant permet d'ajouter les nouvelles valeurs :
{{{
INSERT INTO Groups VALUES (-1, 'GUEST', 'self-registered users', null, null);
INSERT INTO GroupsDes VALUES (-1, 'en', 'GUEST');
INSERT INTO GroupsDes VALUES (-1, 'fr', 'GUEST');
UPDATE IsoLanguages SET code = 'fre' WHERE code = 'fra';
INSERT INTO Operations VALUES (2, 'editing', 'y');
INSERT INTO OperationsDes VALUES (2, 'en', 'Editing');
INSERT INTO OperationsDes VALUES (2, 'fr', 'Editing');
-- Settings
INSERT INTO Settings VALUES (90, 1, 'selectionmanager', null);
INSERT INTO Settings VALUES (91, 90, 'maxrecords', 1000);
INSERT INTO Settings VALUES (170,1,'shib','');
INSERT INTO Settings VALUES (171,170,'use','false');
INSERT INTO Settings VALUES (172,170,'path','/geonetwork/srv/en/shib.user.login');
INSERT INTO Settings VALUES (173,170,'attrib','');
INSERT INTO Settings VALUES (174,173,'username','REMOTE_USER');
INSERT INTO Settings VALUES (175,173,'surname','Shib-Person-surname');
INSERT INTO Settings VALUES (176,173,'firstname','Shib-InetOrgPerson-givenName');
INSERT INTO Settings VALUES (177,173,'profile','Shib-EP-Entitlement');
INSERT INTO Settings VALUES (190,1,'userSelfRegistration','');
INSERT INTO Settings VALUES (191,190,'enable','false');
INSERT INTO Settings VALUES (200,1,'clickablehyperlinks','');
INSERT INTO Settings VALUES (201,200,'enable','true');
INSERT INTO Settings VALUES (210,1,'localrating','');
INSERT INTO Settings VALUES (211,210,'enable','false');
INSERT INTO Settings VALUES (220,1,'xlinkResolver','');
INSERT INTO Settings VALUES (221,220,'enable','true');
INSERT INTO Settings VALUES (600,1,'indexoptimizer','');
INSERT INTO Settings VALUES (601,600,'enable','true');
INSERT INTO Settings VALUES (602,600,'at','');
INSERT INTO Settings VALUES (603,602,'hour','0');
INSERT INTO Settings VALUES (604,602,'min','0');
INSERT INTO Settings VALUES (605,602,'sec','0');
INSERT INTO Settings VALUES (606,600,'interval','');
INSERT INTO Settings VALUES (607,606,'day','0');
INSERT INTO Settings VALUES (608,606,'hour','24');
INSERT INTO Settings VALUES (609,606,'min','0');


UPDATE Metadata SET schemaId = 'iso19139.fra' WHERE schemaId = 'iso19139fra';
}}}

===== Note : Utilisateurs du moissonnage =====
TODO : Vérifier les interactions avec les noeuds moissonnés (problème d'identifiant)

2 options :
 * Supprimer les noeuds moissonnés avant la migration de la base de données
 * Mettre à jour le script SQL de migration pour ne pas avoir d'erreur sur la clé primaire


==== McKoi ====
===== Connexion à la base de données =====
 * Télécharger l'utilitaire Druid (http://druid.sourceforge.net/)
 * Lancer Druid (java -jar druid.jar)
 * Ouvrir le fichier database.druid situé dans le répertoire gast/setup de GeoSource 2.2
 * Dans l'onglet JDBC > Connection, 
  * saisir les informations de connexion pour la base utilisée par GeoSource 2.2
  * cocher l'option autocommit
  * cliquer sur connecter

===== Sauvegarde =====
 * Dans l'onglet structure, faire une sauvegarde de la base :
  * clic droit sur "JDBC database" > "Export records ..."
  * sélectionner "Druid data format"
  * sélectionner un répertoire
  * un fichier par table est alors créé.

===== Migration =====
 * Executer le script SQL ci-dessus pour mettre à jour la base de données.

==== MySQL ====

==== PostGresql ====

==== Oracle ====


=== Installation de l'application ===
Réaliser une installation de GeoSource 2.3.

=== Migration des données ===
Copier les répertoires :
 * des données web/geonetwork/WEB-INF/data dans data
 * des contacts dans le répertoire xml/codelist/local/contactDirectories
 * des thesaurus dans le répertoire xml/codelist/local/thesauri
 * des logos web/geonetwork/images


=== Mise à jour des métadonnées ===
 * Lancer l'application
 * Identifiez-vous avec un compte administrateur 
 * Sélectionner l'ensemble des enregistrements (si vous avez plus de 1000 enregistrement, augmenter la limite dans la configuration du système) :
  * http://localhost:8080/geonetwork/srv/fr/metadata.select?id=0&selected=add-all
 * Mettre à jour les métadonnées :
  * Le processus réalise des corrections dans les XLinks :
   * correction de l'URL du serveur
   * correction des identifiants des mots clés INSPIRE
  * Remplacer les paramètres "s" et "r" fonction de votre configuration. "s" correspond à la nouvelle url de votre serveur et "r" à l'ancienne url. Si l'url est la même, utiliser s=http://localhost:8080&r=http://localhost:8080
  * http://localhost:8080/geonetwork/srv/en/metadata.massive.processing?process=migrate-to-23&s=http://localhost:8084&r=http://localhost:8080