Project

General

Profile

Installation

Voici les grandes étapes de la procédure d'installation. Elle est réservée aux administrateurs. Si vous êtes un simple utilisateur du programme, contactez votre administrateur pour obtenir un identifiant et l'URL à utiliser.

Pré-requis

Le programme est serveur WEB, vous pouvez le faire tourner sur votre machine ou chez un hébergeur Internet. Dans les deux cas il vous faudra:
  • Un serveur Apache
  • Un support de PHP version 5
  • Un support de MySQL

Même si vous voulez le déployer sur Internet, il est toujours pratique de pouvoir tester les modifications en local avant de déployer. Sous Windows, je vous conseille de télécharger WAMP dans lequel vous trouverez tous ce dont vous avez besoin. Les distributions Linux intègrent le plus souvent tous le nécessaire.

Structure SVN

Le projet est organisé en sous-répertoires
  • doc est obsolète. Toute la documentation est maintenant gérée dans ce wiki.
  • scripts contient les scripts mysql de migration de version.
  • gvv contient l'arborescence à déployer à la racine de votre serveur WEB. C'est la seule chose dont vous ayez besoin pour une installation initiale.

Les étapes

Téléchargez le projet

  • gvv à la racine de votre serveur

Plus tard je m'arrangerai pour générer automatiquement un zip our une archive avec tous les fichiers. Pour l'instant il faut aller les chercher sous subversion (le système de gestion des sources).

Le projet étant géré sous SVN (subversion), il vous faut un client SVN pour le charger. Je recommande Tortoise SVN sous windows, KDE SVN sous Linux ou les pluggins de support SVN sous Eclipse (Environement de développement Intégré). Une fois votre client SVN installé, spécifiez lui l'URL suivante: http://subversion.developpez.com/projets/gvv/. Vous pourrez alors le télécharger.

avec svn en ligne de commande cela donne si vous voulez faire du développement:
svn co http://subversion.developpez.com/projets/gvv/trunk/gvv

Si vous voulez contribuer au développement, il faudra d'abord nous soumettre vos contributions pour évaluation. C'est seulement après accord mutuel que vous pourrez être autorisé à enregistrer directement vos conttributions.

si vous voulez juste déployer le programme sans contribuer directement au projet:
svn export http://subversion.developpez.com/projets/gvv/trunk/gvv

exemple d'installation en local avec Eclipse

Si vous utilisez Eclipse et que vous voulez installer le programme ne local sous Windows voici le détail des opérations. J'utilise Eclipse avec le client SVN Subclipse. D'abord il vous faudra créer une référence sur le dépôt.

Puis récupérer (checkout) le dépôt.

N'utilisez pas l'espace de travail par défaut, mais copiez directement l'arborescence dans le répertoire C:\wamp\www (si vous avez installé wamp avec les options par défaut).

Un fois que c'est fait vous allez voir GVV dans les projets locaux de votre serveur Apache. Mais attention, le programme n'est pas encore opérationnel et vous allez avoir une erreur si vous essayez de lancer le programme à ce stade.

Préparez la base de données

  • Créez une base de données MySQL ou activez celle de votre compte free ou autre hébergeur. Il vous faut créer ou connaitre l'identifiant et le mot de passe de l'utilisateur de la base. L'example qui suit est valable sous linux
  • mysql> -u root -ppassword
  • mysql> show databases;
  • mysql> create database gvv2;
  • mysql> use gvv2;
  • mysql> create user gvv_user@localhost identified by 'passwd'
  • mysql> grant all on gvv2.* to gvv_user@localhost;

Configuration CodeIgniter
  • Modifiez le fichier gvv/application/config/config.php
  • Adaptez le fichier gvv/application/config/database.php

CodeIgniter ne fonctionne plus qu'avec PHP version 5. Chez certains hébergeurs (free par exemple) il vous faut modifier le fichier .htaccess pour activer PHP5. Ajoutez-y la ligne:
php 1

