Mise à jour de l'extension

Livrables

Les fichiers de mises à jour sont :

  • un nouveau fichier asgard.control, qui remplacera le précédent ;

  • un ou plusieurs fichiers asgard--x.x.x--y.y.y.sql, qui sont des scripts de passage de la version x.x.x à la version y.y.y. Plusieurs de ces scripts peuvent s'exécuter à la suite lors d'une mise à jour ;

  • un fichier asgard--y.y.y.sql, qui contient l’intégralité du code de la nouvelle version. Celui-ci n’est pas utilisé lors de la mise à jour, mais pourra servir par la suite, notamment en cas de sauvegarde/restauration de la base, ou pour l’installation d’ASGARD sur une nouvelle base.

Où trouver les fichiers ?

L’extension PostgreSQL ASGARD (© République Française, 2020-2021) est publiée sur le site intranet Géoinformations et sur GitHub sous licence CeCILL-B.

ComplémentPour télécharger la dernière version sur le GitHub

Dans le bandeau de droite sur la page d'accueil du dépôt, l'onglet Release met en raccourci un accès à la page de téléchargement de la dernière version publiée.

Méthode

La mise à jour se fait selon le même procédé que l’installation :

  • pour un serveur hors offre Eole/PostgreSQL uniquement, copie des fichiers de mise à jour dans le répertoire des extensions (cf. Préparation de l'installation pour plus de détails) ;

  • activation de la mise à jour par un super-utilisateur[1], en lançant une commande SQL ALTER EXTENSION asgard UPDATE sur chaque base où ASGARD est installé.

Exemple

Pour installer la version 1.0.0 depuis une version antérieure :

1
2
ALTER EXTENSION asgard UPDATE TO '1.0.0' ;

Il est généralement plus simple de ne pas spécifier le numéro de la version cible, c’est dans ce cas celle qui est indiquée dans le fichier asgard.control qui sera utilisée.

1
2
ALTER EXTENSION asgard UPDATE ;

En particulier pour les serveurs de l’offre Eole/PostgreSQL, il est recommandé de procéder à la mise à jour dès qu’une nouvelle version est disponible (cf. Sauvegarde et restauration de la base pour plus d'explications à ce sujet).

Il est également fortement conseillé de prendre connaissance du descriptif des évolutions qui accompagne chaque version. Celui-ci est susceptible de spécifier des mesures à prendre avant ou après la mise à jour.

Conseil

Effectuer au plus tôt la mise à jour lors la sortie d’une nouvelle version, après avoir lu attentivement son descriptif.

ComplémentMéthode alternative avec les menus de pgAdmin

Dans l'arborescence des objets de la base, clic droit sur asgard dans le menu Extensions, puis Propriétés...
Dans l'onglet Définition, champ Version, choisir la nouvelle version, puis appuyer sur Enregistrer.