Installer et utiliser iGestis

Introduction

iGestis n’est pour le moment plus maintenu, faute de succès.

iGestis vous permet :

• d’implémenter un PGI (Progiciel de Gestion Intégré) conçu et adapté pour les petites entreprises, collectivités, artisans, …
• d’utiliser un annuaire de votre choix (OpenLDAP, Active Directory,…)
• de créer rapidement des comptes d’employés, de clients et de founisseurs avec des comptes d’accès à l’aide de son interface conviviale
• de centraliser la gestion de plusieurs sociétés avec une seule instance d’installation.

iGestis a besoin d’une base de données fonctionnelle pour stocker toutes les informations. Pour le moment, seul Mysql est supporté.

Installation avec le paquet Debian (version 2)

Nous fournissons une installation simplifiée d’iGestis grâce au paquet Debian.

Ajoutez le fichier de dépôt

wget http://open.iabsis.com/iabsis.list -O /etc/apt/sources.list.d/iabsis.list

Ajoutez le certificat

wget http://open.iabsis.com/open.iabsis.com.asc -O- | apt-key add -

Rafraichissez la liste des paquets

apt-get update

Et finalement installez iGestis

apt-get install igestis

iGestis va vous poser quelques questions :

• Choose the wanted authentication method: choose your actual directory (OpenLDAP or Active Directory). If none, choose Internal
• Choose the admin account name : changez ce compte uniquement si celui proposé ne vous plait pas. Ce compte doit exister dans annuaire le cas échéant.
• Specify the uris for the directory : remplacez ici par l’adresse de votre serveur. En cas d’utilisation de Samba4, gardez l’url ldapi proposée.
• Specify the directory base tree : saisissez le nom de domaine FQDN (exemple: domain.local)
• Specify the directory admin account for the directory : Le bind dn du compte Administrator. Par exemple dc=admin,dc=domain,dc=local pour OpenLDAP ou Administrator@domain.local pour Samba4 ou Active Directory.
• Please specify the admin password for the directory : Le mot de passe de votre compte administrateur.
• Create a user in iGestis when present in the directory ? Préférez Yes
• Configure database for igestis with dbconfig-common? Yes
• Password of the database’s administrative user: Votre mot de passe Root pour Mysql.
• MySQL application password for igestis: Laissez vide pour générer un mot de passe aléatoire
• Web server to reconfigure automatically : Gardez coché apache2 pour une configuration automatique de Apache2.

Ouvrez votre navigateur, saisissez l’adresse de votre serveur et ajoutez /igestis, par exemple : http://ip_de_votre_serveur/igestis

Installation avec le paquet Debian (version 3)

Nous fournissons une installation simplifiée d’iGestis grâce au paquet Debian.

Ajoutez le fichier de dépôt

wget http://open.iabsis.com/iabsis.list -O /etc/apt/sources.list.d/iabsis.list

Modifiez le fichier téléchargé avec

nano /etc/apt/sources.list.d/iabsis.list

Et décommentez la ligne

deb http://open.iabsis.com/debian testing main

Ajoutez le certificat

wget http://open.iabsis.com/open.iabsis.com.asc -O- | apt-key add -

Rafraichissez la liste des paquets

apt-get update

Et finalement installez iGestis

apt-get install igestis

iGestis va vous poser quelques questions.

• Choose the wanted authentication method: choose your actual directory (OpenLDAP or Active Directory). If none, choose Internal
• Choose the admin account name : changez ce compte uniquement si celui proposé ne vous plait pas. Ce compte doit exister dans annuaire le cas échéant.
• Specify the uris for the directory : remplacez ici par l’adresse de votre serveur. En cas d’utilisation de Samba4, gardez l’url ldapi proposée.
• Specify the directory base tree : saisissez le nom de domaine FQDN (exemple: domain.local)
• Specify the directory admin account for the directory : Le bind dn du compte Administrator. Par exemple dc=admin,dc=domain,dc=local pour OpenLDAP ou Administrator@domain.local pour Samba4 ou Active Directory.
• Please specify the admin password for the directory : Le mot de passe de votre compte administrateur.
• Create a user in iGestis when present in the directory ? Préférez Yes
• Configure database for igestis with dbconfig-common? Yes
• Password of the database’s administrative user: Votre mot de passe Root pour Mysql.
• MySQL application password for igestis: Laissez vide pour générer un mot de passe aléatoire
• Web server to reconfigure automatically : Gardez coché apache2 pour une configuration automatique de Apache2.

Ouvrez votre navigateur, saisissez l’adresse de votre serveur et ajoutez /igestis, par exemple : http://ip_de_votre_serveur/igestis

Installation Manuelle

Vous pouvez télécharger iGestis sur l’adresse https://github.com/olivierb2/igestis/releases Ce guide vous permet de configurer iGestis version 3.

Une fois copié sur le serveur, extraire le fichier avec votre gestionnaire d’archive préféré ou utilisez la commande tar xfz igestis-xx.tar.gz ou unzip igestis-xx.zip Déplacez le dossier extrait dans un emplacement non accessible par apache, par example /usr/share/ ou /opt. Configurez apache avec un alias ou créez un lien symbolique afin de rendre le dossier public accessible par apache. Par exemple ln -s /usr/share/igestis/public/ /var/www/igestis Un Alias pour apache pourrait être Alias /igestis /usr/share/igestis/public

