Guide des commandes Dispatcher et CBR

Le présent chapitre décrit l'utilisation des commandes dscontrol de Dispatcher. Il traite également des commandes de CBR.

Dans les versions antérieures où le produit se nommait Network Dispatcher, la commande de contrôle de Dispatcher était ndcontrol. Elle s'intitule désormais dscontrol. Veillez à mettre à jour tous les fichiers script précédents pour utiliser la commande dscontrol (au lieu de ndcontrol) et configurer Dispatcher.

CBR utilise un sous-ensemble des commandes Dispatcher répertoriées dans ce guide des commandes. Lorsque vous utilisez ces diagrammes de syntaxe pour CBR, remplacez dscontrol par cbrcontrol. Pour plus d'informations, voir Différences de configuration entre CBR et Dispatcher.

La liste suivante contient les commandes relevées dans le présent chapitre :

Vous pouvez entrer une version abrégée des paramètres de commande dscontrol. Il suffit d'entrer les lettres spécifiques des paramètres. Par exemple, pour obtenir l'aide correspondant à la commande file save, vous pouvez entrer dscontrol he f au lieu de dscontrol help file.

Pour démarrer l'interface de ligne de commande, entrez dscontrol pour ouvrir une invite dscontrol.

Pour fermer l'interface de ligne de commande, entrez exit ou quit.

Les valeurs des paramètres de commande doivent être saisies en anglais. Les seules exceptions s'appliquent aux noms d'hôte (utilisés dans les commandes cluster, server et highavailability) et aux noms de fichiers (utilisés dans les commandes file).

Différences de configuration entre CBR et Dispatcher

L'interface de ligne de commande de CBR est un sous-ensemble de l'interface de ligne de commande de Dispatcher. Pour CBR, remplacez la commande dscontrol par la commande cbrcontrol pour configurer le composant.

Remarque :
Le composant Content Based Routing (CBR) n'est pas disponible sur les plateformes qui exécutent la machine virtuelle Java 64 bits, à l'exception de HP-UX ia64. Sous HP-UX ia64, le composant CBR exécute une application de 32 bits. Vous pouvez utiliser la méthode de réacheminement CBR du composant Load Balancer's Dispatcher afin de fournir un routage basé sur le contenu sans l'utilisation de Caching Proxy. Pour plus de détails, voir Fonction CBR de Dispatcher (méthode d'acheminement cbr).

Certaines des commandes inutilisées dans CBR sont répertoriées ci-dessous.

  1. highavailability
  2. subagent
  3. executor
  4. cluster
  5. port
  6. rule add {c:p:r} type port
  7. server

dscontrol advisor — Contrôle du conseiller

Lire le diagrammeSauter le diagramme>>-dscontrol--advisor--+-connecttimeout--Nom--+-port---------+--délai d'expiration en secondes-+-><
                       |                      '-cluster:port-'                                 |
                       +-interval--Nom--+-port---------+--secondes-----------------------------+
                       |                '-cluster:port-'                                       |
                       +-list------------------------------------------------------------------+
                       +-loglevel--Nom--+-port---------+--niveau-------------------------------+
                       |                '-cluster:port-'                                       |
                       +-logsize--Nom--+-port---------+--+-unlimited----------------+----------+
                       |               '-cluster:port-'  '-nombre d'enregistrements-'          |
                       +-receivetimeout--Nom--+-port---------+--délai d'expiration en secondes-+
                       |                      '-cluster:port-'                                 |
                       +-report--Nom--+-port---------+-----------------------------------------+
                       |              '-cluster:port-'                                         |
                       +-retries--Nom--+-port---------+--nbrtentatives-------------------------+
                       |               '-cluster:port-'                                        |
                       +-start--Nom--+-port---------+--+-----------------+---------------------+
                       |             '-cluster:port-'  '-fichier journal-'                     |
                       +-status--Nom--+-port---------+-----------------------------------------+
                       |              '-cluster:port-'                                         |
                       +-stop--Nom--+-port---------+-------------------------------------------+
                       |            '-cluster:port-'                                           |
                       +-timeout--Nom--+-port---------+--+-unlimited-+-------------------------+
                       |               '-cluster:port-'  '-secondes--'                         |
                       '-version--Nom--+-port---------+----------------------------------------'
                                       '-cluster:port-'
 

connecttimeout
Permet de définir le délai à l'expiration duquel un conseiller signale qu'une connexion à un serveur pour un port particulier d'un serveur (d'un service) a échoué. Pour plus d'informations, voir Délai de connexion du conseiller et délai de réception pour les serveurs.
nom
Nom du conseiller. Les valeurs possibles sont connect, db2, dns, ftp, http, https, cachingproxy, imap, ldap, ldaps, nntp, ping, pop3, self, sip, smtp, ssl, ssl2http, telnet et wlm.

Pour plus d'informations sur les conseillers que fournit Load Balancer, voir Liste des conseillers.

Les noms des conseillers personnalisés sont au format xxxx, ADV_xxxx étant le nom de la classe mettant en oeuvre le conseiller personnalisé. Pour plus d'informations, voir Création de conseillers personnalisés.

port
Numéro du port contrôlé par le conseiller.
cluster:port
La valeur de cluster est facultative dans les commandes du conseiller, mais la valeur de port est requise. Si la valeur de cluster n'est pas indiquée, le conseiller s'exécutera sur le port de tous les clusters. Si vous indiquez un cluster, le conseiller s'exécutera sur le port uniquement pour le cluster spécifié. Pour plus d'informations, voir Démarrage et arrêt d'un conseiller.

Le cluster correspond à l'adresse IP ou au nom symbolique. Le port correspond au numéro du port que le conseiller surveille.

