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

Exemples de mise à niveau d'un type de ressources

Ces exemples présentent plusieurs scénarios de mise à niveau et d'installation d'un type de ressources. Les informations relatives au package et à la capacité de réglage ont été choisies en fonction des types de modifications apportés à la mise en œuvre du type de ressources. La capacité de réglage s’applique à la migration de la ressource vers le nouveau type de ressources.

Tous les exemples supposent que :

Le type de ressources est fourni dans un package Solaris. Reportez-vous à pkgadd(1M) et pkgrm(1M).
Il existe une seule version antérieure du type de ressources et, par conséquent, une seule instruction #$upgrade_from dans le nouveau fichier RTR.
La procédure d'installation ne peut pas supprimer ou écraser les méthodes dans la mesure où le RGM peut les exécuter alors qu'elles ont été effacées du disque.
Les nouvelles méthodes sont compatibles avec les méthodes antérieures à moins que l'inverse soit spécifié.
Les ressources et les groupes de ressources sont basculés dans l'état requis avant l'installation ou la migration à l'aide de la commande scswitch(1M) appropriée ou d'une commande équivalente. Exemples de basculement du groupe de ressources en mode non géré :
scswitch -M -n -j ressource scswitch -n -j ressource scswitch -F -g groupe_ressources scswitch -u -g groupe_ressources
Vous pouvez enregistrer un type de ressources à l'aide de la commande suivante :
scrgadm -a -t type_ressource -f transfert_vers_fichier_RTR

Vous pouvez migrer un type de ressources à l'aide de la commande suivante :

scrgadm -c -j ressource -y Type_version=version \
           -y propriété=valeur \
           -x propriété=valeur ...

L'état précédent des ressources et des groupes de ressources est restauré après la migration à l'aide de la commande scswitch (1M) ou d'une commande équivalente :
scswitch -M -e -j ressource scswitch -e -j ressource scswitch -o -g groupe_ressources scswitch -Z -g groupe_ressources

Le développeur du type de ressources peut devoir spécifier des valeurs de capacité de réglage plus restrictives que celles utilisées dans ces exemples. Les valeurs de réglage dépendent des modifications précises qui ont été apportées à la mise en œuvre du type de ressources. En outre, le développeur peut choisir d'utiliser un package différent du package Solaris employé dans ces exemples.

Tableau 3–1 Exemples de mise à niveau d'un type de ressources


Type de modification	Capacité de réglage	Configurations	Procédure
Les propriétés sont uniquement modifiées dans le fichier RTR.	`ANYTIME`	Fournit uniquement un nouveau fichier RTR.	Exécutez la commande `pkgadd` du nouveau fichier RTR sur tous les nœuds. Enregistrez le nouveau type de ressources. Migrez la ressource.
Les méthodes sont mises à jour.	`ANYTIME`	Le chemin d'accès aux méthodes mises à jour doit différer du chemin d'accès aux méthodes antérieures.	Exécutez la commande `pkgadd` des méthodes mises à jour sur tous les nœuds. Enregistrez le nouveau type de ressources. Migrez la ressource.
Nouveau programme détecteur.	`WHEN_UNMONITORED`	Écrasez uniquement la méthode précédente du détecteur.	Désactivez la surveillance. Exécutez la commande `pkgadd` du nouveau programme détecteur sur tous les nœuds. Enregistrez le nouveau type de ressources. Migrez la ressource. Activez la surveillance.
Les méthodes sont mises à jour. Les nouvelles méthodes `Update`/`Stop` sont incompatibles avec les méthodes de `Start` antérieures.	`WHEN_OFFLINE`	Le chemin d'accès aux méthodes mises à jour doit différer du chemin d'accès aux méthodes antérieures.	Exécutez la commande `pkgadd` des méthodes mises à jour sur tous les nœuds. Enregistrez le nouveau type de ressources. Déconnectez la ressource. Migrez la ressource. Connectez la ressource.
Les méthodes sont mises à jour et les nouvelles propriétés sont ajoutées aux fichiers RTR. Les nouvelles méthodes requièrent de nouvelles propriétés. (L'objectif est de permettre au groupe de ressources correspondant de rester en ligne tout en évitant de connecter la ressource, même si le groupe de ressources déconnecté est mis en ligne sur un nœud).	`WHEN_DISABLED`	Écrasez les versions précédentes des méthodes.	Désactivez la ressource. Au niveau de chaque nœud : Retirez le nœud du cluster. Exécutez la commande `pkgrm`/`pkgadd` des méthodes en cours de mise jour Restaurez le nœud sur le cluster. Enregistrez le nouveau type de ressources. Migrez la ressource. Activez la ressource.
Les méthodes sont mises à jour et les nouvelles propriétés sont ajoutées aux fichiers RTR. Les nouvelles méthodes ne requièrent pas de nouvelles propriétés.	`ANYTIME`	Écrasez les versions précédentes des méthodes.	Au niveau de chaque nœud : Retirez le nœud du cluster. Exécutez la commande `pkgrm`/`pkgadd` des méthodes en cours de mise à jour Restaurez le nœud sur le cluster. Lors de cette procédure, le RGM exécute les nouvelles méthodes même si la migration (qui doit configurer les nouvelles propriétés) n'a pas encore été réalisée. Il est important que les nouvelles méthodes soient fonctionnelles sans les nouvelles propriétés. Enregistrez le nouveau type de ressources. Migrez la ressource.
Les méthodes sont mises à jour. La nouvelle méthode `Fini` est incompatible avec la méthode `Init` antérieure.	`WHEN_UNMANAGED`	Le chemin d'accès aux méthodes mises à jour doit différer du chemin d'accès aux méthodes antérieures.	Basculez le groupe de ressources correspondant en mode non géré. Exécutez la commande `pkgadd` des méthodes mises à jour sur tous les nœuds. Enregistrez le type de ressources. Migrez la ressource. Basculez le groupe de ressources correspondant en mode géré.
Les méthodes sont mises à jour. Le fichier RTR n'est pas modifié.	Sans objet. Le fichier RTR n'est pas modifié.	Écrasez les versions précédentes des méthodes.	Au niveau de chaque nœud : Retirez le nœud du cluster. Exécutez la commande `pkgadd` des méthodes mises à jour Restaurez le nœud sur le cluster. Comme le fichier RTR n'est pas modifié, il n'est pas nécessaire d'enregistrer ou de migrer la ressource.