Mises à jour de corrections de bugs¶
Introduction¶
Afin de bénéficier des dernières améliorations, correctifs de sécurité, corrections de bugs et améliorations de performances, vous devrez peut-être mettre à jour votre installation Odoo de temps en temps.
Ce guide s’applique uniquement lorsque vous utilisez Odoo sur votre propre infrastructure d’hébergement. Si vous utilisez l’une des solutions Odoo Cloud, les mises à jour sont automatiquement effectuées pour vous.
La terminologie entourant les mises à jour logicielles prête souvent à confusion, voici donc quelques définitions préliminaires :
- Mise à jour (une installation Odoo)
Fait référence au processus d’obtention de la dernière révision du code source de votre édition Odoo actuelle. Par exemple, mettre à jour votre Odoo Enterprise 13.0 vers la dernière révision. Cela n’entraîne directement aucune modification du contenu de votre base de données Odoo et peut être annulé en réinstallant la révision précédente du code source.
- Mise à niveau (une base de données Odoo)
Désigne un traitement de données complexe où la structure et le contenu de votre base de données sont modifiés de manière permanente pour la rendre compatible avec une nouvelle version d’Odoo. Cette opération est irréversible et généralement réalisée via le « service de mise à niveau de la base de données <https://upgrade.odoo.com> »_ d’Odoo, lorsque vous décidez de passer à une version plus récente d’Odoo. Historiquement, ce processus est également connu sous le nom de « migration » car il implique le déplacement de données à l’intérieur de la base de données, même si la base de données peut se retrouver au même emplacement physique après la mise à niveau.
Cette page décrit les étapes typiques nécessaires pour mettre à jour une installation Odoo vers la dernière version. Si vous souhaitez plus d’informations sur la mise à niveau d’une base de données, veuillez plutôt visiter la Page de mise à niveau Odoo.
En un mot¶
La mise à jour d’Odoo s’effectue simplement en réinstallant la dernière version de votre édition Odoo en plus de votre installation actuelle. Cela préservera vos données sans aucune altération, tant que vous ne désinstallez pas PostgreSQL (le moteur de base de données fourni avec Odoo).
La principale référence pour la mise à jour est logiquement notre guide d’installation, qui explique les méthodes d’installation courantes.
La mise à jour est également effectuée de manière plus appropriée par la personne qui a déployé Odoo initialement, car la procédure est très similaire.
Note
Nous recommandons toujours de télécharger une nouvelle version complète et à jour d’Odoo, plutôt que d’appliquer manuellement des correctifs, tels que les correctifs de sécurité fournis avec les avis de sécurité. Les correctifs sont principalement fournis pour les installations fortement personnalisées ou pour le personnel technique qui préfère appliquer temporairement des modifications minimes tout en testant une mise à jour complète.
Étape 1 : Téléchargez une version mise à jour d’Odoo¶
La page de téléchargement centrale est https://www.odoo.com/page/download. Si vous voyez un lien « Acheter » pour le téléchargement d’Odoo Enterprise, assurez-vous que vous êtes connecté à Odoo.com avec le même identifiant que celui lié à votre abonnement Odoo Enterprise.
Vous pouvez également utiliser le lien de téléchargement unique inclus dans votre e-mail de confirmation d’achat Odoo Enterprise.
Note
Le téléchargement d’une version mise à jour n’est pas nécessaire si vous avez installé via Github (voir ci-dessous)
Étape 2 : Faites une sauvegarde de votre base de données¶
La procédure de mise à jour est assez sûre et ne devrait pas altérer vos données. Cependant, il est toujours préférable d’effectuer une sauvegarde complète de la base de données avant d’effectuer toute modification sur votre installation et de la stocker dans un endroit sûr, sur un autre ordinateur.
Si vous n’avez pas désactivé l’écran du gestionnaire de base de données (voir ici pourquoi vous devriez le faire), vous pouvez l’utiliser (lien en bas de l’écran de sélection de votre base de données) pour télécharger une sauvegarde de votre (vos) base(s) de données. Si vous l’avez désactivé, utilisez la même procédure que pour vos sauvegardes habituelles.
Étape 3 : Installez la version mise à jour¶
Choisissez la méthode qui correspond à votre installation actuelle :
Installateurs packagés¶
Si vous avez installé Odoo avec un package d’installation téléchargé sur notre site Internet (la méthode recommandée), la mise à jour est très simple. Il ne vous reste plus qu’à télécharger le package d’installation correspondant à votre système (voir étape #1) et à l’installer sur votre serveur. Ils sont mis à jour quotidiennement et incluent les derniers correctifs de sécurité. Habituellement, vous pouvez simplement double-cliquer sur le package pour l’installer par-dessus l’installation actuelle. Après avoir installé le package, assurez-vous de redémarrer le service Odoo ou de redémarrer votre serveur, et vous êtes prêt.
Installation source (Tarball)¶
Si vous avez initialement installé Odoo avec la version « tarball » (archive du code source), vous devez remplacer le répertoire d’installation par une version plus récente. Téléchargez d’abord la dernière archive tar sur Odoo.com. Ils sont mis à jour quotidiennement et incluent les derniers correctifs de sécurité (voir étape n°1). Après avoir téléchargé le package, extrayez-le dans un emplacement temporaire sur votre serveur.
Vous obtiendrez un dossier intitulé avec la version du code source, par exemple « odoo-13.0+e.20190719 », qui contient un dossier « odoo.egg-info » et le dossier du code source réel nommé » odoo » (pour Odoo 10 et versions ultérieures) ou « openerp » pour les anciennes versions. Vous pouvez ignorer le dossier odoo.egg-info. Localisez le dossier dans lequel votre installation actuelle est déployée et remplacez-le par le dossier « odoo » ou « openerp » plus récent qui se trouvait dans l’archive que vous venez d’extraire.
Assurez-vous de respecter la disposition des dossiers, par exemple le nouveau dossier « addons » inclus dans le code source devrait se retrouver exactement au même chemin qu’avant. Ensuite, faites attention aux fichiers de configuration spécifiques que vous avez peut-être copiés ou modifiés manuellement dans l’ancien dossier et copiez-les dans le nouveau dossier. Enfin, redémarrez le service Odoo ou redémarrez la machine, et vous êtes prêt.
Installation source (Github)¶
Si vous avez initialement installé Odoo avec un clone Github complet des référentiels officiels, la procédure de mise à jour vous oblige à extraire le dernier code source via git. Accédez au répertoire de chaque référentiel (le référentiel Odoo principal et le référentiel Enterprise) et exécutez les commandes suivantes : :
git fetch
git rebase --autostash
La dernière commande peut rencontrer des conflits de code source si vous aviez édité le code source Odoo localement. Le message d’erreur vous donnera la liste des fichiers en conflit, et vous devrez résoudre les conflits manuellement, en les modifiant et en décidant quelle partie du code conserver.
Alternativement, si vous préférez simplement ignorer les modifications conflictuelles et restaurer la version officielle, vous pouvez utiliser la commande suivante : :
git reset --hard
Enfin, redémarrez le service Odoo ou redémarrez la machine, et vous devriez avoir terminé.
Docker¶
Veuillez vous référer à notre documentation sur l’image Docker pour des instructions de mise à jour spécifiques.