Installer Galette

Trois cas de figure principaux peuvent se présenter si vous souhaitez installer Galette. Dans tous les cas, les différences vont se situer au niveau de la préparation, et des possibilités qui vous sont offertes. L'installation de Galette en elle même, telle que décrite sur cette page, sera toujours identique.

Les captures d'écran de cette page sont un peu vieillottes, mais devraient suffire au bon déroulement des opérations.

La toute première chose à faire, c'est de télécharger Galette, bien entendu Pour faire fonctionner Galette, il vous faut :

• Apache
• PHP
  • module gettext
  • module mysql ou postgresql
• MySQL ou PostgreSQL

Galette est régulièrement testé avec des version récentes (ou pas ) de ces programmes, si vous rencontrez des erreurs avec une version particulière d'un composant, merci de nous en faire part

Selon votre cas, vous devrez effectuer certaines tâches avant de vous lancer dans l'installation en elle-même :

• Installation sous Unix
• Installation sur un hébergement
• Installation sous Windows

Certains pourraient également vouloir installer un site de démonstration.

L'installation de Galette se fait entièrement depuis votre navigateur web (une fois les étapes préliminaires achevées). Rendez-vous à l'adresse http://www.exemple.org/galette/install/.

Le première page de la procédure d'installation vous permet de choisir votre langue.

L'écran suivant vous permet de choisir le type d'installation. Vous aurez le choix entre « Nouvelle installation » (le cas que nous allons traiter ici) et une série de mises à jour.

Si toutes les étapes préalables ont été correctement suivies, les droits des dossiers devraient être corrects. Cette étape s'assure que les droits nécessaires au bon fonctionnement de Galette aient été placés. En cas de problème (rectangle rouge), référez-vous à la section « Droits des fichiers et dossiers » du cas de figure qui vous concerne, rafraîchissez ensuite la page pour relancer la procédure de vérification des droits.

Avant toute chose, vous devez vous assurer que votre base de données existe déjà. Rassemblez les éléments requis, à savoir :

• nom de l'hôte
• nom de l'utilisateur de la base
• mot de passe de l'utilisateur
• nom de la base
• type de la base (MySQL ou PostgreSQL)

Pour l'exemple, nous allons nous baser sur une base de données nommée magalette appartenant à un utilisateur monutilisateurgalette dont le mot de passe est monmotdepasse.

• MySQL

$ mysql -u root -p
mysql> CREATE DATABASE magalette;
mysql> GRANT ALL ON magalette.* to 'monutilisateurgalette'@'localhost' IDENTIFIED BY 'monmotdepasse';

• PostgreSQL :

$ su -
# su - postgres
$ createuser -P monutilisateurgalette
$ createdb -O monutilisateurgalette magalette

Les commandes décrites ci dessus peuvent varier, référez vous aux documentations de MySQL ou de PostgreSQL selon votre cas.

Free n'autorise qu'une seule base de données dont les éléments sont les suivants :

• hôte : sql.free.fr,
• utilisateur : jean.dupond (si l'adresse électronique de votre compte principal est jean.dupond@free.fr)
• mot de passe : le mot de passe associé à votre compte principal,
• nom de la base : jean_dupond (si votre login comprend un ., le remplacer par un _ (le caractère de soulignement, parfois également appelé « le trait du 8 »)

À l'instar de free, NFrance n'autorise qu'une seule base de données (tout au moins dans le cas de la formule basic) :

• hôte : localhost,
• utilisateur : juXXXXX,
• mot de passe : mot de passe associé à votre abonnement chez NFrance,
• nom de la base : juXXXXX (identique au nom d'utilisateur/login).

En cas de doutes, rendez-vous sur votre espace client.

Sur cet écran, sélectionner votre type de base de données puis entrez simplement les nom d'hôte, nome de base de données, nom d'utilisateur et mot de passe. Le préfixe de la table est fort utile si vous n'avez pas une base dédiée intégralement à Galette ; la proposition par défaut devrait être parfaitement acceptable, mais vous pouvez bien entendu y mettre ce que vous souhaitez

Les deux écrans suivants vont vérifier qu'une connexion peut être établie à votre base de données en utilisant les éléments que vous avez fournis, puis que les droits sont corrects (ajout/suppression/modification de tables, ajout/suppression/modification d'enregistrements, …).

En cas d'erreur (rectangle rouge), revenez à l'étape précédente, effectuez les éventuels ajustement requis, puis valider de nouveau en cliquant le bouton « étape suivante ». Si l'erreur concerne un ou plisuers tests lors de la vérification des droits, il faudra vous assurer que l'utilisateur de votre base de données possèdent bien les droits requis sur la base.

Si une connexion à la base a pu être établie, et que les droits sont corrects, l'installation va maintenant créer les tables et y insérer les valeurs par défaut.

La création des tables peut être vérifiée à l'aide de PhpMyAdmin.

En ligne de commande, vous pouvez utiliser :

• pour MySQL (mysql) :

mysql> use magalette;
mysql> show tables;

• pour PostgreSQL (psql) :

postgres=# \c magalette
postgres=# \dt

L'écran suivant vous demande de saisir les informations de l'administrateur de Galette. Par la suite, certains comptes crées via l'interface pourront être élevés au rang d'administrateur également, mais celui qui est créé à l'installation n'est pas un adhérent, et ne peux pas être supprimé.

Nous voici à la fin de l'installation ! Si tout s'est bien passé, un écran vous informera que le fichier de configuration a été créé, et que les paramètres sont bien stockés dans la base.

Vous avez maintenant accès à la page de login de Galette, entrez-y les identifiants administrateur préalablement renseignés, et vous pouvez commencer à l'utiliser. Vous pouvez maintenant vous référer au manuel de l'utilisateur de Galette.

Enjoy !