Waarp R66

Waarp R66 est un moniteur de transfert de fichier. Il implémente le protocole R66.

Chaque transfert est associé à une règle de transfert, permettant de définir les chaînes de traitement à exécuter avant et après le transfert, en cas de succès et en cas d’erreur.

Modes de fonctionnement

Waarp R66 peut être exécuté dans les modes suivants :

Serveur

Le serveur doit utiliser une base de données. sa configuration est enregistrée en base de données. Il peut recevoir et initier des demandes de transferts;

Client lourd

Le client lourd utilise une base de données. Sa configuration est enregistrée en base de données. Le client ne peut qu’initier des demandes de transfert ;

Client léger

Le client léger n’utilise pas de base de données. Il utilise les fichiers XML de configuration. Le client ne peut qu’initier des demandes de transfert.

File watcher

Il s’agit d’un client Waarp R66, configuré pour surveiller un dossier. Tout les fichiers déposés dans ce dossier sont transférés automatiquement vers le partenaire indiqué dans la configuration du client et en utilisant la règle de transfert indiquée au même endroit.

Dans tous les cas, et selon les règles de transfert disponibles, les transferts peuvent être initiés en envoi (mode push) ou en réception (mode pull).

Dossiers utilisés

Les instances Waarp R66 (client et serveur) utilisent les dossiers suivants (dans la suite, hostid correspond à l’identifiant de l’instance) :

/etc/waarp/conf.d/hostid

Contient les fichiers de configuration XML de Waarp R66.

/var/lib/waarp/hostid/arch

Dossier de destination des exports de la configuration et des logs.

/var/lib/waarp/hostid/db

Dossier où les bases de données sont créées si l’instance est configurée pour fonctionner avec une base de données embarquée (H2).

/var/lib/waarp/hostid/in

Dossier où sont placés les fichiers reçus par Waarp R66.

/var/lib/waarp/hostid/out

Dossier où doivent être lacés les fichiers à envoyer par Waarp R66.

/var/lib/waarp/hostid/work

Dossier où sont stockés temporairement les fichiers en cours de réception.

/var/log/waarp

Dossier où sont enregistrés les logs.

Commandes

Contrôle des instances Waarp R66

Serveur

Le démarrage et l’arrêt des instances Waarp R66 sont commandés par le gestionnaire de services :

service waarp-r66server {start|stop|status|restart} [hostid|all]

Par exemple, la commande suivante démarre le serveur server1 :

service waarp-r66server start server1

Si aucun identifiant d’instance n’est renseigné (hostid), seules les instances configurées pour être démarrées et arrêtées automatiquement sont impactées par la commande. Si le mot-clef all est donné, toutes les instances Waarp R66 Server configurées sont impactées.

De plus certaines opérations spécifiques aux passerelles sont commandées par le programme waarp-gwftp qui accepte les commandes suivantes:

  • initdb : initialise la base de données

  • loadconf : charge la configuration en base de données

  • help : affiche le message d’aide

La commande waarp-r66 doit être suivi par l’identifiant de l’instance voulue.

Par exemple, la commande suivante initialise la base de données du serveur server1 :

waarp-r66server server1 initdb

Client

Les opérations d’un client sont commandé par le programme waarp-r66client.

Ce script permet les actions suivantes :

  • send : démarre un transfert synchrone

  • asend: démarre un transfert asynchrone

  • msend: démarre plusieurs transferts synchrones en même temps

  • masend: démarre plusieurs transferts asynchrones en même temps

  • getinfo : récupère les informations des fichiers sur un hôte distant

  • transfer : récupère les informations sur un transfert

  • spool : démarre le client en mode file watcher

  • initdb : initialise la base de données

  • loadconf : charge la configuration en base de données

  • log-export : exporte l’historique des transferts

  • config-export : exporte la configuration

  • help : affiche le message d’aide

La commande waarp-r66client doit être suivi par l’identifiant de l’instance voulue.

Par exemple, la commande suivante lance le client fw-client en mode file watcher :

waarp-r66client fw-client spool

Envoi d’un fichier

Pour envoyer un fichier entrer la commande suivante dans un terminal de la VM :

waarp-r66client.sh {{sender}} send -file {{file}} -to {{receiver}} -rule {{rule}}

Où :

  • {{sender}} est l’identifiant du partenaire source ;

  • {{file}} est le chemin du fichier à envoyer ;

  • {{receiver}} est l’identifiant du partenaire destinataire ;

  • {{rule}} est le nom de la règle à utiliser.

Par exemple, la commande suivante envoie le fichier testfile.txt du dossier courant du client wm-client au serveur server1 :

waarp-r66client.sh wm-client send -file testfile.txt -to server1 -rule default

Lancer un client en mode file watcher

Pour activer le mode file watcher du client waarp fw-client, exécuter la commande suivante :

waarp-r66client.sh fw-client spool

fw-client est paramétré pour surveillé le dossier /var/lib/waarp/fw-client/spool.

Le file watcher s’arrête quand un fichier avec le nom stop est déposé dans le dossier surveillé (le nom du fichier d’arrêt est paramétrable).