test

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

Annexe A Propriétés standard

Cette annexe décrit les propriétés standard des types de ressources, des ressources et des groupes de ressources, ainsi que les attributs des propriétés de ressource, disponibles pour modifier les propriétés définies par le système et créer des propriétés d'extension.

Remarque –

Les noms de propriété des groupes de ressources, des ressources et des types de ressources ne sont pas sensibles à la casse. Vous pouvez associer les majuscules et les minuscules dans les noms des propriétés.

Cette annexe aborde les sujets suivants :

Propriétés des types de ressources

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

Les propriétés des types de ressources ne peuvent être mises à jour via les utilitaires d'administration, hormis Installed_nodes et RT_system, qui ne peuvent pas être déclarées dans le fichier RTR et doivent être définies par l'administrateur du cluster.

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

Remarque –

les noms des propriétés de types de ressources, tels API_version et Boot, ne sont pas sensibles à la casse. Vous pouvez associer les majuscules et les minuscules dans le nom des propriétés.

API_version (integer)

Version minimum de l'API de gestion des ressources nécessaire à la prise en charge de l'implémentation de ce type de ressource.

Ci-dessous, vous trouverez une liste des versions de Sun Cluster avec en regard l'API_version maximum prise en charge.

Version 3.1 et antérieures

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

3.1 8/05

6

Si vous définissez la propriété API_version sur une valeur supérieure à 2 dans le fichier RTR, le type de ressources ne sera pas installé sur les versions de Sun Cluster qui prennent en charge une API_version maximum inférieure. Par exemple, si vous déclarez API_version=5 pour un type de ressources, ce type de ressources ne peut être installé sur aucune des versions de Sun Cluster antérieures à la version 3.1 9/04.

Remarque –

Si vous ne déclarez pas cette propriété ou si vous lui affectez sa valeur par défaut (2), le service de données peut être installé sur n'importe quelle version de Sun Cluster (ultérieure à Sun Cluster 3.0).

Catégorie :

Facultatif

Valeur par défaut :

2

Réglable :

NONE

