Waarp R66¶
Contenu
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éesloadconf
: charge la configuration en base de donnéeshelp
: 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 synchroneasend
: démarre un transfert asynchronemsend
: démarre plusieurs transferts synchrones en même tempsmasend
: démarre plusieurs transferts asynchrones en même tempsgetinfo
: récupère les informations des fichiers sur un hôte distanttransfer
: récupère les informations sur un transfertspool
: démarre le client en mode file watcherinitdb
: initialise la base de donnéesloadconf
: charge la configuration en base de donnéeslog-export
: exporte l’historique des transfertsconfig-export
: exporte la configurationhelp
: 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).