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

Propriétés du groupe de ressources

Les informations suivantes décrivent les propriétés des groupes de ressources définis par Sun Cluster. Les valeurs des propriétés sont classées comme suit :

Les propriétés ci-dessous sont d'abord présentées par leur nom, suivi d'une description.

Auto_start_on_new_cluster (boolean)

Cette propriété vérifie que le RGM démarre automatiquement le groupe de ressources lors de la formation d’un nouveau cluster. La valeur par défaut est TRUE.

Si elle est définie sur TRUE, le RGM essaie de lancer le groupe de ressources automatiquement afin d'obtenir les Desired_primaries lors de la réinitialisation simultanée de l'ensemble des noeuds du cluster.

En cas de définition sur FALSE, le groupe de ressources ne démarre pas automatiquement lors de la réinitialisation du cluster. Le groupe de ressources reste déconnecté jusqu'à ce qu'il soit manuellement connecté, via la commande scswitch ou via une instruction équivalente de l'interface graphique utilisateur. Après cela, le groupe de ressources reprend un comportement de basculement normal.

Catégorie :

Facultatif

Valeur par défaut :

TRUE

Réglable :

ANYTIME

Desired_primaries (integer)

Nombre total des noeuds sur lesquels le groupe peut s'exécuter simultanément.

La valeur par défaut est 1. Si la propriété RG_mode est définie sur Failover, sa valeur ne doit pas être supérieure à 1. Si la propriété RG_mode est définie sur Scalable, vous pouvez lui octroyer une valeur supérieure à 1.

Catégorie :

Facultatif

Valeur par défaut :

1

Réglable :

ANYTIME

Failback (boolean)

Valeur booléenne indiquant s'il faut recalculer l'ensemble de noeuds sur lesquels le noeud est actif lorsque les membres du cluster changent. Un recalcul peut amener le gestionnaire RGM à déconnecter le groupe de noeuds qui ne sont pas des noeuds de prédilection et à les connecter aux noeuds de prédilection.

Catégorie :

Facultatif

Valeur par défaut :

FALSE

Réglable :

ANYTIME

Global_resources_used (string_array)

Indique si les systèmes de fichiers du cluster sont utilisés par une ressource de ce groupe. L'administrateur de cluster peut utiliser deux valeurs : l'astérisque (*) pour indiquer toutes les ressources globales et la chaîne de caractères vide (“”) pour indiquer aucune ressource globale.

Catégorie :

Facultatif

Valeur par défaut :

Toutes les ressources globales

Réglable :

ANYTIME

Implicit_network_dependencies (boolean)

Valeur booléenne indiquant, lorsque TRUE est défini, que le RGM doit appliquer les dépendances implicites fortes des ressources d'adresse non réseau aux ressources d'adresses réseau au sein du groupe. Par conséquent, le RGM démarre toutes les ressources d'adresses réseau avant toutes les autres et arrête ces ressources après toutes les autres dans le groupe. Les ressources d'adresse réseau comprennent les ressources de type nom d'hôte logique et adresse partagée.

Dans un groupe de ressources évolutives, cette propriété n'a aucune incidence car un groupe de ressources évolutives ne contient pas de ressources d'adresse réseau.

Catégorie :

Facultatif

Valeur par défaut :

TRUE

Réglable :

ANYTIME

Maximum_primaries (integer)

Nombre maximum de noeuds auxquels le groupe peut être connecté simultanément.

Si la propriété RG_mode est définie sur Failover, sa valeur ne doit pas être supérieure à 1. Si la propriété RG_mode est définie sur Scalable, vous pouvez lui octroyer une valeur supérieure à 1.

Catégorie :

Facultatif

Valeur par défaut :

1

Réglable :

ANYTIME

Nodelist (string_array)

Liste des noeuds de cluster sur lequels le groupe peut être mis en ligne, par ordre de préférence. Ces noeuds correspondent aux noeuds principaux potentiels ou maîtres du groupe de ressources.

Catégorie :

Facultatif

Valeur par défaut :

liste de tous les noeuds du cluster dans un ordre arbitraire

Réglable :

ANYTIME

Pathprefix (string)

Répertoire dans le système de fichiers de cluster dans lequel les ressources du groupe peuvent enregistrer des fichiers d'administration stratégiques. Certaines ressources demandent cette propriété. Faites en sorte que Préfixe_chemin_accès soit unique pour chaque groupe de ressources.

