Principe
Un site Biodiv ’neuf’ est constitué d’un ensemble de fichiers et de répertoires organisés dans plusieurs archives (fichiers .zip). Pour installer les fichiers sur le site, il faut donc :
- décompresser chacune des archives dans un même répertoire local (sur PC)
- transférer toute l’arborescence obtenue à la racine du site côté serveur
Le transfert se fait par FTP en utilisant des outils comme FileZilla.
Les éléments de la distribution
Plusieurs fichiers d’archive peuvent être associés à une distribution :
- SPIP : le logiciel de base du CMS avec lequel la version Biodiv a été testée. Vous pouvez également la télécharger depuis spip.net.
- PLUGINS : Les plugins généraux de SPIP utiles pour Biodiv. Ils sont également téléchargeables depuis Plugins SPIP. Les versions proposées sont celles qui on été testées. L’archive contient également des bibliothèques non-SPIP utiles à Biodiv.
- BIODIV : Les plugins et librairies développées pour le site Biodiv et nécessaires à son fonctionnement
- EXTENSIONS : des utilitaires complémentaires non indispensables à Biodiv mais qui étendent ses fonctionnalités
- TAXREF : les données du référentiel de l’INPN préparées pour Biodiv.
- PATCH : des correctifs de l’archive BIODIV
- PATCHEX : des correctifs de l’archive EXTENSIONS
Première installation
Si c’est votre première installation de Biodiv, vous devez installer toutes les archives de la distribution, puis passer à l’étape : "activer SPIP".
Mise à jour
Si vous avez déjà installé Biodiv, vous devrez à un moment le mettre à jour. Pour cela, lisez attentivement les notes de version de celle que vous souhaitez installer : elles vous guideront sur la démarche à suivre.
D’une manière générale retenez que :
- les versions ont des numéros composés de 3 parties (par exemple 3.8.1)
- Quand seul le dernier nombre change (ici le 1), il s’agit d’une correction de bug. Pour l’appliquer, vous n’avez besoin que de PATCH (pour BIODIV) ou de PATCHEX (pour EXTENSIONS).
- Quand le nombre du milieu change (8 dans l’exemple), il s’agit d’une évolution fonctionnelle : Appliquez la avec BIODIV (ou EXTENSIONS) ainsi qu’avec les patchs complémentaires.
- Quand le premier nombre change (3 dans l’exemple), c’est un changement d’architecture : réinstallez tout.
Important
- Faites une sauvegarde du logiciel et de la base de données avant toute mise à jour
- Quand vous décompressez les archives dans un répertoire local avant de les transférer, respectez toujours l’ordre suivant : SPIP avant PLUGINS avant BIODIV avant tous les PATCH avant EXTENSIONS avant tous les PATCHEX.
- Si plusieurs PATCH (ou PATCHEX) doivent être appliqués, décompressez les archives de la version la plus ancienne à la plus récente.
- Bien entendu, suivant la mise à jour, certains éléments ne seront pas nécessaires, mais ceux qui doivent être installés doivent respecter les règles ci-dessus.
- Au cours de la décompression des archives, certains fichiers plus anciens seront écrasés par des des fichiers plus récent : c’est normal, et c’est pourquoi respecter l’ordre des mises à jour est important.
Exemples
| Pour aller de | vers | installez |
|---|---|---|
| Biodiv 3.6.0 | Biodiv 3.6.1 | PATCH 3.6.1 |
| Biodiv 3.6.0 | Biodiv 3.8.2 | BIODIV 3.8.0, PATCH 3.8.1, PATCH 3.8.2 |
| Biodiv 3.7.0 | Biodiv 4.0.1 | SPIP 4.3, PLUGINS 4.3, BIODIV 4.0.0, PATCH 4.0.1 |
Remarques:
SPIP propose un mécanisme de mise à jour automatique dans l’espace privé, le spip loader. Ne l’utilisez jamais. En effet, cette mise à jour pourrait installer une version de SPIP non compatible avec la version installée de Biodiv.