délai d'expiration en secondes
Il s'agit d'un entier positif représentant la période en secondes pendant laquelle le conseille attend avant de signaler qu'une connexion à un serveur a échoué. La valeur par défaut est trois fois la valeur spécifiée pour l'intervalle du conseiller.
interval
Définit la fréquence à laquelle le conseiller demande des informations aux serveurs.
secondes
Il s'agit d'un entier positif qui représente le nombre de secondes entre les demandes envoyées aux serveurs pour connaître leurs états en cours. Valeur par défaut : 7.
list
Affiche la liste des conseillers qui fournissent des informations au gestionnaire.
loglevel
Définit le niveau de consignation relatif à un journal de conseiller.
niveau
Valeur du niveau (0 à 5). La valeur par défaut est 1. Plus la valeur est élevée, plus la quantité d'informations consignée dans le journal du conseiller est importante. Les valeurs possibles sont les suivantes : 0 (Aucun), 1 (Minimal), 2 (De base), 3 (Modéré), 4 (Avancé), 5 (Prolixe).
logsize
Définit la taille maximale d'un journal de conseiller. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La taille du journal ne peut pas être moins élevée que la taille actuelle du journal. Les entrées du journal sont horodatées, ce qui permet de déterminer l'ordre dans lequel elles ont été enregistrées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie attentivement car l'espace peut être saturé rapidement lors d'une consignation à des niveaux plus élevés.
nombre d'enregistrements
Taille maximale (en octets) du fichier journal du conseiller. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il se peut que le fichier journal n'atteigne pas la taille maximale exacte avant l'écrasement, car la taille des entrées de journal elles-mêmes varie. La valeur par défaut est 1 Mo.
receivetimeout
Permet de définir le délai à l'expiration duquel un conseiller signale que la réception d'un envoi provenant d'un port particulier d'un serveur (d'un service) a échoué. Pour plus d'informations, voir Délai de connexion du conseiller et délai de réception pour les serveurs.
délai d'expiration en secondes
Il s'agit d'un entier positif qui représente la période en secondes pendant laquelle le conseiller attend avant de signaler qu'une réception d'un envoi provenant d'un serveur a échoué. La valeur par défaut est trois fois la valeur spécifiée pour l'intervalle du conseiller.
report
Affiche un rapport sur l'état du conseiller.
retry
Nombre de tentatives accordées à un conseiller avant de déclarer un serveur arrêté.
nbrtentatives
Entier supérieur ou égal à zéro. Il est préférable que le nombre de tentatives ne dépasse pas 3. Par défaut, le nombre de tentatives est égal à zéro.
start
Démarre le conseiller. Il existe des conseillers pour chaque protocole. Les ports par défaut sont les suivants :
Nom du conseiller Protocole port
cachingproxy HTTP (via Caching Proxy) 80
connexion ICMP 12345
db2 privé 50000
dns DNS 53
ftp FTP 21
http HTTP 80
https SSL 443
imap IMAP 143
ldap LDAP 389
ldaps SSL 443
nntp NNTP 119
ping PING 0
pop3 POP3 110
self privé 12345
sip SIP 5060
smtp SMTP 25
ssl SSL 443
ssl2http SSL 443
telnet Telnet 23
WLM privé 10,007
Remarque :
Le conseiller FTP doit est activé uniquement pour le port de contrôle FTP (21). Ne démarrez pas un conseiller FTP sur le port de données FTP (20).
fichier journal
Nom du fichier dans lequel les données de gestion sont consignées. Chaque enregistrement du journal est horodaté.

Le fichier par défaut est nom_conseiller_port.log, par exemple, http_80.log. Pour changer le répertoire dans lequel les fichiers journaux sont enregistrés, voir Modification des chemins des fichiers journaux. Les fichiers journaux par défaut des conseillers spécifiques de clusters (ou de sites) sont créés avec l'adresse du cluster, comme http_127.40.50.1_80.log.

status
Affiche l'état en cours de toutes les valeurs d'un conseiller qui peuvent être affectées globalement, ainsi que les valeurs par défaut associées.
stop
Arrête le conseiller.
timeout
Définit le nombre de secondes pour lequel le gestionnaire considère que les informations provenant du conseiller sont valides. Si le gestionnaire considère que les informations du conseiller sont antérieures à ce délai, il n'utilise pas ces informations pour déterminer les pondérations relatives aux serveurs sur le port contrôlé par le conseiller. Il est fait exception à ce délai lorsque le conseiller a informé le gestionnaire qu'un serveur spécifique est hors service. Le gestionnaire utilise ces informations relatives au serveur même après le dépassement du délai imparti aux informations du conseiller.
secondes
Nombre positif représentant le nombre de secondes, ou le mot unlimited. La valeur par défaut est unlimited.
version
Affiche la version en cours du conseiller.

Exemples

dscontrol binlog — Contrôle du fichier journal binaire

Lire le diagrammeSauter le diagramme>>-dscontrol--binlog--+-start-----------------------+----------><
                      +-stop------------------------+
                      +-set--+-retention--heures--+-+
                      |      '-interval--secondes-' |
                      '-status----------------------'
 

start
Lance la consignation binaire.
stop
Arrête la consignation
set
Définit les zones de consignation. Pour plus d'informations sur la définition des zones pour la consignation binaire, voir Utilisation de la consignation binaire pour analyser les statistiques des serveurs.
rétention
Nombre d'heures pendant lesquelles les fichiers journaux sont conservés. La valeur de rétention par défaut est 24.
heures
Nombre d'heures.
interval
Nombre de secondes qui s'écoulent entre deux entrées de journal. La valeur par défaut est 60.
secondes
Nombre de secondes.
status
Affiche la rétention et les intervalles du journal.

dscontrol cluster — Configuration des clusters

Lire le diagrammeSauter le diagramme>>-dscontrol--cluster--+-add--cluster+c2+...;;--+-------------------------------------------+-+-><
                       |                      +-address--adresse--------------------------+ |
                       |                      +-proportions--activ.--nouv.--port--système-+ |
                       |                      +-maxports--taille--------------------------+ |
                       |                      +-maxservers--taille------------------------+ |
                       |                      +-stickytime--heure-------------------------+ |
                       |                      +-weightbound--pondération------------------+ |
                       |                      +-porttype--type----------------------------+ |
                       |                      +-primaryhost--adresse----------------------+ |
                       |                      +-staletimeout--délai d'expiration----------+ |
                       |                      '-sharedbandwidth--taille-------------------' |
                       +-set--cluster+c2+...;;--+-proportions--activ.--nouv.--port--système-+-+
                       |                      +-maxports--taille--------------------------+ |
                       |                      +-maxservers--taille------------------------+ |
                       |                      +-stickytime--heure-------------------------+ |
                       |                      +-weightbound--pondération------------------+ |
                       |                      +-porttype--type----------------------------+ |
                       |                      +-primaryhost--adresse----------------------+ |
                       |                      +-staletimeout--délai d'expiration----------+ |
                       |                      '-sharedbandwidth--taille-------------------' |
                       +-remove--cluster----------------------------------------------------+
                       +-report--cluster----------------------------------------------------+
                       '-status--cluster----------------------------------------------------'
 

add
Ajoute ce cluster. Vous devez définir au moins un cluster.
cluster
Nom ou adresse du cluster auquel les clients se connectent sous forme de nom symbolique ou d'adresse IP. Il est possible d'utiliser la valeur 0.0.0.0 pour spécifier un cluster générique. Utilisation d'un cluster générique pour combiner les configurations serveurs.

Vous pouvez utiliser le signe deux-points (:) comme caractère générique sauf pour la commande dscontrol cluster add. Par exemple, la commande dscontrol cluster set : weightbound 80 permet de définir une pondération de 80 pour tous les clusters.

Remarque :
Chaque cluster supplémentaire doit être séparé du précédent par le signe plus (+).
address
Adresse IP unique de la machine TCP sous forme de nom d'hôte ou d'adresse IP. S'il n'est pas possible de résoudre la valeur du cluster, vous devez fournir l'adresse IP de la machine physique.
Remarque :
Address ne s'applique qu'au composant Dispatcher.
adresse
Valeur de l'adresse du cluster.
proportions
Au niveau du cluster, définit le niveau d'importance (proportion) des connexions actives (actives), des nouvelles connexions (nouvelles), des informations en provenance des conseillers (port) et des informations provenant d'un programme de contrôle système tel que Metric Server (système) utilisées par le gestionnaire pour définir les pondérations des serveurs. Chacune des valeurs décrites ci-après est exprimée en pourcentage de la valeur totale, et par conséquent, leur somme est toujours égale à 100. Pour plus d'informations, voir Proportion de l'importance accordée aux données d'état.
activ.
Nombre compris entre 0 et 100 représentant la proportion de pondération à affecter aux connexions actives. La valeur par défaut est 50.
nouv.
Nombre compris entre 0 et 100 représentant la proportion de pondération à affecter aux nouvelles connexions. La valeur par défaut est 50.
port
Nombre compris entre 0 et 100 représentant la proportion de pondération à affecter aux informations provenant des conseillers. La valeur par défaut est 0.
Remarque :
Lorsqu'un conseiller est démarré et que la proportion du port est 0, Load Balancer définit automatiquement la valeur 1 pour que le gestionnaire puisse utiliser les informations du conseiller en tant qu'entrée pour calculer la pondération du serveur.
système
Nombre compris entre 0 et 100 représentant la proportion de pondération à affecter aux informations provenant d'une mesure système, par exemple, Metric Server. La valeur par défaut est 0.
maxports
Nombre maximal de ports. La valeur par défaut du paramètre maxports est 8.
taille
Nombre de ports autorisés
maxservers
Nombre maximal par défaut de serveurs par port. Ce paramètre peut être remplacé pour des ports spécifiques, à l'aide de la commande port maxservers. La valeur par défaut de maxservers est 32.
taille
Nombre de serveurs autorisés par port
stickytime
Délai de maintien de routage par défaut pour les ports à créer. Ce paramètre peut être remplacé pour des ports individuels, à l'aide de la commande port stickytime. La valeur par défaut du délai de maintien de routage est 0. La valeur par défaut du délai de maintien de routage est 0.
Remarque :
Pour la méthode d'acheminement CBR de Dispatcher, si le délai de maintien de routage est différent de zéro, le délai de maintien de routage est activé pour les ports SSL (non HTTP). L'affinité SSL ID est activée si le port ajouté est un port SSL et que le délai de maintien de routage des ports à créer est différent de zéro. Pour la désactiver, vous devez associer de façon explicite un délai de maintien de routage de 0 au port.
heure
Valeur du paramètre stickytime en secondes.
weightbound
Limite de pondération par défaut du port. Ce paramètre peut être remplacé pour des ports individuels, à l'aide de la commande port weightbound. La valeur par défaut de la pondération est de 20.
pondération
Valeur de la limite de pondération
porttype
Type de port par défaut. Ce paramètre peut être remplacé pour des ports individuels, à l'aide de la commande port porttype.
type
La valeurs possibles sont tcp, udp et both.
primaryhost
Adresse NFA des machines Dispatcher, principale et de secours. Dans une configuration de haute disponibilité réciproque , le cluster est associé soit à la machine principale, soit à celle de secours.

Si vous modifiez l'hôte principal d'un cluster alors que les machines principale et de secours sont lancées et exécutées en haute disponibilité réciproque, vous devez contraindre le nouvel hôte principal à prendre le relais. Vous devrez ensuite mettre à jour les scripts puis déconfigurer et reconfigurer le cluster correctement. Pour plus d'informations, voir Haute disponibilité réciproque.

adresse
Valeur de l'adresse du primaryhost. Elle correspond par défaut à l'adresse NFA de cette machine.
staletimeout
Nombre de secondes d'inactivité possible sur une connexion avant que cette dernière soit supprimée. La valeur par défaut pour FTP est 900 et celle pour Telnet est 259 200. La valeur par défaut pour tous les autres protocoles est 300. Ce paramètre peut être remplacé pour des ports individuels, à l'aide de la commande port staletimeout. Pour plus d'informations, voir Utilisation de la valeur du délai d'attente.
délai d'expiration
Valeur du paramètre staletimeout.
sharedbandwidth
Quantité maximale de bande passante (en kilo-octets par seconde) pouvant être partagée au niveau du cluster. Pour plus d'informations sur la bande passante partagée, voir Utilisation de règles basées sur la largeur de bande réservée et sur la largeur de bande partagée et Règle de largeur de bande partagée.
Remarque :
Shared bandwidth ne s'applique qu'au composant Dispatcher.
taille
La taille de la bande passante partagée correspond à un entier. La valeur par défaut est zéro. Si la valeur est zéro, la bande passante ne peut pas être partagée au niveau du cluster.
set
Définit les caractéristiques du cluster.
remove
Supprime ce cluster.
report
Affiche les zones internes du cluster.
Remarque :
Report ne s'applique qu'au composant Dispatcher.
status
Affiche l'état en cours d'un cluster spécifique.

Exemples

dscontrol executor — Contrôle de l'exécuteur

Lire le diagrammeSauter le diagramme>>-dscontrol--executor--+-report-----------------------------------------------------------------------+-><
                        +-set--+-nfa--Adresse IP---------------------+---------------------------------+
                        |      +-maxclusters--taille-----------------+                                 |
                        |      +-maxports--taille--------------------+                                 |
                        |      +-fintimeout--fintimeout--------------+                                 |
                        |      +-hatimeout--heure--------------------+                                 |
                        |      +-hasynctimeout--heure----------------+                                 |
                        |      +-maxservers--taille------------------+                                 |
                        |      +-mss--taille-------------------------+                                 |
                        |      +-staletimeout--staletimeout----------+                                 |
                        |      +-Délai de maintien de routage--heure-+                                 |
                        |      +-clientgateway--address--------------+                                 |
                        |      +-weightbound--weight-----------------+                                 |
                        |      +-porttype--type----------------------+                                 |
                        |      +-wideportnumber--port----------------+                                 |
                        |      '-sharedbandwidth--taille-------------'                                 |
                        +-configuration--adresse_interface+i2+...--+---------------------------------+-+
                        |                                          '-nom_interface--masque de réseau-' |
                        +-unconfigure--adresse_interface-----------------------------------------------+
                        +-start------------------------------------------------------------------------+
                        +-status-----------------------------------------------------------------------+
                        '-stop-------------------------------------------------------------------------'
 

report
Affiche un rapport d'analyse sur les statistiques. Exemple : nombre total de paquets, paquets annulés, paquets transmis avec des erreurs, etc.
Remarque :
Report ne s'applique qu'au composant Dispatcher.
set
Définit les zones de l'exécuteur.
nfa
Définit l'adresse de non-réacheminement. Tout paquet envoyé à cette adresse n'est pas réacheminé par la machine Dispatcher.
Remarque :
NFA ne s'applique qu'au composant Dispatcher.
Adresse IP
Adresse IP (Internet Protocol) sous forme de nom symbolique ou en notation décimale à points.
maxclusters
Nombre maximal de clusters pouvant être configurés. La valeur par défaut du paramètre maxclusters est 100.
taille
Nombre maximal de clusters pouvant être configurés.
maxports
Valeur par défaut du nombre maximum de ports pour les clusters à créer. Ce paramètre peut être remplacé à l'aide des commandes cluster set ou cluster add. La valeur par défaut du paramètre maxports est 8.
taille
Nombre de ports.
fintimeout
Nombre de secondes durant lequel une connexion doit être gardée en mémoire avant que cette dernière ne soit mise à l'état FIN. La valeur par défaut du paramètre fintimeout est 30.
délai fin
Valeur du paramètre fintimeout.
Remarque :
Fintimeout ne s'applique qu'au composant Dispatcher.
hatimeout
Nombre de secondes nécessaires à l'exécuteur pour arrêter les signaux de présence de disponibilité pour dépassement du délai d'expiration. La valeur par défaut est 2.
Remarque :
La valeur hatimeout s'applique au composant Dispatcher.
heure
Valeur du paramètre hatimeout.
hasynctimeout
Nombre de secondes nécessaires à l'exécuteur pour arrêter la réplication des enregistrements de connexion entre la machine principale et la machine de secours à cause du dépassement du délai d'expiration. La valeur par défaut est 50.

Le temporisateur permet de garantir que les machines principale et de secours tentent de se synchroniser. Toutefois, en présence d'un trop grand nombre de connexions, et lorsque la machine active continue à gérer une charge de trafic entrant importante, la synchronisation risque de ne pas se terminer avant expiration du temporisateur. Par conséquent, Load Balancer tente sans arrêt la resynchronisation et les deux machines ne sont jamais synchronisées. Dans ce type de situation, donnez une valeur supérieure à la valeur par défaut de hasynctimeout pour donner aux deux machines suffisamment de temps pour échanger des informations sur les connexions existantes. Pour définir ce temporisateur, lancez la commande hasynctimeout après la commande dscontrol executor start, mais avant les commandes de haute disponibilité (dscontrol highavailability).

Remarque :
La valeur hasynctimeout s'applique au composant Dispatcher.
heure
Valeur du paramètre hasynctimeout.
maxservers
Nombre maximal par défaut de serveurs par port. Ce paramètre peut être remplacé à l'aide de la commande cluster ou port. La valeur par défaut de maxservers est 32.
mss
Nombre maximal d'octets dans le segment de données de la connexion TCP/UDP. Le nombre total d'octets du segment de données et de l'en-tête doit être inférieur au nombre d'octets de l'unité de transmission maximale (MTU). La valeur par défaut de mss est 1460.
Remarque :
La taille de segment maximale ne s'applique qu'à la méthode de transfert nat ou cbr du composant Dispatcher.
taille
Nombre de serveurs
staletimeout
Nombre de secondes d'inactivité possible sur une connexion avant que cette dernière soit supprimée. La valeur par défaut pour FTP est 900 et celle pour Telnet est 259 200. La valeur par défaut pour tous les autres ports est 300. Ce paramètre peut être remplacé à l'aide de la commande cluster ou port. Pour plus d'informations, voir Utilisation de la valeur du délai d'attente.
délai d'expiration
Valeur du paramètre staletimeout.
stickytime
Valeur du délai de maintien de routage par défaut de tous les futurs clusters. Elle peut être remplacée par la commande cluster ou port. La valeur par défaut du paramètre stickytime est 0.
heure
Valeur du paramètre stickytime en secondes.
clientgateway
Clientgateway est une adresse IP utilisée pour NAT/NAPT ou Fonction CBR de Dispatcher. Il s'agit de l'adresse du routeur par lequel le trafic de retour est transmis de Load Balancer vers les clients. Clientgateway doit être associé à une valeur non nulle avant l'ajout d'un port à une méthode d'acheminement NAT/NAPT ou Fonction CBR de Dispatcher. Voir Réacheminement NAT/NAPT de Dispatcher (méthode d'acheminement nat) et Fonction CBR de Dispatcher (méthode d'acheminement cbr) pour plus d'informations.
Remarque :
Clientgateway ne s'applique qu'au composant Dispatcher.
adresse
Adresse de la passerelle client sous forme de nom symbolique ou en notation décimale à points. La valeur par défaut est 0.0.0.0.
weightbound
Valeur de la limite de pondération par défaut de tous les futurs ports. Elle peut être remplacée par la commande cluster ou port. La valeur par défaut du paramètre weightbound est 20.
pondération
Valeur du paramètre pondération (weightbound).
porttype
Valeur du type de port par défaut pour tous les futurs ports. Elle peut être remplacée par la commande cluster ou port.
Remarque :
Porttype ne s'applique qu'au composant Dispatcher.
type
La valeurs possibles sont tcp, udp et both.
wideportnumber
Port TCP inutilisé pour chaque machine Dispatcher. Le paramètre wideportnumber doit être le même pour toutes les machines Dispatcher. La valeur par défaut du paramètre wideportnumber est 0, ce qui indique que la prise en charge du réseau étendu n'est pas utilisée.
Remarque :
Wideportnumber ne s'applique qu'au composant Dispatcher.
port
Valeur de wideportnumber.
sharedbandwidth
Quantité maximale de bande passante (en kilo-octets par seconde) pouvant être partagée au niveau de l'exécuteur. Pour plus d'informations sur la bande passante partagée, voir Utilisation de règles basées sur la largeur de bande réservée et sur la largeur de bande partagée et Règle de largeur de bande partagée.
Remarque :
Shared bandwidth ne s'applique qu'au composant Dispatcher.
taille
La taille de la bande passante partagée correspond à un entier. La valeur par défaut est zéro. Si la valeur est zéro, la bande passante ne peut pas être partagée au niveau de l'exécuteur.
configure
Configure une adresse (par exemple une adresse de cluster, une adresse de retour ou une adresse de signal de présence de haute disponibilité) sur la carte d'interface réseau de la machine Dispatcher. Cette opération est connue comme configuration d'un alias sur la machine Dispatcher.
Remarque :
Configure ne s'applique qu'au composant Dispatcher.
adresse_interface
Adresse sous forme de nom symbolique ou d'adresse IP.
Remarque :
Chaque adresse d'interface supplémentaire doit être séparée de la précédente par le signe plus (+).
nom_interface masque_réseau
Requis uniquement si l'adresse ne correspond pas à une adresse de sous-réseau existante. Le paramètre nom_interface peut être une valeur du type en0, eth1, eri0. Le masque_réseau est le masque de 32 bits utilisé pour identifier les bits de l'adresse de sous-réseau dans la partie d'une adresse IP réservée pour l'hôte.
unconfigure
Supprime l'adresse d'alias de la carte d'interface réseau.
Remarque :
Unconfigure ne s'applique qu'au composant Dispatcher.
start
Lance l'exécuteur.
status
Affiche l'état actuel des valeurs de l'exécuteur pouvant être définies ainsi que les valeurs par défaut.
stop
Arrête l'exécuteur.
Remarque :
Stop s'applique à Dispatcher et à CBR.

Exemples

dscontrol file — Gestion des fichiers de configuration

Lire le diagrammeSauter le diagramme>>-dscontrol--file--+-delete--fichier[.ext]----------+---------><
                    +-appendload--fichier[.ext]------+
                    +-report-------------------------+
                    +-save--fichier[.ext]--+-------+-+
                    |                      '-force-' |
                    '-newload--fichier[.ext]---------'
 

delete
Supprime le fichier.
fichier[.ext]
Un fichier de configuration se compose de commandes dscontrol.

Vous pouvez indiquer n'importe quelle extension de fichier (.ext) ou n'en indiquer aucune.

appendload
Pour mettre à jour la configuration actuelle, la commande appendload lance les commandes exécutables de votre fichier script.
report
Génère un rapport sur les fichiers disponibles.
save
Sauvegarde la configuration en cours de Load Balancer dans le fichier.
Remarque :
Les fichiers sont sauvegardés dans les répertoires suivants et chargés à partir de ces mêmes répertoires, où composant correspond à dispatcher ou cbr :
  • Systèmes d'exploitation AIX, HP-UX, Linux et Solaris : /opt/ibm/edge/lb/servers/configurations/component
  • Systèmes d'exploitation Windows : <root_install>ibm\edge\lb\servers\configurations\component
force
Si vous voulez sauvegarder votre fichier dans un fichier existant du même nom, utilisez force pour supprimer le fichier existant avant de sauvegarder le nouveau fichier. Si vous n'utilisez pas l'option force, le fichier existant n'est pas remplacé.
newload
Permet de charger et d'exécuter un nouveau fichier de configuration dans Load Balancer. Le nouveau fichier de configuration remplace la configuration actuelle.

Exemples

dscontrol help — Affichage ou impression de l'aide relative à cette commande

Lire le diagrammeSauter le diagramme>>-dscontrol--help--+-advisor----------+-----------------------><
                    +-binlog-----------+
                    +-cluster----------+
                    +-executor---------+
                    +-file-------------+
                    +-help-------------+
                    +-highavailability-+
                    +-host-------------+
                    +-logstatus--------+
                    +-manager----------+
                    +-metric-----------+
                    +-port-------------+
                    +-rule-------------+
                    +-server-----------+
                    +-set--------------+
                    +-status-----------+
                    '-subagent---------'
 

Exemples

dscontrol highavailability — Contrôle de la haute disponibilité

Remarque :
Le diagramme de la syntaxe dscontrol high availability ne s'applique qu'au composant Dispatcher.
Lire le diagrammeSauter le diagramme>>-dscontrol--highavailability--+-status--------------------------------------+-><
                                +-backup--+-add--+-primary-+--+-auto---+--p-+-+
                                |         |      +-backup--+  '-manual-'    | |
                                |         |      '-both----'                | |
                                |         '-delete--------------------------' |
                                +-reach--+-add----+--address--masque----------+
                                |        '-delete-'                           |
                                +-heartbeat--+-add--adressesrc--adressedest-+-+
                                |            '-delete--address--------------' |
                                '-takeover--+---------+-----------------------'
                                            '-address-'
 

status
Renvoie un rapport sur la haute disponibilité. Les machines sont identifiées comme étant à l'un des trois états suivants :
Active
Le réacheminement de paquets par un poste déterminé (principal,de sauvegarde, ou les deux) est en cours.
Standby
Le réacheminement de paquets par un poste déterminé (principal, de sauvegarde, ou les deux) n'est pas en cours ; celui-ci contrôle l'état d'un Dispatcher actif.
Inactive
Le réacheminement de paquets par un poste déterminé est en cours, et celui-ci ne tente pas d'établir une connexion avec son Dispatcher partenaire.
En outre, le mot clé status renvoie des informations relatives à divers sous-états:
Synchronized
Un poste déterminé a établi une connexion avec un autre Dispatcher.
Other substates
Ce poste essaie d'établir une connexion avec son Dispatcher partenaire, mais cette tentative n'a pas encore abouti.
backup
Permet de sauvegarder des informations relatives au poste principal (primary) ou de sauvegarde (backup).
add
Permet de définir et d'exécuter les fonctions de haute-disponibilité relatives à ce poste.
primary
Identifie le répartiteur qui sert de poste principal.
backup
Identifie la machine Dispatcher qui sert de poste de sauvegarde.
both
Identifie la machine Dispatcher qui joue le double rôle de poste principal et de sauvegarde. Il s'agit d'une fonction de la haute responsabilité réciproque qui associe, sur la base des clusters, les rôles de poste principale et de sauvegarde. Pour plus d'informations, voir Haute disponibilité réciproque.
auto
Spécifie une stratégie de rétablissement automatique permettant au poste principal (primary) de reprendre l'acheminement des paquets dès qu'il est remis en service.
manual
Spécifie une stratégie de rétablissement manuelle qui ne permet au poste principal (primary) de reprendre le réacheminement des paquets que lorsque l'administrateur a émis une commande takeover.
p[ort]
Port TCP non utilisé sur les deux postes, à utiliser par Dispatcher pour ses messages de cadence. Le port doit être identique pour le poste principal et pour le poste de sauvegarde.
delete
Supprime ce poste de la liste des postes à haute disponibilité, de sorte qu'il ne puisse plus servir de poste de sauvegarde (backup) ou principal (primary).
reach
Ajoute ou supprime une adresse cible pour les répartiteurs principal et de sauvegarde. Le conseiller d'accessibilité envoie des pings à partir des deux répartiteurs pour déterminer le niveau d'accessibilité de leurs cibles.
Remarque :
Lorsque vous configurez la cible d'accessibilité, vous devez également démarrer le conseiller d'accessibilité. Le conseiller d'accessibilité démarre automatiquement par la fonction gestionnaire.
add
Ajoute une adresse cible pour le conseiller d'accessibilité.
delete
Supprime une adresse cible du conseiller d'accessibilité.
adresse
Adresse IP (au format symbolique ou d'adresse IP) du noeud cible.
masque
Masque de sous-réseau.
heartbeat
Définit la session de communication entre les postes Dispatcher principal et de sauvegarde.
add
Indique au Dispatcher source l'adresse de son partenaire (adresse de destination).
adressesrc
Adresse source. Adresse (IP ou symbolique) de ce poste Dispatcher.
adressedest
Adresse de destination. Adresse (IP ou symbolique) de l'autre poste Dispatcher.
Remarque :
srcaddress et dstaddress doivent correspondre aux NFA des machines pour au moins une paire de signaux de présence.
delete
Supprime la paire d'adresses des informations de cadence (heartbeat). Vous pouvez indiquer l'adresse de destination ou l'adresse source de la paire de signaux de présence.
adresse
Adresse (IP ou symbolique) de la destination ou de la source.
takeover
Configuration de haute disponibilité simple (Les machines Dispatcher occupent la fonction, soit de poste principal soit de sauvegarde) :
  • Demande à un Dispatcher en attente de passer à l'état actif et de commencer le routage des paquets, ce qui permet de forcer le Dispatcher actif à passer en attente. Cette commande doit être émise sur le poste en attente et ne fonctionne que dans le cas d'une stratégie manuelle. Le sous-état doit être synchronisé.
Configuration de haute disponibilité réciproque (le rôle de chaque machine Dispatcher est double) :
  • La machine Dispatcher caractérisée par la fonction haute disponibilité réciproque contient deux clusters qui correspondent à ceux de son partenaire. L'un des deux clusters joue le rôle de cluster principal (cluster de sauvegarde du partenaire), et l'autre de cluster de sauvegarde (cluster principal du partenaire). La commande takeover donne l'ordre à la machine Dispatcher de commencer le routage des paquets en direction du ou des cluster(s) de l'autre machine. Cette commande ne peut être émise que lorsque les clusters de la machine Dispatcher sont en mode d'attente et que le sous-état est synchronisé. Ceci va contraindre les clusters actifs du partenaire à passer en mode d'attente. La commande ne fonctionne que dans le cadre d'une stratégie manuelle. Pour plus d'informations, voir Haute disponibilité réciproque.
Remarques :
  1. Il est à noter que les rôles des deux postes (principal et de sauvegarde) ne changent pas. Seul leur état relatif (actif ou en attente) est modifié.
  2. Trois scripts permettent de passer à l'état actif : goActive, goStandby et goInOp. Voir Utilisation de scripts.
adresse
La valeur de l'adresse de relais est facultative. Elle ne doit être utilisée que lorsque la machine joue le double rôle de poste principal et de sauvegarde (configuration de haute disponibilité réciproque). L'adresse indiquée correspond au NFA de la machine Dispatcher chargée habituellement du trafic de ce cluster. Dans le cas où les deux clusters sont relayés, indiquez la propre adresse NFA du Dispatcher.

Exemples

dscontrol host — Configuration d'une machine éloignée

Lire le diagrammeSauter le diagramme>>-dscontrol--host:--hôte_éloigné------------------------------><
 

hôte_éloigné
Nom de la machine Load Balancer en cours de configuration. Lorsque vous tapez cette commande, assurez-vous qu'il ne reste pas d'espace entre host: et hôte_éloigné, par exemple :
dscontrol host:hôte_distant
Après avoir tapé cette commande dans l'indicatif DOS, entrez toute commande dscontrol valide que vous désirez envoyer à la machine Load Balancer éloignée.

dscontrol logstatus — Affichage des paramètres du journal du serveur

Lire le diagrammeSauter le diagramme>>-dscontrol--logstatus----------------------------------------><
 

logstatus
Affiche les paramètres du journal du serveur (nom, niveau de consignation et taille du journal).

Exemples

Pour afficher l'état du journal, entrez :

dscontrol logstatus

Cette commande génère des résultats similaires à l'exemple suivant :

Dispatcher Log Status:
------------------------------
Log filename ............... C:\PROGRA~1\IBM\edge\lb\servers\logs\dispatcher
\server.log
Log level .................. 1
Maximum log size (bytes) ... 1048576

dscontrol manager — Contrôle du gestionnaire

Lire le diagrammeSauter le diagramme>>-dscontrol--manager--+-interval--secondes-----------------------+-><
                       +-loglevel--niveau-------------------------+
                       +-logsize--+-unlimited-+-------------------+
                       |          '-octets----'                   |
                       +-metric set--+-loglevel--niveau-------+---+
                       |             '-logsize--+-unlimited-+-'   |
                       |                        '-octets----'     |
                       +-quiesce--server--+-----+-----------------+
                       |                  '-now-'                 |
                       +-reach set--+-interval--secondes-----+----+
                       |            +-loglevel--niveau-------+    |
                       |            '-logsize--+-unlimited-+-'    |
                       |                       '-octets----'      |
                       +-refresh--cycle de mise à jour------------+
                       +-report--+----------------+---------------+
                       |         '-cluster+c2+...-'               |
                       +-restart--message-------------------------+
                       +-sensitivity--weight----------------------+
                       +-smoothing--indice de lissage-------------+
                       +-start--+-------------------------------+-+
                       |        '-fichier journal--port_mesures-' |
                       +-status-----------------------------------+
                       +-stop-------------------------------------+
                       +-unquiesce--server------------------------+
                       '-version----------------------------------'
 

interval
Définit la fréquence de mise à jour, par le gestionnaire, des pondérations des serveurs pour l'exécuteur, grâce à la mise à jour des critères utilisés par l'exécuteur pour acheminer les requêtes client.
secondes
Nombre positif représentant la fréquence (en secondes) de mise à jour, par le gestionnaire, des pondérations pour l'exécuteur. Valeur par défaut : 2
loglevel
Permet de définir le niveau de consignation relatif au journal du gestionnaire.
niveau
Valeur du niveau (0 à 5). Plus la valeur est élevée, plus la quantité d'informations consignées dans le journal du gestionnaire est importante. Valeur par défaut : 1. Les valeurs possibles sont les suivantes : 0 (Aucun), 1 (Minimal), 2 (De base), 3 (Modéré), 4 (Avancé), 5 (Prolixe).
logsize
Définit la taille maximale du journal du gestionnaire. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La taille du journal ne peut pas être moins élevée que la taille actuelle du journal. Les entrées de journal sont horodatées de sorte que vous pouvez identifier l'ordre dans lequel elles sont consignées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie attentivement car l'espace peut être saturé rapidement lors d'une consignation à des niveaux plus élevés.
octets
Taille maximale (en octets) du fichier journal du gestionnaire. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il se peut que le fichier journal n'atteigne pas la taille maximale exacte avant l'écrasement, car la taille des entrées de journal elles-mêmes varie. La valeur par défaut est 1 Mo.
metric set
Définit le niveau de consignation et la taille du journal du contrôleur de mesures. Les niveaux de consignation admis sont sont les suivants : 0 (Aucun), 1 (Minimal), 2 (De base), 3 (Modéré), 4 (Avancé), 5 (Prolixe). La niveau par défaut est 1. La taille du journal définit le nombre maximum d'octets pouvant être consignés dans le journal du contrôleur de mesures. Vous pouvez indiquer un nombre positif supérieur à zéro ou la valeur "Unlimited". La taille par défaut est 1 Mo.
quiesce
N'indiquez plus de connexions à envoyer à un serveur sauf les nouvelles connexions ultérieures du client vers le serveur mis au repos si la connexion est associée à un délai de maintien de routage et que ce dernier n'est pas arrivé à expiration. Le gestionnaire affecte la valeur 0 à la pondération de ce serveur, pour chaque port pour lequel celui-ci est défini. Utilisez cette commande si vous voulez effectuer une intervention de maintenance rapide sur un serveur puis le réactiver. Si vous supprimez de la configuration un serveur mis au repos, puis que vous l'ajoutez de nouveau, son état ne sera plus celui dans lequel il se trouvait avant d'être mis au repos. Pour plus d'informations, voir Mise au repos de la gestion des connexions serveur.
serveur
Adresse IP du serveur sous forme de nom symbolique ou en notation décimale à points.

Ou, si vous utilisez le partitionnement du serveur, entrez le nom unique du serveur logique. Pour plus d'informations, voir Partitionnement du serveur : serveurs logiques configurés pour un serveur physique (adresse IP).

now
N'utilisez l'option Mettre au repos “maintenant” que si le délai de maintien de routage est défini et que vous voulez que les nouvelles connexions soient envoyées à un autre serveur (différent du serveur mis au repos) avant que le délai de maintien de routage n'expire. Pour plus d'informations, voir Mise au repos de la gestion des connexions serveur.
reach set
Définit l'intervalle, le niveau de consignation et la taille du journal pour le conseiller d'accessibilité.
refresh
Définit le nombre d'intervalles avant qu'il soit demandé à l'exécuteur de mettre à jour les informations relatives aux nouvelles connexions et aux connexions actives.
cycle de mise à jour
Nombre positif représentant le nombre d'intervalles. Valeur par défaut : 2
report
Affiche un rapport d'analyse sur les statistiques.
cluster
Adresse du cluster que vous souhaitez afficher dans le rapport. L'adresse peut prendre la forme d'un nom symbolique ou d'une adresse IP. L'affichage par défaut est un rapport de gestionnaire portant sur tous les clusters.
Remarque :
Chaque cluster supplémentaire doit être séparé du précédent par le signe plus (+).
restart
Relance tous les serveurs (qui ne sont pas arrêtés) en leur affectant des valeurs de pondération normalisées (la moitié de la pondération maximale).
message
Message à consigner dans le fichier journal du gestionnaire.
sensitivity
Définit la sensibilité minimale à partir de laquelle les pondérations sont mises à jour. Cette valeur définit le moment où le gestionnaire doit modifier sa pondération pour le serveur en fonction des informations externes.
pondération
Nombre compris entre 1 et 100 à utiliser comme pourcentage de pondération. La valeur par défaut de 5 crée une sensibilité minimale de 5%.
smoothing
Définit un indice de lissage des variations des pondérations lors de l'équilibrage de charge. Plus l'indice de lissage est élevé, moins les pondérations des serveurs varient lorsque les conditions réseau sont modifiées. Plus cet index est faible, plus les pondérations des serveurs varient.
indice
Nombre positif en virgule flottante. Valeur par défaut : 1,5.
start
Lance le gestionnaire
fichier journal
Nom du fichier dans lequel les données de gestion sont consignées. Chaque enregistrement du journal est horodaté.

Le fichier par défaut se trouve dans le répertoire logs. Voir Annexe C. Exemples de fichiers de configuration. Pour changer le répertoire dans lequel les fichiers journaux sont enregistrés, voir Modification des chemins des fichiers journaux.

port_mesures
Port utilisé par Metric Server pour signaler les charges du système. Si vous indiquez un port de décompte, vous devez spécifier un nom de fichier journal. Le port de décompte par défaut est 10004.
status
Affiche l'état en cours de toutes les valeurs du gestionnaire qui peuvent être affectées globalement, ainsi que les valeurs par défaut associées.
stop
Arrête le gestionnaire.
unquiesce
Indique que le gestionnaire peut commencer à attribuer une pondération supérieure à 0 à un serveur préalablement mis au repos, sur chaque port pour lequel il est défini.
serveur
Adresse IP du serveur sous forme de nom symbolique ou en notation décimale à points.
version
Affiche la version en cours du gestionnaire.

Exemples

dscontrol metric — Configuration des mesures du système

Lire le diagrammeSauter le diagramme>>-dscontrol--metric--+-add--cluster+c2+...+cN:mesure+mesure1+...+mesureN--------------+-><
                      +-remove--cluster+c2+...+cN:mesure+mesure1+...+mesureN-----------+
                      +-proportions--cluster+c2+...+cN proportion1 prop2 prop3...propN-+
                      '-status--cluster+c2+...+cN:mesure+mesure1+...+mesureN-----------'
 

add
Permet d'ajouter la mesure spécifiée.
cluster
Adresse de connexion des clients. Il peut s'agir du nom d'hôte de la machine ou de l'adresse IP. Chaque cluster supplémentaire doit être séparé du précédent par le signe plus (+).
mesure
Nom de la valeur du système. Il doit s'agir du nom d'un fichier exécutable ou d'un fichier script du répertoire script du Metric Server.
remove
Supprime la mesure spécifiée.
proportions
Définit les proportions de toutes les mesures associées à cet objet.
status
Affiche les valeurs actuelles de cette mesure.

Exemples

dscontrol port — Configuration des ports

Lire le diagrammeSauter le diagramme>>-dscontrol--port--+-add--cluster:port--+-------------------------------------+-+-><
                    |                    +-crossport--autre port---------------+ |
                    |                    +-maxservers--taille------------------+ |
                    |                    +-stickymask--valeur------------------+ |
                    |                    +-Délai de maintien de routage--heure-+ |
                    |                    +-method--type------------------------+ |
                    |                    +-staletimeout--valeur----------------+ |
                    |                    +-weightbound--weight-----------------+ |
                    |                    +-porttype--type----------------------+ |
                    |                    +-protocol--type----------------------+ |
                    |                    '-reset--valeur-----------------------' |
                    +-set--cluster:port--+-crossport--autre port---------------+-+
                    |                    +-maxservers--taille------------------+ |
                    |                    +-stickymask--valeur------------------+ |
                    |                    +-Délai de maintien de routage--heure-+ |
                    |                    +-staletimeout--valeur----------------+ |
                    |                    +-weightbound--weight-----------------+ |
                    |                    +-porttype--type----------------------+ |
                    |                    +-maxhalfopen--valeur-----------------+ |
                    |                    '-reset--valeur-----------------------' |
                    +-remove--cluster:port---------------------------------------+
                    +-report--cluster:port---------------------------------------+
                    +-status--cluster:port---------------------------------------+
                    '-halfopenaddressreport--cluster:port------------------------'
 

add
Ajoute un port à un cluster. Avant d'ajouter un serveur à un port, vous devez ajouter un port à un cluster. Si aucun port n'est destiné à un cluster, toutes les requêtes client sont traitées en local. Cette commande permet d'ajouter plusieurs ports à la fois.
cluster
Adresse du cluster sous forme de nom symbolique ou d'adresse IP. Vous pouvez utiliser le signe deux-points (:) comme caractère générique. Par exemple, la commande dscontrol port add :80 permet d'ajouter le port 80 à tous les clusters.
Remarque :
Chaque cluster supplémentaire doit être séparé du précédent par le signe plus (+).
port
Numéro du port. Le numéro de port 0 (zéro) est utilisé pour indiquer un port générique.
Remarque :
Les autres ports sont séparés par le signe Plus (+).
crossport
Trans ports permet d'étendre la fonction d'affinité/maintien de routage à des ports multiples de façon à ce que les requêtes des clients reçue sur différents ports continuent à être envoyées au même serveur lors des requêtes suivantes. En ce qui concerne la valeur trans ports, indiquez le numéro autre port avec lequel vous souhaitez partager la fonction d'affinité trans ports. Pour utiliser cette fonction, les ports doivent :
  • partager la même adresse de cluster
  • partager les mêmes serveurs
  • avoir le même (non nul) délai de maintien de routage
  • avoir le même masque de maintien de routage
Pour supprimer la fonction trans ports, replacez la valeur trans ports sur son propre numéro de port. Pour plus d'informations sur la fonction de l'affinité trans ports, voir Affinité de ports croisés.
Remarque :
L'affinité trans ports ne s'applique qu'aux méthodes d'acheminement MAC et NAT/NATP du composant Dispatcher.
autre port
Valeur de trans ports. La valeur par défaut de est la même que celle de son numéro de port.
maxservers
Nombre maximal de serveurs. La valeur par défaut du paramètre maxservers est 32. La valeur par défaut de maxservers est 32.
taille
Valeur de maxservers.
stickymask
La fonction de masque d'adresse de l'affinité regroupe les requêtes des clients entrants, en fonction de leurs adresses de sous-réseaux communes. Lorsqu'une requête client établit une connexion avec un port pour la première fois, toutes les adresses ultérieures des clients possédant la même adresse de sous-réseau (indiquée par la partie masquée de l'adresse) sont acheminées vers ce même serveur. Pour activer le masque de maintien de routage, le maintien de routage (stickytime) du port doit être défini à zéro. Masque d'adresse de l'affinité (masque de maintien de routage).
Remarque :
Le mot clé du masque de maintien de routage ne s'applique qu'au composant Dispatcher.
valeur
La valeur du masque de maintien de routage correspond au nombre de bits à poids fort, parmi les adresses IP 32 bits, que vous souhaitez masquer. Les valeurs possibles sont 8, 16, 24 et 32. La valeur par défaut est 32 et elle désactive la fonction du masque d'adresse d'affinité.
stickytime
Délai entre la fermeture d'une connexion et l'ouverture d'une nouvelle connexion au cours de laquelle un client sera renvoyé au même serveur utilisé lors de la première connexion. Passé le délai de maintien de routage, le client peut être envoyé à un serveur autre que le premier.

Composant Dispatcher :

  • Méthode d'acheminement CBR de Dispatcher
    • Le délai de maintien de routage ne peut être défini (valeur différente de zéro) que sur un port SSL (et non sur un port HTTP) car sa définition active l'affinité d'ID SSL ID.
    • Lorsque vous définissez le délai de routage du port, le type d'affinité par défaut (none) doit être associé à la commande rule. L'affinité basée sur les règles (cookie passif, URI) ne peut pas être utilisée lorsqu'un délai de maintien de routage est défini pour le port.
  • Méthodes d'acheminement MAC et NAT de Dispatcher
    • Lorsque vous définissez le délai de routage du port (valeur différente de zéro), vous ne pouvez pas associer de type d'affinité à la règle. L'affinité basée sur les règles ne peut pas être utilisée lorsqu'un délai de maintien de routage est défini pour le port.
    • La définition d'une valeur de délai de maintien de routage active l'affinité de l'adresse IP.

Composant CBR : lorsque vous définissez un délai de routage différent de zéro, le type d'affinité par défaut (none) doit être associé à la commande rule. L'affinité basée sur les règles (cookie passif, URI, cookie actif) ne peut pas être utilisée lorsqu'un délai de maintien de routage est défini pour le port.

heure
Délai de maintien de routage du port (en secondes). la valeur Zéro signifie que le port n'est pas maintenu.
method
Correspond à la méthode d'acheminement. Les méthodes d'acheminement possibles sont les suivantes : MAC, NAT ou CBR (routage par contenu). Il se peut que vous n'ajoutiez pas de méthode d'acheminement NAT ou CBR si vous n'indiquez pas d'abord une adresse IP non nulle pour le paramètre clientgateway de la commande dscontrol executor. Voir Réacheminement NAT/NAPT de Dispatcher (méthode d'acheminement nat) et Fonction CBR de Dispatcher (méthode d'acheminement cbr) pour plus d'informations.
Remarques :
  1. La méthode ne s'applique qu'au composant Dispatcher.
  2. Si le serveur dorsal se trouve sur le même sous-réseau que l'adresse de retour et que vous utilisez la méthode d'acheminement CBR ou NAT, vous devez définir l'adresse de routeur en tant qu'adresse de serveur dorsal.
  3. Si vous ajoutez une méthode d'acheminement MAC, pour devez attribuer au paramètre "protocol" la valeur HTTP ou SSL.
type
Correspond au type de la méthode d'acheminement. Les valeurs possibles sont les suivantes : mac, nat ou cbr. La méthode d'acheminement par défaut est MAC.
staletimeout
Nombre de secondes d'inactivité possible sur une connexion avant que cette dernière soit supprimée. Pour le composant Dispatcher, la valeur par défaut est 900 pour le port 21 (FTP) et 259 200 pour le port 23 (Telnet). Pour tous les autres ports Dispatcher et CBR, la valeur par défaut est 300. Le paramètre staletimeout peut également être défini au niveau de l'exécuteur ou du cluster. Pour plus d'informations, voir Utilisation de la valeur du délai d'attente.
valeur
Valeur du paramètre staletimeout (en secondes).
weightbound
Définit la pondération maximale des serveurs sur ce port. Cela a une incidence sur le degré de différence possible entre le nombre des demandes transmises par l'exécuteur à chaque serveur. La valeur par défaut est 20.
pondération
Nombre compris entre 1 et 100 représentant la limite de pondération maximale.
porttype
Type de port.
Remarque :
Le paramètre Porttype ne s'applique qu'à Dispatcher.
type
La valeurs possibles sont tcp, udp et both. La valeur par défaut est (tcp/udp).
protocol
Type de protocole. Ce paramètre doit être défini pour le composant Dispatcher si vous spécifiez la méthode "cbr" sur le port. Si vous sélectionnez le type de protocole SSL, vous devez également définir le délai de maintien de routage (valeur différente de zéro) pour activer l'affinité d'ID SSL. Si vous sélectionnez le type de protocole HTTP, vous pouvez définir l'affinité du serveur à l'aide de règles Contenu. Pour plus d'informations, voir Fonction CBR de Dispatcher (méthode d'acheminement cbr).
Remarque :
Le protocole ne s'applique qu'à la méthode d'acheminement CBR de Dispatcher.
type
La valeurs possibles sont HTTP ou SSL.
maxhalfopen
Nombre maximal de connexions partielles. Ce paramètre permet de détecter les refus de service éventuelles qui génèrent un nombre élevé de connexions TCP partielles sur les serveurs.

