MultiSite Control Panel

Configure la fonction store-and-forward

Conditions d'utilisation

Produit Type de commande
MultiSite Outil d'administration
Plateforme
Windows

Syntaxe

%SystemRoot%\System32\ms.cpl

Pour ouvrir MultiSite Control Panel, cliquez deux fois sur l'icône MultiSite dans le Panneau de configuration.

Description

MultiSite Control Panel contrôle les opérations de la fonction store-and-forward sur chaque hôte. Il permet de définir les paramètres de configuration décrits dans les sections qui suivent. Dans certains cas, l'opération correspondante échoue si un paramètre n'est pas défini. Dans d'autres cas, une valeur par défaut est codée en dur.

Taille maximale de paquet

Valeur par défaut : 2097151 Ko (2Go - 1Ko)

Contrôle la division des paquets logiques en plusieurs paquets physiques. Cette valeur indique la taille maximale pour un fichier de paquet physique. Le fait de limiter la taille des paquets physiques peut améliorer la fiabilité de leur livraison sur certains réseaux. Pour ne préciser aucune limite, utilisez la valeur 0 (zéro).

Cette valeur est utilisée par les commandes suivantes (à moins que vous ne précisiez également –maxsize) :

Lorsque vous appelez mkreplica ou syncreplica avec l'option –out, cette valeur n'est pas utilisée, et vous devez utiliser –maxsize pour limiter la taille de paquet.

Adresse électronique de l'administrateur

Valeur par défaut : Aucune.

