Propriétés facultatives du module GDS

La liste ci-dessous répertorie les propriétés facultatives du module GDS :

• Network_resources_used

• Stop_command (propriété d'extension) ;

• Probe_command (propriété d'extension)

• Start_timeout ;

• Stop_timeout ;

• Probe_timeout (propriété d'extension) ;

• Child_mon_level (propriété d'extension utilisée uniquement avec les commandes d'administration standard)

• Failover_enabled (propriété d'extension) ;

• Stop_signal (propriété d'extension).

• Log_level (propriété d'extension)

Propriété >Network_resources_used

La valeur par défaut de cette propriété est Null. Vous devez impérativement spécifier cette propriété dès lors que l'application doit être liée à une ou plusieurs adresses spécifiques. Si cette propriété est omise ou si elle est paramétrée sur Null, l'application est supposée écouter sur toutes les adresses.

Avant de créer une ressource GDS, la ressource LogicalHostName ou SharedAddress doit également avoir été configurée. Reportez-vous au document Sun Cluster Data Services Planning and Administration Guide for Solaris OS pour de plus amples informations sur la procédure de configuration d'une ressource LogicalHostname ou SharedAddress.

Pour définir une valeur, indiquez un ou plusieurs noms de ressource. Chacun d'eux peut contenir une ou plusieurs valeurs LogicalHostname ou SharedAddress. Pour plus de détails, voir la page man sur r_properties (5).

Propriété Stop_command

La commande d'arrêt doit arrêter l'application et n'être retournée qu'une fois l'application totalement arrêtée. Il doit impérativement s'agir d'une commande UNIX complète qui peut être transmise directement à un shell pour arrêter l'application.

Si la propriété d'extension Stop_command est indiquée, la méthode d'arrêt du module GDS lance la commande d'arrêt avec 80% du délai d'arrêt imparti. Quel que soit le résultat de la commande d'arrêt, la méthode d'arrêt du module GDS envoie la commande SIGKILL avec 15% du délai d'arrêt imparti. Les 5% restants sont réservés au temps système de gestion interne.

Si la commande d'arrêt est omise, le module GDS tente d'arrêter l'application en utilisant le signal spécifié dans Stop_signal.

Propriété Probe_command

La commande de détection contrôle périodiquement l'état de l'application en question. Il s'agit d'une commande UNIX dont les arguments peuvent être transmis directement à un shell pour sonder l'application. Elle renvoie un état de sortie 0 si l'application est en bon état.

L'état de sortie de la commande de détection permet de déterminer le degré de gravité de la panne qui touche l'application. Appelé état de sondage, l'état de sortie doit être un entier compris entre 0 (succès) et 100 (échec total). Il peut également avoir la valeur spéciale de 201, ce qui provoque le basculement immédiat de l'application, à moins que la propriété Failover_enabled ne soit paramétrée sur FALSE. L'algorithme de vérification (voir la page man sur scds_fm_action(3HA)) utilise cet état pour prendre la décision de redémarrer l'application en local ou de la basculer sur un autre nœud. Si l'état de sortie est 201, l'application est immédiatement basculée.

Si la commande d'analyse est omise, le module GDS fournit sa propre sonde qui se connecte à l'application sur l'ensemble d'adresses IP issues de la propriété Network_resources_used ou de la liste scds_get_netaddr_list (voir la page man sur scds_get_netaddr_list(3HA)). Si la connexion réussit, le module GDS se déconnecte immédiatement. Si la connexion et la déconnexion réussissent, on considère que l'application fonctionne correctement.

la détection effectuée par le module GDS n'est qu'un simple substitut à la détection complète de l'application.

Propriété Start_timeout

Cette propriété détermine le délai de démarrage de la commande Start. Pour plus d'informations, voir la rubrique Propriété d'extension Start_command. La valeur par défaut de Start_timeout est de 300 secondes.

Propriété Stop_timeout

Cette propriété détermine le délai d'arrêt de la commande Stop. Pour plus d'informations, voir la rubrique Propriété Stop_command . La valeur par défaut de Stop_timeout est de 300 secondes.

Propriété Probe_timeout

Cette propriété détermine la valeur du délai de la commande d'analyse. Pour plus d'informations, voir la rubrique Propriété Probe_command. La valeur par défaut de Probe_timeout est de 30 secondes.

Propriété Child_mon_level

Cette option est disponible si vous utilisez les commandes d'administration standard de Sun Cluster, et non si vous utilisez SunPlex Agent Builder.

Cette propriété permet de contrôler les processus surveillés par la fonction PMF (Process Monitor Facility). Elle indique le niveau auquel les processus fils sont surveillés. Son fonctionnement est identique à celui de l'argument -C sur la commande pmfadm. Voir la page man sur pmfadm(1M).

L'omission de cette propriété ou l'attribution de la valeur par défaut, soit -1, revient à omettre l'option -C de la commande pmfadm : tous les enfants (et leurs descendants) seront surveillés.

Propriété Failover_enabled

Cette propriété d'extension de type booléen contrôle le comportement de basculement de la ressource. Si cette propriété d'extension est définie sur true, l'application est basculée dès lors que le nombre de redémarrages dépasse la valeur retry_count au cours du délai de retry_interval (en secondes).

Si cette propriété est paramétrée sur false, l'application ne redémarre pas ou n'est pas basculée sur un autre nœud, lorsque le nombre de tentatives de redémarrage dépasse la valeur de retry_count au cours du délai de retry_interval (en secondes).

Cette propriété peut être utilisée pour empêcher la ressource d'application de lancer le basculement du groupe de ressources. La valeur par défaut est true.

Propriété Stop_signal

Le module GDS utilise la valeur de cette propriété d'extension entière pour déterminer le signal utilisé pour arrêter l'application au moyen de la fonction PMF. Voir la page man sur signal( 3HEAD) pour obtenir la liste des valeurs entières proposées. La valeur par défaut est 15 ( SIGTERM).

Propriété Log_level

Cette propriété détermine le niveau ou le type des messages de diagnostic consignés par le module GDS. Vous pouvez lui attribuer la valeur NONE, INFO ou ERR. Lorsque vous choisissez NONE, les messages de diagnostic ne sont pas consignés par le module GDS. Lorsque vous choisissez INFO, seuls les messages d'informations sont consignés et lorsque vous choisissez ERR, seuls les messages d'erreur sont consignés. Par défaut, le module GDS ne consigne pas les messages de diagnostic (NONE).