Définition des directives #$upgrade et #$upgrade_from

Pour garantir que le type de ressources modifié sera prêt pour la mise à niveau, incluez la directive #$upgrade dans son fichier RTR. Ajoutez ensuite éventuellement une ou plusieurs directives #$upgrade_from pour chacune des versions antérieures à prendre en charge.

Dans le fichier RTR, les directives #$upgrade et #$upgrade_from doivent être placées entre les déclarations des propriétés du type de ressources et les déclarations de ressources. Pour plus d'informations, reportez-vous à la page de manuel rt_reg(4).

Exemple 4–1 Directive #$upgrade_from dans un fichier RTR

#$upgrade_from   "1.1"   WHEN_OFFLINE
#$upgrade_from   "1.2"   WHEN_OFFLINE
#$upgrade_from   "1.3"   WHEN_OFFLINE
#$upgrade_from   "2.0"   WHEN_UNMONITORED
#$upgrade_from   "2.1"   ANYTIME
#$upgrade_from   ""      WHEN_UNMANAGED

La directive #$upgrade_from a le format suivant :

#$upgrade_from version tunability

version

RT_version. Si le type de ressources n'a pas de version ou que sa version est différente de celle que vous avez définie dans le fichier RTR, saisissez une chaîne vide (“”).

tunability

Cet argument définit les conditions selon lesquelles l'administrateur du cluster est autorisé à mettre à niveau la version RT_version indiquée.

Dans les directives #$upgrade_from, les valeurs de capacité de réglage sont les suivantes :

ANYTIME

Utilisez cette option lorsqu'il n'existe aucune restriction ou que l'administrateur peut mettre la ressource à niveau. La ressource peut rester connectée pendant la mise à niveau.

WHEN_UNMONITORED

Utilisez cette option lorsque les méthodes de la version du nouveau type de ressources remplissent les conditions suivantes :

• Les méthodes Update, Stop, Monitor_check et Postnet_stop sont compatibles avec les méthodes de démarrage de l'ancienne version du type de ressources (Prenet_stop et Start).

• La méthode Fini est compatible avec les méthodes Init des anciennes versions.

L'administrateur du cluster doit seulement arrêter le détecteur de la ressource avant de procéder à la mise à niveau.

WHEN_OFFLINE

Utilisez cette option lorsque la méthode Update, Stop, Monitor_check ou Postnet_stop du nouveau type de ressources est :

• compatible avec la méthode Init d'une version antérieure,

• incompatible avec les méthodes de démarrage (Prenet_stop et Start) d'une version antérieure du type de ressources.

L'administrateur du cluster doit déconnecter la ressource avant de procéder à la mise à niveau.

WHEN_DISABLED

Cette option est similaire à WHEN_OFFLINE. Cependant, l'administrateur du cluster doit désactiver la ressource avant d'effectuer la mise à niveau.

WHEN_UNMANAGED

Utilisez cette option si la méthode Fini de la nouvelle version du type de ressources est incompatible avec la méthode Init d'une version antérieure. L'administrateur du cluster doit mettre le groupe de ressources existant à l'état non géré avant de procéder à la mise à niveau.

Si une version du type de ressources n'apparaît pas dans la liste des directives #$upgrade_from, le RGM lui impose l'option de capacité de réglage WHEN_UNMANAGED, par défaut.

AT_CREATION

Cette option empêche la mise à niveau des ressources vers la nouvelle version du type de ressources. Si elle est utilisée, l'administrateur du cluster doit supprimer et recréer la ressource.