Comment installer iGestis¶

Introduction¶

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

	iGestis v2	iGestis v3	Package name
Commercial: let you manage your quotation, invoicing, orders and accounting	Yes (but not updated)	Yes	igestis-commercial
Ajaxplorer: Access remotely to your files (not available for iGestis 3 yet	Yes	Not yet	igestis-ajaxplorer
Roundcube: Display and manage your mail within iGestis	Yes	Yes	igestis-roundcube
OpenChange: Extend Active Directory attributes to manage OpenChange.	Yes	Not yet	igestis-roundcube
Samba: Extend OpenLDAP attributes to manage Samba 3/4.	Yes	Yes	igestis-roundcube
ServerMgmt: Easily setup your folder access right within iGestis.	No	Yes	igestis-roundcube

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.