le 09/03/2016
Jean-Marc Gobat, jmg (@) musiques-tangentes.asso.fr
Algem est un logiciel de type client-serveur.
Il peut être installé sur plusieurs machines du réseau local.
La base de données, quant à elle, doit se situer sur une machine serveur.
Cependant, la même machine peut très bien être utilisée comme serveur et comme client.
Le programme Algem.jar (accompagné de ses fichiers de configuration et de son fichier de démarrage) correspond au client proprement dit.
Le programme a été testé sous Windows XP, Windows Vista, Windows 7, Windows 8, Windows 10 et Windows Server 2008.
Il est nécessaire de disposer d'une version récente de PostgreSQL et de Java.
La procédure d'installation est décrite ci-dessous dans le détail.
Note : afin d'éviter toute ambiguïté dans les noms de fichiers, veuillez vérifier que l'extension
de tous les fichiers est bien visible sur votre système.
Sous Windows XP, dans le gestionnaire de fichiers, cliquez dans le menu sur Outils -> Options des dossiers...
Sous Windows 7, dans le gestionnaire de fichiers, cliquez sur Organiser -> Options des dossiers et de recherche.
Ouvrez l'onglet "Affichage" et décochez la ligne :
Masquer les extensions des fichiers dont le type est connu.
Faites OK puis Validez.
Dézippez le fichier Algem.zip dans un répertoire de votre choix :
Cliquez droit sur le fichier et faites "Extraire tout...".
Eventuellement, cliquez sur "Parcourir" pour sélectionner un dossier d'installation autre que celui proposé par défaut.
Après cette opération, vous devriez trouver un répertoire nommé Algem comportant l'ensemble des fichiers nécessaires au démarrage
et à la configuration du logiciel.
Merci de ne pas renommer ou déplacer ces fichiers et dossiers.
NOTE : les étapes 2 à 4 ne sont à faire que sur la machine serveur (celle sur laquelle vous installez la base de données).
Télécharger le programme PGAdmin pour Windows à cette adresse :
http://www.enterprisedb.com/products-services-training/pgdownload#windows.
Choisissez de préférence la version 9.3.x (remplacer x par le numéro actuel : 9.3.6 à ce jour). En aucun cas, ne prenez une version inférieure (9.1.x par exemple).
En fonction de votre système d'exploitation, choisissez la version 32 ou 64 bits.
En cas de doute ou si vous ne connaissez pas la version de votre système, choisissez la version 32 bits (Win-x86-32).
Installer le programme téléchargé.
Lors de l'installation, il vous sera demandé un mot de passe. Ne l'oubliez pas : il s'agit du mot de passe de l'administrateur de la base de données.
Cet administrateur correspond au login postgres. Sur la page suivante, laissez le numéro de port indiqué (5432).
Ouvrir le programme pgAdminIII
Dans la colonne de gauche, devrait apparaître PostgreSQL X.X (les X correspondent au numéro de version qui peut varier d'un système à l'autre)
Faites un clic droit sur cette ligne et choisissez Se connecter.
Un mot de passe vous sera demandé. Tapez le mot de passe que vous avez fourni à l'installation de PostgreSQL (celui de l'administrateur de la base de données, postgres).
Cliquez sur le signe + à gauche de la ligne PostgreSQL X.X afin de faire apparaître les différents paramètres.
Cliquez droit sur la ligne Rôles de connexion et faites Ajouter un rôle de connexion.
Dans la fenêtre qui s'ouvre, indiquez le nom du rôle : nobody
Puis faites OK
Cliquez droit maintenant sur la ligne Base de données et faites Ajouter une base de données.
Dans la fenêtre qui s'ouvre tapez dans le champ correspondant le nom de votre base : algem (en minuscules)
Laissez les paramètres par défaut puis faites OK
Cliquez sur Outils -> Administration du serveur et choisissez pg_hba.conf
Modifiez la ligne commençant par : host all all 127.0.0.1/32 md5
Double-cliquez sur cette ligne et faites les modifications suivantes :
Devant le champ Base de données, remplacez all par algem.
Devant utilisateur, remplacez all par nobody.
Devant méthode, remplacez md5 par trust
Faites OK puis cliquez sur l'icone (en forme de disquette) Enregistrer le fichier.
Cliquez sur Outils -> Administration du serveur et choisissez postgresql.conf
Vérifiez que la ligne intitulée standard_conforming_strings est bien à off. Modifiez-là sinon en double cliquant dessus. Indiquez off devant le champ Valeur et cochez Activé.
Faites OK puis cliquez sur l'icone (en forme de disquette) Enregistrer le fichier.
Vérifiez aussi que le paramètre datestyle dans la section "Locale and Formatting" est bien égal à : 'iso, dmy'
Toujours dans pgAdmin, cliquez droit sur la base de données algem nouvellement créée.
Cliquez sur Restaurer...
Dans Nom de fichier, cliquer sur le bouton Parcourir (...) et choisissez le fichier algem.backup
situé dans le répertoire Algem que vous avez dézippé à l'étape 1 de l'installation.
Cliquez sur le bouton "Restaurer".
Si tout s'est bien passé, vous devriez voir la ligne d'info suivante :
Le process a retourné le code de sortie 0.
Cliquez sur le bouton "Réalisé" pour terminer.
La base de données est maintenant initialisée.
Vous pouvez fermer pgAdmin.
Si ce n'est pas déjà fait, téléchargez java (version 1.7 ou supérieur)
Vous pouvez le trouver à cette adresse :
http://java.com/fr/download/manual.jsp
ou alternativement sur cette page (version 1.7 seulement) :
Java SE Runtime Environment 7u80
Si java ne démarre pas automatiquement :
Créer la variable d'environnementJAVA_HOME. Cette variable se définit dans les propriétés avancées du poste de travail. Dans l'onglet Avancé, cliquez sur le bouton variables d'environnement. Dans Variable Utilisateur cliquez sur Nouveau. Dans nom de la variable, indiquezJAVA_HOME
Dans valeur, indiquez le chemin d'accès du répertoire dans lequel a été installé java, par exemple :
C:\Program Files\Java\jre7 (si vous avez installé la version 1.7)
Faites OK
Note : sous Vista/Seven, la procédure est un peu différente :
1. Cliquez sur Démarrer, tapez comptes dans la zone Démarrer la recherche puis cliquez sur comptes d'utilisateurs sous programmes.
Si vous êtes invité à entrer un mot de passe administrateur ou à confirmer une opération, tapez le mot de passe, ou cliquez sur Autoriser.
2. Dans la boîte de dialogue comptes d'utilisateurs, cliquez sur Modifier mes variables d'environnement sous tâches.
3. Apportez les modifications que vous souhaitez pour les variables d'environnement de votre compte d'utilisateur, puis cliquez sur OK.
Pour lancer Algem, placez-vous à l'endroit où vous avez dézippé le programme.
Si vous avez l'intention d'utiliser Algem sur plusieurs machines de votre réseau,
il est conseillé de lancer tout d'abord le dispatcher.
C'est un petit utilitaire qui permet de synchroniser les actions des utilisateurs
sur la base (comme par exemple le rafraîchissement d'un planning ou l'ajout d'un contact).
Pour lancer le dispatcher, double-cliquez sur le fichier gemdispatcher.bat.
Il se peut que le parefeu de Windows vous demande confirmation avant de lancer ce programme.
Cliquez s'il le faut sur le bouton Débloquer. Une fenêtre de console s'ouvrira.
Vous pouvez laisser cette console ouverte en permanence.
Il faudra néanmoins la relancer à chaque démarrage de la machine ou créer un raccourci dans Programmes au démarrage.
Important : le dispatcher ne doit être lancé que sur un seul poste du réseau local.
En règle générale, cet utilitaire est lancé sur la machine serveur.
Enfin, lancez le programme Algem : double-cliquez sur le fichier algem.bat.
Si le programme ne se lance pas ou génère des erreurs, veuillez consulter le paragraphe PROBLÈMES DIVERS.
Si tout est correct, vous pouvez désormais placer un raccourci du fichier algem.bat sur votre bureau ou dans votre liste de programmes.
Cliquez droit sur le fichier algem.bat et faites Envoyer vers -> Bureau.
La base de données initialisée à l'étape 4 regroupe des informations minimales pour vous permettre de démarrer.
L'établissement intitulé ETABLISSEMENT, les salles SALLE 1 et SALLE 2, les personnes Elise DURAND, Marcel DUPONT, Daniel MONPROF ont été créées
ainsi que plusieurs formules de cours.
Les groupes GROUPE DEMO et GROUPE DEMO 2 ont aussi été créés.
Quelques plannings ont aussi été créés (à partir du 17 septembre 2012) afin de vous donner des exemples de configuration et d'utilisation.
Certaines informations relatives à votre organisation sont disponibles dans le menu
Configuration -> Paramètres -> Généraux.
Vous pouvez modifier par exemple les dates de début et de fin de période,
Les dates de vacances sont à configurer dans le logiciel :
Menu Configuration -> Vacances
De même que l'établissement, les salles, les genres musicaux, les cours, les formules, les instruments ou les catégories professionnelles.
Il vous faudra configurer tout cela avant qu'Algem ne devienne véritablement opérationnel.
Plusieurs problèmes peuvent se présenter au démarrage du logiciel :
- Il se peut que le service postgresql ne soit pas démarré. Vérifiez que ce service est en fonctionnement. Dans le menu des programmes de Windows, aller dans Postgresql, puis cliquer sur Start Server.
- En cas d'échec de connexion à la base de données, vérifiez que le port 5432 (port par défaut pour la communication avec la base de données) est bien ouvert (au niveau du parefeu en particulier).
- Il se peut que le programme ne trouve pas java. Dans ce cas, aucune fenêtre ne s'ouvrira. Consultez le paragraphe CONFIGURATION JAVA afin de résoudre le problème.
- Si le message d'erreur fait référence au driver org.postgresql.Driver, il s'agit surement d'une mauvaise configuration du fichier de démarrage, de librairies introuvables ou du service postgresql non démarré.
- Si le message d'erreur indique "login inconnu", l'utilisateur n'est pas encore présent dans la base :
Note : le mot REM au début d'une ligne permet de désactiver la commande qui suit.
Pour toute info supplémentaire, veuillez vous adresser à :
Jean-Marc Gobat, jmg@musiques-tangentes.asso.fr
ou au 01 40 84 80 09 à Musiques Tangentes