INSTALLATION PAS A PAS D'ALGEM SOUS LINUX

VERSION 2.9.3 et suivantes

le 05/03/2015
Jean-Marc Gobat, jmg (@) musiques-tangentes.asso.fr

INTRODUCTION

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.

PRE-REQUIS pour une utilisation optimale :

1 - DEZIPPEZ LE PROGRAMME D'INSTALLATION

Dézippez le programme d'installation dans un répertoire de votre choix.
Ce répertoire contient plusieurs utilitaires vous permettant d'installer plus facilement le logiciel.

SUR LE SERVEUR

Les étapes 2, 3, 4 ne sont pas nécessaires si vous avez déjà installé et configuré PostgreSQL sur cette machine. Dans ce cas, passez directement à l'étape 5.

2 - INSTALLATION POSTGRESQL

Ouvrir une console système et connectez-vous en tant qu'administrateur.
Sous certaines distributions, on peut se connecter en tant qu'administrateur en tapant dans une console :
(Les noms de commande à taper sont indiqués en rouge après le signe >)
> su root
Un mot de passe vous sera alors demandé : tapez le mot de passe de l'administrateur

Sous Ubuntu, il suffit de taper la commande suivante puis de taper son mot de passe habituel
> sudo -s

Une fois connecté en tant qu'administrateur, installer (si ce n'est pas déjà fait) le paquet postgresql :
> apt-get install postgresql

Si ce n'est pas le cas, rendez-vous dans le dossier dans lequel vous avez dézippé Algem :
> cd /chemin_vers_algem/ (remplacer chemin_vers_algem par votre propre chemin d'accès)

Se connecter en tant qu'utilisateur postgres :
> su postgres

Créer un utilisateur nobody :
> createuser nobody
(répondre non à toutes les questions)

3 - INSTALLATION DE LA BASE

Toujours en tant qu'utilisateur postgres, initialiser la base de données minimale fournie avec algem :
> createdb -E utf8 algem

> psql -d algem -f algem.sql
Puis faites exit pour reprendre en tant qu'administrateur :
> exit

4 - CONFIGURATION DE POSTGRESQL

En tant qu'administrateur, ouvrez le fichier /etc/postgresql/X.X/main/pg_hba.conf (X.X correspond au numéro actuel de version)
Dans la rubrique :
# IPv4 local connections:
ajoutez la ligne suivante si elle n'existe pas :
host algem all 127.0.0.1/32 trust

Ouvrez le fichier /etc/postgresql/X.X/main/postgresql.conf (X.X correspond au numéro de version de PostgreSQL)
Vérifiez que vous avez bien la ligne suivante : (au besoin modifiez-la)
listen_addresses = '*'
Vérifiez également que la ligne suivante est à off (à partir de la version 9, cette option n'est plus celle par défaut) :
standard_conforming_strings = off
Vérifiez aussi que le paramètre datestyle dans la section "Locale and Formatting" est bien égal à : 'iso, dmy'

5 - SUR LES POSTES CLIENTS

(le serveur peut aussi être utilisé comme client)
Dézippez le répertoire d'installation dans un dossier à cet usage (/home/monlogin/algem par ex.).
Créer un raccourci vers l'application sur votre bureau pointant vers le fichier algem.sh

MODIFICATION DU FICHIER DE CONFIGURATION D'ALGEM

Le fichier de configuration algem.conf se trouve dans le répertoire
dans lequel vous avez installé Algem.
Par défaut, le serveur est recherché sur la même machine.
C'est ce que signifie la ligne :
host=localhost
Mais vous pouvez toujours modifier cette adresse.
La valeur à modifier se situe après le signe =.
Voici par exemple ce qu'il faudrait écrire si la machine sur laquelle la base de données d'Algem a été installée aux étapes 1 2 et 3 (le serveur) était différente de la machine sur laquelle on a installé Algem (le client) :
host=192.168.0.10

Ici, 192.168.0.10 correspond à l'adresse ip du serveur. Modifiez cette adresse en fonction de vos propres paramètres.

FICHIER DE DÉMARRAGE

Un fichier de démarrage par défaut est fourni avec le logiciel (algem.sh)
C'est un script shell automatisant le démarrage d'algem.
La variable $USER fait référence à l'utilisateur courant (celui qui est connecté sur son poste client)
Pour la première mise en service, $USER a été remplacé par admin
Après avoir démarré le logiciel, il est conseillé de vous ajouter en tant qu'utilisateur :
Créez un nouveau contact : Menu Recherche -> Contact
Indiquez vos nom, prénom, civilité, etc.
Enregistrez la fiche puis dans cette fiche, cliquez sur Options -> Création login
Indiquez votre identifiant de connexion (celui avec lequel vous vous connectez au système), choisissez un mot de passe et un profil.
Le profil administrateur permet de tout faire dans Algem. Le profil utilisateur est un peu plus restreint.

PROBLÈMES DIVERS

Plusieurs problèmes peuvent subvenir au démarrage du logiciel :

LANCEMENT

Sous Linux, un utilitaire correspondant au fichier gemdispatcher permet de synchroniser plusieurs clients tournant sur Algem.
Cela permet de voir les modifications effectuées sur le planning ou l'ajout de postits par exemple sur tous les postes en fonctionnement.
En tant qu'administrateur, copiez ce fichier dans le répertoire /etc/init.d/ et démarrez le service en faisant :
/etc/init.d/gemdispatcher start
Ce service peut être lancé automatiquement à chaque démarrage de la machine grâce à la commande suivante (en tant qu'administrateur) : > update-rc-d gemdispatcher defaults
Le répertoire d'Algem contient un fichier algem.sh utilisé pour démarrer le logiciel.
Pous pouvez double-cliquer (ou cliquer une seule fois suivant votre environnement de bureau) pour lancer Algem.
Pour pouvez aussi lancer le programme à partir d'une console de commande.
En supposant que vous vous trouvez dans le répertoire où se trouve algem.sh, vous pouvez taper :
> ./algem.sh

Vous pouvez aussi créer un raccourci sur votre bureau pointant vers ce fichier algem.sh

Après avoir démarré, il ne vous restera plus qu'à insérer de nouveaux contacts, ajouter des logins pour les futurs utilisateurs, etc.

CONFIGURATION GENERALE D'ALGEM

Certaines informations relatives à votre organisation sont disponibles dans le menu Configuration -> Paramètres -> Généraux
N'oubliez pas de modifier notamment les dossiers d'historique et d'exportation en fonction de votre environnement.
D'autres paramètres, comme le lecteur de mails ou le navigateur internet par défaut sont accessibles dans le fichier algem.properties.
Ces paramètres optionnels permettent d'ouvrir un lecteur de mail ou un navigateur dans le cas où le bureau Java ne serait pas pris en charge par votre système.

De nombreux autres paramètres ont été déjà configurés dans le logiciel : genres musicaux, les instruments ou les catégories professionnelles, par exemple. Vous êtes libres d'en ajouter si vous le désirez.
Il vous faudra aussi ajouter des contacts, des professeurs, des adhérents, des salles, des cours ou des formules de cours afin qu'Algem soit complètement opérationnel et réponde à vos besoins spécifiques.

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