UPGRADE.fr.md

Sauf indiqué, cette procédure prend en compte par défaut les distributions GNU/Linux Ubuntu et Debian

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".

Identifier la version ciblée

Lorsqu'une version est publiée par l'équipe Bokeh, elle est identifiable par un tag.

Les apports des versions sont consignés dans le fichier VERSIONS de la racine du projet.

Les dernières versions majeurs sont complétées par une page dans le wiki qui apporte un éclairage plus fonctionnel aux ajouts des développements.

Collecter les versions intermédaires

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.

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

À la racine de votre installation de BOKEH, lancez le script suivant pour mettre à jour les projets dont dépend BOKEH :

$ bash update.sh

À 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

Informations sur les versions

MariaDB

Bokeh requiert a minima MariaDB 10.3

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

PHP 8.1

Version minimum : 8.0.157 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

• 8.0.157 - 23/05/2022 : cosmogramme/sql/patch/patch_429.php cosmogramme/sql/patch/patch_430.php

• 8.0.158 - 16/05/2022 : cosmogramme/sql/patch/patch_431.php

• 8.0.159 - 31/05/2022 : cosmogramme/sql/patch/patch_432.php

• 8.0.162 - 12/07/2022 : cosmogramme/sql/patch/patch_434.php cosmogramme/sql/patch/patch_435.php

• 8.0.167 - 06/09/2022 : cosmogramme/sql/patch/patch_437.php

Opérations spécifiques

Version 8.0.162

Recherche plus exacte

Si vous avez déjà des données en base avant de passer Bokeh en version 8.0.162 ou supérieure,

Pour réindexer toutes les notices de la base de données de façon à tirer le meilleur parti des améliorations du moteur de recherche et de pertinence. au cas où vous souhaitiez avoir un accès rapide à cette fonctionnalité il est nécessaire de lancer le script scripts/reindex_local_unimarc.php

Vous pouvez aussi attendre un réimport total de votre catalogue.

Parcourir les étagères

Pour que vos utilisateurs puissent parcourir les documents de la même étagère, Vous pouvez activer le parcours des étagères dans la configuration de la boite exemplaire.

Cela fait appel à des clés de parcours d'étagères qui ont besoin d'être calculées et stockées au cas où vous souhaitiez avoir un accès rapide à cette fonctionnalité il est nécessaire de lancer le script scripts/index_items_shelf_key.php

Vous pouvez aussi attendre un réimport total de votre catalogue.

Identifiant unique PPN et Ark

Pour que vous puissiez accéder aux ressources du portail de type notice depuis un autre système avec un identifiant unique.

Après avoir configuré le profil de données du cosmogramme pour ajouter la définition de l'identifiant unique, pour réindexer l'unimarc présent dans les notices et mettre à jour les données en base, il est nécessaire de lancer le script scripts/identifiers_records.php

Vous pouvez aussi attendre un réimport total de vos notices.

Changement de structure HTML pouvant impacter votre charte graphique

• 8.0.154 - 20/03/2022 : Suite à une amélioration RGAA des thèmes du magasin de thèmes, les tag "a" servant à afficher un dropdown ont été modifiés en tag "button".

• 8.0.158 - 16/05/2022 : Passage de jQuery 3.2.1 en 3.6.0

• 8.0.159 - 31/05/2020 : Suite à une amélioration de l'ergonomie, le résultat de recherche et la liste des exemplaires dans le magasin de thèmes passent de l'affichage mur à l'affichage grille.

• 8.0.160 - 20/06/2022 : cosmogramme/sql/patch/patch_433.php

• 8.0.170 - 29/09/2022 : Pour faciliter la personnalisation, les titres des notices sont maintenant composés de balises span ayant comme classe le champs UNIMARC.