Commandes Java brutes

Les commandes Waarp R66 peuvent être appélé directement sans passer par les scripts Waarp R66 Client et Waarp R66 Server.

Tous les appels sont de la forme :

java -cp "path/to/waarp/jars" [options jvm] [classname] [class arguments]

Le détail des classes pouvant être exécutées et de leurs arguments est décrit ci-dessous.

Options additionnelles pour Waarp via la JVM

-Dopenr66.locale=en|fr

(défaut = en)

Permet choisir entre l’anglais ou le français pour le langage de l’interface

-Dopenr66.ishostproxyfied=1|0

(défaut = 0)

Indique que ce serveur est derrière un proxy (comme R66Proxy ou un matériel équivalent) afin d’empêcher le contrôle des adresses IP de s’appliquer (puisque celle-ci sera celle du Proxy)

-Dopenr66.startup.warning=1|0

(défaut = 1)

Indique si les messages de démarrage doivent être inscrits dans les logs avec le niveau warning (1) ou info (0).

-Dopenr66.startup.checkdb=1|0

Obsolète depuis la version 3.1.0: Utiliser -Dopenr66.autoUpgrade à la place

-Dopenr66.startup.autoUpgrade=0|1

(défaut = 0)

Nouveau dans la version 3.1.0.

Active la mise-à-jour automatique de la base de données au lancement du programme

-Dopenr66.chroot.checked=1|0

(défaut = 1)

Active le mode chroot pour les connexions clientes.

Par exemple, tenter de récupérer un fichier (RECV) depuis un partenaire distant en spécifiant un chemin complet peut être autorisé, même si il est en dehors du répertoire « OUT », sauf si checked=1. Si checked=1, alors tous les fichiers reçus doivent spécifier un chemin inclu dans « OUT », sans remonter au-delà.

-Dopenr66.blacklist.badauthent=1|0

(défaut = 1)

Active le banissement temporaire des partenaires distants en cas d’erreur d’authentification. Cette option permet de prévenir les attaques de type DDOS.

Si -Dopenr66.ishostproxyfied=1, alors il est obligatoirement faux. En effet, dans ce cas, si un des partenaires a un problème d’authentification, alors tous les partenaires proxifiés via le même proxy seront bannis puisque visibles depuis la même adresse IP.

-Dopenr66.filename.maxlength=n

(défaut = 255)

Définit la longueur maximale autorisée pour les nom de fichiers reçus (nom temporaire et nom final). Ceci n’empêche pas de changer le nom du fichier après et #ORIGINALFILENAME# contient toujours le nom complet d’origine du fichier, non tronqué.

-Dopenr66.trace.stats=n

(défaut = 0)

pour mettre en debug certaines traces spécifiques sur des données toutes les n secondes. 0 signifie absence de trace.

-Dopenr66.cache.limit=n et -Dopenr66.cache.timelimit=m

(défaut n = 20000, m=180000)

Modifié dans la version 3.2.0: Le cache a été supprimé, ces options sont ignorées

pour mettre en cache les informations de transfert avec

  • n est le nombre maximum de tâches à conserver dans un cache LRU (Last Recent Used). La valeur minimale est 100

  • m est le temps maximum en millisecondes avant qu’un élément créé, utilisé ou modifié soit évincé du cache. La valeur minimale est 1000 ms (1s). Une valeur trop grande peut provoquer des consommations mémoires trop importante.

-Dopenr66.usespaceseparator=0|1

(défaut = 0)

Autorise Waarp à utiliser l’espace comme séparateur mais induit des risques de bugs.

-Dopenr66.executebeforetransferred=0|1

(défaut = 1)

Autorise Waarp à exécuter les Error-Tasks si une erreur intervient pendant les « pré-task », avant le transfert effectif

org.waarp.client.Message

Permet d’échanger un message simple avec un partenaire pour s’assurer de la connectivité et de l’authentification respective entre les partenaires.

Cette commande accepte les arguments suivants :

clientConfigurationFile.xml

obligatoire

Fichier de confguration client Waarp R66, en mode synchrone

-to PARTNER

obligatoire

Serveur R66 de destination

-msg MESSAGE

obligatoire pour indiquer le message à transmettre

Contenu du message à transmettre. Celui-ci apparaîtra dans les logs respectifs des deux serveurs (émetteur et récepteur).

Codes de retour :

Code

Signification

0

Succès

1

Les arguments sont incorrects ou le fichier de configuration contient une erreur

2

Une erreur s’est produite lors de la tentative de connexion ou d’authentification

org.waarp.client.BusinessRequest

Permet de déclencher une action à distance avec un partenaire si le partenaire demandeur est autorisé (cf. BUSINESS ROLE)

Cette commande accepte les arguments suivants :

clientConfigurationFile.xml

obligatoire

Fichier de confguration client Waarp R66, en mode synchrone

-to PARTNER

obligatoire

Serveur R66 de destination

-class FULL.CLASS.NAME

obligatoire pour indiquer la classe cible à exécuter de type ExecBusinessTask

Nom de la classe à exécuter

-arg ARGUMENT

Argument à appliquer à la classe

-nolog

Désactive les logs pour ce transfert

Codes de retour :

Code

Signification

0

Succès

2

Les arguments sont incorrects ou le fichier de configuration contient une erreur

N

Une erreur s’est produite lors de la tentative d’exécution