Guide des développeurs pour les services de données Sun Cluster 3.1 10/03

Déclaration des propriétés de type de ressources

L'administrateur du cluster ne peut pas configurer les propriétés de type de ressources que vous déclarez dans le fichier RTR. Ces propriétés font partie intégrante de la configuration permanente du type de ressources.


Remarque :

seule une propriété de type de ressources, Noeuds_installés est configurable par l'administrateur système. En fait, elle ne peut être configurée que par un administrateur système. Vous ne pouvez pas la déclarer dans le fichier RTR.


Syntaxe de déclaration des types de ressources :


nom_propriété = valeur;

Remarque :

le gestionnaire RGM est insensible à la casse dans les noms de propriété. Les fichiers RTR fournis par Sun sont basés sur la convention suivante : la première lettre du nom est en majuscules tandis que toutes les autres sont en minuscules. Cette convention s'applique aux noms de propriété mais pas aux noms de méthode. Les noms de méthodes et les attributs de propriété sont en majuscules.


Voici les déclarations de type de ressources contenues dans le fichier RTR d'un service de données (smpl) échantillon :

# Sun Cluster Data Services Builder template version 1.0
# Enregistrement de données et de ressources pour smpl
#
#REMARQUE : les mots clés sont insensibles à la casse. Cela signifie
que vous pouvez utiliser les minuscules
#ou les majuscules au choix.
#
Type_ressource = "smpl";
id_fournisseur = SUNW;
Description_TR = "Sample Service on Sun Cluster";

Version_RT ="1.0";
Version_API = 2;
Basculement = VRAI;

noeuds_init = Éléments_principaux_GR;

rép_base_TR=/opt/SUNWsmpl/bin;

Démarrage           =    smpl_svc_start;
Arrêt                        =    smpl_svc_stop;

Validation        =    smpl_validate;
Mise_à_jour    =    smpl_update;

Démarrage_détecteur   =    smpl_monitor_start;
Arrêt_détecteur    =    smpl_monitor_stop;
Contrôle_détecteur   =    smpl_monitor_check;

Astuce :

la propriété Type_ressource doit être déclarée en tant que première entrée dans le fichier RTR. Dans le cas contraire, l'enregistrement du type de ressources échoue.


Le premier ensemble de déclarations de type de ressources fournit des informations élémentaires sur le type de ressources :

Type_ressource et id_fournisseur

Indique le nom du type de ressources. Vous pouvez spécifier le nom du type de ressources de deux façons : au moyen de la propriété Type_ressource (smpl) uniquement ou en utilisant le préfixe id_fournisseur suivi d'un point (“.”) comme séparateur et du nom du type de ressources ( SUNW.smpl), comme dans notre exemple. Si vous utilisez id_fournisseur, définissez le type de ressources à l'aide du symbole boursier de l'entreprise. Le nom du type de ressources doit être unique sur le cluster.


Remarque :

les noms de types de ressources (Type_ressourcesId_fournisseur) sont traditionnellement utilisés comme nom de package. Les noms de package ne peuvent pas contenir plus de 9 caractères. C'est pourquoi il est préférable de limiter le nombre total de caractères à 9 maximum lorsque vous attribuez un nom à ces deux propriétés bien que le gestionnaire RGM n'impose pas cette restriction. Par contre, comme Agent Builder génère explicitement le nom du package à partir du nom du type de ressources, il impose cette restriction.


Version_RT

Identifie la version du service de données échantillon.

Version_API

Identifie la version de l'interface API. Par exemple, Version_API = 2 signifie que le service de données fonctionne sous Sun Cluster, version 3.0.

Basculement = VRAI

Indique qu'il est impossible d'exécuter le service de données dans un groupe de ressources pouvant être en ligne simultanément sur plusieurs noeuds car il s'agit d'un service de données de basculement. Reportez-vous à la rubrique Transfert d'un service de données sur un cluster pour de plus amples informations.

Démarrage, Arrêt, Validation, etc.

Indiquent les chemins d'accès aux programmes de méthode de rappel correspondants que le gestionnaire RGM appelle. Ces chemins d'accès dépendent du répertoire spécifié par rép_base_TR.

Les autres déclarations de type de ressources fournissent des informations sur la configuration :

noeuds_init = Éléments_principaux_GR

Indique que le gestionnaire RGM n'appelle les méthodes Init, Initialisation, Fini et Validation que sur les noeuds pouvant gérer le service de données. Les noeuds spécifiés par Éléments_principaux_GR constituent un sous-ensemble de tous les noeuds sur lesquels le service de données est installé. Définissez la valeur sur noeuds_installés_TR pour indiquer que le gestionnaire RGM appelle ces méthodes sur tous les noeuds sur lesquels le service de données est installé.

rép_base_TR

Sélectionnez le chemin d'accès au répertoire /opt/SUNWsample/bin pour compléter les chemins relatifs, comme les chemins d'accès aux méthodes de rappel.

Démarrage, Arrêt, Validation, etc.

Indiquent les chemins d'accès aux programmes de méthode de rappel correspondants que le gestionnaire RGM appelle. Ces chemins d'accès dépendent du répertoire spécifié par rép_base_TR.