Paramètres de Up ! Content Service

Up ! Content Service est le service réseau multi plates-formes de consultation ou de mise à jour de ressources. Ce service est une extension d'Up ! Network.

Up ! Content Service peut être invoqué soit :

Quel que soit son mode d'invocation, Up ! Content 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 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 HyperText Transfer Protocol est le suivant :

http://${NomServeur}:${Port}

Avec : Pour connaître les paramètres des frontaux Http en technologie tierce, merci de se référer aux fiches :

Paramètres d'exécution

Archiver

Archiver permet de spécifier que réponse des requêtes d'Up ! Content Service sont conservées dans des archives portant le nom du programme et localisées dans RepertoireAnteMemoire et non des sous-répertoires.

Par défaut, il s'agit d'archives.

Archiver=Non

AutoriserAnonymous

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

Si la connexion anonyme n'est pas autorisée alors le client doit s'identifier un utilisateur et un mot de passe géré par Up ! Security Manager.

AutoriserAnonymous=Oui

AutoriserRoutage

AutoriserRoutage a pour valeur vraie si le routage est autorisé pour Http. La valeur par défaut est Non.

AutoriserRoutage=Oui

Compresser

Compresser a pour valeur vraie s'il faut compresser les contenus à transférer. Ce paramètre affecte le client et le serveur. 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 ! Content 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 :

DroitDAcces1=Lecture DroitsDAcces2=LectureEcriture

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 ! Content 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 ! Content 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

PasDeCacheClient

PasDeCacheClient a pour valeur vraie si aucun résultat de requête n'est conservé dans l'anté-mémoire persistant. En ce cas, les requêtes sont systématiquement soumises aux serveurs.

Par défaut, il y a un cache pour le client.

PasDeCacheClient=Oui

PasDeCacheServeur

PasDeCacheServeur a pour valeur vraie si aucun résultat de requête n'est conservé dans l'anté-mémoire persistant. En ce cas, le résultat des requêtes sont systématiquement recalculées.

Par défaut, il y a un cache pour le serveur.

PasDeCacheServeur=Oui

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 ! Content Service.

Il doit exister au moins une arborescence. Etant donné qu'il peut en exister plusieurs, ce paramètre comporte un index. La valeur pour le premier index est obligatoirement 1.

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 ! Content 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 1.

Il n'y a pas de valeur par défaut.

Repertoire1=/ Repertoire2=/tmp

RepertoireAnteMemoire

RepertoireAnteMemoire permet de spécifier dans lequel sont conservés les caches d'Up ! Content Service. Ce paramètre est obligatoire.

La valeur par défaut est ${UPS_HOME}/upsnet/upsnet. Il y a une archive par utilisateur.

RepertoireAnteMemoire=/users/http

ServiceDefaut

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

Par défaut, le serveur offre les services de transfert de contenu standard, tel Apache, 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}-upscns-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${UPS_APPLICATION}-upscns-${UPS_SESSION}.log en mode multi-utilisateur.

TracerCommunication=Oui

URIServeur

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

Le service d'écoute Http est uniquement lancé si URIServeur est renseigné. Il ne peut correspondre à une URL scruptée par un frontal Http en technologie tiers.

URIServeur=http://soleil:80

Optimisation du cycle de vie des objets

TypeConservation possibleTaille par défaut
du segment
ClientContenuOui.8.
ReponseContenuOui.8.
RequeteContenuOui.8.
ServeurContenuOui.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.

ConserverObjetsClientContenu=Oui
ConserverObjetsReponseContenu=Non
ConserverObjetsRequeteContenu=Oui
ConserverObjetsServeurContenu=Oui

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.

TailleSegmentClientContenu=16
TailleSegmentReponseContenu=16
TailleSegmentRequeteContenu=16
TailleSegmentServeurContenu=4

Exemple de configuration d'Up ! Content Service

; -------------------------------------------------------------------
; Fichier : upscns.ini
; Objet : Initialisation d'Up ! Content Service.
;
; Module : Up ! Application System.
; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.
; -------------------------------------------------------------------
; Observations
;
;
; -------------------------------------------------------------------

[UpsCns]
AutoriserAnonymous=Oui
Compresser=Oui
ConserverObjetsClientContenu=Oui
ConserverObjetsReponseContenu=Non
ConserverObjetsRequeteContenu=Oui
ConserverObjetsServeurContenu=Oui
LatenceServeur=30
NbClients=4
NbServeurs=2
Port=2048
RepertoireAnteMemoire=/users/http
TailleSegmentClientContenu=16
TailleSegmentReponseContenu=16
TailleSegmentRequeteContenu=16
TailleSegmentServeurContenu=4
TracerCommunication=Oui
URIServeur=http://soleil:80

DroitsDAcces1=Lecture
Racine1=${UPS_HOME}/public/partition1
Repertoire1=/
DroitsDAcces2=LectureEcriture
Racine2=${UPS_HOME}/public/partition2
Repertoire2=/tmp