test

Guide des développeurs pour les services de données Sun Cluster pour SE Solaris

Annexe A Propriétés standard

Cette annexe présente les propriétés des types de ressources standard, des groupes de ressources et des 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.

Elle est constituée des sections suivantes :

Propriétés des types de ressources

La section ci-après présente les propriétés de type de ressources définies par Sun Cluster. Les valeurs de propriété sont classées comme suit (après Catégorie) :

Les propriétés de type de ressources ne peuvent pas être mises à jour par des utilitaires d'administration, à l'exception des propriétés 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.

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

API_version (entier)

Version de l'API de gestion des ressources utilisée lors de l'implémentation de ce type de ressources.

Les informations ci-dessous décrivent la valeur maximale de la propriété API_version prise en charge par chacune des versions de Sun Cluster.

Version 3.1 et antérieures

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

La déclaration dans le fichier RTR d'une valeur supérieure à 2 pour API_version empêche l'installation de ce type de ressources sur une version de Sun Cluster prenant en charge une version dont la valeur maximale est 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.

Catégorie :

Optionnelle

Valeur par défaut :

2

Réglable :

Non

Boot (chaîne)

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 génère des actions d'initialisation sur des ressources de ce type, similaires à celles de la méthode Init.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Failover (booléen)

La valeur TRUE indique qu'il est impossible de configurer les ressources de ce type dans un groupe pouvant être en ligne sur plusieurs nœuds à la fois.

Catégorie :

Optionnelle

Valeur par défaut :

FALSE

Réglable :

Non

Fini (chaîne)

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

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Init (chaîne)

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

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Init_nodes (énum.)

Valeurs disponibles : RG_primaries (uniquement les nœuds pouvant gérer la ressource) ou >RT_installed_nodes (tous les nœuds sur lesquels le type de ressource est installé). Cette propriété indique les nœuds sur lesquels le RGM doit appeler les méthodes Init, Fini, Boot et Validate.

Catégorie :

Optionnelle

Valeur par défaut :

RG_primaries

Réglable :

Non

Installed_nodes (tableau de chaînes)

Liste des noms des nœuds du cluster sur lesquels le type de ressources est autorisé à fonctionner. Le 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 :

Oui

Is_logical_hostname (booléen)

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 :

Non

Is_shared_address (booléen)

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 :

Non

Monitor_check (chaîne)

Méthode de rappel facultative : chemin d'accès au programme appelé par le gestionnaire RPM avant d'effectuer, sur demande du détecteur, le basculement d'une ressource de ce type.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Monitor_start (chaîne)

Méthode de rappel facultative : chemin d'accès au programme que le RGM exécute pour démarrer un système de détection des pannes pour une ressource de ce type.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Monitor_stop (chaîne)

Méthode de rappel requise si la propriété Monitor_start est définie : chemin d'accès au programme que le RGM exécute pour arrêter un système de détection des pannes pour une ressource de ce type.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Pkglist (tableau de chaînes)

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 :

Non

Postnet_stop (chaîne)

Méthode de rappel facultative : chemin d'accès au programme exécuté par le RGM après que ce dernier a appelé la méthode Stop de n'importe quelle ressource d'adresse réseau dont dépend une ressource de ce type. Une fois les interfaces réseau déconnectées, la méthode entreprend des actions Stop.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Prenet_start (chaîne)

Méthode de rappel facultative : chemin d'accès au programme appelé par le RGM avant qu'il n'appelle la méthode Start de n'importe quelle ressource d'adresse réseau dont dépend une ressource de ce type. Cette méthode doit entreprendre des actions Start avant que les interfaces réseau ne soient configurées.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Resource_type (chaîne)

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

scrgadm -p

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

vendor_id.resource_type:version

Les trois composants du nom d'un type de ressources correspondent à des propriétés définies dans le fichier RTR en tant que Vendor_id, Resource_type et RT_version. La commande scrgadm insère les séparateurs point (.) et deux-points (:) . Le suffixe RT_version du nom du type de ressources est identique à la valeur de la propriété RT_version. Pour avoir l'assurance que l'ID_fournisseur est unique, nous vous recommandons d'utiliser le symbole boursier de l'entreprise en tant que type de ressources. Les noms de 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 :

Non

RT_basedir (chaîne)

Chemin d'accès au répertoire permettant de compléter les chemins d'accès relatifs des méthodes de rappel. Ce chemin doit être configuré conformément à l'emplacement où sont installés les packages du type de ressources. Il doit être complet, c'est-à-dire qu'il doit commencer par une barre oblique (/). Il n'est pas nécessaire de définir cette propriété si tous les noms de chemin d'accès des méthodes sont absolus.

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 :

Non

RT_description (chaîne)

Brève description du type de ressources.

Catégorie :

Conditionnelle

Valeur par défaut :

Chaîne vide

Réglable :

Non

RT_system (booléen)

Lorsqu'elle est paramétrée sur TRUE pour un type de ressources, cette propriété indique que les opérations scrgadm( 1M) autorisées sur ce type de ressources sont limitées. Un type de ressources dont la propriété RT_system est paramétrée sur TRUE, est appelé type de ressources système. Quelle que soit la valeur de cette propriété, il est toujours possible de la modifier.

Catégorie :

Optionnelle

