Paramètres de Up ! File Transfer Service

Up ! File Transfer Service est le service réseau multi plates-formes de transfert de fichiers. Ce service est une extension d'Up ! Network.

Up ! File Transfer Service peut être invoqué soit :

Via Up ! Object Request Broker ou Up ! Server.
En ce cas, l'outil est un serveur de transfert de fichiers classique.
Via Up ! Shell.
En ce cas, l'outil est un client interactif de transfert de fichiers.
Via Up ! Script Engine.
En ce cas, l'outil est un client batch interprétant des commandes de transfert de fichiers.
Via un programme compilé.
En ce cas, celui-ci utilise des fonctions de transfert de fichiers en tant que client ou répond à des requêtes de transfert de fichiers en tant que serveur.

Quel que soit son mode d'invocation, Up ! File Transfer Service possède les mêmes paramètres cités dans la section suivante.

Certains paramètres font référence à des fichiers ou à des chemins d'accès. En ce cas, il est possible d'employer des variables environnement dans l'expression des chemins d'accès. Exemple :

Tmp=${UPS_HOME}/demo/tmp/${UPS_USER}

D'autre part, le séparateur de répertoire est le caractère division / et les noms de fichiers ou de répertoires peuvent utiliser les partitions montées automatiquement par Up ! System.

Les paramètres sont lus successivement dans :

Les variables environnement.
Le fichier d'initialisation.
${UPS_HOME}/ini/${UPS_LANGUAGE}/upsaps.ini en mode mono-utilisateur ou ${UPS_HOME}/ini/${UPS_USER}/upsaps.ini en mode multi-utilisateur. Si le programme comporte un profil d'exécution particulier, les paramètres sont lus dans ce profil au lieu de upsaps.ini.
La section est UpsFts.
Le fichier de paramètres.
S'il existe.
La ligne de commande.
Il s'agit soit de :
- La ligne de commande stricto sensu.
- La valeur de la variable environnement QUERY_STRING.
  En ce cas, le programme s'exécute automatiquement et obligatoirement en mode batch en respectant la norme Common Gateway Interface (CGI).
Les paramètres peuvent être préfixés par UpsFts.

Les valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Le format d'une Uniform Resource Identifier pour un accès en File Transfer Protocol est le suivant :

ftp://${NomServeur}:${Port}

Avec :

NomServeur représente le nom du serveur de communication.
Port représente le numéro du port.
Ce numéro est usuellement 21 pour un serveur Ftp.

Paramètres d'exécution

AutoriserAnonymous

AutoriserAnonymous a pour valeur vraie si la connexion par anonymous est autorisée. La valeur par défaut est Non.

Le mot de passe est alors l'e-mail du client.

AutoriserAnonymous=Oui

Compresser

Compresser a pour valeur vraie s'il faut compresser les fichiers à transférer. La valeur par défaut est Non.

La demande de compression est a l'initiative du client.

Compresser=Oui

DroitsDAcces

DroitsDAcces permet de spécifier les droits d'accès d'une arborescence de fichiers visible par un client au travers d'un serveur Up ! File Transfer Service.

Il doit exister un droits d'accès par arborescence. Etant donné qu'il peut en exister plusieurs, ce paramètre comporte un index. La valeur pour le premier index est obligatoirement 1.

Droits d'accès.	Valeur de l'option.
Ecriture.	DroitEcriture
Execution.	DroitLecture
Lecture.	DroitExecution
Lecture et écriture.	DroitLectureEcriture
Lecture et exécution.	DroitLectureExecution
Lecture, écriture et exécution.	DroitLectureEcritureExecution

La valeur par défaut est Lecture.

Voici les règles d'application des droits :

Ecriture.
Les méthodes APPEND, DELETE, RNFR, RNTO, STORE et STORE UNIQUE sont autorisées.
Exécution.
Les méthodes MKD, RMD et SITE CHMOD sont autorisées.
Lecture.
Les méthodes CWD, LIST, NLST, RETRIEVE et HEAD sont autorisées.

LatenceServeur

LatenceServeur est le temps à partir duquel une tâche serveur inactive est détruite. La valeur par défaut est 60 secondes.

LatenceServeur=30

NbClients

NbClients permet de spécifier le nombre de sessions clientes que chaque serveur est sait gérer simultanément. Au delà, la session au serveur est refusée par Up ! File Transfer Service. Les requêtes des clients sont gérées à tour de rôle selon le principe du tourniquet. Par défaut, la valeur est 8.

NbClients=100

NbServeurs

NbServeurs permet de spécifier le nombre de tâches serveurs maximal qu'Up ! File Transfer Service peut lancer pour traiter les demandes en paralèlle. Les demandes d'au plus NbClients*NbServeurs clients seront traitées simultanément, tant qu'il existe une place dans une file d'attente d'un serveur.