Catégorie :

Facultatif

Valeur par défaut :

Chaîne vide

Réglable :

ANYTIME

Pingpong_interval (integer)

Valeur d'entier non négatif (en secondes) que le RGM utilise pour déterminer sur quels noeuds le groupe de ressources doit être connecté dans les cas suivants :

  • Reconfiguration

  • Après l'exécution d'une commande/fonction scha_control GIVEOVER

Dans le cas d'une reconfiguration, la tentative de connexion du groupe de ressources peut échouer plus d'une fois sur un noeud spécifique durant l'intervalle (en secondes) défini par Pingpong_interval. Cet échec se produit lorsque les méthodes Start ou Prenet_start d'une ressource se sont terminées avec un état différent de zéro ou ont dépassé le délai d'attente autorisé. Par conséquent, le RGM considère que le noeud n'est pas à même d'héberger le groupe de ressources et cherche un autre maître.

Si une commande scha_control ou scha_control GIVEOVER est exécutée par une ressource sur un noeud donné (ce qui amène son groupe de ressources à basculer sur un autre noeud), le premier noeud (sur lequel s'exécutait scha_control) ne peut servir de destination au résultat d'une autre commande scha_control GIVEOVER initiée par cette même ressource tant que Pingpong_interval secondes ne se sont pas écoulées.

Catégorie :

Facultatif

Valeur par défaut :

3600 (une heure)

Réglable :

ANYTIME

Resource_list (string_array)

Liste des ressources contenues dans le groupe. L'administrateur du cluster ne peut pas définir directement cette propriété. Le RGM met à jour cette propriété lorsque l'administrateur du cluster ajoute ou supprime des ressources dans le groupe de ressources.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

NONE

RG_affinities (string)

Le RGM s'efforce de localiser un groupe de ressources sur un noeud actuellement maître d'un groupe de ressources donné (affinité positive) ou qui n'est pas le maître d'un groupe de ressources donné (affinité négative).

Vous pouvez paramétrer la propriété RG_affinities sur les valeurs suivantes :

  • ++ (affinité positive forte) ;

  • + (affinité positive faible) ;

  • - (affinité négative faible) ;

  • -- (affinité négative forte) ;

  • +++ (affinité positive forte avec délégation de basculement).

Par exemple, RG_affinities=+RG2,--RG3 indique que le groupe de ressources dispose d'une affinité positive faible avec RG2 et d'une affinité négative forte avec RG3.

L'utilisation de la propriété RG_affinities est détaillée plus avant dans le Chapitre 2, Administering Data Service Resources du Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Catégorie :

Facultatif

Valeur par défaut :

Chaîne vide

Réglable :

ANYTIME

RG_dependencies (string_array)

Liste (facultative) des groupes de ressources. Elle indique l'ordre choisi pour la connexion ou la déconnexion d'autres groupes sur un même noeud. Le graphique de l'ensemble des RG_affinities fortes (positives et négatives), comprenant également les RG_dependencies, ne doit pas contenir de cycles.

Supposons, par exemple, que le groupe de ressources RG2 soit répertorié dans la liste des RG_dependencies du groupe de ressources RG1 (de ce fait, RG1 a une dépendance de groupe de ressources par rapport à RG2). La liste suivante résume les effets de cette dépendance :

  • Lorsqu'un nœud joint le cluster, les méthodes Boot sur ce nœud ne sont pas exécutées sur les ressources du groupe RG1 tant que l'exécution de toutes les méthodes Boot de ce nœud n'est pas terminée sur les ressources du groupe RG2.

  • Si RG1 et RG2 sont tous deux à l'état PENDING_ONLINE sur un même noeud, au même moment, les méthodes de démarrage (Prenet_start ou Start) ne sont pas exécutées sur les ressources de RG1 tant que l'ensemble des ressources de RG2 n'ont pas exécuté leurs propres méthodes de démarrage.

  • Si RG1 et RG2 sont tous deux à l'état PENDING_OFFLINE sur un même noeud, au même moment, les méthodes d'arrêt (Postnet_stop ou Stop) ne sont pas exécutées sur les ressources de RG2 tant que l'ensemble des ressources de RG1 n'ont pas exécuté leurs propres méthodes d'arrêt.

  • La tentative de basculement des éléments principaux de RG1 ou de RG2 échoue si, du fait de cette opération, le groupe RG1 reste en ligne sur un nœud et que RG2 est désactivé sur tous les nœuds. Pour plus d'informations à ce sujet, consultez les pages de manuel scswitch(1M) et scsetup(1M).

  • Si la propriété Desired_primaries est définie sur zéro sur RG2, sa valeur ne peut être supérieure à zéro sur RG1.

  • Vous ne pouvez pas paramétrer la propriété Auto_start_on_new_cluster sur TRUE pour RG1, si cette même propriété est paramétrée sur FALSE pour RG2.

Catégorie :

Facultatif

Valeur par défaut :

Liste vide

Réglable :

ANYTIME

RG_description (string)

Brève description du groupe de ressources.

Catégorie :

Facultatif

Valeur par défaut :

Chaîne vide

Réglable :

ANYTIME

RG_is_frozen (boolean)

Valeur booléenne indiquant si un périphérique global dont dépend un groupe de ressources est en cours de basculement. Si cette propriété est définie sur TRUE, le périphérique global est basculé. Si elle est paramétrée sur FALSE, aucun périphérique global n'est en cours de basculement. La propriété Global_resources_used du groupe de ressources indique s'il dépend de périphériques globaux.

Vous ne pouvez pas définir directement la propriété RG_is_frozen. Le RGM met à jour la propriété RG_is_frozen lors de la modification de l'état des périphériques globaux.

Catégorie :

Facultatif

Valeur par défaut :

Aucune

Réglable :

NONE

RG_mode (enum)

Indique si le groupe de ressources est un groupe de basculement ou évolutif. Si elle est définie sur Failover, le RGM définit la propriété Maximum_primaries du groupe sur 1. Par conséquent, le groupe de ressources ne peut être géré que par un seul noeud.

Si elle est définie sur Scalable, le RGM permet à la propriété Maximum_primaries d'être configurée sur une valeur supérieure à 1. Le cas échéant, le groupe peut être géré par plusieurs noeuds en même temps. Le RGM n'autorise pas l'ajout d'une ressource dont la propriété Failover est définie sur TRUE dans un groupe de ressources dont la propriété RG_mode est définie sur Scalable.

Si Maximum_primaries est défini sur 1, la valeur par défaut est Failover. Si la valeur de Maximum_primaries est supérieure à 1, la valeur par défaut est Scalable.

Catégorie :

Facultatif

Valeur par défaut :

Dépend de la valeur de la propriété Maximum_primaries

Réglable :

NONE

RG_name (string)

Nom du groupe de ressources. Cette propriété est nécessaire et doit être unique au sein du cluster.

Catégorie :

Requis

Valeur par défaut :

Aucune

Réglable :

NONE

RG_project_name (string)

Nom du projet Solaris (consultez la page de manuel projects(1)) associé au groupe de ressources. 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 RGM connecte des groupes de ressources, il démarre les processus associés sous le nom du projet pour les ressources dont la propriété Resource_project_name n'est pas définie (consultez la page de manuel r_properties(5) pour obtenir plus d'informations). 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 :

