Cette section présente les propriétés de ressource définies par Sun Cluster. Les valeurs de propriété sont classées comme suit (après Catégorie) :
Requise : l'administrateur doit spécifier une valeur lors de la création d'une ressource à l'aide d'un utilitaire d'administration.
Optionnelle : si l'administrateur ne spécifie pas de valeur lors de la création d'un groupe de ressources, le système lui attribue une valeur par défaut.
Conditionnelle : le RGM ne crée la propriété que si elle est déclarée dans le fichier RTR. Dans le cas contraire, la propriété n'existe pas et les administrateurs système ne peuvent y accéder. Une propriété conditionnelle déclarée dans le fichier RTR est soit facultative soit requise, selon qu'une valeur par défaut est indiquée ou non dans le fichier RTR. Pour plus d'informations, reportez-vous à la description de toutes les propriétés conditionnelles.
Interrogation uniquement : ne peut être directement définie par un outil d'administration.
L'attribut Réglable indique si et quand vous pouvez mettre à jour les propriétés de ressource, comme suit :
NONE ou FALSE |
Jamais |
TRUE ou ANYTIME |
À tout moment |
AT_CREATION |
Lorsque la ressource est ajoutée à un cluster |
WHEN_DISABLED |
Lorsque la ressource est désactivée |
Les propriétés ci-dessous sont d'abord présentées par leur nom, suivi d'une description.
Durée en secondes pendant laquelle les connexions de l'adresse IP d'un client donné à l'un des services de la ressource sont envoyées vers le même nœud de serveur.
Cette propriété n'est utile que lorsque la propriété Load_balancing_policy est paramétrée sur Lb_sticky ou sur Lb_sticky_wild. En outre, la propriété Weak_affinity doit être paramétrée sur FALSE (valeur par défaut).
Cette propriété n'est utilisée qu'avec les services évolutifs.
Optionnelle
Aucune
ANYTIME
Durée en secondes entre les appels de détection rapide des pannes de la ressource. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR.
Elle est facultative si une valeur par défaut est spécifiée dans le fichier RTR. Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.
Cette propriété est requise si elle est déclarée dans le fichier RTR et si l'attribut Default n'est pas défini.
Conditionnelle
Aucune
WHEN_DISABLED
Propriétés d'extension telles qu'elles sont déclarées dans le fichier RTR du type de ressources. La mise en œuvre du type de ressources définit ces propriétés. La rubrique Attributs des propriétés de ressources comporte des informations sur les attributs individuels que vous pouvez définir pour les propriétés d'extension.
Conditionnelle
Aucune
Dépend de chaque propriété
NONE, SOFT et HARD affectent uniquement le comportement de basculement lors de l'échec d'une méthode de démarrage ( Prenet_start ou Start). Cependant, une fois la ressource correctement démarrée, NONE, SOFT et HARD n'ont plus aucune incidence sur le prochain démarrage de la ressource ou sur le comportement d'arrêt initié par le détecteur de ressources avec scha_control(1HA) ou scha_control(3HA). NONE (valeur par défaut) signifie que le RGM doit paramétrer l'état de la ressource de manière à indiquer un échec de la méthode et attendre l'intervention de l'utilisateur. SOFT indique qu'en cas d'échec d'une méthode Start, le RGM doit déplacer le groupe de la ressource vers un autre nœud. En cas d'échec d'une méthode Stop ou Monitor_stop, le RGM paramètre la ressource sur l'état Stop_failed et le groupe de ressources sur l'état Error_stop_failed. Le RGM attend, ensuite, l'intervention de l'utilisateur. En cas d'échec de la méthode Stop ou Monitor_stop, les valeurs NONE et SOFT sont identiques. HARD indique qu'en cas d'échec de la méthode Start, le RGM doit déplacer le groupe. En cas d'échec de la méthode Stop ou Monitor_stop, le RGM doit arrêter la ressource en abandonnant le nœud du cluster. HARD, NONE et SOFT affectent les comportements de basculement lors de l'échec d'une méthode Start ou Prenet_start.
Contrairement aux attributs NONE, SOFT et HARD, RESTART_ONLY et LOG_ONLY affectent tous les comportements de basculement, y compris les redémarrages de ressource et de groupe de ressources et les arrêts provoqués par le détecteur de ressources (scha_control ). RESTART_ONLY indique que le détecteur peut exécuter la commande scha_control pour redémarrer une ressource, mais que les tentatives ultérieures de redémarrage ou d'arrêt d'un groupe de ressources avec la commande scha_control échoueront. La propriété Retry_count détermine le nombre de redémarrages autorisés par le RGM dans un laps de temps lui-même défini dans la propriété Retry_interval . Si le nombre de tentatives excède la valeur de la propriété Retry_count, aucun redémarrage de ressource n'est autorisé. Si la propriété Failover_mode est paramétrée sur LOG_ONLY , aucun redémarrage de ressource, ni aucun arrêt ne sont autorisés. Le paramétrage de Failover_mode sur LOG_ONLY a la même incidence que le paramétrage de cette même propriété sur RESTART_ONLY associé au paramétrage de la propriété Retry_count sur zéro. Lorsqu'une méthode de démarrage échoue, RESTART_ONLY et LOG_ONLY ont la même incidence que NONE: aucun basculement ne se produit et l'état de la ressource est remplacé par Start_failed.
Optionnelle
Aucune
ANYTIME
Chaîne de caractères définissant les règles d'équilibrage de la charge. Cette propriété n'est utilisée qu'avec les services évolutifs. Le RGM crée automatiquement cette propriété si la propriété Scalable est déclarée dans le fichier RTR. Les différentes valeurs de la propriété Load_balancing_policy sont les suivantes :
Lb_weighted (par défaut). La charge est répartie entre plusieurs nœuds en fonction des poids définis dans la propriété Load_balancing_weights.
Lb_sticky. Un client donné (identifié par son adresse IP) du service évolutif est toujours envoyé au même nœud du cluster.
Lb_sticky_wild. L'adresse IP d'un client donné connecté à l'adresse IP d'un service de rétention générique du client (wildcard sticky) est toujours envoyée vers le même nœud de cluster, quel que soit le numéro du port de destination de l'adresse IP.
Conditionnelle/facultative
Lb_weighted
AT_CREATION
Pour les ressources évolutives uniquement. Le RGM crée automatiquement cette propriété si la propriété Scalable est déclarée dans le fichier RTR. Son format est poids@ nœud,poids@nœud, où poids correspond à un entier reflétant la part de charge relative distribuée au nœud indiqué. Cette part correspond au poids du nœud divisé par la somme de tous les poids. Par exemple, 1@1,3@2 indique que le nœud 1 reçoit 1/4 de la charge et que le nœud 2 en reçoit les 3/4. La chaîne de caractères vide (“”) définit une répartition uniforme. Il s'agit de la valeur par défaut. Les nœuds auxquels aucun poids explicite n'est attribué reçoivent un poids par défaut de 1.
Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est paramétrée sur ANYTIME. En changeant cette propriété, vous modifiez uniquement la répartition des nouvelles connexions.
Conditionnelle/facultative
Chaîne vide (“”)
ANYTIME
Intervalle de temps en secondes après lequel le RGM conclut que l'exécution d'une méthode a échoué.
Conditionnelle/facultative
3 600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
ANYTIME
Le RGM paramètre cette propriété sur Enabled ou Disabled selon que l'administrateur du cluster active ou désactive le détecteur à l'aide d'un utilitaire d'administration. Lorsque la propriété est paramétrée sur Disabled, la méthode Start du détecteur n'est pas appelée tant que ce dernier n'est pas réactivé. Si la ressource n'a pas de méthode de rappel du détecteur, cette propriété n'existe pas.
Interrogation uniquement
Aucune
Jamais
Liste des ressources (noms d'hôte logique ou adresses partagées) utilisées par la ressource. Pour les services évolutifs, cette propriété doit se référer aux ressources d'adresse partagée qui se trouvent dans un groupe de ressources séparé. Pour les services à basculement, cette propriété se réfère aux noms d'hôte logique ou aux ressources d'adresse partagée qui se trouvent dans le même groupe de ressources. Le RGM crée automatiquement cette propriété si la propriété Scalable est déclarée dans le fichier RTR. Si elle n'est pas déclarée dans le fichier RTR, Network_resources_used n'est pas disponible à moins qu'elle ne soit explicitement déclarée dans le fichier RTR.
Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est paramétrée sur AT_CREATION.
La page man SUNW.Event(5) décrit la procédure de configuration de cette propriété avec CRNP.
Conditionnelle/requise
Aucune
AT_CREATION
Vous ne pouvez pas définir directement cette propriété. Elle est paramétrée par le RGM sur le nombre d'appels scha_control , Resource_restart ou Resource_is_restarted effectués pour la ressource sur le nœud depuis les n dernières secondes. n correspond à la valeur de la propriété Retry_interval de la ressource. Le compteur de redémarrage de la ressource est remis à zéro par le RGM dès qu'un arrêt scha_control est exécuté par la ressource, quel que soit le résultat de la tentative d'arrêt.
Si un type de ressources ne déclare pas la propriété Retry_interval, la propriété Num_resource_restarts n'est pas disponible pour les ressources de ce type.
Interrogation uniquement
Aucune
Non
Vous ne pouvez pas définir directement cette propriété. Elle est paramétrée par le RGM sur le nombre d'appels scha_control Restart effectués par la ressource pour son groupe de ressources sur le nœud au cours des n dernières secondes, n correspondant à la valeur de la propriété Retry_interval de la ressource. Si un type de ressource ne déclare pas la propriété Retry_interval, la propriété Num_rg_restarts n'est pas disponible pour les ressources de ce type.
Voir la description
Aucune
Non
Le RGM paramètre cette propriété sur Enabled ou Disabled selon que l'administrateur du cluster active ou désactive la ressource à l'aide d'un utilitaire d'administration. Si elle est désactivée, la ressource est déconnectée et aucun rappel n'est invoqué jusqu'à ce qu'elle soit de nouveau activée.
Interrogation uniquement
Aucune
Jamais
Liste des numéros de port de réception du serveur. Chaque numéro de port est suivi d'une barre oblique (/) et du protocole utilisé par le port, par exemple Port_list=80/tcp ou Port_list=80/tcp6,40/udp6. Vous pouvez indiquer les valeurs de protocole suivantes :
tcp, pour TCP IPv4 ;
tcp6, pour TCP IPv6 ;
udp, pour UDP IPv4 ;
udp6, pour UDP IPv6.
Le paramétrage de cette propriété pour Apache est décrit dans le manuel Sun Cluster Data Service for Apache Guide for Solaris OS.
Conditionnelle/requise
Aucune
AT_CREATION
Brève description de la ressource.
Optionnelle
Chaîne vide
ANYTIME
Liste de ressources d'un même groupe ou de groupes différents avec lesquelles la ressource a une forte relation de dépendance. La ressource ne peut être exécutée si l'une des ressources de la liste n'est pas activée. Si la ressource et l'une des ressources de la liste tentent de démarrer en même temps, le RGM attend que la ressource de la liste démarre avant de lancer l'autre ressource. Si la ressource de la liste Resource_dependencies ne démarre pas, l'autre ressource reste également déconnectée. La ressource de la liste risque de ne pas démarrer lorsque le groupe de ressources de cette ressource est déconnecté ou lorsque l'état de cette ressource est paramétré sur Start_failed. Si la ressource demeure déconnectée du fait d'une dépendance avec une ressource d'un autre groupe qui ne parvient pas à démarrer, l'état du groupe est alors paramétré sur Pending_online_blocked.
Si la ressource est déconnectée en même temps que celles de la liste, elle est arrêtée avant celles de la liste. Cependant, si la ressource reste connectée ou ne parvient pas à s'arrêter, les ressources de la liste appartenant à un autre groupe peuvent néanmoins s'arrêter. Les ressources de la liste ne peuvent pas être désactivées, à moins que la ressource ne soit désactivée en premier.
Par défaut, dans les groupes de ressources, les ressources d'application ont une forte relation de dépendance implicite avec les ressources d'adresse réseau. La rubrique sur la propriété Implicit_network_dependencies dans la section Propriétés du groupe de ressources contient plus d'informations.
Au sein d'un groupe de ressources, les méthodes Prenet_start sont exécutées par ordre de dépendance avant les méthodes Start. Quant aux méthodes Postnet_stop, elles sont exécutées par ordre de dépendance après les méthodes Stop. Dans le cadre d'une dépendance entre plusieurs groupes de ressources, la ressource dépendante attend que la ressource dont elle dépend termine d'exécuter les méthodes Prenet_start et Start avant d'exécuter sa méthode Prenet_start. En revanche, la ressource dont elle dépend attend que la ressource dépendante termine l'exécution des méthodes Stop et Postnet_stop avant d'exécuter sa méthode Stop.
Optionnelle
Liste vide
ANYTIME
Liste de ressources d'un même groupe ou de groupes différents avec lesquelles la ressource a une relation de dépendance au niveau du redémarrage.
Le fonctionnement de cette propriété est similaire à celui de Resource_dependencies, hormis le fait que, si l'une des ressources de la liste est redémarrée, l'autre ressource est redémarrée. Le redémarrage de la ressource se produit après que la ressource de la liste a été reconnectée.
Optionnelle
Liste vide
ANYTIME
Liste de ressources d'un même groupe ou de groupes différents avec lesquelles la ressource a une faible relation de dépendance. Une dépendance faible détermine l'ordre des appels de méthode. Le RGM appelle les méthodes Start des ressources de la liste avant d'appeler la méthode Start de la ressource. En revanche, il appelle les méthodes Stop de la ressource avant d'appeler celles des ressources de la liste. Si les ressources de la liste ne parviennent pas à démarrer ou restent déconnectées, l'autre ressource peut néanmoins démarrer.
Si la ressource et l'une des ressources de la liste tentent de démarrer en même temps, le RGM attend que la ressource de la liste démarre avant de lancer l'autre ressource. Si la ressource de la liste ne démarre pas (par exemple si son groupe reste déconnecté ou si son état est paramétré sur Start_failed ), l'autre ressource démarre. Le groupe de la ressource peut se voir attribuer provisoirement l'état Pending_online_blocked lors du démarrage des ressources de la liste. Lorsque toutes les ressources de la liste ont démarré ou qu'elles ont subi un échec lors du démarrage, l'autre ressource démarre et son groupe se voit de nouveau attribuer l'état Pending_online.
Si la ressource est déconnectée en même temps que celles de la liste, elle est arrêtée avant celles de la liste. Si la ressource reste connectée ou ne parvient pas à s'arrêter, la ressource de la liste peut tout de même s'arrêter. Vous ne pouvez pas désactiver les ressources de la liste, à moins d'avoir au préalable désactivé l'autre ressource.
Au sein d'un groupe de ressources, les méthodes Prenet_start sont exécutées par ordre de dépendance avant les méthodes Start. Quant aux méthodes Postnet_stop, elles sont exécutées par ordre de dépendance après les méthodes Stop. Dans le cadre d'une dépendance entre plusieurs groupes de ressources, la ressource dépendante attend que la ressource dont elle dépend termine d'exécuter les méthodes Prenet_start et Start avant d'exécuter sa méthode Prenet_start. En revanche, la ressource dont elle dépend attend que la ressource dépendante termine l'exécution des méthodes Stop et Postnet_stop avant d'exécuter sa méthode Stop.
Optionnelle
Liste vide
ANYTIME
Nom de l'instance de la ressource. Ce nom doit être unique au sein de la configuration du cluster. Vous ne pouvez plus le modifier après avoir créé une ressource.
Requise
Aucune
Jamais
Nom de projet Solaris associé à la ressource. Cette propriété permet d'appliquer aux services de données du cluster, les fonctions de gestion de ressources de Solaris, telles que le partage d'unité centrale ou les pools de ressources. Lorsque le RGM connecte les ressources, il exécute les processus connexes sous ce nom de projet. Si cette propriété n'est pas spécifiée, le nom de projet est récupéré à partir de la propriété RG_project_name du groupe de ressources contenant la ressource (voir rg_properties (5)). Si aucune propriété n'est spécifiée, le RGM utilise le nom de projet prédéfini default. Le nom de projet spécifié doit se trouver dans la base de données des projets et le superutilisateur root doit être configuré comme membre du projet nommé. Cette propriété est prise en charge uniquement avec les versions 9 et supérieures de Solaris.
Les modifications apportées sur cette propriété prennent effet lors du prochain démarrage de la ressource.
Optionnelle
Null
ANYTIME
État de la ressource déterminé par le RGM sur chaque nœud du cluster. Différents états possibles : Online, Offline, Start_failed, Stop_failed, Monitor_failed, Online_not_monitored, Starting et Stopping.
Vous ne pouvez pas configurer cette propriété.
Interrogation uniquement
Aucune
Jamais
Nombre de fois qu'un détecteur tente de redémarrer une ressource si celle-ci échoue. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR. Elle est facultative lorsqu'une valeur par défaut est indiquée dans le fichier RTR.
Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.
Cette propriété est requise si elle est déclarée dans le fichier RTR et si l'attribut Default n'est pas défini.
Conditionnelle
Aucune
WHEN_DISABLED
Intervalle de temps en secondes entre les tentatives de redémarrage d'une ressource qui a échoué. Le détecteur de ressources utilise cette propriété en association avec Retry_count. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR. Elle est facultative lorsqu'une valeur par défaut est indiquée dans le fichier RTR.
Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.
Cette propriété est requise si elle est déclarée dans le fichier RTR et si l'attribut Default n'est pas défini.
Conditionnelle
Aucune
WHEN_DISABLED
Indique si la ressource est évolutive, c'est-à-dire si elle utilise les fonctions d'équilibrage de charge réseau de Sun Cluster.
Si cette propriété est déclarée dans le fichier RTR, le RGM crée automatiquement les propriétés de service évolutif pour les ressources de ce type : Affinity_timeout, Load_balancing_policy, Load_balancing_weights, Network_resources_used, Port_list, UDP_affinity et Weak_affinity . Ces propriétés sont définies sur leur valeur par défaut à moins qu'elles ne soient spécifiquement déclarées dans le fichier RTR. Par défaut, la propriété Scalable, lorsqu'elle est déclarée dans le fichier RTR, est paramétrée sur TRUE.
Si cette propriété est déclarée dans le fichier RTR, son attribut de réglage ne peut être autre que AT_CREATION.
Si elle n'est pas déclarée dans le fichier RTR, la ressource n'est pas évolutive, vous ne pouvez pas la régler et aucune propriété de service évolutif n'est définie par le RGM. Cependant, vous pouvez explicitement déclarer les propriétés Network_resources_used et Port_list dans le fichier RTR, car elles peuvent être utiles aussi bien à un service non évolutif qu'à un service évolutif.
Vous devez utiliser cette propriété en association avec la propriété de type de ressource Failover .
Pour ce faire, reportez-vous à la rubrique r_properties (5).
Optionnelle
Aucune
AT_CREATION
Cette propriété est paramétrée par le détecteur de ressources avec scha_resource_setstatus(1HA) ou scha_resource_setstatus(3HA). Les différentes valeurs possibles sont les suivantes : OK, degraded, faulted, unknown et offline. Lorsqu'une ressource est activée ou désactivée, le RGM paramètre automatiquement la propriété Status si celle-ci n'est pas définie par le détecteur de ressources ou par les méthodes.
Interrogation uniquement
Aucune
Jamais
Cette propriété est définie par le détecteur de ressources en même temps que la propriété Status. Lorsqu'une ressource est activée ou désactivée, le RGM réinitialise automatiquement cette propriété avec une chaîne vide si elle n'est pas définie par les méthodes de la ressource.
Interrogation uniquement
Aucune
Jamais
Durée en secondes entre les appels de détection des pannes nécessitant un temps système important de la ressource. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR. Elle est facultative lorsqu'une valeur par défaut est indiquée dans le fichier RTR.
Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.
Cette propriété est requise si l'attribut Default n'est pas spécifié dans la déclaration de propriétés dans le fichier RTR.
Conditionnelle
Aucune
WHEN_DISABLED
Type de ressource dont cette ressource est une instance.
Requise
Aucune
Jamais
Indique la version de type de ressources actuellement associée à cette ressource. Le RGM crée automatiquement cette propriété qui ne peut être déclarée dans le fichier RTR. Sa valeur est identique à celle de la propriété RT_version du type de la ressource. Lors de la création d'une ressource, la propriété Type_version n'est pas explicitement indiquée, mais elle peut apparaître en tant que suffixe du nom du type de ressource. Sa valeur peut être modifiée lors de la modification d'une ressource.
Les possibilités de réglage de la propriété dépendent des éléments suivants :
la version actuelle du type de ressources ;
l'instruction #$upgrade_from figurant dans le fichier RTR.
Voir la description
Aucune
Voir la description
Si cette propriété est définie sur vrai, l'intégralité du trafic UDP provenant d'un client donné est envoyé au nœud de serveur qui gère actuellement tout le trafic TCP de ce client.
Cette propriété n'est utile que lorsque la propriété Load_balancing_policy est paramétrée sur Lb_sticky ou sur Lb_sticky_wild. En outre, la propriété Weak_affinity doit être paramétrée sur FALSE (valeur par défaut).
Cette propriété n'est utilisée qu'avec les services évolutifs.
Optionnelle
Aucune
WHEN_DISABLED
Si cette propriété est définie sur vrai, cette propriété active l'affinité faible du client. Avec cette affinité, les connexions d'un client donné sont envoyées sur le même nœud de serveur, sauf dans les cas suivants :
Lorsque le module d'écoute d'un serveur démarre, en réponse par exemple au redémarrage d'un détecteur de pannes, au basculement d'une ressource ou à l'association d'un nœud à un cluster après un échec.
La valeur de la propriété Load_balancing_weights de la ressource évolutive est modifiée du fait d'une opération d'administration.
L'affinité faible offre une alternative de faible déperdition par rapport à la configuration par défaut, tant en termes d'utilisation de la mémoire que de cycles du processeur.
Cette propriété n'est utile que lorsque la propriété Load_balancing_policy est paramétrée sur Lb_sticky ou sur Lb_sticky_wild.
Cette propriété n'est utilisée qu'avec les services évolutifs.
Optionnelle
Aucune
WHEN_DISABLED