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:

/etc/waarp/conf.d pour une installation via les rpms
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.

CONFDIR/server1
CONFDIR/server2
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} :

/usr/share/waarp/templates/ pour une installation via les rpms

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 :

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 :

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 CONFDIR/$HOSTID/server.xml et CONFDIR/$HOSTID/client.xml.

La configuration de la base de données se trouve dans le bloc XML <db>...</db> :

<db>
   <dbdriver>postgresql</dbdriver>
   <dbserver>jdbc:postgresql://localhost/waarp_r66</dbserver>
   <dbuser>waarp</dbuser>
   <dbpasswd>waarp</dbpasswd>
   <dbcheck>false</dbcheck>
</db>

Initialisation de la base de données¶

Pour initialiser la base de données, exécuter la commande suivante :

# Avec les packages :
waarp-r66client $HOSTID initdb

# Avec les archives :
./bin/waarp-r66client.sh $HOSTID initdb

Démarrage du serveur¶

Si l’instance configurée est un serveur, vous pouvez mintenant le démarrer.

# 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 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 :

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 CONFDIR\HOSTID\server.xml et CONFDIR\HOSTID\client.xml.

La configuration de la base de données se trouve dans le bloc XML <db>...</db> :

<db>
   <dbdriver>postgresql</dbdriver>
   <dbserver>jdbc:postgresql://localhost/waarp_r66</dbserver>
   <dbuser>waarp</dbuser>
   <dbpasswd>waarp</dbpasswd>
   <dbcheck>false</dbcheck>
</db>

Initialisation de la base de données¶

Pour initialiser la base de données, exécuter la commande suivante :

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 :

bin\waarp-r66server.bat %HOSTID% start