Une valeur positive indique qu'une vérification est effectuée pour déterminer si le nombre de connexions partielles en cours dépasse la limite autorisée. Si tel est le cas, un script d'alerte est appelé. Pour plus d'informations, voir Détection d'attaque de refus de service.

Remarque :
Le paramètre maxhalfopen ne s'applique qu'à Dispatcher.
valeur
Valeur de maxhalfopen. La valeur par défaut est zéro (aucune vérification n'est effectuée).
reset
Reset permet d'indiquer si Load Balancer envoie des réinitialisations TCP aux serveurs arrêtés du port. Une réinitialisation A TCP provoque la fermeture immédiate de la connexion. Pour plus d'informations, voir Envoie d'une réinitialisation TCP à un serveur arrêté (composant Dispatcher uniquement).
Remarque :
Reset ne s'applique qu'au composant Dispatcher. Le paramètre clientgateway de la commande dscontrol executor doit avoir pour valeur une adresse de routeur pour utiliser le mot clé reset.
valeur
Les valeurs possibles de reset sont yes et no ; no étant la valeur par défaut. (Aucune réinitialisation TCP n'est effectuée pour des serveurs arrêtés). Lorsque reset a la valeur yes, des réinitialisations TCP sont envoyées aux serveurs arrêtés.
set
Définit les zones d'un port.
remove
Supprime ce port.
report
Génère un rapport sur ce port.
status
Affiche l'état des serveurs sur ce port. Pour visualiser l'état de tous les ports, n'indiquez pas de port dans cette commande. N'oubliez pas les deux-points.
nbSecondes
Durée en secondes avant la réinitialisation des connexions partielles.
halfopenaddressreport
Génère des entrées dans le journal (halfOpen.log) pour toutes les adresses client (jusqu'à environ 8000 paires d'adresses) qui ont accédé à des serveurs disposant de connexions partielles. De plus, les données statistiques sont affichées sur la ligne de commande, telles que le nombre total, moyen ou plus élevé de connexions partielles, et le temps moyen de connexion partielle (en secondes). Pour plus d'informations, voir Détection d'attaque de refus de service.

Exemples

dscontrol rule — Configuration des règles

Lire le diagrammeSauter le diagramme>>-dscontrol--rule--+-add--cluster:port:règle--type--type--| opts |-+-><
                    +-dropserver--cluster:port:règle--server--------+
                    +-remove--cluster:port:règle--------------------+
                    +-report--cluster:port:règle--------------------+
                    +-set--cluster:port:règle--| opts |-------------+
                    +-status--cluster:port:règle--------------------+
                    '-useserver--cluster:port:règle--serveur+s2+...-'
 
opts:
 
|--+--------------------------------------+---------------------|
   +-beginrange--faible--endrange--élevée-+
   +-priority--niveau---------------------+
   +-pattern--motif-----------------------+
   +-tos--valeur--------------------------+
   +-stickytime--heure--------------------+
   +-affinity--type_affinité--------------+
   +-cookiename--valeur-------------------+
   +-evaluate--niveau---------------------+
   '-sharelevel--niveau-------------------'
 

add
Ajoute cette règle à un port.
cluster
Adresse du cluster sous forme de nom symbolique ou d'adresse IP. Vous pouvez utiliser le signe deux-points (:) comme caractère générique. Par exemple, la commande suivante dscontrol rule add :80:RuleA type type, permet d'ajouter RuleA au port 80 pour tous les clusters.
Remarque :
Chaque cluster supplémentaire doit être séparé du précédent par le signe plus (+).
port
Numéro du port. Vous pouvez utiliser le signe deux-points (:) comme caractère générique. Par exemple, la commande suivante dscontrol rule add clusterA::RuleA type type permet d'ajouter RuleA à tous les ports pour ClusterA.
Remarque :
Les autres ports sont séparés par le signe Plus (+).
règle
Nom choisi pour la règle. Ce nom peut contenir tout caractère alphanumérique, des traits de soulignement, des traits d'union ou des points. Il peut comporter de 1 à 20 caractères, et ne doit contenir aucun espace.
Remarque :
Chaque règle supplémentaire doit être séparée de la précédente par le signe plus (+).
type
Type de règle.
type
Les différents types de règles possibles sont les suivants :
ip
La règle est définie en fonction de l'adresse IP du client.
time
La règle est définie en fonction de l'heure.
connection
La règle est définie en fonction du nombre de connexions par seconde du port. Cette règle ne fonctionne que si le gestionnaire est en cours d'exécution.
active
La règle est définie en fonction du nombre total de connexions actives sur le port. Cette règle ne fonctionne que si le gestionnaire est en cours d'exécution.
port
La règle est définie en fonction du port client.
Remarque :
Port ne s'applique qu'au composant Dispatcher.
service
Cette règle est fondée sur la zone d'octets type de service (TOS) de l'en-tête IP.
Remarque :
la règle Service ne s'applique qu'au composant Dispatcher.
reservedbandwidth
Cette règle est fonction du nombre de kilo-octets par seconde de largeur de bande délivrés par un ensemble de serveurs. Pour plus d'informations, voir Utilisation de règles basées sur la largeur de bande réservée et sur la largeur de bande partagée et Règle de largeur de bande réservée.
Remarque :
Reservedbandwidth ne s'applique qu'au composant Dispatcher.
sharedbandwidth
Cette règle est fonction du nombre de kilo-octets par seconde de largeur de bande partagés au niveau de l'exécuteur ou du cluster. Pour plus d'informations, voir Utilisation de règles basées sur la largeur de bande réservée et sur la largeur de bande partagée et Règle de largeur de bande partagée.
Remarque :
Sharedbandwidth ne s'applique qu'au composant Dispatcher.
true
Cette règle est toujours vraie. Considérez-la comme une instruction else en logique de programmation.
content
Cette règle décrit une expression régulière qui sera comparée aux URL demandées par les clients. Elle ne fonctionne que pour Dispatcher et CBR.
beginrange
Valeur de début de la fourchette utilisée pour déterminer si la règle est vraie.
faible
Dépend du type de règle. Le type de valeur et les valeurs par défaut sont précisés ci-après par type de règle :
ip
Adresse du client sous forme de nom symbolique ou d'adresse IP. La valeur par défaut est 0.0.0.0.
time
Entier. La valeur par défaut est 0 (minuit).
connection
Entier. La valeur par défaut est 0.
active
Entier. La valeur par défaut est 0.
port
Entier. La valeur par défaut est 0.
reservedbandwidth
Entier (kilo-octets par seconde). La valeur par défaut est 0.
endrange
Valeur de fin de la fourchette utilisée pour déterminer si la règle est vraie.
élevée
Dépend du type de règle. Le type de valeur et les valeurs par défaut sont précisés ci-après par type de règle :
ip
Adresse du client sous forme de nom symbolique ou d'adresse IP. La valeur par défaut est 255.255.255.254.
time
Entier. La valeur par défaut est 24 (minuit).
Remarque :
Lors de la définition des intervalles de temps (début et fin d'une fourchette horaire), notez que chaque valeur doit être un entier représentant seulement l'heure. Les subdivisions de l'heure ne sont pas indiquées. Pour cette raison, pour indiquer une heure, par exemple entre 3:00 et 4:00 du matin, attribuez la valeur 3 à beginrange (début) et 3 à endrange (fin). Cela signifiera toutes les minutes comprises entre 3:00 et 3:59. Si vous indiquez 3 au paramètre beginrange et 4 au paramètre endrange, vous couvrirez la période de deux heures allant de 3:00 à 4:59.
connections
Entier. La valeur par défaut est 2 à la puissance 32 moins 1.
active
Entier. La valeur par défaut est 2 à la puissance 32 moins 1.
port
Entier. La valeur par défaut est 65535.
reservedbandwidth
Entier (kilo-octets par seconde). La valeur par défaut est 2 à la puissance 32 moins 1.
priority
Ordre dans lequel les règles sont consultées.
niveau
Entier. Si vous ne spécifiez pas la priorité de la première règle que vous ajoutez, Dispatcher lui affecte par défaut la valeur 1. Une règle ajoutée par la suite se verra affecter par défaut une priorité égale à la priorité la plus basse existante + 10. Supposons que vous avez une règle dont la priorité est 30. Vous ajoutez une nouvelle règle et définissez sa priorité à 25 (priorité supérieure à 30). Vous ajoutez ensuite une troisième règle, sans lui affecter de priorité. La priorité de la troisième règle sera de 40 (30 + 10).
pattern
Indique le motif à utiliser pour une règle type de contenu.
motif
Motif à utiliser. Pour plus d'informations sur les valeurs acceptées, voir Annexe B. Syntaxe des règles de contenu (modèle).
tos
Indique la valeur de “type de service” (TOS) utilisée par la règle type service.
Remarque :
TOS ne s'applique qu'au composant Dispatcher.
valeur
Chaîne de 8 caractères à utiliser pour la valeur TOS. Les caractères valides sont : 0 (zéro binaire), 1 (un binaire), et x (peu importe). Par exemple : 0xx1010x. Pour plus d'informations, voir Utilisation de règles basées sur le type de services (TOS).
stickytime
Indique le délai de maintien de routage à utiliser pour une règle. Lorsque vous attribuez la valeur "activecookie" au paramètre affinity dans la commande rule, vous devez affecter une valeur différente de zéro au délai de maintien de routage pour activer ce type d'affinité. Le délai de maintien de routage de la commande rule ne s'applique pas aux types d'affinité "passivecookie" ou "uri".

Pour plus d'informations, voir Affinité de cookie actif.

Remarque :
La règle de délai de maintien de routage ne s'applique qu'au composant CBR.
heure
Heure en secondes
Affinity
Indique le type d'affinité à utiliser pour une règle : cookie actif, cookie passif, URI ou aucune affinité.

Le type d'affinité "activecookie" permet l'équilibrage de charge du trafic Web et une affinité avec le même serveur en fonction des cookies générés par Load Balancer.

Le type d'affinité "passivecookie" permet l'équilibrage de la charge du trafic Web et une affinité avec le même serveur en fonction des cookies d'auto-identification générés par les serveurs. Vous devez utiliser le paramètre cookiename avec l'affinité de cookie passif.

Le type d'affinité "URI" permet l'équilibrage de la charge du trafic Web vers des serveurs Caching Proxy dans le but d'augmenter la mémoire cache.

Pour plus d'informations, voir Affinité de cookie actif, Affinité de cookie passif et Affinité d'URI.

Remarque :
L'affinité s'applique aux règles configurées avec la méthode d'acheminement CBR de Dispatcher et au composant CBR.
type_affinité
Les valeurs possibles pour le type d'affinité sont les suivantes : none (valeur par défaut), activecookie, passivecookie ou uri.
cookiename
Nom arbitraire défini par l'administrateur qui agit comme identificateur pour Load Balancer. Il s'agit du nom que Load Balancer doit rechercher dans la demande d'en-tête HTTP client. Le nom de cookie et la valeur associée sert d'identificateur à Load Balancer, lui permettant d'envoyer les demandes suivantes d'un site Web au même serveur. Le nom de cookie n'est applicable qu'avec l'affinité de cookie passif.

Pour plus d'informations, voir Affinité de cookie passif.

Remarque :
Le nom de cookie s'applique aux règles configurées avec la méthode d'acheminement CBR de Dispatcher et au composant CBR.
valeur
Valeur du nom de cookie.
evaluate
Cette option est disponible pour le composant Dispatcher uniquement. Indique s'il faut évaluer la condition de règle sur tous les serveurs sur un port ou sur tous les serveurs de la règle. C'est option n'est valide que pour les règles qui fondent leurs décisions sur des caractéristiques des serveurs, telles que les règles de type connection, active et reservedbandwidth. Pour plus d'informations, voir Option d'évaluation de serveur.

Pour la règle de type de connexion, vous pouvez également indiquer une option d'évaluation — upserversonrule. Grâce à cette option, les serveurs restants ne seront pas surchargés si l'un ou plusieurs d'entre eux s'arrêtent.

niveau
Les valeurs acceptées sont port, rule ou upserversonrule. La valeur par défaut est port. upserversonrule ne s'applique qu'à la règle de type de connexion.
sharelevel
Ce paramètre ne s'applique qu'à la règle relative à la largeur de bande partagée. Indique si la largeur de bande est partagé au niveau du cluster ou au niveau de l'exécuteur. Le partage de la largeur de bande au niveau du cluster permet à un ou des ports de partager une quantité maximale de largeur de bande sur plusieurs ports dans le même cluster. Le partage de la largeur de bande au niveau de l'exécuteur permet à un ou des clusters de la configuration Dispatcher de partager une quantité maximale de largeur de bande. Pour plus d'informations, voir Règle de largeur de bande partagée.
niveau
Les valeurs acceptées sont executor ou cluster.
dropserver
Supprimez un serveur d'un ensemble de règles.
serveur
Adresse IP de la machine serveur TCP sous forme de nom symbolique ou d'adresse IP.

Ou, si vous utilisez le partitionnement du serveur, entrez le nom unique du serveur logique. Pour plus d'informations, voir Partitionnement du serveur : serveurs logiques configurés pour un serveur physique (adresse IP).

Remarque :
Chaque serveur supplémentaire doit être séparé du précédent par le signe plus (+).
remove
Supprime une ou plusieurs règles séparées entre elles par des signes plus.
report
Affichez les valeurs internes d'une ou plusieurs règles.
set
Définissez les valeurs de cette règle.
status
Affiche les valeurs paramétrables d'une ou plusieurs règles.
useserver
Insérez des serveurs dans un ensemble de règles.

Exemples

dscontrol server — Configuration des serveurs

Lire le diagrammeSauter le diagramme>>-dscontrol--server--+-add--cluster:port:serveur--+-------------------------+-+-><
                      |                            +-address--address--------+ |
                      |                            +-collocated--valeur------+ |
                      |                            +-sticky--valeur----------+ |
                      |                            +-weight--valeur----------+ |
                      |                            +-fixedweight--valeur-----+ |
                      |                            +-cookievalue--valeur-----+ |
                      |                            +-mapport--valeur de port-+ |
                      |                            +-protocol--valeur--------+ |
                      |                            +-router--adr-------------+ |
                      |                            +-returnaddress--adr------+ |
                      |                            +-advisorrequest--chaîne--+ |
                      |                            '-advisorresponse--chaîne-' |
                      +-set--cluster:port:serveur--+-collocated--valeur------+-+
                      |                            +-sticky--valeur----------+ |
                      |                            +-weight--valeur----------+ |
                      |                            +-fixedweight--valeur-----+ |
                      |                            +-cookievalue--valeur-----+ |
                      |                            +-protocol--valeur--------+ |
                      |                            +-router--adr-------------+ |
                      |                            +-advisorrequest--chaîne--+ |
                      |                            '-advisorresponse--chaîne-' |
                      +-down--cluster:port:serveur-----------------------------+
                      +-remove--cluster:port:serveur---------------------------+
                      +-report--cluster:port:serveur---------------------------+
                      +-up--cluster:port:serveur-------------------------------+
                      '-status--cluster:port:serveur---------------------------'
 

add
Permet d'ajouter ce serveur.
cluster
Adresse du cluster sous forme de nom symbolique ou d'adresse IP. Vous pouvez utiliser le signe deux-points (:) comme caractère générique. Par exemple, la commande dscontrol server add :80:ServerA permet d'ajouter ServerA au port 80 sur tous les clusters.
Remarque :
Chaque cluster supplémentaire doit être séparé du précédent par le signe plus (+).
port
Numéro du port. Vous pouvez utiliser le signe deux-points (:) comme caractère générique. Par exemple, la commande dscontrol server add ::ServerA, permet d'ajouter ServerA à tous les clusters sur tous les ports.
Remarque :
Chaque port supplémentaire doit être séparé du précédent par le signe plus (+).
serveur
Le serveur est l'adresse IP unique de la machine serveur TCP sous forme de nom symbolique ou d'adresse IP.

Ou, si vous utilisez un nom unique qui ne se résout pas en adresse IP, vous devez fournir le paramètre address du serveur dans la commande dscontrol server add. Pour plus d'informations, voir Partitionnement du serveur : serveurs logiques configurés pour un serveur physique (adresse IP).

Remarque :
Chaque serveur supplémentaire doit être séparé du précédent par le signe plus (+).
address
Adresse IP unique du serveur TCP sous forme de nom d'hôte ou d'adresse IP. S'il n'est pas possible de résoudre le serveur, vous devez fournir l'adresse de la machine serveur physique. Pour plus d'informations, voir Partitionnement du serveur : serveurs logiques configurés pour un serveur physique (adresse IP).
adresse
Valeur de l'adresse du serveur.
collocated
L'option Co-implanté permet d'indiquer si Dispatcher est installé sur l'un des serveurs dont il équilibre les charges.
Remarque :
Prenez connaissance des éléments suivants :
  • Le paramètre collocated n'est valide que si vous utilisez les méthodes d'acheminement MAC, NAT ou CBR de Dispatcher. Site Selector et CBR peuvent être co-implantés sur toutes les plateformes mais ne requièrent pas ce mot clé. Pour plus d'informations, voir Utilisation de serveurs implantés au même endroit.
  • Systèmes Windows : La co-implantation n'est pas disponible.
valeur
Valeur de Co-implanté : oui ou non. Elle est fixée à non par défaut.
sticky
Permet à un serveur de remplacer sur son port les paramètres de maintien de routage. Lorsque la valeur par défaut est “oui," le serveur garde l'affinité normale définie sur le port. Lorsque cette valeur est “non," le client ne sera pas renvoyé à ce serveur lors de sa prochaine requête à ce port et ce, indépendamment des paramètres de maintien de routage du port. Ceci peut s'avérer utile quand vous utilisez des règles. Pour plus d'informations, voir Substitution d'affinité de port.
valeur
Valeur du maintien de routage : oui ou non. Elle est fixée à non par défaut.
weight
Nombre compris entre 0 et 100 (mais qui ne doit pas dépasser la valeur de pondération du port spécifiée) représentant la pondération relative à ce serveur. L'affectation de la valeur zéro à la pondération empêche l'envoi de nouvelles demandes au serveur mais ne met pas fin aux connexions actuellement actives à ce serveur. La valeur par défaut correspond à la moitié de la valeur de pondération maximale du port indiqué. Si le gestionnaire est en cours d'exécution, ce paramètre est rapidement remplacé.
valeur
Valeur de la pondération du serveur.
fixedweight
L'option fixedweight vous permet d'indiquer si vous souhaitez, ou non, que le gestionnaire modifie la pondération du serveur. Si vous fixez sur oui la valeur fixedweight, le gestionnaire en activité ne sera pas autorisé à modifier la pondération du serveur. Pour plus d'informations, voir Pondérations fixées par le gestionnaire.
valeur
Valeur de fixedweight : oui ou non. La valeur par défaut est non.
cookievalue
Cookievalue est une valeur arbitraire qui représente le côté serveur de la paire de valeur nom de cookie/cookie. La valeur de cookie, associée au nom de cookie, sert d'identificateur permettant à Load Balancer d'envoyer les demandes client suivantes au même serveur. Pour plus d'informations, voir Affinité de cookie passif.
Remarque :
Cookievalue est valide pour Dispatcher (avec la méthode d'acheminement CBR) et pour CBR.
valeur
Il s'agit de n'importe quelle valeur arbitraire. Par défaut, il n'y a pas de valeur de cookie.
mapport
Mappe le numéro du port de destination de la demande client (pour Dispatcher) au numéro de port du serveur que Dispatcher utilise pour équilibrer la charge de la demande du client. Permet à Load Balancer de recevoir une demande de client sur un port et de la transmettre à un autre port de la machine serveur. Le paramètre mapport permet d'équilibrer la charge des demandes d'un client sur un serveur sur lequel peuvent s'exécuter plusieurs démons serveur.
Remarque :
Mapport s'applique à Dispatcher (avec les méthodes d'acheminement nat ou cbr) ainsi qu'à CBR. Pour Dispatcher, voir Réacheminement NAT/NAPT de Dispatcher (méthode d'acheminement nat) et Fonction CBR de Dispatcher (méthode d'acheminement cbr). Pour CBR, voir Equilibrage de charge client-proxy dans SSL et proxy-serveur dans HTTP.
protocol
Les valeurs valides pour le protocole sont HTTP et HTTPS. La valeur par défaut est HTTP.
Remarque :
Le protocole ne s'applique qu'au composant CBR.
valeur du port
Valeur du numéro de port de mappage. La valeur par défaut est le numéro de port de destination de la demande du client.
router
Si vous définissez un réseau étendu, il s'agit de l'adresse du routeur vers le serveur éloigné. La valeur par défaut est 0, correspondant à un serveur local. Notez que, lorsqu'une adresse de routeur est définie avec une valeur autre que zéro (ce qui désigne un serveur éloigné), elle ne peut pas être redéfinie par 0 pour rechanger le serveur en serveur local. Le serveur doit être supprimé, puis ajouté à nouveau sans adresse de routeur spécifiée. De même, un serveur local (adresse de routeur = 0) ne peut pas être changé en serveur éloigné en changeant l'adresse du routeur. Le serveur doit être supprimé, puis ajouté de nouveau. Pour plus d'informations, voir Configuration du support de réseau étendu pour Dispatcher.
Remarque :
Le routeur ne concerne que Dispatcher. Si vous utilisez les méthodes d'acheminement NAT ou CBR, indiquez l'adresse de routeur lors de l'ajout d'un serveur à la configuration.
adr
Adresse du routeur.
returnaddress
Adresse IP ou nom d'hôte unique. Il s'agit d'une adresse configurée sur la machine Dispatcher que Dispatcher utilise comme adresse source lors de l'équilibrage de charge des demandes du client sur le serveur. Elle permet de garantir que le serveur renverra le paquet à la machine Dispatcher pour traiter le contenu de la demande, au lieu de l'envoyer directement au client. (Dispatcher transmettra ensuite le paquet IP au client.) Vous devez indiquer la valeur d'adresse de retour lors de l'ajout du serveur. L'adresse de retour ne peut pas être modifiée sauf si vous supprimez le serveur et l'ajoutez à nouveau. Elle ne peut pas être identique à l'adresse de cluster, de serveur ou NFA.
Remarque :
Le paramètre returnaddress ne s'applique qu'à Dispatcher. Lorsque vous utilisez les méthodes d'acheminement nat ou cbr, vous devez définir une adresse de retour permettant la communication entre Load Balancer et les serveurs dorsaux. Le nombre de connexions que Load Balancer peut maintenir avec le serveur dorsal est limité par le nombre d'adresses de retour définies. Load Balancer utilise des ports basés uniquement sur les adresses de retour et non pas sur la combinaison adresse de retour et serveur. Les connexions supplémentaires échouent, lorsque tous les ports disponibles sont occupés. Dans un environnement occupé, utilisez plusieurs adresses de retour afin d'éviter le problème de disponibilité des ports.
adr
Valeur de l'adresse de retour.
advisorrequest
Le conseiller HTTP ou HTTPS utilise la chaîne advisor request pour interroger l'état des serveurs. Elle n'est valide que pour les serveurs qui sont traités par le conseiller HTTP ou HTTPS. Vous devez démarrer le conseiller HTTP ou HTTPS pour activer cette valeur. Pour plus d'informations, voir Configuration du conseiller HTTP ou HTTPS à l'aide de l'option de demande ou de réponse (URL).
Remarque :
La chaîne advisorrequest s'applique aux composants Dispatcher et CBR.
chaîne
Valeur de la chaîne utilisée par le conseiller HTTP ou HTTPS. La valeur par défaut est HEAD / HTTP/1.0.
Remarque :
Si la chaîne comporte un espace --
  • Lorsque vous lancez la commande à partir de l'invite du shell dscontrol>>, vous devez mettre la chaîne entre guillemets. Par exemple : server set cluster:port:serveur advisorrequest "head / http/1.0"
  • Lorsque vous lancez la commande dscontrol à partir de l'invite du système d'exploitation, vous devez placer les caractères "\" et \"" respectivement avant et après le texte. Par exemple : dscontrol server set cluster:port:serveur advisorrequest "\"head / http/1.0\""

advisorresponse
Chaîne advisor response que le conseiller HTTP ou HTTPS recherche dans la réponse HTTP. Elle n'est valide que pour les serveurs qui sont traités par le conseiller HTTP ou HTTPS. Vous devez démarrer le conseiller HTTP ou HTTPS pour activer cette valeur. Pour plus d'informations, voir Configuration du conseiller HTTP ou HTTPS à l'aide de l'option de demande ou de réponse (URL).
Remarque :
La chaîne advisorresponse s'applique aux composants Dispatcher et CBR.
chaîne
Valeur de la chaîne utilisée par le conseiller HTTP ou HTTPS. La valeur par défaut est null.
Remarque :
Si la chaîne comporte un espace --
  • Lorsque vous lancez la commande à partir de l'invite du shell dscontrol>>, vous devez mettre la chaîne entre guillemets.
  • Lorsque vous lancez la commande dscontrol à partir de l'invite du système d'exploitation, vous devez placer les caractères "\" et \"" respectivement avant et après le texte.
down
Marque ce serveur comme étant arrêté. Cette commande permet d'interrompre toutes les connexions actives à ce serveur et d'empêcher l'envoi d'autres connexions ou paquets à ce serveur.

Lorsqu'un serveur est arrêté à l'aide de la commande server down, si le délai de maintien de routage a une valeur différente de zéro pour ce serveur, les clients existants continuent à être servis par ce serveur jusqu'à expiration du délai. Le serveur n'est arrêté qu'après expiration du délai de maintien de routage.

remove
Permet de supprimer ce serveur.
report
Génère un rapport sur ce serveur. Le rapport contient pour chaque serveur les informations suivantes : nombre actuel de connexions par seconde, nombre de Ko transférés en une seconde, nombre total de connexions existantes, nombre de connexions actives, nombre de connexions à l'état FIN et nombre de connexions terminées.
set
Permet de définir des valeurs pour ce serveur.
status
Affiche l'état des serveurs.
up
Marque ce serveur comme étant activé. Dispatcher envoie désormais de nouvelles connexions à ce serveur.

Exemples

dscontrol set — Configuration du journal du serveur

Lire le diagrammeSauter le diagramme>>-dscontrol--set--+-loglevel--niveau-------+------------------><
                   '-logsize--+-unlimited-+-'
                              '-taille----'
 

loglevel
Niveau auquel le serveur dsserver consigne ses activités.
niveau
La valeur par défaut de loglevel est 0. La fourchette va de 0 à 5. Les valeurs possibles sont les suivantes : 0 (Aucun), 1 (Minimal), 2 (De base), 3 (Modéré), 4 (Avancé), 5 (Prolixe).
logsize
Nombre maximal d'octets à consigner dans le fichier journal.
taille
La taille de fichier journal par défaut est 1 Mo.

dscontrol status — Indique par affichage si le gestionnaire et les conseillers sont en cours d'exécution

Lire le diagrammeSauter le diagramme>>-dscontrol--status-------------------------------------------><
 

Exemples

dscontrol subagent — Configuration du sous-agent SNMP

Remarque :
Les diagramme de syntaxe de la commande dscontrol subagent ne s'applique qu'au composant Dispatcher.
Lire le diagrammeSauter le diagramme>>-dscontrol--subagent--+-loglevel--niveau---------------------------+-><
                        +-logsize--+-octets----+---------------------+
                        |          '-unlimited-'                     |
                        +-report-------------------------------------+
                        +-start--+---------------------------------+-+
                        |        '-nom_communauté--fichier journal-' |
                        +-status-------------------------------------+
                        +-stop---------------------------------------+
                        '-version------------------------------------'
 

loglevel
Niveau auquel le sous-agent consigne ses activités dans un fichier.
niveau
Valeur du niveau (0 à 5). Plus la valeur est élevée, plus la quantité d'informations consignées dans le journal du gestionnaire est importante. Valeur par défaut : 1. Les valeurs possibles sont les suivantes : 0 (Aucun), 1 (Minimal), 2 (De base), 3 (Modéré), 4 (Avancé), 5 (Prolixe).
logsize
Taille maximale en octets à consigner dans le journal du sous-agent. La valeur par défaut est 1 Mo. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La taille du journal ne peut pas être moins élevée que la taille actuelle du journal. Les entrées de fichier sont horodatées, ce qui permet de déterminer l'ordre dans lequel elles ont été créées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie attentivement car l'espace peut être saturé rapidement lors d'une consignation à des niveaux plus élevés.
octets
Taille maximale (en octets) du fichier journal du sous-agent. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il se peut que le fichier journal n'atteigne pas la taille maximale exacte avant l'écrasement, car la taille des entrées de journal elles-mêmes varie. La valeur par défaut est unlimited.
report
Affiche un rapport d'analyse sur les statistiques.
start
Lance le sous-agent.
nom_communauté
Nom de la valeur SNMP du nom de communauté que vous pouvez utiliser comme mot de passe de sécurité. La valeur par défaut est public.

Pour la plateforme Windows, le nom de communauté du système d'exploitation est utilisé.

fichier journal
Nom du fichier dans lequel les données du sous-agent SNMP sont consignées. Chaque enregistrement du journal est horodaté. La valeur par défaut est subagent.log. Le fichier par défaut se trouve dans le répertoire logs. Voir Annexe C. Exemples de fichiers de configuration. Pour changer le répertoire dans lequel les fichiers journaux sont enregistrés, voir Modification des chemins des fichiers journaux.
status
Affiche l'état en cours de toutes les valeurs du sous-agent SNMP qui peuvent être affectées globalement, ainsi que les valeurs par défaut associées.
version
Affiche la version en cours du sous-agent.

Exemples