Précise l'adresse de messagerie électronique de l'utilisateur à prévenir au cas où l'un des événements suivants surviendrait :
  • Un paquet (sur l'hôte local) qui a expiré est retourné à l'hôte expéditeur.
  • Un paquet dont la livraison est interrompue est retourné à l'hôte expéditeur.
  • syncreplica –import trouve un paquet de création de réplique.
Remarque : Si vous utilisez Rational ClearQuest MultiSite mais pas Rational ClearCase MultiSite, exécutez la commande control_panel pour indiquer l'hôte SMTP et l'e-mail de l'administrateur.
Pour activer la notification par e-mail :
  1. Indiquez l'hôte SMTP à utiliser :
    • Si vous utilisez Rational ClearCase MultiSite, vérifiez que la zone Hôte SMTP de ClearCase Control Panel indique un hôte valide. (Cette zone est située sur l'onglet Options.)
    • Si vous n'utilisez pas Rational ClearCase MultiSite, exécutez la commande control_panel pour indiquer l'hôte SMTP.
  2. Entrez une adresse e-mail dans la zone Administrator Email de MultiSite Control Panel. Vous ne pouvez préciser qu'une adresse.
  3. (facultatif) Entrez une valeur différente dans la zone Email Notification Program Path.

Chemin du programme de notification par messagerie électronique

Valeur par défaut : rép-principal-ccase\bin\notify.exe

Indique le programme de messagerie électronique à appeler dans les circonstances indiquées dans la section Adresse électronique de l'administrateur.

Délai d'expiration pour hôte inaccessible (en minutes)

Valeur par défaut : Zéro.

Indique le nombre de minutes d'attente du serveur de livraison, avant qu'il ne tente de contacter un hôte de destination précédemment identifié comme non accessible.

Si le serveur de livraison tente d'envoyer un paquet à un hôte de destination et détermine que celui-ci n'est pas accessible, il crée un fichier dans le répertoire rép-principal-ccase\var\shipping\ms_downhost. Le nom du fichier est celui de l'hôte inaccessible. Si la valeur de la zone Timeout for Unreachable Host n'est pas nulle, le serveur de livraison recherche dans le répertoire des hôtes cibles pour les opérations suivantes de livraison.

Si l'hôte de destination est trouvé dans le répertoire ms_downhost, et si la différence entre l'heure actuelle et l'heure du dernier changement est inférieure à la valeur du délai d'expiration défini sur l'hôte du serveur de livraison, celui-ci n'essaie pas d'envoyer des paquets à l'hôte de destination. Si la différence est supérieure ou égale au paramètre de délai d'expiration, le serveur de livraison tente d'envoyer des paquets à l'hôte de destination. Si le paramètre Timeout for Unreachable Host est égal à zéro, le serveur de livraison tente d'envoyer le paquet à l'hôte de destination. (Chaque tentative d'envoi de paquet vers un hôte inaccessible prend environ 30 secondes.)

Classes de stockage

Nom de la classe de stockage

Valeur par défaut : Les commandes multiutil avec l'option –sclass utilisent la classe de stockage cq_default pour les paquets qui ne sont affectés à aucune classe de stockage et ceux dont la classe de stockage n'est pas configurée. La classe de stockage cq_default n'est pas créée lorsque MultiSite est installé. Les commandes mkorder et shipping_server utilisent la classe de stockage –default pour les paquets qui ne sont affectés à aucune classe de stockage et ceux dont la classe de stockage n'est pas configurée. Vous pouvez créer des classes de stockage supplémentaires pour les paquets Rational ClearQuest MultiSite, mais vous devez utiliser des classes de stockage différentes pour les paquets Rational ClearQuest MultiSite et les paquets Rational ClearCase MultiSite.

Indiquez le nom d'une classe de stockage. Pour chaque classe de stockage, vous pouvez préciser des valeurs pour l'expiration des paquets, la baie de stockage, la baie de retour et le gestionnaire de réception.

Remarque : Vous pouvez créer jusqu'à 64 classes de stockage, dont les noms sont sensibles à la casse.

Expiration de paquet

Valeur par défaut : Lorsque la case Utiliser l'expiration par défaut est cochée, la classe de stockage utilise la valeur d'expiration de paquet associée à la classe –default. (Cette valeur n'apparaît pas dans la zone Packet Expiration. Vous devez afficher la classe –default pour connaître la valeur.) Lorsque MultiSite est installé pour la première fois, la valeur Packet Expiration correspondant à la classe –default est définie sur 14 jours.

Indique le délai d'expiration (en jours) des instructions de livraison associées à la classe de stockage indiquée. Ce délai commence à l'heure à laquelle l'instruction de livraison est générée. Si un paquet ne peut être livré à toutes ses destinations dans le nombre de jours indiqué, le paquet est retourné à l'hôte expéditeur et un message est envoyé à l'adresse indiquée dans la zone Administrator Email. Si la notification par messagerie électronique n'est pas activée, un message est inscrit dans l'observateur d'événements de Windows.

La valeur 0 indique l'absence d'expiration ; les tentatives de livraison sont répétées indéfiniment.

L'option –pexpire de syncreplica ou mkreplica prévaut sur ce paramètre.

Le programme shipping_server n'essaie pas de livrer les paquets de nouveau. La spécification Packet Expiration n'est utile que si vous définissez un hôte pour qu'il tente régulièrement d'envoyer tout paquet non livré.

Chemin de la baie de stockage

Valeur par défaut : Les commandes multiutil avec l'option –sclass ont recours à la classe de stockage cq_default. Les commandes mkorder et shipping_server utilisent la classe de stockage –default. Vous devez créer la classe de stockage cq_default. Si vous utilisez Rational ClearCase MultiSite et Rational ClearQuest MultiSite, vous devez utiliser des baies de stockage différentes pour les paquets de réplique de VOB et les paquets de base de données.

Définit l'emplacement d'un répertoire contenant les paquets de mise à jour entrants et sortants, ainsi que les instructions de livraison pour une classe de stockage particulière.

Les paquets placés dans une baie de stockage d'un système de fichiers NTFS héritent de la liste de contrôle d'accès (ACL) Windows de la baie. Vous devez définir des ACL sur les baies de stockage, pour permettre l'exécution des commandes MultiSite afin de traiter les paquets, et pour vous protéger des accès non autorisés. Les paquets conservés sur les systèmes de fichiers FAT ne sont pas protégés.

Avant d'utiliser la fonction store-and-forward, vérifiez que la partition de disque sur laquelle est créé le répertoire rép-principal-ccase\var\shipping dispose d'assez d'espace pour les paquets de création de réplique et de mise à jour qui sont prévus. Pour éviter d'endommager une base de données de VOB suite à la saturation de la partition de disque qui la contient, placez la baie de stockage sur une partition qui ne contient pas de répertoires de stockage de VOB. .

Remarque : Lorsque vous créez une classe de stockage, la baie de stockage et la baie de retour indiquées sont créées. Les répertoires incoming et outgoing des baies sont également créés.

Chemin de la baie de retour

Valeur par défaut : Les commandes multiutil avec l'option –sclass ont recours à la classe de stockage cq_default. Les commandes mkorder et shipping_server utilisent la classe de stockage –default. Vous devez créer la classe de stockage cq_default. Si vous utilisez à la fois Rational ClearCase MultiSite et Rational ClearQuest MultiSite, vous devez utiliser des baies de retour différentes pour les paquets de réplique de VOB et les paquets de base de données.

Définit l'emplacement du répertoire qui contient les paquets entrants et sortants en cours de renvoi à leur origine, car ils n'ont pas pu être livrés à toutes les destinations indiquées.

Les paquets placés dans une baie de retour d'un système de fichiers NTFS héritent de la liste de contrôle d'accès (ACL) Windows de la baie. Vous devez définir des ACL sur les baies de retour, pour permettre l'exécution des commandes MultiSite afin de traiter les paquets, et pour vous protéger des accès non autorisés. Les paquets conservés sur les systèmes de fichiers FAT ne sont pas protégés.

Chemin du gestionnaire de réception

Valeur par défaut : Aucune.

Indique un fichier de traitement par lot ou un programme que le serveur de livraison doit exécuter en cas de réception d'un paquet destiné à la classe de stockage. Par défaut, aucun fichier n'est spécifié.

Pour chaque paquet reçu, la commande shipping_server fonctionne comme suit :

  1. Elle lit les entrées dans MultiSite Control Panel pour trouver la valeur Receipt Handler appropriée au paquet.
    • Si le paquet est associé à une classe de stockage, et qu'il existe une valeur Receipt Handler pour cette classe, shipping_server utilise le programme ou le fichier de traitement par lot indiqué. Si aucun gestionnaire de réception n'est défini pour la classe de stockage, mais qu'un gestionnaire de réception par défaut est indiqué, c'est ce dernier qui est appelé pour ce paquet.
    • Si le paquet n'est associé à aucune classe de stockage et si une valeur Receipt Handler est définie pour la classe de stockage –default, shipping_server utilise cette valeur.
  2. Elle appelle le gestionnaire de réception de la façon suivante :

    script-pname [ –d/ata packet-file-pname ] [ –a/ctual shipping-order-pname ]
    [ –s/class classe-stockage ]
    –o/rigin nomhôte

    nomchemin-script
    Le script indiqué dans l'entrée RECEIPT-HANDLER.
    –d/ata nomchemin-fichier-paquet
    L'emplacement du paquet. Ce paramètre n'est utilisé que lorsque le paquet est destiné à cet hôte.
    –a/ctual nomchemin-ordre-livraison
    L'emplacement de l'instruction de livraison. Ce paramètre n'est utilisé que lorsque le paquet est destiné à un autre hôte.
    –s/class classe-stockage
    La classe de stockage associée au paquet. Ce paramètre n'est utilisé que si le paquet a été associé à une classe de stockage au moment de sa création.
    –o/rigin nomhôte
    Le nom de l'hôte depuis lequel le paquet a été initialement envoyé.
    Remarque : Si le paquet est destiné à la fois à l'hôte local et à un autre hôte, les paramètres –data et –actual sont utilisés. Le paquet est importé sur la réplique de l'hôte et transmis à la destination suivante.

Informations de routage

Les zones Routing Information contrôlent le routage réseau des paquets.

Hôte de routage suivant

Valeur par défaut : Aucune.

Indique la destination suivante des paquets dont la destination finale est n'importe lequel des noms d'hôtes indiqués dans la liste Destination Hostnames. Cet hôte est chargé de livrer le paquet à sa destination. Vous pouvez préciser un hôte à l'aide de son nom d'hôte (qui doit être utilisable par les hôtes des différents domaines) ou de son adresse IP numérique.

Noms des hôtes de destination

Valeur par défaut : Aucune.

Les paquets destinés aux hôtes indiqués dans cette zone sont envoyés à l'hôte indiqué dans la zone Next Routing Hop. Vous pouvez préciser un hôte à l'aide de son nom d'hôte (qui doit être utilisable par les hôtes des différents domaines) ou de son adresse IP numérique. La valeur –default en tant que Destination Hostname recouvre tous les hôtes non associés à un hôte de routage.


Retour d'informations