Valeur par défaut :

FALSE

Réglable :

Oui

RT_version (chaîne)

À partir de la version Sun Cluster 3.1, cette chaîne doit être indiquée dans le cadre de l'implémentation du type de ressource. RT_version représente le suffixe dans un nom de type de ressources complet. La propriété RT_version , facultative sous Sun Cluster 3.0, est devenue obligatoire dans les versions 3.1 et supérieures.

Catégorie :

Optionnelle/explicite ou requise

Valeur par défaut :

Aucune

Réglable :

Non

Single_instance (booléen)

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

Catégorie :

Optionnelle

Valeur par défaut :

FALSE

Réglable :

Non

Start (chaîne)

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

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 :

Non

Stop (chaîne)

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

Catégorie :

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

Valeur par défaut :

Aucune

Réglable :

Non

Update (chaîne)

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

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Validate (chaîne)

Méthode de rappel facultative : chemin d'accès au programme appelé pour contrôler les valeurs des propriétés des ressources de ce type.

Catégorie :

Conditionnelle/explicite

Valeur par défaut :

Aucune

Réglable :

Non

Vendor_ID (chaîne)

Reportez-vous à la propriété Resource_type.

Catégorie :

Conditionnelle

Valeur par défaut :

Aucune

Réglable :

Non

Propriétés des ressources

Cette section présente les propriétés de ressource définies par Sun Cluster. Les valeurs de propriété sont classées comme suit (après Catégorie) :

L'attribut Réglable indique si et quand vous pouvez mettre à jour les propriétés de ressource, comme suit :

NONE ou FALSE

Jamais 

TRUE ou ANYTIME

À tout moment 

AT_CREATION

Lorsque la ressource est ajoutée à un cluster 

WHEN_DISABLED

Lorsque la ressource est désactivée 

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

Affinity_timeout (entier )

Durée en secondes pendant laquelle les connexions de l'adresse IP d'un client donné à l'un des services de la ressource sont envoyées vers le même nœud de serveur.

Cette propriété n'est utile que lorsque la propriété Load_balancing_policy est paramétrée sur Lb_sticky ou sur Lb_sticky_wild. En outre, la propriété Weak_affinity doit être paramétrée sur FALSE (valeur par défaut).

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

Catégorie :

Optionnelle

Valeur par défaut :

Aucune

Réglable :

ANYTIME

Cheap_probe_interval (entier)

Durée en secondes entre les appels de détection rapide des pannes de la ressource. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR.

Elle est facultative si une valeur par défaut est spécifiée dans le fichier RTR. Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.

Cette propriété est requise si elle est déclarée dans le fichier RTR et si l'attribut Default n'est pas défini.

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. La rubrique Attributs des propriétés de ressources comporte des informations sur les attributs individuels que vous pouvez définir pour les propriétés d'extension.

Catégorie :

Conditionnelle

Valeur par défaut :

Aucune

Réglable :

Dépend de chaque propriété

Failover_mode (énum.)

NONE, SOFT et HARD affectent uniquement le comportement de basculement lors de l'échec d'une méthode de démarrage ( Prenet_start ou Start). Cependant, une fois la ressource correctement démarrée, NONE, SOFT et HARD n'ont plus aucune incidence sur le prochain démarrage de la ressource ou sur le comportement d'arrêt initié par le détecteur de ressources avec scha_control(1HA) ou scha_control(3HA). NONE (valeur par défaut) signifie que le RGM doit paramétrer l'état de la ressource de manière à indiquer un échec de la méthode et attendre l'intervention de l'utilisateur. SOFT indique qu'en cas d'échec d'une méthode Start, le RGM doit déplacer le groupe de la ressource vers un autre nœud. En cas d'échec d'une méthode Stop ou Monitor_stop, le RGM paramètre la ressource sur l'état Stop_failed et le groupe de ressources sur l'état Error_stop_failed. Le RGM attend, ensuite, l'intervention de l'utilisateur. En cas d'échec de la méthode Stop ou Monitor_stop, les valeurs NONE et SOFT sont identiques. HARD indique qu'en cas d'échec de la méthode Start, le RGM doit déplacer le groupe. En cas d'échec de la méthode Stop ou Monitor_stop, le RGM doit arrêter la ressource en abandonnant le nœud du cluster. HARD, NONE et SOFT affectent les comportements de basculement lors de l'échec d'une méthode Start ou Prenet_start.

Contrairement aux attributs NONE, SOFT et HARD, RESTART_ONLY et LOG_ONLY affectent tous les comportements de basculement, y compris les redémarrages de ressource et de groupe de ressources et les arrêts provoqués par le détecteur de ressources (scha_control ). RESTART_ONLY indique que le détecteur peut exécuter la commande scha_control pour redémarrer une ressource, mais que les tentatives ultérieures de redémarrage ou d'arrêt d'un groupe de ressources avec la commande scha_control échoueront. La propriété Retry_count détermine le nombre de redémarrages autorisés par le RGM dans un laps de temps lui-même défini dans la propriété Retry_interval . Si le nombre de tentatives excède la valeur de la propriété Retry_count, aucun redémarrage de ressource n'est autorisé. Si la propriété Failover_mode est paramétrée sur LOG_ONLY , aucun redémarrage de ressource, ni aucun arrêt ne sont autorisés. Le paramétrage de Failover_mode sur LOG_ONLY a la même incidence que le paramétrage de cette même propriété sur RESTART_ONLY associé au paramétrage de la propriété Retry_count sur zéro. Lorsqu'une méthode de démarrage échoue, RESTART_ONLY et LOG_ONLY ont la même incidence que NONE: aucun basculement ne se produit et l'état de la ressource est remplacé par Start_failed.

