Guide du développeur de services de données Sun Cluster pour SE Solaris

Propriétés des ressources

Cette rubrique décrit les propriétés de ressources définies par Sun Cluster. Les valeurs des propriétés sont classées comme suit :

Requise. L'administrateur du cluster doit spécifier une valeur lorsqu'il crée une ressource à l'aide d'un utilitaire d'administration.
Facultative. Si l'administrateur ne propose pas de valeur lorsqu'il crée le groupe de ressources, le système fournit une valeur par défaut.
Conditionnelle. Le RGM crée la propriété uniquement si celle-ci est déclarée dans le fichier RTR. Dans le cas contraire, la propriété n'existe pas et les administrateurs du cluster ne peuvent pas 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 pas être directement définie à l'aide d'un outil d'administration.

L'attribut Tunable (décrit dans la rubrique Attributs des propriétés de ressources) permet d'indiquer si les propriétés de ressource peuvent être définies et quand elles peuvent l'être :

FALSE ou NONE: 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.

Affinity_timeout (integer)

Durée en secondes pendant laquelle les connexions d'une adresse IP cliente à 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. De plus, Weak_affinity doit être défini sur FALSE.

Cette propriété n'est utilisée qu'avec les services évolutifs.

Catégorie :: Facultative
Valeur par défaut :: Aucune
Réglable :: ANYTIME

Boot_timeout pour chaque méthode de rappel du type ( integer)

Délai en secondes après lequel le gestionnaire RGM conclut que l'exécution de cette méthode a échoué. Pour un type de ressource donné, seules les méthodes déclarées dans le fichier RTR possèdent des propriétés de délai d'attente définies.

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 (une heure) si la méthode est déclarée dans le fichier RTR
Réglable :: ANYTIME

Cheap_probe_interval (integer)

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 du cluster 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 défini dans le fichier RTR, la valeur Tunable de la propriété sera WHEN_DISABLED.

Catégorie :: Conditionnelle
Valeur par défaut :: Aucune
Réglable :: WHEN_DISABLED

propriétés d'extension

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. Pour obtenir plus d'informations sur les attributs des propriétés d'extension que vous pouvez définir, consultez la rubrique Attributs des propriétés de ressources.

Catégorie :: Conditionnelle
Valeur par défaut :: Aucune
Réglable :: Dépend de chaque propriété

Failover_mode (enum)

Modifie les actions de récupération entreprises par le RGM lorsqu'une ressource ne démarre ou ne s'arrête pas correctement, ou lorsqu'un détecteur de ressource demande le redémarrage ou le basculement d'une ressource défaillante.

