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

# Pré-requis

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

## 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

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.

# Mise à jour de Bokeh

La mise à jour d'un portail se fait en plusieurs phase: mise à jour des sources puis mise à jour de la base de données.

## 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).

## Mise à jour de la base de données

La base de données peut être mise à jour en ligne de commande ou via l'interface.

```
$ php cosmogramme/php/upgrade_db.php
```