Creation d'instance
###################
Principe généraux
=================
Waarp R66 est une solution multi-instance.
Une unique installation peut servir à plusieurs moniteurs.
Pour cela le dossier de configuration répertorie les configurations des
différentes instances dans un dossier du nom de leur ``HOSTID``.
Le dossier de configuration dépends du type d'installation de waarp:
* :file:`/etc/waarp/conf.d` pour une installation via les rpms
* :file:`etc/conf.d` à partir du dossier d'extraction pour les archives
autoportantes
Dans ce document ce dossier est nommé ``CONFDIR``.
Ainsi un serveur portant 3 moniteurs (server1, server2, server3) Waarp R66
aurait une arborsence semblable à celle ci-dessous.
* :file:`{CONFDIR}/server1`
* :file:`{CONFDIR}/server2`
* :file:`{CONFDIR}/server3`
Création d'une instance Linux
=============================
Création de la configuration
----------------------------
Pour facililter l'initialisation d'une instance, des modèles de configuration
sont fournis. Ces modèles sont situés dans le dossiers ``{TEMPLATES}`` :
* :file:`/usr/share/waarp/templates/` pour une installation via les rpms
* :file:`share/templates` à partir du dossier d'extraction pour les archives
autoportantes
Pour créer une instance, copiez le dossier de modèle dans le dossier
correspondant à la configuration de l'instance :
.. code-block:: bash
cp -r {TEMPLATES} {CONFDIR}/$HOSTID
Ces fichiers sont préconfigurés pour une utilisation standard. Une partie de la
configuration est dépendante de l'instance (identifiants, dossiers, etc.).
Dans les fichiers XML de modèle, la chaîne ``{{app_name}}`` doit être remplacée
par l'identifiant de l'instance :
.. code-block:: sh
for f in {CONFDIR}/$HOSTID/*.xml; do
sed -i -r "s|{{app_name}}|$HOSTID|g" $f
done
Configuration de la base de données
-----------------------------------
Par défaut, la nouvelle instance est configurée pour utiliser la base de données
embarquée H2. Pour utiliser une autre base de données, il faut la configurer
dans les fichier :file:`{CONFDIR}/$HOSTID/server.xml` et
:file:`{CONFDIR}/$HOSTID/client.xml`.
La configuration de la base de données se trouve dans le bloc XML
``...`` :
.. code-block:: xml
postgresql
jdbc:postgresql://localhost/waarp_r66
waarp
waarp
false
Initialisation de la base de données
------------------------------------
Pour initialiser la base de données, exécuter la commande suivante :
.. code-block:: sh
# Avec les packages :
waarp-r66client $HOSTID initdb
# Avec les archives :
./bin/waarp-r66client.sh $HOSTID initdb
Démarrage du serveur
--------------------
.. todo:: à ce stade-là, il manque les données d'authentification
Si l'instance configurée est un serveur, vous pouvez mintenant le démarrer.
.. code-block:: sh
# Avec les packages :
waarp-r66server $HOSTID start
# Avec les archives :
./bin/waarp-r66server.sh $HOSTID start
Création d'une instance Windows
===============================
Création de la configuration
----------------------------
Pour facililter l'initialisation d'une instance, des modèles de configuration
sont fournis. Ces modèles sont situés dans le dossier
:file:`share\\templates` à partir du dossier d'extraction.
Pour créer une instance, copiez le dossier de modèle dans le dossier
correspondant à la configuration de l'instance :
.. code-block:: bat
xcopy /S share\templates {CONFDIR}\%$HOSTID%
Ces fichiers sont préconfigurés pour une utilisation standard. Une partie de la
configuration est dépendante de l'instance (identifiants, dossiers, etc.).
Dans les fichiers XML de modèle, la chaîne ``{{app_name}}`` doit être remplacée
par l'identifiant de l'instance %$HOSTID%.
Configuration de la base de données
-----------------------------------
Par défaut, la nouvelle instance est configurée pour utiliser la base de données
embarquée H2. Pour utiliser une autre base de données, il faut la configurer
dans les fichier :file:`{CONFDIR}\\HOSTID\\server.xml` et
:file:`{CONFDIR}\\HOSTID\\client.xml`.
La configuration de la base de données se trouve dans le bloc XML
``...`` :
.. code-block:: xml
postgresql
jdbc:postgresql://localhost/waarp_r66
waarp
waarp
false
Initialisation de la base de données
------------------------------------
Pour initialiser la base de données, exécuter la commande suivante :
.. code-block:: bat
bin\waarp-r66server.bat %HOSTID% initdb
Démarrage du serveur
--------------------
Si l'instance configurée est un serveur, vous pouves mintenant le démarrer.
Pour une installation avec les archives, la commande est :
.. code-block:: bat
bin\waarp-r66server.bat %HOSTID% start