NONE, SOFT ou HARD (échecs d'une méthode)

Ces paramètres n'affectent le basculement qu'en cas d'échec d'une méthode d'arrêt ou de démarrage ( Prenet_start, Start, Monitor_stop, Stop ou Postnet_stop). Lorsque la ressource démarre normalement, NONE, SOFT et HARD n'ont aucun effet sur son comportement de redémarrage ou de transfert (le détecteur de la ressource initie le démarrage ou le transfert via la commande scha_control ou la fonction scha_control()). Pour obtenir plus d'informations, reportez-vous aux pages de manuel scha_control(1HA) et scha_control(3HA). NONE indique que le RGM n'effectuera aucune action de récupération en cas d'échec de l'une des méthodes d'arrêt ou de démarrage citées précédemment. Si la valeur SOFT ou HARD est spécifiée, le RGM relocalisera le groupe de la ressource sur un autre nœud si la méthode Start ou Prenet_start échoue. Dans les situations d'échec de Start ou de Prenet_start, SOFT et HARD ont le même effet.

Dans les cas d'échec d'une méthode d'arrêt (Monitor_stop, Stop ou Postnet_stop), SOFT est identique à NONE. Si Failover_mode est défini sur HARD lorsque l'une de ces méthodes échoue, le RGM redémarre le nœud pour forcer le groupe de ressources à se déconnecter. Il tente ensuite de démarrer le groupe sur un autre nœud.

RESTART_ONLY ou LOG_ONLY

Contrairement à NONE, SOFT et HARD, qui n'affectent le comportement de basculement que lors de l'échec d'une méthode de démarrage ou d'arrêt, RESTART_ONLY et LOG_ONLY ont une influence sur l'ensemble du comportement de basculement. Celui-ci inclut le redémarrage des ressources et des groupes de ressources, initié par le détecteur (scha_control) ainsi que tout transfert effectué par le détecteur de ressource (scha_control). RESTART_ONLY indique que le détecteur peut exécuter scha_control pour redémarrer une ressource ou un groupe de ressources. 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 la limite de Retry_count est dépassée, aucun autre redémarrage n'est autorisé. Si le paramètre Failover_mode est défini sur LOG_ONLY, aucun redémarrage ni transfert de ressource n'est autorisé. Définir Failover_mode sur LOG_ONLY revient à définir Failover_mode sur RESTART_ONLY en donnant à Retry_count une valeur de zéro.

RESTART_ONLY ou LOG_ONLY (échecs d'une méthode)

Si une méthode du type Prenet_start, Start, Monitor_stop , Stop ou Postnet_stop échoue, RESTART_ONLY et LOG_ONLY équivalent à NONE : le nœud ne sera ni basculé, ni réinitialisé.

Effet des paramètres de Failover_mode sur un service de données

L'effet de chaque paramètre de Failover_mode sur un service de données diffère selon que le service est contrôlé ou non et, le cas échéant, selon son type (basé sur la bibliothèque DSDL ou non).

Le service de données est dit contrôlé s'il implémente une méthode Monitor_start et que le contrôle de la ressource est activé. Le RGM démarre le détecteur de la ressource en exécutant la méthode Monitor_start après avoir démarré la ressource elle-même. Le détecteur de ressource envoie une sonde pour contrôler le bon fonctionnement de la ressource. Si la sonde échoue, le détecteur de ressource peut demander un redémarrage ou un basculement en appelant la fonction scha_control(). Pour les ressources basées sur la bibliothèque DSDL, une vérification peut faire apparaître un échec partiel (dégradation) ou total du service de données. Les échecs partiels répétés s'accumulent pour former un échec total.
Le service de données n'est pas contrôlé s'il ne fournit aucune méthode Monitor_start ou si le contrôle de la ressource a été désactivé.
Les services de données basés sur la bibliothèque DSDL peuvent être développés à l'aide d'Agent Builder, du GDS, ou en utilisant directement la DSDL. Certains services de données (comme HA Oracle) ont été développés sans la DSDL.

NONE, SOFT et HARD (échecs d'une sonde)

Si vous définissez Failover_mode sur NONE, SOFT ou HARD ; si le service de données est contrôlé et basé sur la DSDL et si la sonde échoue, le détecteur appelle la fonction scha_control () pour demander un redémarrage de la ressource. Si les sondes échouent encore, la ressource est redémarrée jusqu'à Retry_count fois, dans l'intervalle Retry_interval. Si les sondes échouent toujours après Retry_count tentatives, le détecteur demande un basculement du groupe de ressources sur un autre noeud.

Si vous définissez Failover_mode sur NONE, SOFT ou HARD et si le service de données est un service non contrôlé basé sur la DSDL, le seul échec détecté est la mort de l'arborescence de processus de la ressource. Si cette arborescence meurt, la ressource est redémarrée.

Si le service de données n'est pas basé sur DSDL, le comportement de redémarrage ou de basculement dépend du code du détecteur de la ressource. Par exemple, le détecteur de ressources Oracle récupère en redémarrant la ressource ou le groupe de ressources ou en basculant ce dernier.

RESTART_ONLY (échecs de sonde)

Si vous définissez Failover_mode sur RESTART_ONLY, si le service de données est contrôlé et basé sur la DSDL et si la sonde échoue complètement, alors la ressource est redémarrée Retry_count fois, pendant Retry_interval . Cependant, si la limite de Retry_count est dépassée, le détecteur de ressource se termine, définit l'état de la ressource sur FAULTED et génère un message indiquant que l'application a rencontré un problème, mais n'a pas été redémarrée et que la sonde a été arrêtée. Dans ce cas, même si le contrôle est toujours activé, la ressource n'est pas contrôlée tant qu'elle n'a pas été réparée et redémarrée par l'administrateur du cluster.

Si vous définissez Failover_mode sur RESTART_ONLY ; si le service de données est un service non contrôlé basé sur la DSDL et si l'arborescence de processus meurt, la ressource n'est pas redémarrée.

Si un service de données contrôlé n'est pas basé sur la DSDL, le comportement de récupération dépend du code du détecteur de la ressource. Si vous définissez Failover_mode sur RESTART_ONLY, la ressource ou le groupe de ressources peuvent être redémarrés via la fonction scha_control() jusqu'à Retry_count fois dans l'intervalle Retry_interval. Si le détecteur de la ressource dépasse le nombre défini par Retry_count, la tentative de redémarrage échoue. De même, si le détecteur appelle la fonction scha_control() pour demander un basculement, sa demande échoue.

LOG_ONLY (échecs de sonde)

Si vous définissez Failover_mode sur LOG_ONLY pour un service de données quelconque, toutes les requêtes scha_control() (que ce soit pour le redémarrage d'une ressource ou d'un groupe de ressources ou pour le basculement d'un groupe de ressources) sont exclues. Si le service de données est basé sur la DSDL, un message est consigné en cas d'échec de la sonde mais la ressource n'est pas redémarrée. Si la sonde échoue plus de Retry_count fois dans l'intervalle défini par Retry_interval, le détecteur de la ressource se termine, définit l'état de la ressource sur FAULTED et génère un message signalant que l'application a rencontré un problème mais n'a pas été redémarrée et que la sonde a été arrêtée. Dans ce cas, même si le contrôle est toujours activé, la ressource n'est pas contrôlée tant qu'elle n'a pas été réparée et redémarrée par l'administrateur du cluster.

Si vous définissez Failover_mode sur LOG_ONLY ; si le service de données est un service non contrôlé basé sur la DSDL et si l'arborescence de processus meurt, un message est consigné mais la ressource n'est pas redémarrée.

Si un service de données contrôlé n'est pas basé sur la DSDL, le comportement de récupération dépend du code du détecteur de ressource. Si vous définissez Failover_mode sur LOG_ONLY, toutes les requêtes scha_control() (demandes de redémarrage d'une ressource ou d'un groupe de ressources et demandes de basculement d'un groupe de ressources) échouent.

Catégorie :: Facultative
Valeur par défaut :: NONE
Réglable :: ANYTIME

Fini_timeout pour chaque méthode de rappel du type (integer)

Délai en secondes après lequel le gestionnaire RGM conclut que l'exécution de la méthode a échoué. Pour un type de ressources donné, seules les méthodes déclarées dans le fichier RTR possèdent des propriétés de délai d'attente définies.

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Init_timeout pour chaque méthode de rappel du type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Load_balancing_policy (string)

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 logiciel RGM crée automatiquement cette propriété si la propriété Évolutivité est déclarée dans le fichier RTR. La propriété Load_balancing_policy peut prendre les valeurs suivantes :

Équilibrage_charge_pondéré (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 noeud 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.

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: Lb_weighted
Réglable :: AT_CREATION

Load_balancing_weights (string_array)

Pour les ressources évolutives uniquement. Le logiciel RGM crée automatiquement cette propriété si la propriété Évolutivité est déclarée dans le fichier RTR. Format : weight@node,weight@node, weight étant un nombre entier qui indique la part relative de la charge distribuée au node spécifié. 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 noeud 1 reçoit 1/4 de la charge et que le noeud 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 RTR, la valeur Tunable de la propriété sera ANYTIME. En changeant cette propriété, vous modifiez uniquement la répartition des nouvelles connexions.

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: Chaîne vide (“”)
Réglable :: ANYTIME

Monitor_check_timeout pour chaque méthode de rappel du type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Monitor_start_timeout pour chaque méthode de rappel du type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Monitor_stop_timeout pour chaque méthode de rappel du type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Monitored_switch (enum)

Le gestionnaire RGM définit cette propriété sur Activé ou Désactivé si l'administrateur du cluster active ou désactive le détecteur à l'aide d'un utilitaire d'administration. Si la propriété est définie sur Disabled, le contrôle de la ressource est arrêté, même si la ressource elle-même reste en ligne. La méthode Monitor_start n'est appelée que lorsque le contrôle est de nouveau activé. Si la ressource n'a pas de méthode de rappel du détecteur, cette propriété n'existe pas.

Catégorie :: Interrogation uniquement
Valeur par défaut :: Aucune
Réglable :: NONE

Network_resources_used (string_array)

Liste des ressources (noms d'hôte logique ou adresses réseau 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 RTR, la valeur Tunable de la propriété sera AT_CREATION.

Remarque –

La page de manuel SUNW.Event(5) explique en détail comment configurer cette propriété pour le CRNP.

Catégorie :: Conditionnelle ou requise
Valeur par défaut :: Aucune
Réglable :: AT_CREATION

Num_resource_restarts sur chaque nœud de cluster (integer)

Vous ne pouvez pas définir cette propriété directement. C'est le gestionnaire RGM qui la définit sur le nombre d'appels scha_control, Resource_restart ou Resource_is_restarted effectués pour la ressource sur le nœud au cours des n dernières secondes. n correspond à la valeur de la propriété Retry_interval de la ressource. Le RGM réinitialise le compteur de redémarrage à zéro (0) chaque fois que cette ressource exécute un transfert scha_control (que la tentative de transfert réussisse ou non).

Si un type de ressource 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.

Catégorie :: Interrogation uniquement
Valeur par défaut :: Aucune
Réglable :: NONE

Num_rg_restarts sur chaque nœud de cluster (integer)

Vous ne pouvez pas définir cette propriété directement. Le gestionnaire RGM la définit sur le nombre d'appels scha_control Restart que la ressource a effectués sur le nœud, pour le groupe auquel elle appartient, au cours des n dernières secondes. n correspond à 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.

Catégorie :: Voir la description
Valeur par défaut :: Aucune
Réglable :: NONE

On_off_switch (enum)

Le gestionnaire RGM définit cette propriété sur Activé ou Désactivé si l'administrateur du cluster active ou désactive la ressource à l'aide d'un utilitaire d'administration. En cas de désactivation, la ressource est déconnectée et aucun rappel n'est effectué tant qu'elle n'est pas réactivée.

Catégorie :: Interrogation uniquement
Valeur par défaut :: Aucune
Réglable :: NONE

Port_list (string_array)

Liste des numéros de port de réception du serveur. Chaque numéro de port est suivi d'une barre oblique (/), puis 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.

Si la propriété Scalable est déclarée dans le fichier RTR, le RGM crée automatiquement la propriété Port_list. Dans le cas contraire, la propriété est indisponible à moins qu'elle ne soit explicitement déclarée dans le fichier RTR.

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.

Catégorie :: Conditionnelle ou requise
Valeur par défaut :: Aucune
Réglable :: ANYTIME

Postnet_stop_timeout pour chaque méthode de rappel du type (integer)

Délai en secondes après lequel le gestionnaire RGM conclut que l'exécution de la méthode a échoué. Pour un type de ressource donné, seules les méthodes déclarées dans le fichier RTR possèdent des propriétés de délai d'attente définies.

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Prenet_start_timeout pour chaque méthode de rappel du type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

R_description (string)

Brève description de la ressource.

Catégorie :: Facultatif
Valeur par défaut :: Chaîne vide
Réglable :: ANYTIME

Resource_dependencies (string_array)

Liste de ressources du même groupe ou d'un groupe différent, dont la ressource Resource_dependencies dépend fortement. La ressource ne peut être démarrée que si toutes les ressources de la liste sont activées. Si cette ressource et l'une des ressources de la liste démarrent en même temps, le gestionnaire RGM attend pour démarrer cette ressource que la ressource de la liste démarre. Si la ressource dominante ne démarre pas, la ressource dépendante reste déconnectée. Il se peut que la ressource dominante ne démarre pas parce que son groupe est déconnecté ou se trouve à l'état START_FAILED. Si la ressource dépendante reste déconnectée parce qu'elle dépend d'une ressource d'un autre groupe, qui ne démarre pas, le groupe de la ressource dépendante passe à l'état PENDING_ONLINE_BLOCKED .

Si la ressource dépendante est déconnectée en même temps que ses ressources dominantes, elle est arrêtée en premier. Cependant, si elle reste connectée ou ne parvient pas à s'arrêter, ses ressources dominantes appartenant à d'autres groupes peuvent néanmoins s'arrêter. Les ressources de la liste ne peuvent pas être désactivées, à moins que la ressource dépendante 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. Pour obtenir plus d'informations, reportez-vous au paragraphe Implicit_network_dependencies de la rubrique Propriétés du groupe de ressources.

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. Les méthodes Postnet_stop sont exécutées après les méthodes Stop, selon l'ordre de leurs dépendances. Si les ressources se trouvent dans des groupes différents, la ressource dépendante attend que la ressource dont elle dépend termine Prenet_start et Start avant d'exécuter Prenet_start . Réciproquement, la ressource dont elle dépend attend qu'elle termine Stop et Postnet_stop avant d'exécuter Stop.

Catégorie :: Facultative
Valeur par défaut :: Liste vide
Réglable :: ANYTIME

Resource_dependencies_restart (string_array)

Liste de ressources du même groupe ou d'un groupe différent, dont la ressource Resource_dependencies_restart dépend pour le redémarrage.

Cette propriété fonctionne de la même manière que Resource_dependencies, à une exception près. Si l'une des ressources de la liste des dépendances de redémarrage est redémarrée, cette ressource l'est également. Le RGM redémarre la ressource dépendante une fois la ressource dominante reconnectée.

Catégorie :: Facultative
Valeur par défaut :: Liste vide
Réglable :: ANYTIME

Resource_dependencies_weak (string_array)

Liste de ressources du même groupe ou de groupes différents, par rapport auxquelles la ressource Resource_dependencies_weak a une dépendance faible. Une dépendance faible détermine l'ordre des appels de méthode. Le RGM appelle les méthodes Start des ressources de cette liste, avant d'appeler la méthode Start de la ressource dépendante. Le RGM appelle les méthodes Stop de la ressource dépendante avant d'appeler les méthodes Stop de celles de la liste. Si les ressources de la liste ne parviennent pas à démarrer ou restent déconnectées, la ressource dépendante peut néanmoins démarrer.

Si la ressource dépendante démarre en même temps qu'une des ressources de sa liste Resource_dependencies_weak, le RGM attend le démarrage de la ressource dominante avant de démarrer la ressource dépendante. Si la ressource dominante ne démarre pas – si, par exemple, le groupe de ressources auquel elle appartient reste déconnecté ou si elle se trouve à l'état START_FAILED, la ressource dépendante démarre. Le groupe de ressources de la ressource dépendante peut passer temporairement à l'état PENDING_ONLINE_BLOCKED au démarrage des ressources de sa liste Resource_dependencies_weak. Lorsque toutes les ressources de la liste ont démarré, ou refusé de démarrer, la ressource dépendante démarre et son groupe repasse à 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. Les méthodes Postnet_stop sont exécutées après les méthodes Stop, selon l'ordre de leurs dépendances. Si les ressources se trouvent dans des groupes différents, la ressource dépendante attend que la ressource dont elle dépend effectue Prenet_start et Start avant d'exécuter Prenet_start . Réciproquement, la ressource dont elle dépend attend que la ressource qui dépend d'elle termine Stop et Postnet_stop avant d'exécuter Stop.

Catégorie :: Facultative
Valeur par défaut :: Liste vide
Réglable :: ANYTIME

Resource_name (string)

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.

Catégorie :: Requis
Valeur par défaut :: Aucune
Réglable :: NONE

Resource_project_name (string)

Nom de projet Solaris associé à la ressource. Utilisez cette propriété pour appliquer aux services de données du cluster les fonctions de gestion de ressources Solaris, telles que les partages de processeurs et les pools de ressources. Lorsque le gestionnaire RGM connecte les ressources, il démarre les processus connexes sous ce nom de projet. Si cette propriété n'est pas spécifiée, le nom du projet est tiré de la propriété RG_project_name du groupe de ressources comprenant la ressource (pour plus d'informations, consultez la page de manuel rg_properties(5)). Si aucune propriété n'est spécifiée, le gestionnaire RGM utilise le nom de projet prédéfini par_défaut. Le nom de projet spécifié doit apparaître dans la base de données des projets (pour plus d'informations, consultez la page de manuel projects(1) et le document System Administration Guide: Solaris Containers-Resource Management and Solaris Zones).

Cette propriété n'est prise en charge que si elle est exécutée sous Solaris 9.

Remarque –

Les modifications apportées à la propriété prennent effet lors du démarrage de la ressource.

Catégorie :: Facultatif
Valeur par défaut :: Null
Réglable :: ANYTIME

Resource_state sur chaque noeud de cluster (enum)

État de la ressource déterminé par le RGM sur chaque nœud du cluster. Les états possibles sont les suivants : ONLINE, OFFLINE, START_FAILED , STOP_FAILED, MONITOR_FAILED, ONLINE_NOT_MONITORED, STARTING et STOPPING .

Vous ne pouvez pas configurer cette propriété.

Catégorie :: Interrogation uniquement
Valeur par défaut :: Aucune
Réglable :: NONE

Retry_count (integer)

Nombre de fois qu'un détecteur tente de redémarrer une ressource si celle-ci échoue. Si le nombre défini par Retry_count est dépassé, le détecteur effectue l'une des actions suivantes (en fonction du service de données spécifique et du paramétrage de la propriété Failover_mode) :

Il peut autoriser le groupe de ressources à rester sur le noeud principal actuel, même si la ressource est dans un état défectueux
Il peut demander un basculement du groupe de ressources sur un autre noeud

Cette propriété est créée par le RGM. L'administrateur du cluster 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 RTR, la valeur Tunable de la propriété sera WHEN_DISABLED.

Remarque –

Si vous spécifiez une valeur négative pour cette propriété, le détecteur tente de redémarrer la ressource un nombre illimité de fois.

Catégorie :: Conditionnelle
Valeur par défaut :: voir ci-dessus
Réglable :: WHEN_DISABLED

Retry_interval (integer)

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 Nombre_nouvelles_tentatives. Cette propriété est créée par le RGM. L'administrateur du cluster 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 RTR, la valeur Tunable de la propriété sera WHEN_DISABLED.

Catégorie :: Conditionnelle
Valeur par défaut :: pas de valeur par défaut (voir ci-dessus)
Réglable :: WHEN_DISABLED

Scalable (boolean)

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. La valeur par défaut de la propriété Scalable, lorsqu'elle est déclarée dans le fichier RTR, est TRUE.

Si cette propriété est déclarée dans le fichier RTR, on ne peut lui affecter un attribut Tunable différent de 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 déclarer les propriétés Network_resources_used et Port_list de manière explicite dans le fichier RTR. Ces propriétés peuvent être aussi utiles dans un service non évolutif que dans un service évolutif.

L'utilisation de cette propriété de ressource avec la propriété de type de ressource Failover est détaillée plus avant dans la page de manuel r_properties(5).

Catégorie :: Facultatif
Valeur par défaut :: Aucune
Réglable :: AT_CREATION

Start_timeout pour chaque méthode de rappel de type (integer)

Intervalle de temps en secondes après lequel le gestionnaire RGM conclut que l'exécution de cette méthode a échoué. Pour un type de ressource donné, les propriétés de l'intervalle d'attente sont uniquement définies pour les méthodes déclarées dans le fichier RTR.

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Status sur chaque noeud de cluster (enum)

Défini par le détecteur de ressource via la commande scha_resource_setstatus ou la fonction scha_resource_setstatus(). Les valeurs possibles sont les suivantes : OK, degraded, faulted, unknown et offline. Lorsqu'une ressource est connectée ou déconnectée, le RGM définit automatiquement la valeur Status si cette dernière n'est pas définie par le détecteur ou les méthodes de la ressource.

Catégorie :: Interrogation uniquement
Valeur par défaut :: Aucune
Réglable :: NONE

Status_msg sur chaque noeud de cluster (string)

Cette propriété est définie par le détecteur de ressources en même temps que la propriété Statut. 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.

Catégorie :: Interrogation uniquement
Valeur par défaut :: Aucune
Réglable :: NONE

Stop_timeout pour chaque méthode de rappel de type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Thorough_probe_interval (integer)

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 du cluster 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 RTR, la valeur Tunable de la propriété sera WHEN_DISABLED.

Catégorie :: Conditionnelle
Valeur par défaut :: Aucune
Réglable :: WHEN_DISABLED

Type (string)

Type de ressource dont cette ressource est une instance.

Catégorie :: Requis
Valeur par défaut :: Aucune
Réglable :: NONE

Type_version (string)

Indique la version de type de ressource actuellement associée à cette ressource. Le gestionnaire 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. Lorsqu'une ressource est éditée, la valeur de la propriété Type_version peut être modifiée.

Les possibilités de réglage de la propriété dépendent des éléments suivants :

la version actuelle du type de ressource ;
L'instruction #$upgrade_from figurant dans le fichier RTR.

Catégorie :: Voir la description
Valeur par défaut :: Aucune
Réglable :: Voir la description

UDP_affinity (boolean)

Si cette propriété est définie sur TRUE, elle envoie tout le trafic UDP depuis un client donné vers le noeud de serveur qui gère actuellement tout le trafic TCP du 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. De plus, Weak_affinity doit être défini sur FALSE.

Cette propriété n'est utilisée qu'avec les services évolutifs.

Catégorie :: Facultatif
Valeur par défaut :: Aucune
Réglable :: WHEN_DISABLED

Update_timeout pour chaque méthode de rappel de type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Validate_timeout pour chaque méthode de rappel de type (integer)

Catégorie :: Conditionnelle ou facultative
Valeur par défaut :: 3600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.
Réglable :: ANYTIME

Weak_affinity (boolean)

Si cette propriété est définie sur TRUE, elle active la forme faible d'affinité 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 :

Un listener de serveur démarre en réponse à divers événements - comme par exemple le redémarrage d'un détecteur de pannes, le basculement d'une ressource ou l'admission d'un noeud dans un cluster après un échec.
La valeur de Load_balancing_weights change pour la ressource évolutive car l'administrateur du cluster a effectué une action 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.

Catégorie :: Facultatif
Valeur par défaut :: Aucune
Réglable :: WHEN_DISABLED