La chaîne de texte “default

Réglable :

ANYTIME

RG_state sur chaque noeud du cluster (enum)

Définie par le RGM sur UNMANAGED, ONLINE, OFFLINE, PENDING_ONLINE, PENDING_OFFLINE, ERROR_STOP_FAILED, ONLINE_FAULTED ou PENDING_ONLINE_BLOCKED afin de décrire l'état du groupe sur chaque noeud du cluster.

Vous ne pouvez pas configurer cette propriété. Toutefois, vous pouvez définir cette propriété de manière indirecte via la commande scswitch ou la commande scsetup équivalente - ou encore via les commandes de SunPlex Manager. Un groupe peut exister à l'état UNMANAGED s'il n'est pas géré par le RGM.

Les descriptions qui suivent résument chaque état.


Remarque –

Ces états ne s'appliquent qu'aux noeuds individuels - sauf UNMANAGED, qui s'applique à l'ensemble des noeuds. Par exemple, un groupe de ressources peut être OFFLINE sur le noeud A et PENDING_ONLINE sur le noeud B.


UNMANAGED

État initial d'un groupe de ressources qui vient d'être créé ou qui a été géré précédemment. Soit les méthodes Init n'ont pas encore été exécutées sur les ressources du groupe, soit les méthodes Fini ont été exécutées sur ces ressources.

Le groupe n'est pas géré par le RGM.

ONLINE

