Chapitre 2 - Installation et mise à jour

2.1. Pré-requis

Cette section propose une liste non-exhaustive de menues tâches à effectuer avant une installation de Plume CMS : vérification, manipulation,... Le but étant d'être sûr que vous installez Plume CMS dans les meilleures conditions.

2.1.1. Quelle version de Plume CMS ?

Avant toute chose, il est nécessaire de définir les besoins de votre site, car, la plupart du temps, ce seront eux qui guideront votre choix concernant la version de Plume à utiliser. Sur ce point précis, on ne saurait vous conseiller que de tester par vous-même chaque mouture pour vous faire une opinion. Néanmoins, ce qui définit globalement la différence entre les versions est la stabilité de l'application et ses fonctionnalités. Les versions de test proposent nativement de nouvelles fonctionnalités dont l'implantation est encore inaboutie. Il est probable qu'un plugin propose les mêmes services pour la version stable. Mener quelques recherches sur le site et le wiki, voire poser quelques questions sur le forum, n'est pas superflu.

2.1.2. Choix de l'environnement

2.1.2.1. À propos de l'environnement xAMP

Plume CMS a été conçu pour opérer dans un environnement de type xAMP : soit Apache comme serveur Web, MySQL en système de bases de données (dit SGBD) et PHP. Afin de bénéficier pleinement des fonctionnalités relatives aux traitements des images, PHP doit être compilé avec la bibliothèque GD.

Les versions minimales recommandées sont les suivantes :

Apache, à partir de la version 1.3.x ;
MySQL 3.23 minimum, mais il est conseillé d'avoir une version égale ou supérieure à la 4.1 afin de tirer parti du support natif d'Unicode ;
PHP 4.3.x, notez que PHP 5 est tout à fait supporté ;
Bibliothèque GD : 2.x ;

2.1.2.2. Collecte des informations sur l'environnement

Les versions logicielles sont très certainement consultables sur le site de l'hébergeur. Cependant, vous pouvez collecter directement ces renseignements.

Créez un fichier .php avec un simple éditeur de texte, par exemple info.php, qui contient ces lignes :

<?php echo $_SERVER['SERVER_SOFTWARE']; ?>
<hr />
<?php phpinfo(); ?>

