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

Fichier RTR (Resource Type Registration)

Nom du type de ressources

Les trois composantes du nom du type de ressources sont des propriétés spécifiées dans le fichier RTR sous id_fournisseur, type_ressources et version_type_res. La commande scrgadm insère les délimiteurs (points et deux points) pour créer le nom du type de ressources :


vendor_id.resource_type:rt_version

Le préfixe id_fournisseur permet de distinguer deux fichiers de connexion portant le même nom mais provenant de deux fournisseurs différents. La version_type_res permet de distinguer plusieurs versions enregistrées (mises à niveau) du même type de ressources de base. 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.

La mise en ligne d'une ressource échoue si la chaîne version_type_res comprend un espace vide, une tabulation, une barre oblique (/) ou (\), un astérisque (*), un point d'interrogation (?), une virgule (,), un point virgule (;), un crochet gauche ([) ou un crochet droit (]).

La propriété Version_TR, qui était facultative dans Sun Cluster 3.0, est désormais obligatoire sous Sun Cluster 3.1.

Le nom qualifié est le nom que renvoie la commande suivante :


scha_resource_get -O Type -R nom_ressource -G nom_groupe_ressources

Les noms de type de ressources enregistrés sous les versions antérieures à Sun Cluster 3.1 se présentent toujours sous la forme suivante :


type_ressource.id_fournisseur

Instructions

Les fichiers RTR des types de ressources supportant les mises à niveau doivent inclure une instruction #$upgrade, suivie de zéro ou plusieurs instructions comme suit :


#$upgrade_from version capacité_réglage

L'instruction upgrade_from comprend la chaîne #$upgrade_from, suivie de Version_RT, de la contrainte de capacité de réglage de la ressource. Si le type de ressources en cours de mise à jour ne possède pas de version, la propriété Version_RT est définie en tant que chaîne de caractères vide, comme illustré dans l'exemple ci-après :


#$upgrade_from   "1.1"   Losque_hors_ligne
#$upgrade_from   "1.2"   Losque_hors_ligne
#$upgrade_from   "1.3"   Losque_hors_ligne
#$upgrade_from   "2.0"   Lorsque_non_contrôlée
#$upgrade_from   "2.1"   À_tout_moment
#$upgrade_from   ""      Lorsque_non_gérée

Le gestionnaire RGM exécute ces contraintes sur une ressource lorsque l'administrateur système tente de modifier la ressource Version_type. Si la version actuelle du type de ressources n'apparaît pas dans la liste, le gestionnaire RGM impose la capacité de réglage de l'instruction Lorsque_non_gérée.

Ces instructions doivent apparaître entre la rubrique relative aux déclarations de propriétés de type de ressources et la rubrique relative aux déclarations de ressources du fichier RTR. Reportez-vous à rt_reg( 4).

Modification de la chaîne Version_RT dans un fichier RTR

Modifiez la chaîne Version_RT dans un fichier RTR chaque fois que le contenu de ce fichier change. La valeur de cette propriété doit permettre de reconnaître la nouvelle version du type de ressources de la précédente. Il n'est pas nécessaire de modifier la chaîne Version_RT si le fichier RTR n'a pas été modifié.

Noms des types de ressources dans les versions précédentes de Sun Cluster

Les noms de type de ressources dans Sun Cluster 3.0 ne contenaient pas le suffixe de version :


nom_ressource.id_fournisseur

Le format du nom d'un type de ressources initialement enregistré sous Sun Cluster 3.0 est conservé même après la mise à niveau du logiciel vers Sun Cluster 3.1. De la même façon, un nom de format Sun Cluster 3.0 sans version de suffixe est attribué à un type de ressources dont le fichier RTR ne contient pas d'instruction #$upgrade, si ce fichier est enregistré sur un cluster fonctionnant sous Sun Cluster 3.1.

Vous pouvez enregistrer des fichiers RTR avec l'instruction #$upgrade ou #$upgrade_from dans Sun Cluster 3.0. Par contre, la migration des ressources existantes vers les nouveaux types de ressources dans Sun Cluster 3.0 n'est pas prise en charge.