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

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