Cette page décrit l'installation rapide de SynerGaïa sur une machine Linux de type Debian ou Ubuntu.
Cette procédure suppose seulement qu'un serveur web php est installé, par exemple Apache + PHP 7 + CouchDB (voir la procédure d'installationapache)
Prérequis et résumé
L'installation de SynerGaïa est simple et repose sur la configuration préalable suivante :
- vous disposez d'une machine qui servira de serveur (Linux de préférence) sur lequel tournera l'application
- cette machine est donc connectée à votre réseau
- sur cette machine, vous devez avoir installé
- un serveur web (par exemple Apache) sur lequel tourne PHP 7.0 minimum (depuis la version SynerGaïa 2.0)
- un gestionnaire de base de données CouchDB qui stockera et gèrera toutes les informations
- éventuellement une possibilité d'envoyer des mails à l'extérieur (serveur smtp) mais ce n'est pas indispensable pour démarrer
- éventuellement un dispositif de cache pour accélérer les performances (mais ce n'est pas obligatoire pour commencer)
Sur cette configuration préalable, vous allez installer votre première configuration SynerGaïa
- allez chercher le logiciel sur un site de distribution ou dans cette documentation
- dans le répertoire du serveur web (par exemple /var/www/html/), vous créez un répertoire auquel accéderez de l'extérieur pour lancer l'application SynerGaïa
- dans ce répertoire vous décompressez le fichier que vous avez téléchargé.
A partir de ce moment, votre logiciel SynerGaïa est prêt à être utilisé.
C'est la création de l'application proprement dite.
Procédure d'installation de SynerGaïa
Téléchargement et installation des programmes
0. ouvrez un terminal pour taper les instructions
1. installez github si ce n'est déjà fait (github)
sudo apt-get install git
2. importez le logiciel SynerGaïa depuis cette plate-forme
cd /var/lib
sudo git clone https://github.com/pfrappe/synergaia
3. dans le répertoire des applications internet (/var/www/html en principe), créez un répertoire propre pour votre application (ici 'monappli') et donnez lui les droits d'accès pour Apache
cd /var/www/html
mkdir monappli
sudo chown -R www-data:www-data /var/www/html/monappli
où vous remplacez synergaia par le nom de répertoire de votre application
4. recopiez-y le fichier index.php qui se trouve dans le répertoire /var/lib/synergaia
Installation de votre première application
- placez-vous dans le répertoire de vos applications web (probablement /var/www/html)
- créez un répertoire pour votre application (par exemple ici monappli (et donc le répertoire /var/www/monappli)
- recopiez-y le fichier index.php du répertoire SynerGaïa
- créer les liens vers les répertoires du logiciel SynerGaïa :
Lancement et initialisation de SynerGaïa
- ouvrez un navigateur (de préférence safari, firefox, chrome)
- tapez l'adresse de votre serveur et le nom du répertoire (par exemple 127.0.0.1/synergaia) (si vous êtes physiquement sur votre serveur, ne tapez pas localhost car CouchDB refuserait - par défaut - de mettre à jour les bases).
- Une boite de dialogue s'affiche :

- Il s'agit de préciser à SynerGaïa le login d'accès à CouchDB en mode administrateur. Vous remplissez donc le code et le mot de passe qui donne l'accès complet à CouchDB. Vous donnez aussi le préfixe qui s'ajoutera dans CouchDB devant chaque nom de base de votre application (par défaut sg_) :

- Si tout se passe bien, SynerGaïa a désormais accès à CouchDB pour stocker les informations. Il charge donc le dictionnaire.
- A la fin du chargement la fenêtre suivante s'affiche :

- Vous allez créer la fiche de l'administrateur principal de SynerGaïa (probablement vous). Il vous faut un identifiant et un mot de passe :

- SynerGaïa crée alors l'annuaire et la première fiche d'utilisateur. Il vous donne aussi le profil "Administrateur SynerGaïa".
- Quand c'est terminé, vous obtenez la fenêtre :

- Il suffit de cliquer sur "Terminer l'installation"
- Et vous êtes prêt à commencer !

Pour continuer d'avancer dans SynerGaïa, voyez la documentation suivante : Tutoriel : Débuter une application