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

• Requise : une valeur explicite de la propriété doit être indiquée dans le fichier RTR (Resource Type Registration). À défaut, l'objet auquel appartient la propriété ne peut pas être créé. Une chaîne de caractères blanche ou vide est proscrite.

• Conditionnelle : la propriété doit obligatoirement être déclarée dans le fichier RTR. À défaut, le RGM ne la crée pas et elle n'est pas accessible aux utilitaires d'administration. Une chaîne de caractères blanche ou vide est autorisée. Si la propriété est déclarée dans le fichier RTR mais qu'aucune valeur n'est spécifiée, le RGM lui attribue une valeur par défaut.

• Conditionnelle/Explicite : pour exister, la propriété doit obligatoirement être déclarée dans le fichier RTR avec une valeur explicite. À défaut, le RGM ne la crée pas et elle n'est pas accessible aux utilitaires d'administration. Une chaîne de caractères blanche ou vide est proscrite.

• Optionnelle : la propriété peut être déclarée dans le fichier RTR. Si elle n'est pas déclarée, le RGM la crée et fournit une valeur par défaut. Si elle est déclarée dans le fichier RTR sans qu'une valeur soit spécifiée, le RGM lui attribue la valeur par défaut qu'il lui aurait donnée si elle n'avait pas été déclarée.

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