Procédure de mise à jour de Canopsis

Note

Cette procédure ne décrit que la mise à jour d'une instance mono-nœud de Canopsis open-core.

Principes des numéros de version de Canopsis

Une nouvelle version de Canopsis sort généralement toutes les 3 semaines.

Afin de décrire ses changements, Canopsis suit le principe du versionnage sémantique.

Mises à jour majeures

On parle d'une mise à jour majeure lorque le premier chiffre change ; par exemple, lors du passage de Canopsis 2 à Canopsis 3.

Ceci signifie que des changements fondamentaux ont été apportés à Canopsis (changement d'interface, de paradigmes, de technologies…), ou qu'une incompatibilité majeure est survenue. Ces changements sont exceptionnels.

La mise à jour d'une installation existante n'est pas garantie lors d'une mise à jour majeure. Il faudra généralement prévoir une réinstallation et une reconfiguration complètes.

Mises à jour intermédiaires

Les mises à jour intermédiaires sont les plus courantes. Il s'agit, par exemple, d'une mise à jour de Canopsis 3.25.0 vers Canopsis 3.26.0.

Ce type de mise à jour apporte de nouvelles fonctionnalités, souvent des corrections de bugs et parfois quelques changements de comportement.

Elle nécessite de suivre la procédure de mise à jour decrite ci-dessous.

Mises à jour mineures

La mise à jour d'un Canopsis 3.26.0 vers 3.26.1 constitue une mise à jour mineure.

Ces mises à jour ne comportent uniquement que des correctifs. Il n'y a aucun ajout de fonctionnalités ou de changement fonctionnel.

Elle nécessite de suivre la procédure de mise à jour décrite ci-dessous.

Procédure de mise à jour

Cette procédure s'applique aux mises à jour intermédiaires (3.25.0 vers 3.26.0) et aux mises à jour mineures (3.26.0 vers 3.26.1).

Vous devez impérativement lire chacune des notes de version vous séparant de votre version précédente à votre version cible, avant de procéder à une mise à jour.

Mise à jour en installation par paquets

Veuillez tout d'abord obligatoirement lire les notes de version qui vous concernent avant de démarrer toute manipulation. Des prérequis cruciaux peuvent y être mentionnés.

Puisque la procédure d'installation par paquets ajoute un dépôt Canopsis dans votre gestionnaire de paquets, celui-ci vous permettra de mettre à jour Canopsis avec le reste de votre système.

Attention

Cette mise à jour causera une interruption de service.

Sur un environnement Debian :

apt update
apt upgrade

Sur un environnement CentOS :

yum update

Il faut ensuite lancer le script canopsinit pour appliquer les éventuelles procédures automatisées de mise à jour.

Attention

Avant Canopsis 3.27.0, la procédure suivante réinitialise les identifiants root de la base utilisateur, interne à Canopsis, ainsi que sa authkey associée.

Si vous utilisez la configuration « moteurs Python uniquement » et « édition Canopsis open-core » (qui sont les réglages par défaut), lancer :

su - canopsis -c "canopsinit"

En revanche, si vous utilisez une configuration « moteurs Go » et « édition Canopsis CAT », lancer :

# Valeurs acceptées : --canopsis-edition core OU cat, --canopsis-stack python OU go.
# "core" et "python" sont les valeurs par défaut.
su - canopsis -c "canopsinit --canopsis-edition cat --canopsis-stack go"

S'assurer que toute modification des unités systemd soit bien prise en compte :

systemctl daemon-reload

Puis, redémarrer l'ensemble des moteurs Canopsis :

canoctl restart

Ne pas oublier d'appliquer toute éventuelle procédure supplémentaire décrite dans chacune des notes de version qui vous concernent.

Si vous bénéficiez d'un développement spécifique (modules ou add-ons ayant été spécifiquement développés pour votre installation), assurez-vous de suivre toute procédure complémentaire vous ayant été communiquée.

Vous pouvez alors vous connecter à nouveau sur l'interface Canopsis pour valider que tout fonctionne correctement.

Mise à jour en environnement Docker

Todo

Cette procédure est en cours de rédaction.


Dernière mise à jour: 2020-04-10