Newer
Older
Sauf indiqué, cette procédure prend en compte par défaut les distributions GNU/Linux Ubuntu et Debian
## 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](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.
## 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](http://git.afi-sa.fr/afi/opacce/tags)
À la racine de votre installation de BOKEH, lancez le script suivant pour mettre à jour les projets dont dépend BOKEH :
À 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
## 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
Version minimum : 8.0.157
## 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
Henri-Damien LAURENT
committed
## Opérations spécifiques
### Version 8.0.162
#### Recherche plus exacte
Henri-Damien LAURENT
committed
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
Henri-Damien LAURENT
committed
`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`
Henri-Damien LAURENT
committed
Vous pouvez aussi attendre un réimport total de vos notices.
Henri-Damien LAURENT
committed
## 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
Ghislain Loas
committed
- 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.
- 8.0.179 - 04/04/2023 : Patch correctif de la migration des abonnements des utilisateurs.