Catégorie :

Optionnelle

Valeur par défaut :

Aucune

Réglable :

ANYTIME

Load_balancing_policy (chaîne)

Chaîne de caractères définissant les règles d'équilibrage de la charge. Cette propriété n'est utilisée qu'avec les services évolutifs. Le RGM crée automatiquement cette propriété si la propriété Scalable est déclarée dans le fichier RTR. Les différentes valeurs de la propriété Load_balancing_policy sont les suivantes :

Lb_weighted (par défaut). La charge est répartie entre plusieurs nœuds en fonction des poids définis dans la propriété Load_balancing_weights.

Lb_sticky. Un client donné (identifié par son adresse IP) du service évolutif est toujours envoyé au même nœud du cluster.

Lb_sticky_wild. L'adresse IP d'un client donné connecté à l'adresse IP d'un service de rétention générique du client (wildcard sticky) est toujours envoyée vers le même nœud de cluster, quel que soit le numéro du port de destination de l'adresse IP.

Catégorie :

Conditionnelle/facultative

Valeur par défaut :

Lb_weighted

Réglable :

AT_CREATION

Load_balancing_weights (tableau de chaînes)

Pour les ressources évolutives uniquement. Le RGM crée automatiquement cette propriété si la propriété Scalable est déclarée dans le fichier RTR. Son format est poids@ nœud,poids@nœud, où poids correspond à un entier reflétant la part de charge relative distribuée au nœud indiqué. Cette part correspond au poids du nœud divisé par la somme de tous les poids. Par exemple, 1@1,3@2 indique que le nœud 1 reçoit 1/4 de la charge et que le nœud 2 en reçoit les 3/4. La chaîne de caractères vide (“”) définit une répartition uniforme. Il s'agit de la valeur par défaut. Les nœuds auxquels aucun poids explicite n'est attribué reçoivent un poids par défaut de 1.

Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est paramétrée sur ANYTIME. En changeant cette propriété, vous modifiez uniquement la répartition des nouvelles connexions.

Catégorie :

Conditionnelle/facultative

Valeur par défaut :

Chaîne vide (“”)

Réglable :

ANYTIME

Méthode_timeout pour chacune des méthodes de rappel dans la propriété Type (entier)

Intervalle de temps en secondes après lequel le RGM conclut que l'exécution d'une méthode a échoué.

Catégorie :

Conditionnelle/facultative

Valeur par défaut :

3 600 secondes (une heure) si la méthode est déclarée dans le fichier RTR.

Réglable :

ANYTIME

Monitored_switch (énum.)

Le RGM paramètre cette propriété sur Enabled ou Disabled selon que l'administrateur du cluster active ou désactive le détecteur à l'aide d'un utilitaire d'administration. Lorsque la propriété est paramétrée sur Disabled, la méthode Start du détecteur n'est pas appelée tant que ce dernier n'est pas réactivé. Si la ressource n'a pas de méthode de rappel du détecteur, cette propriété n'existe pas.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Jamais

Network_resources_used (tableau de chaînes)

