Le fichier d'enregistrement du type de ressource (RTR) de cet exemple définit la configuration statique du type de ressource DNS. Les ressources de ce type héritent des propriétés définies dans le fichier RTR.
Les informations contenues dans le fichier RTR sont lues par le RGM lorsque l'administrateur du cluster enregistre le service de données HA-DNS.
Le fichier RTR suit un format bien défini. Les propriétés du type de ressources sont définies en premier lieu dans le fichier, suivent les propriétés de ressource définies par le système, puis les propriétés d'extension. Reportez-vous à la page de manuel rt_reg(4) et à la rubrique Paramétrage des propriétés de ressources et de types de ressources pour de plus amples informations.
Cette rubrique décrit les propriétés spécifiques du fichier RTR modèle. Elle fournit également une liste des différentes parties du fichier. Pour obtenir une liste complète du contenu de ce fichier, reportez-vous à la rubrique Liste de code du fichier RTR.
Le fichier RTR modèle commence par des commentaires, suivis des propriétés du type de ressource définissant la configuration de HA-DNS, comme vous pouvez le voir dans la liste suivante :
# # Copyright (c) 1998-2003 by Sun Microsystems, Inc. # Tous droits réservés # # Informations relatives à l'enregistrement du service DNS (Domain Name Service) # #pragma ident “@(#)SUNW.sample 1.1 00/05/24 SMI” TYPE_RESSOURCE = “modèle”; ID_FOURNISSEUR = SUNW; DESCRIPTION_TR = “service DNS sur Sun Cluster”; VERSION_TR =”1.0”; VERSION_API = 2; BASCULEMENT = VRAI; RÉP_BASE_TR=/opt/SUNWsample/bin; LISTE_PACKAGES = SUNWsample; DÉMARRAGE = dns_svc_start; ARRÊT = dns_svc_stop; VALIDATION = dns_validate; MISE_À_JOUR = dns_update; DÉMARRAGE_DÉTECTEUR = dns_monitor_start; ARRÊT_DÉTECTEUR = dns_monitor_stop; CONTRÔLE_DÉTECTEUR = dns_monitor_check;
vous devez déclarer la propriété Type_ressource comme première entrée du fichier RTR. Dans le cas contraire, l'enregistrement du type de ressource échoue.
dans les noms de propriété, le RGM établit une différence entre les majuscules et les minuscules. La convention applicable aux propriétés dans les fichiers RTR fournis par Sun, à l'exception des noms de méthode, est la majuscule à l'initiale du nom, et des minuscules partout ailleurs. Les noms de méthodes, de même que les attributs de propriété, contiennent uniquement des lettres majuscules.
Vous trouverez présentées ci-dessous des informations sur ces propriétés :
Le nom du type de ressource peut être spécifié par la propriété Type_ressource seule (sample) ou en utilisant l'Id_fournisseur comme préfixe avec un “.” le séparant du type de ressource (SUNW.sample).
Si vous utilisez l'Id_fournisseur, choisissez le symbole de l'entreprise pour la définition du type de ressource. Le nom du type de ressource doit être unique dans le cluster.
La propriété Version_TR identifie la version du service de données modèle telle que spécifiée par le fournisseur.
La propriété Version_API identifie la version de Sun Cluster. Par exemple, Version_API = 2 indique que le service de données tourne sous Sun Cluster version 3.0.
Basculement = VRAI indique que le service de données ne peut pas tourner dans un groupe de ressources susceptible d'être en ligne sur plusieurs noeuds à la fois.
rép_base_TR pointe vers /opt/SUNWsample/bin comme le chemin de répertoire permettant de compléter les chemins relatifs, tels que les chemins de méthode de rappel.
Démarrage, Arrêt, Validation, etc. proposent les chemins pointant vers les programmes de méthode rappel respectifs appelés par le RGM. Ces chemins sont fonction du répertoire spécifié par rép_base_TR.
Liste_packages identifie SUNWsample comme le package contenant l'installation du service de données modèle.
Les propriétés du type de ressource non spécifiées dans ce fichier RTR, par exemple Instance_unique, noeuds_init et Noeuds_installés , reçoivent leur valeur par défaut. Reportez-vous au Tableau A–1 pour obtenir une liste complète des propriétés du type de ressource, avec leurs valeurs par défaut.
L'administrateur du cluster ne peut pas modifier les valeurs spécifiées pour les propriétés du type de ressource dans le fichier RTR.
Par convention, déclarez les propriétés de ressource selon les propriétés du type de ressource dans le fichier RTR. Les propriétés de ressource comprennent les propriétés définies par le système et fournies par Sun Cluster, ainsi que les propriétés d'extension définies par l'utilisateur. Pour chaque type, vous pouvez spécifier un nombre d'attributs de propriété fournis par Sun Cluster, telles que des valeurs minimum et maximum ainsi que des valeurs par défaut.
La liste énumérée ci-dessous présente les propriétés définies par le système dans le fichier RTR.
# Une liste des déclarations de propriétés de ressources entre crochets suit les # déclarations relatives au type de ressource. La déclaration du nom de la propriété doit # être le premier attribut après le crochet ouvrant de chaque entrée. # Les propriétés <Délai_exécution_[méthode] définissent le délai (en secondes) après lequel # le RGM conclut que l'appel de la méthode a échoué. # La valeur MIN de tous les délais impartis de la méthode est définie à 60 secondes. Ceci # évite que les administrateurs définissent des délais plus courts qui non seulement # n'améliorent pas les performances de basculement, mais peuvent générer des actions # non souhaitées de la part du RGM (basculements erronés, réinitialisation de noeuds # ou passage du groupe de ressources à l'état ERREUR_ÉCHEC_ARRÊT, requérant une intervention # de l'opérateur). La définition de délais trop courts pour la méthode entraîne une # *diminution* de la disponibilité générale du service de données. { PROPRIÉTÉ = Délai_démarrage; MIN=60; PAR DÉFAUT=300; } { PROPRIÉTÉ = Délai_arrêt; MIN=60; PAR DÉFAUT=300; } { PROPRIÉTÉ = Délai_validation; MIN=60; PAR DÉFAUT=300; } { PROPRIÉTÉ = Délai_mise_à_jour; MIN=60; PAR DÉFAUT=300; } { PROPRIÉTÉ = Délai_démarrage_détecteur; MIN=60; PAR DÉFAUT=300; } { PROPRIÉTÉ = Délai_arrêt_détecteur; MIN=60; PAR DÉFAUT=300; } { PROPRIÉTÉ = Intervalle_sonde_complet; MIN=1; MAX=3600; PAR DÉFAUT=60; RÉGLABLE = À_TOUT_MOMENT; } # Le nombre de nouvelles tentatives à effectuer au cours d'une période donnée avant de conclure # que l'application ne peut pas démarrer correctement sur ce noeud. { PROPRIÉTÉ = Nombre_nouvelles_tentatives; MIN=0; MAX=10; PAR DÉFAUT=2; RÉGLABLE = À_TOUT_MOMENT; } # Définissez une valeur multiple de 60 pour Intervalle_nouvelles_tentatives, étant donné que # cette valeur est convertie de secondes en minutes, avec arrondissement au chiffre supérieur. # Par exemple, une valeur de 50 (secondes) est convertie en 1 minute. Utilisez cette propriété # pour établir le délai séparant les nouvelles tentatives (Nombre_nouvelles_tentatives). { PROPRIÉTÉ = Intervalle_nouvelles_tentatives; MIN=60; MAX=3600; PAR DÉFAUT=300; RÉGLABLE = À_TOUT_MOMENT; } { PROPRIÉTÉ = Ressources_réseau_utilisées; RÉGLABLE = À_LA_CRÉATION; PAR DÉFAUT = ““; }
Bien que Sun Cluster fournisse les propriétés définies par le système, vous pouvez définir d'autres valeurs par défaut à l'aide des attributs de propriété de ressource. Reportez-vous à la rubrique Attributs des propriétés de ressource pour une liste complète des attributs disponibles pour une application aux propriétés de ressource.
Remarquez les points suivants sur les propriétés de ressource définies par le système dans le fichier RTE modèle :
Sun Cluster fournit une valeur minimale (1 seconde) et une valeur par défaut (3600 secondes) pour tous les dépassements de délais impartis. Le fichier RTR modèle modifie le minimum à 60 et fait passer la valeur par défaut à 300 secondes. Un administrateur de clusters peut accepter cette valeur par défaut ou modifier la valeur du délai imparti (à 60 ou plus). Sun Cluster n'impose pas de valeur maximale autorisée.
Les propriétés Intervalle_sonde_complet, Nombre_nouvelles_tentatives et Intervalle_nouvelles_tentatives ont la valeur À_TOUT_MOMENT pour l'attribut RÉGLABLE. Ce paramètre signifie que l'administrateur du cluster peut modifier la valeur de ces propriétés, même lorsque le service de données tourne. Celles-ci sont utilisées par le détecteur de pannes mis en oeuvre par le service de données modèle. Le service de données modèle met en oeuvre une méthode de Mise_à_jour pour arrêter et redémarrer le détecteur de pannes lors de la modification de ces propriétés de ressource ou d'autres par l'administrateur. Reportez-vous à la rubrique Méthode de Mise_à_jour.
Les propriétés de ressource sont classifiées comme :
requises : l'administrateur du cluster doit spécifier une valeur à la création d'une ressource.
optionnelles : si l'administrateur ne spécifie pas de valeur, le système en renseigne une par défaut.
conditionnelles : le RGM ne crée la propriété que si elle est déclarée dans le fichier RTR.
Le détecteur de pannes du service de données modèle utilise les propriétés conditionnelles Intervalle_sonde_complet, Nombre_nouvelles_tentatives, Intervalle_nouvelles_tentatives et Ressources_réseau_utilisées, de telle manière que le développeur a dû les déclarer dans le fichier RTR. Reportez-vous à la page du manuel r_properties(5) ou à la rubrique Propriétés des ressources pour obtenir des informations sur la manière dont les propriétés sont classifiées.
Les propriétés d'extension se trouvent à la fin du fichier RTR modèle, comme le montre la liste suivante :
# Propriétés d'extension # L'administrateur du cluster doit définir la valeur de cette propriété afin qu'elle pointe vers # le répertoire contenant les fichiers de configuration utilisés par l'application. # Pour cette application, DNS, spécifiez le chemin du fichier de configuration DNS sur # PXFS (généralement named.conf). { PROPRIÉTÉ = Rép_conf; EXTENSION; CHAÎNE; RÉGLABLE = À_LA_CRÉATION; DESCRIPTION = “Chemin du répertoire de configuration”; } # Délai en secondes avant la déclaration d'un échec de la sonde. { PROPRIÉTÉ = Délai_sonde; EXTENSION; INT; PAR DÉFAUT = 120; RÉGLABLE = À_TOUT_MOMENT; DESCRIPTION = “Délai imparti pour la sonde (secondes)”; }
Le fichier RTR modèle définit deux propriétés d'extension, Rép_conf et Délai_sonde. Rép_conf spécifie le chemin vers le répertoire de configuration DNS. Ce répertoire contient le fichier in.named requis par le DNS pour fonctionner correctement. Les méthodes de Démarrage et de Validation du service de données modèle utilisent cette propriété pour vérifier que le répertoire de configuration et le fichier in.named sont accessibles avant de démarrer le DNS.
Lorsque le service de données est configuré, la méthode de Démarrage vérifie que le nouveau répertoire est accessible.
La méthode de SONDE du service de données modèle n'est pas une méthode de rappel de Sun Cluster, mais une méthode définie par l'utilisateur. C'est la raison pour laquelle Sun Cluster ne propose aucune propriété Délai_sonde pour celle-ci. Le développeur a défini une propriété d'extension dans le fichier RTR afin de permettre à un administrateur de cluster de configurer une valeur Délai_sonde.