Vous pouvez désormais utiliser votre navigateur préféré afin d’accéder à l’interface web de votre serveur : http://ip_de_votre_serveur/igestis Lors de cette première connexion, vous accéderez à une page de vérification de l’installation permettant de consulter les paramètres de votre serveur.

Configuration

Pendant la configuration, vous pourrez rafraichir la page afin de vérifier ce que vous avez modifié.

Correction des problèmes de permissions

Dans un premier temps, autorisez les droits en écriture par le compte Apache sur les répertoires documents et cache. En fonction de votre distribution Linux, faites un chown www-data documents cache ou chown apache documents cache.

Créez une base MySQL

Créez une base de données vide sous MySQL. Depuis la ligne de commande, vous pouvez accéder au shell de Mysql avec :

mysql -uroot -p

Et créez une base pour iGestis :

create database igestis;
create user 'igestis'@'localhost' identified by 'igestis1234';
grant all privileges on igestis.* to 'igestis'@'localhost';
quit

Remplacez igestis1234 par un mot de passe de votre choix (ou aléatoire).

Créez le fichier config.ini.

Créez ensuite un fichier config.ini en copiant le fichier config.ini-template.ini grâce à la commande cp config/igestis/config.ini-template.ini config/igestis/config.ini. Utilisez votre éditeur de texte préféré et modifiez le fichier, comme par exemple nano config/igestis/config.ini. Changez les valeurs des quatre premières lignes afin de l’adapter à votre configuration définie précédemment.

MYSQL_HOST = "localhost"
MYSQL_DATABASE = "igestis"
MYSQL_LOGIN = "igestis"
MYSQL_PASSWORD = ""

Pensez également à changer la variable ENCRYPT_KEY en générant une clef aléatoire. Cette clef sera utilisée pour stocker les données sensibles dans votre base de données tout en restant déchiffrable.

ENCRYPT_KEY = "TBXvZGkFMiKoCsMY1AjlEuexFR6XMo"

Dans ce cas, même si la base de données est volée, ces données resteront cryptées et indéchiffrables sans la clef de décryptage.

Installer la base de données Mysql.

De retour dans la page de vérification, vérifiez une dernière fois que tout est vert ou orange et cliquez sur Launch database update.

Configuration Ldap (optionnelle).

In the of you would like to let user use their Active directory or OpenLDAP account, you can configure iGestis to use and manage the Users LDAP information.

Uncomment the values you want to use. The minimum that you need to define are :

USE_LDAP = true
LDAP_URIS = "ldap://localhost:389"
LDAP_BASE = "dc=example,dc=local"
LDAP_ADMIN = "cn=admin,dc=example,dc=local"
LDAP_PASSWORD = ""
LDAP_USERS_OU = "ou=Users,dc=example,dc=local"
LDAP_CUSTOMERS_OU = "ou=Customers,dc=example,dc=local"
LDAP_SUPPLIERS_OU = "ou=Suppliers,dc=example,dc=local"

• LDAP_ADMIN must be a LDAP account with write privilage on the directory. Don’t forgot to define the LDAP_PASSWORD as well.

• LDAP_USERS_OU is the location in the directory where the new employee will be written LDAP_CUSTOMERS_OU is for new customers and LDAP_SUPPLIERS_OU is for new suppliers.

Others optionnal values can be configured :

• LDAP_AUTO_IMPORT_USER allow a user existing in the directory but not in iGestis to be created on fly in iGestis when the user tries to login in iGestis. Note the employee will be automatically assigned to the first company available.

• LDAP_READONLY (not implemented yet) restricts iGestis for writting in the directory. The only way to create new employees will be using a third party tool.

• LDAP_SCHEMA (not implemented yet) lets you choose the schema you want to enable and use with your directory.

• LDAP_AD_MODE (deprecated) define if the directory is directory is an Active Directory or not.

• LDAP_USER_RDN by default, iGestis create an employee with “uid=%username%”. But Active Directory use the convention “cn=%username%”.

Installation de module (version 3)

iGestis est fourni avec plusieurs modules optionnels

Dépannage

Dans le cas ou vous rencontreriez un problème avec iGestis, suivez la procédure suivante.

iGestis v2

Activez le mode debuggage avec la commande suivante :

nano /usr/share/igestis/index.php

Et modifiez la ligne

define("DEBUG_MODE", false);

En

define("DEBUG_MODE", true);

Ouvrez la page web et tentez à nouveau l’étape ayant échouée, vous devriez avoir maintenant un message plus détaillé du problème.

iGestis v3

Activez le mode debuggage avec la commande suivante :

nano /etc/igestis/config.ini

Et ensuite ajoutez la ligne suivante :

DEBUG_MODE=true

Ouvrez la page web et tentez à nouveau l’étape ayant échouée, vous devriez avoir maintenant un message plus détaillé du problème.