Liste des ressources (noms d'hôte logique ou adresses partagées) utilisées par la ressource. Pour les services évolutifs, cette propriété doit se référer aux ressources d'adresse partagée qui se trouvent dans un groupe de ressources séparé. Pour les services à basculement, cette propriété se réfère aux noms d'hôte logique ou aux ressources d'adresse partagée qui se trouvent dans le même groupe de ressources. Le RGM crée automatiquement cette propriété si la propriété Scalable est déclarée dans le fichier RTR. Si elle n'est pas déclarée dans le fichier RTR, Network_resources_used n'est pas disponible à moins qu'elle ne soit explicitement déclarée dans le fichier RTR.

Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est paramétrée sur AT_CREATION.

Remarque –

La page man SUNW.Event(5) décrit la procédure de configuration de cette propriété avec CRNP.

Catégorie :

Conditionnelle/requise

Valeur par défaut :

Aucune

Réglable :

AT_CREATION

Num_resource_restarts sur chaque nœud de cluster (entier)

Vous ne pouvez pas définir directement cette propriété. Elle est paramétrée par le RGM sur le nombre d'appels scha_control , Resource_restart ou Resource_is_restarted effectués pour la ressource sur le nœud depuis les n dernières secondes. n correspond à la valeur de la propriété Retry_interval de la ressource. Le compteur de redémarrage de la ressource est remis à zéro par le RGM dès qu'un arrêt scha_control est exécuté par la ressource, quel que soit le résultat de la tentative d'arrêt.

Si un type de ressources ne déclare pas la propriété Retry_interval, la propriété Num_resource_restarts n'est pas disponible pour les ressources de ce type.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Non

Num_rg_restarts sur chaque nœud de cluster (entier)

Vous ne pouvez pas définir directement cette propriété. Elle est paramétrée par le RGM sur le nombre d'appels scha_control Restart effectués par la ressource pour son groupe de ressources sur le nœud au cours des n dernières secondes, n correspondant à la valeur de la propriété Retry_interval de la ressource. Si un type de ressource ne déclare pas la propriété Retry_interval, la propriété Num_rg_restarts n'est pas disponible pour les ressources de ce type.

Catégorie :

Voir la description

Valeur par défaut :

Aucune

Réglable :

Non

On_off_switch (énum.)

Le RGM paramètre cette propriété sur Enabled ou Disabled selon que l'administrateur du cluster active ou désactive la ressource à l'aide d'un utilitaire d'administration. Si elle est désactivée, la ressource est déconnectée et aucun rappel n'est invoqué jusqu'à ce qu'elle soit de nouveau activée.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Jamais

Port_list (tableau de chaînes)

Liste des numéros de port de réception du serveur. Chaque numéro de port est suivi d'une barre oblique (/) et du protocole utilisé par le port, par exemple Port_list=80/tcp ou Port_list=80/tcp6,40/udp6. Vous pouvez indiquer les valeurs de protocole suivantes :

  • tcp, pour TCP IPv4 ;

  • tcp6, pour TCP IPv6 ;

  • udp, pour UDP IPv4 ;

  • udp6, pour UDP IPv6.

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/requise

Valeur par défaut :

Aucune

Réglable :

AT_CREATION

R_description (chaîne)

Brève description de la ressource.

Catégorie :

Optionnelle

Valeur par défaut :

Chaîne vide

Réglable :

ANYTIME

Resource_dependencies (tableau de chaînes)

Liste de ressources d'un même groupe ou de groupes différents avec lesquelles la ressource a une forte relation de dépendance. La ressource ne peut être exécutée si l'une des ressources de la liste n'est pas activée. Si la ressource et l'une des ressources de la liste tentent de démarrer en même temps, le RGM attend que la ressource de la liste démarre avant de lancer l'autre ressource. Si la ressource de la liste Resource_dependencies ne démarre pas, l'autre ressource reste également déconnectée. La ressource de la liste risque de ne pas démarrer lorsque le groupe de ressources de cette ressource est déconnecté ou lorsque l'état de cette ressource est paramétré sur Start_failed. Si la ressource demeure déconnectée du fait d'une dépendance avec une ressource d'un autre groupe qui ne parvient pas à démarrer, l'état du groupe est alors paramétré sur Pending_online_blocked.

Si la ressource est déconnectée en même temps que celles de la liste, elle est arrêtée avant celles de la liste. Cependant, si la ressource reste connectée ou ne parvient pas à s'arrêter, les ressources de la liste appartenant à un autre groupe peuvent néanmoins s'arrêter. Les ressources de la liste ne peuvent pas être désactivées, à moins que la ressource ne soit désactivée en premier.

Par défaut, dans les groupes de ressources, les ressources d'application ont une forte relation de dépendance implicite avec les ressources d'adresse réseau. La rubrique sur la propriété Implicit_network_dependencies dans la section Propriétés du groupe de ressources contient plus d'informations.

Au sein d'un groupe de ressources, les méthodes Prenet_start sont exécutées par ordre de dépendance avant les méthodes Start. Quant aux méthodes Postnet_stop, elles sont exécutées par ordre de dépendance après les méthodes Stop. Dans le cadre d'une dépendance entre plusieurs groupes de ressources, la ressource dépendante attend que la ressource dont elle dépend termine d'exécuter les méthodes Prenet_start et Start avant d'exécuter sa méthode Prenet_start. En revanche, la ressource dont elle dépend attend que la ressource dépendante termine l'exécution des méthodes Stop et Postnet_stop avant d'exécuter sa méthode Stop.

Catégorie :

Optionnelle

Valeur par défaut :

Liste vide

Réglable :

ANYTIME

Resource_dependencies_restart (tableau de chaînes)

Liste de ressources d'un même groupe ou de groupes différents avec lesquelles la ressource a une relation de dépendance au niveau du redémarrage.

Le fonctionnement de cette propriété est similaire à celui de Resource_dependencies, hormis le fait que, si l'une des ressources de la liste est redémarrée, l'autre ressource est redémarrée. Le redémarrage de la ressource se produit après que la ressource de la liste a été reconnectée.

Catégorie :

Optionnelle

Valeur par défaut :

Liste vide

Réglable :

ANYTIME

Resource_dependencies_weak (tableau de chaînes)

Liste de ressources d'un même groupe ou de groupes différents avec lesquelles la ressource a une faible relation de dépendance. Une dépendance faible détermine l'ordre des appels de méthode. Le RGM appelle les méthodes Start des ressources de la liste avant d'appeler la méthode Start de la ressource. En revanche, il appelle les méthodes Stop de la ressource avant d'appeler celles des ressources de la liste. Si les ressources de la liste ne parviennent pas à démarrer ou restent déconnectées, l'autre ressource peut néanmoins démarrer.

Si la ressource et l'une des ressources de la liste tentent de démarrer en même temps, le RGM attend que la ressource de la liste démarre avant de lancer l'autre ressource. Si la ressource de la liste ne démarre pas (par exemple si son groupe reste déconnecté ou si son état est paramétré sur Start_failed ), l'autre ressource démarre. Le groupe de la ressource peut se voir attribuer provisoirement l'état Pending_online_blocked lors du démarrage des ressources de la liste. Lorsque toutes les ressources de la liste ont démarré ou qu'elles ont subi un échec lors du démarrage, l'autre ressource démarre et son groupe se voit de nouveau attribuer l'état Pending_online.

Si la ressource est déconnectée en même temps que celles de la liste, elle est arrêtée avant celles de la liste. Si la ressource reste connectée ou ne parvient pas à s'arrêter, la ressource de la liste peut tout de même s'arrêter. Vous ne pouvez pas désactiver les ressources de la liste, à moins d'avoir au préalable désactivé l'autre ressource.

Au sein d'un groupe de ressources, les méthodes Prenet_start sont exécutées par ordre de dépendance avant les méthodes Start. Quant aux méthodes Postnet_stop, elles sont exécutées par ordre de dépendance après les méthodes Stop. Dans le cadre d'une dépendance entre plusieurs groupes de ressources, la ressource dépendante attend que la ressource dont elle dépend termine d'exécuter les méthodes Prenet_start et Start avant d'exécuter sa méthode Prenet_start. En revanche, la ressource dont elle dépend attend que la ressource dépendante termine l'exécution des méthodes Stop et Postnet_stop avant d'exécuter sa méthode Stop.

Catégorie :

Optionnelle

Valeur par défaut :

Liste vide

Réglable :

ANYTIME

Resource_name (chaîne)

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 :

Requise

Valeur par défaut :

Aucune

Réglable :

Jamais

Resource_project_name (chaîne)

Nom de projet Solaris associé à la ressource. Cette propriété permet d'appliquer aux services de données du cluster, les fonctions de gestion de ressources de Solaris, telles que le partage d'unité centrale ou les pools de ressources. Lorsque le RGM connecte les ressources, il exécute les processus connexes sous ce nom de projet. Si cette propriété n'est pas spécifiée, le nom de projet est récupéré à partir de la propriété RG_project_name du groupe de ressources contenant la ressource (voir rg_properties (5)). Si aucune propriété n'est spécifiée, le RGM utilise le nom de projet prédéfini default. Le nom de projet spécifié doit se trouver dans la base de données des projets et le superutilisateur root doit être configuré comme membre du projet nommé. Cette propriété est prise en charge uniquement avec les versions 9 et supérieures de Solaris.

Remarque –

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

Catégorie :

Optionnelle

Valeur par défaut :

Null

Réglable :

ANYTIME

Resource_state sur chaque nœud de cluster (énum.)

État de la ressource déterminé par le RGM sur chaque nœud du cluster. Différents états possibles : Online, Offline, Start_failed, Stop_failed, Monitor_failed, Online_not_monitored, Starting et Stopping.

Vous ne pouvez pas configurer cette propriété.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Jamais

Retry_count (entier)

Nombre de fois qu'un détecteur tente de redémarrer une ressource si celle-ci échoue. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR. Elle est facultative lorsqu'une valeur par défaut est indiquée dans le fichier RTR.

Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.

Cette propriété est requise si elle est déclarée dans le fichier RTR et si l'attribut Default n'est pas défini.

Catégorie :

Conditionnelle

Valeur par défaut :

Aucune

Réglable :

WHEN_DISABLED

Retry_interval (entier)

Intervalle de temps en secondes entre les tentatives de redémarrage d'une ressource qui a échoué. Le détecteur de ressources utilise cette propriété en association avec Retry_count. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR. Elle est facultative lorsqu'une valeur par défaut est indiquée dans le fichier RTR.

Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.

Cette propriété est requise si elle est déclarée dans le fichier RTR et si l'attribut Default n'est pas défini.

Catégorie :

Conditionnelle

Valeur par défaut :

Aucune

Réglable :

WHEN_DISABLED

Scalable (booléen)

Indique si la ressource est évolutive, c'est-à-dire si elle utilise les fonctions d'équilibrage de charge réseau de Sun Cluster.

Si cette propriété est déclarée dans le fichier RTR, le RGM crée automatiquement les propriétés de service évolutif pour les ressources de ce type : Affinity_timeout, Load_balancing_policy, Load_balancing_weights, Network_resources_used, Port_list, UDP_affinity et Weak_affinity . Ces propriétés sont définies sur leur valeur par défaut à moins qu'elles ne soient spécifiquement déclarées dans le fichier RTR. Par défaut, la propriété Scalable, lorsqu'elle est déclarée dans le fichier RTR, est paramétrée sur TRUE.

Si cette propriété est déclarée dans le fichier RTR, son attribut de réglage ne peut être autre que AT_CREATION.

Si elle n'est pas déclarée dans le fichier RTR, la ressource n'est pas évolutive, vous ne pouvez pas la régler et aucune propriété de service évolutif n'est définie par le RGM. Cependant, vous pouvez explicitement déclarer les propriétés Network_resources_used et Port_list dans le fichier RTR, car elles peuvent être utiles aussi bien à un service non évolutif qu'à un service évolutif.

Vous devez utiliser cette propriété en association avec la propriété de type de ressource Failover .

Pour ce faire, reportez-vous à la rubrique r_properties (5).

Catégorie :

Optionnelle

Valeur par défaut :

Aucune

Réglable :

AT_CREATION

Status sur chacun des nœuds du cluster (énum.)

Cette propriété est paramétrée par le détecteur de ressources avec scha_resource_setstatus(1HA) ou scha_resource_setstatus(3HA). Les différentes valeurs possibles sont les suivantes : OK, degraded, faulted, unknown et offline. Lorsqu'une ressource est activée ou désactivée, le RGM paramètre automatiquement la propriété Status si celle-ci n'est pas définie par le détecteur de ressources ou par les méthodes.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Jamais

Status_msg sur chacun des nœuds du cluster (chaîne)

Cette propriété est définie par le détecteur de ressources en même temps que la propriété Status. Lorsqu'une ressource est activée ou désactivée, le RGM réinitialise automatiquement cette propriété avec une chaîne vide si elle n'est pas définie par les méthodes de la ressource.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Jamais

Thorough_probe_interval (entier)

Durée en secondes entre les appels de détection des pannes nécessitant un temps système important de la ressource. Cette propriété est créée par le RGM. L'administrateur ne peut y accéder que si elle est déclarée dans le fichier RTR. Elle est facultative lorsqu'une valeur par défaut est indiquée dans le fichier RTR.

Si l'attribut Tunable n'est pas spécifié dans le fichier du type de ressources, la valeur Tunable de la propriété est WHEN_DISABLED.

Cette propriété est requise si l'attribut Default n'est pas spécifié dans la déclaration de propriétés dans le fichier RTR.

Catégorie :

Conditionnelle

Valeur par défaut :

Aucune

Réglable :

WHEN_DISABLED

Type (chaîne)

Type de ressource dont cette ressource est une instance.

Catégorie :

Requise

Valeur par défaut :

Aucune

Réglable :

Jamais

Type_version (chaîne)

Indique la version de type de ressources actuellement associée à cette ressource. Le RGM crée automatiquement cette propriété qui ne peut être déclarée dans le fichier RTR. Sa valeur est identique à celle de la propriété RT_version du type de la ressource. Lors de la création d'une ressource, la propriété Type_version n'est pas explicitement indiquée, mais elle peut apparaître en tant que suffixe du nom du type de ressource. Sa valeur peut être modifiée lors de la modification d'une ressource.

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

  • la version actuelle du type de ressources ;

  • l'instruction #$upgrade_from figurant dans le fichier RTR.

Catégorie :

Voir la description

Valeur par défaut :

Aucune

Réglable :

Voir la description

UDP_affinity (booléen)

Si cette propriété est définie sur vrai, l'intégralité du trafic UDP provenant d'un client donné est envoyé au nœud de serveur qui gère actuellement tout le trafic TCP de ce client.

Cette propriété n'est utile que lorsque la propriété Load_balancing_policy est paramétrée sur Lb_sticky ou sur Lb_sticky_wild. En outre, la propriété Weak_affinity doit être paramétrée sur FALSE (valeur par défaut).

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

Catégorie :

Optionnelle

Valeur par défaut :

Aucune

Réglable :

WHEN_DISABLED

Weak_affinity (booléen)

Si cette propriété est définie sur vrai, cette propriété active l'affinité faible du client. Avec cette affinité, les connexions d'un client donné sont envoyées sur le même nœud de serveur, sauf dans les cas suivants :

  • Lorsque le module d'écoute d'un serveur démarre, en réponse par exemple au redémarrage d'un détecteur de pannes, au basculement d'une ressource ou à l'association d'un nœud à un cluster après un échec.

  • La valeur de la propriété Load_balancing_weights de la ressource évolutive est modifiée du fait d'une opération d'administration.

L'affinité faible offre une alternative de faible déperdition par rapport à la configuration par défaut, tant en termes d'utilisation de la mémoire que de cycles du processeur.

Cette propriété n'est utile que lorsque la propriété Load_balancing_policy est paramétrée sur Lb_sticky ou sur Lb_sticky_wild.

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

Catégorie :

Optionnelle

Valeur par défaut :

Aucune

Réglable :

WHEN_DISABLED

Propriétés du groupe de ressources

La section suivante présente les propriétés de groupe de ressources définies par Sun Cluster. Les valeurs de propriété sont classées comme suit (après Catégorie) :

Chaque description indique si la propriété peut être mise à jour ou non après avoir été définie.

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

Auto_start_on_new_cluster (booléen)

Cette propriété interdit le démarrage automatique d'un groupe de ressources lorsqu'un nouveau cluster est formé.

S'il est configuré sur TRUE, le RGM essaie de démarrer le groupe de ressources automatiquement afin d'obtenir les Desired_primaries lors de la réinitialisation du cluster. S'il est configuré sur FALSE, le groupe de ressources ne démarre pas automatiquement lors de la réinitialisation du cluster.

Catégorie :

Optionnelle

Valeur par défaut :

TRUE

Réglable :

Oui

Desired_primaries (entier)

Nombre de nœuds sur lesquels vous souhaitez que le groupe puisse être en ligne simultanément.

Si la propriété RG_mode est paramétrée sur Failover, sa valeur ne doit pas être supérieure à 1. Si elle est paramétrée sur Scalable, sa valeur peut être supérieure à 1.

Catégorie :

Optionnelle

Valeur par défaut :

1

Réglable :

Oui

Failback (booléen)

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

Catégorie :

Optionnelle

Valeur par défaut :

FALSE

Réglable :

Oui

Global_resources_used (tableau de chaînes)

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

Catégorie :

Optionnelle

Valeur par défaut :

Toutes les ressources globales

Réglable :

Oui

Implicit_network_dependencies (booléen)

Valeur booléenne indiquant, lorsqu'elle est paramétrée sur TRUE, 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. 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 :

Optionnelle

Valeur par défaut :

TRUE

Réglable :

Oui

Maximum_primaries (entier)

Nombre maximum de nœuds auxquels le groupe peut être connecté en même temps.

Si la propriété RG_mode est paramétrée sur Failover, sa valeur ne doit pas être supérieure à 1. Si elle est paramétrée sur Scalable, sa valeur peut être supérieure à 1.

Catégorie :

Optionnelle

Valeur par défaut :

1

Réglable :

Oui

Nodelist (tableau de chaînes)

Liste des nœuds du cluster sur lesquels le groupe peut être mis en ligne suivant un ordre de prédilection. Ces nœuds correspondent aux nœuds principaux potentiels ou maîtres du groupe de ressources.

Catégorie :

Optionnelle

Valeur par défaut :

Liste de tous les nœuds du cluster

Réglable :

Oui

Pathprefix (chaîne)

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 Pathprefix soit unique pour chaque groupe de ressources.

Catégorie :

Optionnelle

Valeur par défaut :

Chaîne vide

Réglable :

Oui

Pingpong_interval (entier)

Entier non négatif (en secondes) utilisé par le RGM pour déterminer l'emplacement auquel connecter le groupe de ressources. Les conditions sous lesquelles cette propriété peut être requise sont les suivantes :

  • lors d'une reconfiguration ;

  • lors de l'exécution d'une commande scha_control -O GIVEOVER ou d'une fonction scha_control() avec l'argument SCHA_GIVEOVER .

Lors d'une reconfiguration, si le groupe de ressources ne parvient pas à se connecter sur un nœud particulier et ce, à plusieurs reprises au cours des Pingpong_interval dernières secondes, le nœud est considéré comme incapable d'héberger le groupe de ressources et le RGM cherche un autre maître. Le groupe de ressources ne parvient pas à se connecter, car la méthode Start ou Prenet_start de la ressource s'est terminée en renvoyant un état de sortie différent de zéro ou a expiré.

Si l'appel de la fonction ou de la commande scha_control d'une ressource provoque la déconnexion du groupe de ressources sur un nœud spécifique dans un délai de Pingpong_interval secondes, le nœud devient incapable d'héberger le groupe de ressources suite à un autre appel de la fonction scha_control() depuis un autre nœud.

Catégorie :

Optionnelle

Valeur par défaut :

3600 (une heure)

Réglable :

Oui

Resource_list (tableau de chaînes)

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

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Non

RG_affinities (chaîne)

Le RGM tente de localiser le groupe de ressources sur un nœud qui est actuellement le maître d'un autre groupe de ressources donné (affinité positive) ou sur un nœud 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écrite dans la section “Administering Data Service Resources ” (Administration des ressources de service de données) du manuel Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Catégorie :

Optionnelle

Valeur par défaut :

Chaîne vide

Réglable :

Oui

RG_dependencies (tableau de chaîne)

Liste facultative de groupes de ressources, indiquant l'ordre dans lequel vous préférez connecter ou déconnecter les autres groupes sur le même nœud. Le graphique comportant toutes les valeurs fortes (positives et négatives) de RG_affinities et les valeurs de RG_dependencies ne doit pas contenir de cycles.

Supposons, par exemple, que le groupe de ressources RG2 est répertorié dans la liste RG_dependencies du groupe de ressources RG1 (en d'autres termes, le groupe RG1 a une dépendance de groupe de ressources avec RG2). La liste ci-après récapitule 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 les groupes RG1 et RG2 se voient tous les deux attribuer l'état Pending_online simultanément et sur le même nœud, les méthodes de démarrage (Prenet_start ou Start) ne sont exécutées sur aucune des ressources du groupe RG1 tant que toutes les méthodes de démarrage des ressources du groupe RG2 ne sont pas terminées.

  • Si les groupes RG1 et RG2 se voient tous les deux attribuer l'état Pending_offline sur le même nœud et simultanément, les méthodes d'arrêt (Stop ou Postnet_stop) ne sont exécutées sur aucune des ressources du groupe RG2 tant que toutes les méthodes d'arrêt des ressources du groupe RG1 ne sont pas terminées.

  • 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. Les rubriques scswitch(1M) et scsetup(1M) contiennent des informations supplémentaires.

  • Vous ne pouvez pas paramétrer la propriété Desired_primaries sur une valeur supérieure à zéro pour RG1, si cette même propriété est paramétrée sur zéro pour le groupe RG2.

  • 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 :

Optionnelle

Valeur par défaut :

Liste vide

Réglable :

Oui

RG_description (chaîne)

Brève description du groupe de ressources.

Catégorie :

Optionnelle

Valeur par défaut :

Chaîne vide

Réglable :

Oui

RG_is_frozen (booléen)

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 paramétrée sur TRUE, le périphérique global est en cours de basculement. 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 :

Optionnelle

Valeur par défaut :

Aucune

Réglable :

Non

RG_mode (énum.)

Cette propriété indique si le groupe de ressources est un groupe évolutif ou de basculement. Si elle est paramétrée sur Failover, le RGM paramètre la propriété Maximum_primaries du groupe sur 1 et limite le groupe à l'utilisation d'un seul nœud maître.

Si elle est paramétrée sur Scalable, le RGM autorise la définition d'une valeur supérieure à 1 pour la propriété Maximum_primaries. Par conséquent, le groupe peut disposer de plusieurs nœuds maîtres simultanément. Le RGM n'autorise pas l'ajout d'une ressource dont la propriété Failover est paramétrée sur TRUE dans un groupe de ressources dont la propriété RG_mode est paramétrée sur Scalable.

Si la propriété Maximum_primaries est paramétrée 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 :

Optionnelle

Valeur par défaut :

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

Réglable :

Non

RG_name (chaîne)

Nom du groupe de ressources. Ce nom doit être unique au sein du cluster.

Catégorie :

Requise

Valeur par défaut :

Aucune

Réglable :

Non

RG_project_name (chaîne)

Nom du projet Solaris associé au groupe de ressources. Cette propriété permet d'appliquer aux services de données du cluster, les fonctions de gestion de ressources de Solaris, telles que le partage d'unité centrale ou les pools de ressources. Lorsque le RGM connecte des groupes de ressources, il lance des processus connexes sous ce nom de projet pour les ressources dont la propriété Resource_project_name n'a pas été définie. Le nom de projet spécifié doit se trouver dans la base de données des projets et le superutilisateur root doit être configuré comme membre du projet nommé.

Cette propriété est prise en charge uniquement avec les versions 9 et supérieures de Solaris.

Remarque –

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

Catégorie :

Optionnelle

Valeur par défaut :

La chaîne de texte “default”

Réglable :

ANYTIME

RG_state sur chacun des nœuds du cluster (énum.)

Propriété paramétrée par le RGM sur Unmanaged , Online, Offline, Pending_online, Pending_offline, Pending_online_blocked , Error_stop_failed, Online_faulted ou Pending_online_blocked afin de décrire l'état du groupe sur chacun des nœuds du cluster.

Vous ne pouvez pas configurer cette propriété. En revanche, vous pouvez la définir indirectement par le biais de la commande scswitch( 1M) ou des commandes scsetup (1M) ou SunPlex Manager équivalentes.

Catégorie :

Interrogation uniquement

Valeur par défaut :

Aucune

Réglable :

Non

RG_system (booléen)

Si la propriété RG_system d'un groupe de ressources est paramétrée sur TRUE, alors l'accès à certaines opérations particulières sur le groupe et les ressources qu'il contient est limité. Cette restriction est destinée à éviter les modifications ou suppressions accidentelles de groupes ou ressources importantes. Seules les commandes scrgadm (1M) et scswitch(1M) sont affectées par cette propriété. Les opérations avec les commandes 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.

Un groupe de ressources dont la propriété RG_system est paramétrée sur TRUE est appelé groupe de ressources système. Quelle que soit la valeur de cette propriété, il est toujours possible de la modifier. Les restrictions sont expliquées plus en détail dans la page man rg_properties (5).

Catégorie :

Optionnelle

Valeur par défaut :

FALSE

Réglable :

Oui

Attributs des propriétés de ressources

Les informations ci-dessous présentent les attributs de propriété de ressource qui peuvent être utilisés pour modifier les propriétés définies par le système ou pour créer des propriétés d'extension.

Attention – Attention –

Vous ne pouvez pas définir la valeur Null, ou une chaîne de caractères vide (“”) comme valeur par défaut pour les types booléen, énum ou entier.

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

Array_maxsize

Pour le type stringarray, nombre maximum d'éléments de tableau permis.

Array_minsize

Pour le type stringarray, nombre minimum d'éléments de tableau permis.

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

Pour un type int, valeur maximale permise pour la propriété.

Maxlength

Pour les propriétés de type chaîne ou tableau de chaînes, longueur maximum permise.

Min

Valeur minimale autorisée pour une propriété de type entier.

Minlength

Longueur minimale autorisée pour les propriétés de type chaîne ou tableau de chaînes.

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. Peut être paramétré sur NONE ou sur FALSE pour empêcher l'administrateur de définir la propriété. Les valeurs peuvent effectuer des réglages lorsque l'attribut est paramétré sur TRUE, ANYTIME (à tout moment), AT_CREATION (uniquement lors de la création de la ressource) ou WHEN_DISABLED (lorsque la ressource est désactivée). Pour définir d'autres conditions de réglage, par exemple “lorsque le contrôle est désactivé” ou “hors connexion”, paramétrez cet attribut sur ANYTIME et validez l'état de la ressource dans la méthode Validate.

La valeur par défaut diffère pour chacune des propriétés de ressource standard, comme indiqué dans la section suivante. Si elle n'est pas définie dans le fichier RTR, la valeur par défaut de l'attribut de réglage de la propriété d'extension est TRUE (ANYTIME).

Type de la propriété

Types permis : string, boolean, int, 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.