Copiez le programme à la racine de votre serveur WEB

L'arborescence que vous avez obtenu avec les adaptations des fichiers de configuration doit maintenant être copiée à la racine de votre serveur WEB. Utilisez un client ftp si c'est un serveur distant, sinon vous pouvez copier directement en local (vous pouvez même faire le check out directement dans le répertoire de votre serveur WEB).

Lancer la procédure d'installation

Elle est dans le répertoire install, chez moi par exemple eslle est activée avec l'URL http://localhost/gvv2/install. Elle va effectuer un certain nombre de vérification et créer les tables de base de données.

Ecran d'installation

Si la procédure d'installation signale des erreurs, corrigez les. En cas de succès vous obtenez l'information suivante:

Fin de la procédure d'installation

Il existe une procédure qui vous permet d'effacer toutes les données est de revenir dans la situation initiale. Elle est activée par l'URL http://localhost/gvv2/install/reset.php:

Procédure de ré-initialisation

Il est conseillé d'effacer le répertoire install et tout son contenu sur les serveurs d'exploitation. Ceci affin d'éviter qu'un utilisateur malveillant ou malchanceux ne vous efface toutes vos données.

Lancez le programme

  1. Pour activer le programme il suffit d'accéder à l'URL spécifiée dans le fichier de configuration avec un navigateur Internet (Firefox, Google Chrome, Internet Explorer, etc.). Si tous c'est bien passé, vous devriez voir l'écran de connexion et pouvoir vous connecter avec testadmin/password.
  2. Créez au moins un utilisateur et donnez lui les droits d'administration.
  3. Supprimez l'utilisateur testadmin sous PHPMyadmin (sinon n'importe qui pourra se connecter sur votre site).
  4. Vérifiez les droits que vous voulez donner aux différentes classes d'utilisateur. Spécifiez / pour membre si vous ne voulez pas de contrôle fin. Cela doit se faire sur la page "maintenance site/Custom Permissions.
  5. Configurez le nom et l'adresse du club
  6. Réalisez une migration de base si les deux versions affichées sont différentes (dans admin/Migration de la base)
  7. Définissez votre plan comptable, c'est la liste des catégories de compte possibles (comptes de charges 6xx, de produits 7xx, comptes bancaires 5xx, comptes pilotes, etc).
  8. Définissez vos comptes de charges et produits ainsi que vos comptes bancaires. Les comptes pilotes sont crées automatiquement lors de la création des pilotes. Il faut que les catégories (le plan comptable) soient défini avant de créer les comptes.
  9. Créez vos tarifs.
  10. Commencez à créer vos pilotes, vos machines, etc.

Adaptez la facturation.

Il est assez difficile de créer un système de facturation qui soit adapté à chaque club et qui soit entièrement configurable à l'écran sans réaliser une usine à gaz. Le module de facturation a été isolé afin qu'il soit très facile de le remplacer. Cependant l'écriture du module de facturation va vous imposer d'écrire quelques lignes de PHP. En s'inspirant du/des modules fournis, la tâche devrait être à la portée d'un programmeur débutant (mais programmeur tout de même).

La procédure complète sera décrite dans la documentation utilisateur.

En cas de problèmes

  1. Vérifiez d'abord que vous êtes capable de faire fonctionner CodeIgniter. GVV est basé sur CodeIgniter. Reportez vous à la documentation de CodeIgniter et à son WIKI tant que vous n'arrivez pas à faire fonctionner cette étape.
  2. Vérifiez que vous accédez bien à votre base de données avec PHPMyAdmin et les identifiants que vous avez saisis dans votre fichier de configuration. Référez vous à la documentation de MySQL et PHPMyAdmin pour cette étape.
  3. Vérifiez que vous parvenez à faire fonctionner un petit exemple d'accès à la base de données avec CodeIgniter.
  4. Si tous fonctionne jusque la mais toujours pas GVV contactez moi.