Attention : ce document s'adresse aux professionnels de l'informatique

AMAPJ gère de base le multi -tenancy : avec une installation de AMAPJ, il est possible d'héberger x AMAPs. Chaque AMAP dispose de sa base propre, mais il y a un seul serveur

Un manager intégré permet de gérer facilement la liste des amaps, la gestion des logs, ...

La procédure suivante va vous indiquer comment mettre en place le multi tenancy

Vous devez d'abord installer un VPS AMAPJ, en suivant la procédure suivante Installer un VPS AMAPJ

Pour nom d'utilisateur, vous pouvez prendre par exemple prod à la place de amap1

Vous devez ensuite vous connecter par SQL sur la base MASTER

Pour cela, vous démarrez SQUIRREL, vous faites "Aliases / New Alias ..."

Vous choississez ensuite

Name : MASTER

Driver : HSQLDBSERVER

URL : jdbc:hsqldb:hsql://127.0.0.1:8002/master

User Name : SA

Password : laissez vide

Vous devez alors être connecté à la base MASTER

Si vous lancer la requête SQL : select NOMAMAP from PARAMETRES , vous devez obtenir

Vous devez ensuite lancer les 2 requetes SQL suivantes

insert into UTILISATEUR (ID,NOM,PRENOM,EMAIL,ETATUTILISATEUR,PASSWORD,SALT) VALUES(1,'MASTER','master','master@master.fr','ACTIF','jMRZ8T6N56ZqwFWda00rXYsEL7U=','TMpzPYvfq8w=');
INSERT INTO ROLEMASTER (ID,UTILISATEUR_ID) VALUES(1,1);

Vous devez ensuite redemarrer Tomcat

Vous devez ensuite vous connecter en mode MASTER sur votre instance avec l'url suivante contrats.le-nom-de-mon-amap.fr/amapj/master (en remplaçant bien sûr contrats.le-nom-de-mon-amap.fr par votre nom de domaine)

Vous devez alors obtenir ceci

La première chose à faire est de changer le login, mot de passe et e mail de l'utilisateur MASTER, en allant dans "Gestion des utilisateurs".

Ensuite, vous devez aller dans les paramètres généraux, et renseigner le champ "URL de l'application utilisée dans les mails" avec la valeur correspondant à votre installation, c'est à dire http://contrats.le-nom-de-mon-amap.fr/amapj/master (en remplaçant bien sûr contrats.le-nom-de-mon-amap.fr par votre nom de domaine).

Ensuite, vous pouvez aller dans MASTER / Liste des instances

Vous pouvez voir la liste des instances, c'est à dire la liste des bases, chaque base correspondant à une AMAP

Au départ, il y a deux bases : la base MASTER, qui correspond uniquement au management des autres bases, et une base AMAP1, correspondant à une AMAP

Vous pouvez aussi partir à la découverte des écrans de monitoring : Suivi des accès, Visualisation des logs, Statistiques des accès

Imaginons que vous voulez créer une instance de test pour l'AMAP amap-du-jardin.Vous allez dans MASTER / Liste des instances

Vous cliquez sur "Créer une nouvelle instance", et vous remplissez ainsi

Attention : nom correspond à l'url, donc pas d'espace ni d'apostrophe. Dbms doit contenir obligatoirement la valeur hi.

Vous faites suivant, vous obtenez :

Vous remplissez le nom de l'AMAP et la ville, vous faites suivant, vous obtenez :

Vous faites un copier du texte du mail, vous faites suivant, vous obtenez :

Votre base de test pour l'AMAP amap-du-jardin est prête. Vous pouvez y accéder tout de suite par l'url :

http://contrats.le-nom-de-mon-amap.fr/amapj/amap-du-jardin

Les logins et mot de passe sont contenus dans le contenu du mail que vous avez copié

Imaginons que vous voulez créer une instance de production pour l'AMAP amap-au-bon-gout.Vous allez dans MASTER / Liste des instances

Vous cliquez sur "Créer une nouvelle instance", et vous remplissez ainsi

Vous obtenez alors:

Vous remplissez le nom de l'AMAP et la ville, le nom de l'administrateur de cette AMAP, vous faites suivant, vous obtenez :

Vous faites un copier du texte du mail, vous faites suivant, vous obtenez :

Votre base de production pour l'AMAP amap-au-bon-gout est prête. Vous pouvez y accéder tout de suite par l'url :

http://contrats.le-nom-de-mon-amap.fr/amapj/amap-au-bon-gout

Cette base est vide, elle contient un seul utilisateur, le login et mot de passe est contenu dans le mail que vous avez copié