Le groupe de ressources a été démarré sur le noeud. En d'autres termes, les méthodes de démarrage Prenet_start, Start et Monitor_start (applicables à chaque ressource) se sont exécutées sur toutes les ressources activées du groupe.

OFFLINE

Le groupe de ressources a été arrêté sur le noeud. En d'autres termes, les méthodes d'arrêt Monitor_stop, Stop et Postnet_stop (applicables à chaque ressource) se sont exécutées sur toutes les ressources activées du groupe. Cet état s'applique également avant le premier démarrage d'un groupe de ressources sur le noeud.

PENDING_ONLINE

Le groupe de ressources est en cours de démarrage sur le noeud. Les méthodes de démarrage Prenet_start, Start et Monitor_start (applicables à chaque ressource) se sont exécutées sur toutes les ressources activées du groupe.

PENDING_OFFLINE

Le groupe de ressources est en cours d'arrêt sur le noeud. Les méthodes d'arrêt Monitor_stop, Stop et Postnet_stop (applicables à chaque ressource) se sont exécutées sur toutes les ressources activées du groupe.

ERROR_STOP_FAILED

Une ou plusieurs des ressources du groupe ne s'est pas arrêtée correctement et se trouve à l'état Stop_failed. Les autres ressources du groupe peuvent rester connectées ou déconnectées. Ce groupe de ressources ne peut démarrer sur aucun noeud tant que l'état ERROR_STOP_FAILED n'est pas corrigé.

Vous devez utiliser une commande administrative (telle que scswitch -c) pour arrêter manuellement la ressource Stop_failed et redéfinir son état sur OFFLINE.

ONLINE_FAULTED

Le groupe de ressources avait l'état PENDING_ONLINE et a terminé son démarrage sur ce noeud. Cependant, une ou plusieurs ressources sont passées à l'état Start_failed ou Faulted.

PENDING_ONLINE_BLOCKED

Le groupe de ressources n'a pas pu démarrer correctement car une ou plusieurs ressources au sein du groupe n'ont pas satisfait une dépendance forte par rapport à une autre ressource, dans un autre groupe. Ces ressources restent à l'état OFFLINE. Lorsque les dépendances sont satisfaites, le groupe de ressources repasse automatiquement à l'état PENDING_ONLINE.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

NONE

RG_system (boolean)

Si la propriété RG_system est définie sur TRUE pour un groupe de ressources donné, certaines opérations ne sont plus accessibles au groupe de ressources et aux ressources qu'il contient. Cette restriction est destinée à éviter les modifications ou suppressions accidentelles de groupes ou ressources importantes. Seules les commandes scrgadm et scswitch sont affectées par cette propriété. Les opérations de scha_control(1HA) et scha_control(3HA) ne sont pas concernées.

Avant d'effectuer une opération dont l'accès est limité sur un groupe de ressources (ou sur une ressource du groupe), vous devez au préalable paramétrer la propriété RG_system correspondante sur FALSE. Soyez très vigilant lors de la modification ou de la suppression d'un groupe de ressources (ou une ressource de ce groupe) prenant en charge des services de cluster.

Opération 

Exemple 

Suppression d'un groupe de ressources 

scrgadm -r -g RG1

Modification d'une propriété d'un groupe de ressources (sauf RG_system)

scrgadm -c -t RG1 -y nodelist=...

Ajout d'une ressource dans un groupe de ressources 

scrgadm -a -j R1 -g RG1

Suppression d'une ressource dans un groupe de ressources 

scrgadm -r -j R1 -g RG1

Modification d'une propriété d'une ressource appartenant à un groupe de ressources 

scrgadm -c -j R1

Basculement et déconnexion d'un groupe de ressources 

scswitch -F -g RG1

Gestion d'un groupe de ressources 

scswitch -o -g RG1

Basculement d'un groupe de ressources à l'état non géré 

scswitch -u -g RG1

Activation d'une ressource 

scswitch -e -j R1

Activation du contrôle d'une ressource 

scswitch -e -M -j R1

Désactivation d'une ressource 

scswitch -n -j R1

Désactivation du contrôle d'une ressource 

scswitch -n -M -j R1

Si la propriété RG_system est définie sur TRUE pour un groupe de ressources donné, la seule propriété du groupe de ressources que vous pouvez modifier est RG_system elle-même. En d'autres termes, il est toujours possible de modifier la propriété RG_system.

Catégorie :

Facultatif

Valeur par défaut :

FALSE

Réglable :

ANYTIME