Effectuez un upload (ou envoi vers le serveur) de ce fichier avec un client FTP sur votre espace Web, puis, avec votre navigateur, consultez-le (eg. http://www.mon-site.tld/info.php). Toutes les informations concernant la configuration de PHP y seront normalement affichées, de même que les versions d'Apache, MySQL et GD.

2.1.3. Spécificités de l'hébergement

Plume CMS peut être installé aussi facilement sur un réseau local que sur un hébergement online.

Les hébergeurs ont chacun leur lot de spécificités quant à la façon d'utiliser l'espace qu'ils vous allouent. Par exemple, pour activer le support des sessions par PHP, certains laissent aux utilisateurs le soin de créer un répertoire sessions à la racine de leur espace (nommément, Free). Prenez donc le temps de consulter les ressources techniques publiées par votre prestataire de services.

Assurez-vous qu'une base de données est préalablement créée et que vous connaissez son nom et ses identifiants. Il convient d'être vigilant lors du choix du nom de la base, puisque MySQL n'accepte pas tous les caractères. Parfois, l'utilisation de tels caractères est tout de même autorisée, mais ils sont alors transformés de manière plus ou moins transparente par le caractère "_" (dit "underscore"). Par exemple, il serait possible de créer une base de données du nom ma.base, alors que son nom réel sera ma_base. Dans de tels cas, gardez en mémoire qu'il faudra remplacer le caractère non supporté par un underscore.

2.1.4. Synthèse

Pour résumer, vous devez être capable de répondre à ces questions :

Vais-je utiliser la version stable ou la version de développement de Plume CMS ? Pourquoi ?
Dans quel environnement vais-je installer Plume CMS ? Est-ce en accord avec les versions logicielles minimales recommandées ?
Dois-je effectuer une manipulation pour activer le support d'une fonctionnalité de mon hébergement ?
Ma base de données est-elle correctement nommée ? Si non, il faudra faire preuve de vigilance durant la procédure d'installation.

Cette liste est destinée à préparer une installation et une utilisation simple de Plume CMS. Il aurait été possible de l'affiner en y ajoutant d'autres critères. Toutefois, en procédant de la sorte, il faudra envisager l'éventualité que le cadre d'utilisation devienne plus exotique, auquel cas, vous devrez avoir les connaissances nécessaires pour gérer l'application en conséquence.

2.2. Installation pas à pas

2.2.1. Préparation

Après avoir téléchargé Plume CMS, décompressez l'archive. A partir de là, deux choix s'offrent à vous :

Cas 1 : Vous voulez installer Plume CMS à la racine de votre espace. De cette façon, vous y accéderez avec votre navigateur favori par une adresse du type http://www.mon-site.tld.
Cas 2 : Vous voulez installer Plume CMS dans un dossier précis de votre hébergement. L'application sera donc accessible par une adresse du type http://www.mon-site.tld/mon-dossier.

Effectuez l'''upload'' (ou envoi vers le serveur) de Plume CMS à l'aide d'un client FTP et, selon les cas énumérés ci-dessus :

Cas 1 : Versez le contenu du dossier à la racine de votre espace Web.
Cas 2 : Versez le dossier sur votre espace Web. Le nom du dossier constituera le chemin qui mène à Plume CMS.

Avec votre navigateur, rendez vous à l'adresse :

Cas 1 : http://www.mon-site.tld/manager/install ;
Cas 2 : http://www.mon-site.tld/mon-dossier/manager/install.

2.2.2. Le programme d'installation

Vous voilà donc arrivé sur la première page du programme d'installation de Plume CMS. Il vous permet d'installer l'application très simplement, en échange de quelques précieux renseignements. Bien que la procédure soit claire et bien expliquée, vous trouverez ici le détail de la marche à suivre.

2.2.2.1. Choix de la langue du programme d'installation

Il vous faut choisir la langue pour la procédure d'installation, vous sont proposées : français, anglais, slovaque (ainsi qu'allemand et espagnol, selon la version). Sélectionnez et validez votre choix.

2.2.2.2. Vérification du support de Plume CMS par le système

Cette étape permet de vérifier que Plume CMS est supporté par l'environnement de votre hébergement. Si tel est le cas, vous devriez avoir un résultat similaire. La lecture du récapitulatif de cette page vous en apprendra plus dans le cas contraire.

2.2.2.3. Langue du site et du Manager

Vous devez choisir la langue du Manager, interface d'adminitration de Plume CMS. Sélectionnez et validez.

2.2.2.4. Informations de la base de données

Il vous faut renseigner les champs avec les informations de la base de données. Le programme d'installation propose automatiquement des informations génériques servant usuellement à une installation locale. Par ailleurs, la plupart du temps, lorsqu'un hébergeur propose l'accès à une interface d'administration de base de données, telle que PHPMyAdmin, les identifiants que vous utilisez sont les mêmes que ceux de la bases de données.

Serveur de la base de données, ou serveur SQL. Cette information est fournie par votre hébergeur.
Nom de la base de données : le nom de la base préalablement créée. Faites attention à l'écriture du nom.
L'identifiant d'accés à la base de données est parfois semblable au nom même de la base de données. Cela dépend des hébergeurs.
Le mot de passe pour accéder à la base de données.
Le préfixe des tables dans la base de données vous servira à identifier facilement les tables utilisées par Plume CMS au cas où plusieurs applications cohabiteraient dans la même base.

2.2.2.5. Mise en place de la base de données

Cette étape permet de vérifier que toutes les opérations d'installation de Plume CMS au sein de la base de données se sont bien passées.

2.2.2.6. Création du premier utilisateur

Est créé ici le premier utilisateur de Plume CMS. Il sera le seul véritable administrateur du site et aura accès à toutes les parties du Manager.

Vous vous connecterez au Manager grâce à l'identifiant. Il ne doit contenir aucun signe de ponctuation ou d'espacement.
Le nom est votre nom de rédacteur qui apparaîtra lors de la publication de vos articles ou brèves.
Vous pouvez indiquer deux adresses courriel, l'une privée qui ne sera pas diffusée et l'autre publique.
Le mot de passe servira à vous connecter au Manager.

2.2.2.7. Création du premier site Web

Vous devez renseigner ici les informations relatives à votre site.

Le nom du site Web.
L'adresse du site Web est l'URL par laquelle votre site sera accessible avec un navigateur. Cette information est automatiquement renseignée, vérifiez cependant qu'elle est correcte.
Le chemin d'accès à la racine du site Web est le chemin local qui permet l'accès à votre espace Web ; c'est-à-dire sur la machine qui gère votre site chez votre hébergeur. Cette information est automatiquement renseignée, vérifiez cependant qu'elle est correcte.
Le nom du dossier des fichiers et des images est le nom du dossier qui servira à les stocker par le biais du gestionnaire de fichiers et images intégré au Manager. Par défaut nommé «xmedia», vous pouvez toutefois l'appeler comme bon vous semble.
Une rapide description de votre site est requise dans le champ idoine.

2.2.2.8. Création du premier site Web - bis

Cette étape permet de contrôler que toutes les opérations sur les fichiers et dossiers pour l'installation de Plume CMS ont bien été effectuées. Si tel n'est pas le cas, un message d'erreur explicatif vous guidera pour remédier au problème.

2.2.2.9. Fin de l'installation

Vous êtes arrivé au bout de la procédure d'installation de Plume CMS ! Vous pouvez désormais accéder au Manager, après identification.

Nota Bene : Pour éviter qu'une tierce personne n'accède au dossier install, connectez-vous avec un client FTP à votre espace Web. Ouvrez et décommentez le fichier .htaccess qui se trouve dans /manager/install de façon à avoir :

# If you want to protect your install folder
# when using Apache uncomment the line below

deny from all

Vous établissez ainsi une protection contre des visiteurs impromptus car personne ne pourra avoir accès à ce dossier.

2.3. Mise à jour de Plume CMS

Il existe deux procédures différentes de mise à jour selon la version de Plume CMS que vous utilisez. De quelque manière que soit, faites la mise à jour, et surtout prenez soin de faire une sauvegarde du contenu de votre base de données ainsi que des fichiers qui constituent Plume. Ce sera répété tout au long des lignes à venir, et même si nous testons les procédures de mise à jour, la prudence est de mise !

2.3.1. Mise à jour d'une version <= 1.1.2 vers une version courante

A partir de la version 1.1.3, une nouvelle structure pour les dossiers de thème et le support complet du codage UTF-8 avec MySQL 4.1 et supérieures ont fait leur apparition. Ainsi, le contenu de la base de données est désormais stocké directement en UTF-8. Par conséquent, vos pages seront affichées avec ce jeu de caractères uniquement. Du fait de ces changements, vous devez effectuer une mise à jour spécifique, pour cette fois-ci seulement.

Faites une sauvegarde complète de vos fichiers et de votre base de données. Ce n'est jamais perdu.
Trouvez le dossier /manager/templates/default/.
Copiez le contenu du dossier précité dans un dossier, par exemple /manager/templates/monsiteweb.
Ecrasez (remplacez) vos anciens fichiers avec ceux de la nouvelle version de Plume CMS, que vous aurez préalablement dézipppés.
- Vous devez cependant conserver votre fichier /manager/conf/config.php et les fichiers de configuration de votre présent site Web dans le dossier idoine.
Recopiez le contenu du dossier /manager/templates/monsiteweb dans le dossier /manager/templates/default/.
Avec votre navigateur, allez à l'adresse http://www.mon-site.tld/manager/install/ et suivez les étapes de la mise à jour. On doit absolument vous proposer une procédure de mise à jour. Dans le cas contraire, arrêtez immédiatement et reprenez à l'étape 4 (décrite ci-dessus) en vous assurant que vos fichiers de configuration ne sont pas perdus.
Trouvez ensuite la documentation contenant la marche à suivre pour créer vos propres thèmes. Vous n'aurez pas à répéter cette procédure lors de la prochaine mise à jour.

2.3.1.1. MySQL 4.1 et versions supérieures

La nouvelle version de Plume tire pleinement parti du support d'Unicode pour MySQL 4.1 et versions supérieures. Si vous avez effectué une mise à jour de Plume CMS d'une version 1.0.x vers une version courante, ou bien si vous avez mis à jour votre version de MySQL à partir de la 4.0 ou inférieures, vous remarquerez que dans le fichier manager/conf/config.php la variable de configuration $_PX_config['db_version'] a la valeur 4.0 ou inférieure.

Cela signifie que votre base de données stocke des chaînes de caractères UTF-8 en utilisant l'interclassement latin-1. Ce n'est pas la meilleure solution, mais ça fonctionne. Vous pouvez toujours mettre à niveau la base pour utiliser une collation native UTF-8, la procédure est décrite dans ces quelques explications (en anglais) sur MySQL. Il suffira ensuite de mettre le bon numéro de version de MySQL dans le fichier config.php.

2.3.2. La procédure standard

Faites une sauvegarde complète de vos fichiers et de votre base de données. On n'est jamais trop prudent.
Ecrasez (remplacez) vos anciens fichiers avec ceux de la nouvelle version de Plume CMS, que vous aurez préalablement dézipppés.
- Vous devez cependant conserver votre fichier /manager/conf/config.php et les fichiers de configuration de votre présent site Web dans le dossier idoine.
Avec votre navigateur, allez à l'adresse http://www.mon-site.tld/manager/install/ et suivez les étapes de la mise à jour. On doit absolument vous proposer une procédure de mise à jour. Dans le cas contraire, arrêtez immédiatement et reprenez à l'étape 2 (décrite ci-dessus) en vous assurant que vos fichiers de configuration ne sont pas perdus.

Ensuite, si vous voulez protéger votre programme d'installation, décommentez la ligne du fichier .htaccess se situant dans le répertoire /manager/install/ :

#deny from all

Pour obtenir :

deny from all

Tout est normalement fait pour qu'après une installation et/ou une mise à jour, personne ne puisse corrompre votre programme d'installation ; mais on ne sait jamais...

Documentation de Plume CMS (bêta)