Les tâches serveurs sont ajoutées dynamiquement en fonction de la charge du serveur. Quand elles ne sont plus nécessaires, elles sont supprimées. Quand un nouveau client se connecte, le serveur élu est celui qui est le moins chargé.

Par défaut, il y a un unique serveur si le programme en technologie Up ! Virtual Technical Machine est de type serveur i.e. il a été généré avec l'option Lancement=Serveur et zéro sinon.

NbServeurs=4

Port

Port permet de spécifier le début de la plage de ports de communication réservés à l'applicatif. Il y a autant de ports de communication réservés qu'il y a de sessions déclarées par le paramètre NbSessions. Par défaut, la valeur est 2048.

Port=2000

Les ports sont utilisés pour le fonctionnement en mode client de transfert de fichiers.

Racine

Racine permet de spécifier la racine d'une arborescence de fichiers visible par un client au travers d'un serveur Up ! File Transfer Service.

Il doit exister au moins une arborescence. Etant donné qu'il peut en exister plusieurs, ce paramètre comporte un index. Il n'y a pas de valeur par défaut.

Racine1=/ups120/public/partition1 Racine2=/ups120/public/partition2

Repertoire

Repertoire permet de spécifier le répertoire de montage d'une arborescence de fichiers visible par un client au travers d'un serveur Up ! File Transfer Service.

Il doit exister un répertoire de montage par arborescence. Etant donné qu'il peut en exister plusieurs, ce paramètre comporte un index. La valeur pour le premier index est obligatoirement /.

Repertoire1=/ Repertoire2=/tmp

ServiceDefaut

ServiceDefaut permet de spécifier le comportement par défaut d'Up ! File Transfer Service quand aucun module tiers ne veut traiter un ordre Ftp via une méthode de rappel.

Par défaut, le serveur offre les services de transfert de fichiers standard au regard des valeurs des paramètres DroitsDAcces, Racine et Repertoire.

ServiceDefaut=Non

TracerCommunication

TracerCommunication permet de tracer les communications effectuée par le programme. La valeur par défaut est Non.

Cette trace est inscrite dans le fichier ${UPS_HOME}/log/${UPS_LANGUAGE}/${UPS_APPLICATION}-upsfts-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${UPS_APPLICATION}-upsfts-${UPS_SESSION}.log en mode multi-utilisateur.

TracerCommunication=Oui

URIServeur

URIServeur spécifie l'Uniform Resource Identifier d'écoute du serveur Ftp.

Le service d'écoute Ftp est uniquement lancé si URIServeur est renseigné.

URIServeur=ftp://soleil:21

Optimisation du cycle de vie des objets

Type	Conservation possible	Taille par défaut du segment
ClientFtp	Oui.	8.
ServeurFtp	Oui.	8.

ConserverObjets, quand le paramètre est possible, spécifie qu'au plus TailleSegment objets du type sont conservés pré-construits en anté-mémoire au lieu d'être détruits.

Quand un nouvel objet du type est demandé, il est prélevé de l'anté-moire s'il en existe un pré-construit. Cela évite de réaliser des enchaînements de destruction / libération / ... / allocation / création d'objets de ce type trop fréquents.

Par défaut, les objets ne sont pas conservés en anté-mémoire.

ConserverObjetsClientFtp=Oui ConserverObjetsServeurFtp=Non

TailleSegment spécifie la taille d'un segment de mémoire dédié à un objet du type concerné en spécifiant le nombre d'objets de ce dernier par segment de mémoire. Ce nombre ne peut excéder la capacité du ramasse-miettes définie par TailleBloc*NbBlocs.

La valeur est 0 signifie que le type n'a pas ses propres buffers et que les objets du type sont alloués dans le tas commun.

TailleSegmentClientFtp=16 TailleSegmentServeurFtp=4

Exemple de configuration d'Up ! File Transfer Service


; ------------------------------------------------------------------- 

; Fichier    : upsfts.ini                                             

; Objet      : Initialisation d'Up ! File Transfer Service.          

;                                                                     

; Module      : Up ! Application System.                              

; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.                    

; ------------------------------------------------------------------- 

;                          Observations                               

;                                                                      

;                                                                      

; ------------------------------------------------------------------- 



[UpsFts]

AutoriserAnonymous=Oui

Compresser=Oui

ConserverObjetsClientFtp=Oui

ConserverObjetsServeurFtp=Non

LatenceServeur=30

NbClients=4

NbServeurs=2

Port=2048

TailleSegmentClientFtp=16

TailleSegmentServeurFtp=4

TracerCommunication=Oui

URIServeur=ftp://soleil:21



Racine1=${UPS_HOME}/public/partition1

Repertoire1=/

DroitsDAcces1=Lecture

Racine2=${UPS_HOME}/public/partition2

Repertoire2=/tmp

DroitsDAcces2=LectureEcriture