Boot (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute sur un nœud se connectant ou se reconnectant au cluster lorsqu'une ressource de ce type est déjà gérée. Cette méthode initialise les ressources de ce type de la même manière que la méthode Init .

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Failover (boolean)

TRUE indique qu'il est impossible de configurer les ressources de ce type dans un groupe pouvant être connecté à plusieurs nœuds à la fois.

Le tableau suivant illustre l'utilisation de cette propriété de type de ressources avec la propriété de ressources Scalable.

Valeur de la propriété de types de ressources Failover

Valeur de la propriété de ressources Scalable

Description 

TRUE

TRUE

Ne spécifiez pas cette combinaison, qui n'est pas logique. 

TRUE

FALSE

Spécifiez cette combinaison pour un service de basculement. 

FALSE

TRUE

Spécifiez cette combinaison pour un service évolutif utilisant une ressource SharedAddress pour l'équilibrage de charge du réseau.

Pour obtenir plus d'informations sur la ressource SharedAddress, reportez-vous au manuel Guide des notions fondamentales de Sun Cluster pour SE Solaris

FALSE

FALSE

Bien qu'elle soit inhabituelle, cette combinaison peut permettre de sélectionner un service multimaître n'utilisant pas de système d'équilibrage de charge de réseau. 

Pour obtenir plus d'informations, lisez la description de Scalable à la page de manuel r_properties(5) et au Chapitre 3, Notions-clés destinées aux administrateurs système et aux développeurs d’applications du Guide des notions fondamentales de Sun Cluster pour SE Solaris.

Catégorie :

Facultative

Valeur par défaut :

FALSE

Réglable :

NONE

Fini (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute lorsqu'une ressource du type défini bascule en ressource non gérée.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Init (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute lorsqu'une ressource du type défini bascule en ressource gérée.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Init_nodes (enum)

Cette propriété désigne les nœuds sur lesquels le RGM doit appeler les méthodes Init, Fini, Boot et Validate. Elle peut prendre les valeurs RG_PRIMARIES (seulement les nœuds qui peuvent maîtriser la ressource) ou RT_INSTALLED_NODES (tous les nœuds sur lesquels le type de ressource est installé).

Catégorie :

Facultative

Valeur par défaut :

RG_PRIMARIES

Réglable :

NONE

Installed_nodes (string_array)

Liste des noms des nœuds de cluster sur lesquels le type de ressources peut être exécuté. Le gestionnaire RGM crée automatiquement cette propriété. La valeur peut être définie par l'administrateur du cluster. Cette propriété ne peut être déclarée dans le fichier RTR.

Catégorie :

Configuration possible par l'administrateur du cluster

Valeur par défaut :

Tous les nœuds du cluster

Réglable :

ANYTIME

Is_logical_hostname (boolean

La valeur TRUE indique que ce type de ressources correspond à une version du type de ressources LogicalHostname gérant les adresses IP de basculement.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

NONE

Is_shared_address (boolean)

La valeur TRUE indique que ce type de ressources correspond à une version du type de ressources SharedAddress gérant les adresses IP de basculement.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

NONE

Monitor_check (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute avant d'effectuer, sur demande du détecteur, le basculement d'une ressource du type défini.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Monitor_start (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute pour démarrer un détecteur de pannes pour une ressource du type défini.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Monitor_stop (string)

Méthode de rappel requise si Démarrage_détecteur est défini : chemin d'accès au programme que le RGM exécute pour arrêter un détecteur de pannes qui surveille une ressource du type défini.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Pkglist (string_array)

Liste facultative des packages installés lors de l'installation du type de ressources.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Postnet_stop (string)

Méthode de rappel facultative : chemin d'accès au programme que le gestionnaire RGM exécute après avoir appelé la méthode Stop d'une ressource d'adresse réseau dont dépend une ressource du type défini. Une fois les interfaces réseau désactivées, cette méthode doit effectuer des actions Stop.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Prenet_start (string)

Méthode de rappel facultative : chemin d'accès au programme que le gestionnaire RGM exécute avant d'appeler la méthode Start d'une ressource d'adresse réseau dont dépend une ressource du type défini. Cette méthode exécute les actions Start à effectuer avant la configuration des interfaces réseau.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Resource_list (string_array)

Liste de l'ensemble des ressources du type. L'administrateur de cluster ne peut pas définir cette propriété directement. Le RGM la met à jour lorsque l'administrateur de cluster ajoute ou supprime une ressource du type défini dans un groupe de ressources, quel qu'il soit.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Liste vide

Réglable :

NONE

Resource_type (string)

Nom du type de ressources. Pour afficher les noms des types de ressources actuellement en ligne, utilisez la commande suivante :

scrgadm -p

Sous Sun Cluster 3.1 et les versions ultérieures, le nom d'un type de ressources doit obligatoirement comporter le numéro de version :

vendor-id.resource-type:rt-version

Les trois composantes d'un nom de type de ressources correspondent aux propriétés vendor-id, resource-type et rt-version définies dans le fichier RTR. La commande scrgadm ajoute le point (.) et le deux-points (:) . Le suffixe rt-version du nom du type de ressources correspond à la valeur de la propriété RT_version. Pour éviter tout risque d'ambiguité de la propriété vendor-id, il est recommandé d'utiliser le symbole boursier de la société lors de la création du type de ressources. Les noms des type de ressources créés sous les versions antérieures à Sun Cluster 3.1 conservent la syntaxe suivante :

vendor-id.resource-type

Catégorie :

Requise

Valeur par défaut :

Chaîne vide

Réglable :

NONE

RT_basedir (string)

Chemin d'accès au répertoire permettant de compléter les chemins d'accès relatifs des méthodes de rappel. La valeur doit être le chemin du répertoire dans lequel sont installés les packages du type de ressources. Ce chemin doit être complet, c'est-à-dire qu'il doit commencer par une barre oblique (/).

Catégorie :

Requise, à moins que les noms de chemin d'accès de toutes les méthodes ne soient absolus.

Valeur par défaut :

Aucune

Réglable :

NONE

RT_description (string)

Brève description du type de ressources.

Catégorie :

Conditionnelle

Valeur par défaut :

Chaîne vide

Réglable :

NONE

RT_system (boolean)

Si la propriété RT_system d'un type de ressources est définie sur TRUE, ce type de ressources ne peut pas être supprimé (scrgadm -r -t resource-type-name). Cette propriété prévient la suppression accidentelle d'un type de ressources essentiel à la prise en charge de l'infrastructure du cluster, comme LogicalHostname, par exemple. Vous pouvez l'appliquer RT_system à n'importe quel type de ressources.

Pour supprimer un type de ressources dont la propriété RT_system et définie sur TRUE, vous devez d'abord définir cette propriété sur FALSE. Soyez prudent lorsque vous supprimez un type de ressources prenant en charge les services du cluster.

Catégorie :

Facultative

Valeur par défaut :

FALSE

Réglable :

ANYTIME

RT_version (string)

Chaîne indiquant la version de l'implémentation du type de ressources ; elle est obligatoire à partir de Sun Cluster 3.1. RT_version représente le suffixe d'un nom complet de type de ressources. La propriété RT_version, facultative dans Sun Cluster 3.0, est obligatoire depuis Sun Cluster 3.1.

Catégorie :

Conditionnelle/explicite ou requise

Valeur par défaut :

Aucune

Réglable :

NONE

Single_instance (boolean)

Si cette propriété est paramétrée sur TRUE, une seule ressource du type défini peut exister dans le cluster. Le gestionnaire RGM ne permet d'exécuter qu'une seule ressource de ce type à la fois à l'échelle du cluster.

Catégorie :

Facultative

Valeur par défaut :

FALSE

Réglable :

NONE

Start (string)

Méthode de rappel : chemin d'accès au programme que le RGM exécute pour démarrer une ressource du type défini.

Catégorie :

Requise à moins qu'une méthode Prenet_start ne soit déclarée dans le fichier RTR

Valeur par défaut :

Aucune

Réglable :

NONE

Stop (string)

Méthode de rappel : chemin d'accès au programme que le RGM exécute pour arrêter une ressource du type défini.

Catégorie :

Requise à moins que le fichier RTR ne déclare une méthode Postnet_stop

Valeur par défaut :

Aucune

Réglable :

NONE

Update (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute si les propriétés d'une ressource du type défini sont modifiées tandis que cette ressource est en cours d'exécution.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Validate (string)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute pour vérifier les valeurs des propriétés des ressources de ce type.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

NONE

Vendor_ID (string)

Reportez-vous à la description de la propriété Resource_type.

Catégorie :

Conditionnelle

Valeur par défaut :

Aucune

Réglable :

NONE

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 :

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)

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

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)

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

Monitor_start_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

Monitor_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 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

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)

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

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)

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

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)

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

Validate_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

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

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

Attributs des propriétés de ressources

La rubrique suivante présente les attributs des propriétés de ressource pouvant être utilisés pour modifier les propriétés définies par le système ou créer des propriétés d'extension.

Attention – Attention –

vous ne pouvez pas définir les types boolean, enum ou int sur les valeurs par défaut suivantes : Null ou une chaîne de caractères vide (“”) .

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

Array_maxsize

Nombre maximum d'éléments de tableau autorisé pour le type stringarray.

Array_minsize

Nombre minimum d'éléments de tableau autorisé pour le type stringarray.

Default

Indique une valeur par défaut pour la propriété.

Description

Chaîne de caractères présentant une brève description de la propriété. L'attribut Description ne peut pas être défini dans le fichier RTR pour les propriétés définies par le système.

Enumlist

Pour un type énum, ensemble de valeurs de chaînes de caractères permises pour la propriété.

Extension

S'il est utilisé, cet attribut indique que l'entrée du fichier RTR déclare une propriété d'extension définie par l'implémentation du type de ressource. Si cet attribut n'apparaît pas, l'entrée correspond à une propriété définie par le système.

Max

Valeur maximale autorisée pour la propriété du type int.

Maxlength

Pour les types string et stringarray, longueur maximale permise pour une chaîne.

Min

Valeur minimale autorisée pour la propriété du type int.

Minlength

Pour les types string et stringarray, longueur minimale permise pour une chaîne.

Property

Nom de la propriété de ressource.

Tunable

Indique si l'administrateur du cluster peut lui-même définir la valeur de cette propriété dans une ressource. Définissez-la sur NONE ou FALSE pour empêcher l'administrateur du cluster de définir la propriété. Les valeurs permettant à un administrateur du cluster de modifier une propriété sont les suivantes : TRUE ou ANYTIME (à n'importe quel moment), AT_CREATION (uniquement lorsque la ressource est créée) ou WHEN_DISABLED (lorsque la ressource est désactivée). Pour établir d'autres conditions (“lorsque le contrôle est désactivé” ou “en cas de déconnexion”), définissez cet attribut sur ANYTIME et validez l'état de la ressource dans la méthode Validate.

La valeur par défaut est différente pour chaque propriété de ressource standard, comme le montre l'entrée suivante. La valeur par défaut permettant de modifier une propriété d'extension, sauf indication contraire dans le fichier RTR, est TRUE (ANYTIME).

Type de la propriété

Les types autorisés sont string, boolean, integer, enum et stringarray. L'attribut type ne peut pas être utilisé dans le fichier RTR pour les propriétés définies par le système. Le type détermine les valeurs de propriété et les types d'attributs autorisés dans les entrées du fichier RTR. Le type enum correspond à un ensemble de valeurs de chaînes de caractères.