From d33cfc783a024f37d5166e3fd46ba20e977d1e7b Mon Sep 17 00:00:00 2001 From: gloas <gloas@afi-sa.fr> Date: Tue, 22 Feb 2022 15:27:13 +0100 Subject: [PATCH] community #152122 upgrade UDGRADE.fr.md --- UPGRADE.fr.md | 88 ++++++++++++++++++++++++++++++++++++++------- VERSIONS_WIP/152122 | 1 + 2 files changed, 77 insertions(+), 12 deletions(-) create mode 100644 VERSIONS_WIP/152122 diff --git a/UPGRADE.fr.md b/UPGRADE.fr.md index 144e919c1f7..98eced355a5 100644 --- a/UPGRADE.fr.md +++ b/UPGRADE.fr.md @@ -2,32 +2,96 @@ Sauf indiqué, cette procédure prend en compte par défaut les distributions GN # Pré-requis + +## Sauvegarder votre site + +Pensez à faire une sauvegarde de votre base de données ainsi que de votre dossier de sources. +En effet, si la base de données est impactée dans la mise à jour il est fortement déconseillé d'essayer de "downgrader" après application des patchs. +Si vous constatez un problème suite à la mise à jour, nous vous conseillons de réinjecter votre dump de base de données et de faire un retour arrière sur les sources. + + ## Mettre votre site en maintenance -Vous pouvez mettre votre site en maintenance avant de commencer toute opération: dans l'interface d'administration sur la page d'accueil il y a un lien "rendre le site indisponible". À la fin de l'opération, pensez à cliquer sur "remettre le site en ligne". +Vous pouvez mettre votre site en maintenance avant de commencer toute opération: dans l'interface d'administration sur la page d'accueil il y a un lien "rendre le site indisponible". +À la fin de l'opération, pensez à cliquer sur "remettre le site en ligne". -## Sauvegarder votre site -Pensez à faire une sauvegarde de votre base de données ainsi que de votre dossier de sources. En effet, si la base de données est impactée dans la mise à jour il est fortement déconseillé d'essayer de "downgrader" après application des patchs. Si vous constatez un problème suite à la mise à jour, nous vous conseillons de réinjecter votre dump de base de données et de faire un retour arrière sur les sources. +## Identifier la version ciblée + +Lorsqu'une version est publiée par l'équipe Bokeh, elle est identifiable par un [tag](http://git.afi-sa.fr/afi/opacce/tags). + +Les apports des versions sont consignés dans le fichier [VERSIONS de la racine du projet](http://git.afi-sa.fr/afi/opacce/blob/master/VERSIONS). + +Les dernières versions majeurs sont complétées par une [page dans le wiki](http://wiki.bokeh-library-portal.org/index.php/Category:Notes_de_version) qui apporte un éclairage plus fonctionnel aux ajouts des développements. -## Identifier la version -Lorsqu'une version est publiée par l'équipe Bokeh, elle est identifiable par un [tag](http://git.afi-sa.fr/afi/opacce/tags) -Les apports des versions sont consignés dans le fichier [VERSIONS de la racine du projet](http://git.afi-sa.fr/afi/opacce/blob/master/VERSIONS) Les dernières versions sont complétées par une [page dans le wiki](http://wiki.bokeh-library-portal.org/index.php/Category:Notes_de_version) qui apporte un éclairage plus fonctionnel aux ajouts des développements. +## Collecter les versions intermédiares -# Mise à jour de Bokeh +Si votre installation de BOKEH est très éloignés de la version que vous ciblez, il est probable que vous deviez d'abord mettre à jour votre installation vers des versions intermédiaires. -La mise à jour d'un portail se fait en plusieurs phase: mise à jour des sources puis mise à jour de la base de données. +Il s'agit principalement de versions contenant des patchs de base de données qui sont dépendants de la version du code source de Bokeh. + +Veuillez strictement respecter ces installations intermédiaires pour ne pas compromettre votre mise à jour. + + +# Mise à jour de Bokeh vers une version + +La mise à jour d'un portail se fait à l'aide de plusieurs commandes : + - des commandes pour mettre à jour les sources du projets + - des commandes pour mettre à jour la base de données. + +À la racine de votre installation de BOKEH, lancez la commande suivante pour récupérer les sources depuis le dépôt GIT officiel : + + +``` +git checkout XXX +``` +XXX étant un [tag](http://git.afi-sa.fr/afi/opacce/tags) -## Mise à jour des sources -Vous devez positionner vos sources sur le tag choisi (vous référer notamment aux commandes git checkout et git rebase). +À la racine de votre installation de BOKEH, lancez le script suivant pour mettre à jour les projets dont dépend BOKEH : -## Mise à jour de la base de données +``` +$ bash update.sh +``` -La base de données peut être mise à jour en ligne de commande ou via l'interface. +À la racine du dossier qui contient le fichier d'accès à la base de données (config.ini), lancer le script suivant pour mettre à jour la base de données : ``` $ php scripts/upgrade_db.php ``` + +# Informatins sur les versions + +## Moteur PHP + +### PHP 5.6 + +Dernière version 8.0.139 + +### PHP 7.2 + +Dernière version 8.0.147 + +### PHP 7.4 + +Dernière version : en cours + + +## Migration de base de données en PHP + +Tant que votre version de Bokeh est inférieure à l'une des versions suivantes, +vous devez procéder à l'étape d'installation de chacune d'elle. + + - 8.0.141 - 11/10/2021 : cosmogramme/sql/patch/patch_403.php + + - 8.0.144 - 08/11/2021 : cosmogramme/sql/patch/patch_417.php + cosmogramme/sql/patch/patch_418.php + + - 8.0.149 - 17/01/2022 : cosmogramme/sql/patch/patch_423.php + cosmogramme/sql/patch/patch_424.php + + - 8.0.151 - 24/01/2022 : cosmogramme/sql/patch/patch_425.php + + - 8.0.152 - 15/02/2022 : cosmogramme/sql/patch/patch_426.php \ No newline at end of file diff --git a/VERSIONS_WIP/152122 b/VERSIONS_WIP/152122 new file mode 100644 index 00000000000..69e6ce45338 --- /dev/null +++ b/VERSIONS_WIP/152122 @@ -0,0 +1 @@ + - fonctionnalité #152122 : Communauté : Mise à jour du fichier UDGRADE.fr.md avec les dernières recommandations -- GitLab