Migration des ressources existantes vers une nouvelle version de type de ressource.

Langue :

Les instructions suivantes expliquent comment utiliser la commande clresource pour effectuer cette tâche. Toutefois, vous n'êtes pas limité à la commande clresource pour effectuer cette tâche. Au lieu de la commande clresource, vous pouvez utiliser Oracle Solaris Cluster ou l'option de groupe de ressources de la commande clsetup pour effectuer cette tâche. Reportez-vous à clsetup(1CL) pour plus d'informations.

Avant de commencer

Consultez les instructions relatives à la mise à niveau du type de ressource pour déterminer à quel moment migrer des ressources vers une nouvelle version du type de ressource.

A tout moment
Uniquement lorsque la ressource n'est pas surveillée
Uniquement lorsque la ressource est hors ligne
Uniquement lorsque la ressource est désactivée
Uniquement lorsque le groupe de ressources n'est pas géré

Les instructions peuvent indiquer que vous ne pouvez pas mettre à niveau votre version existante de la ressource. Si vous ne pouvez pas migrer la ressource, envisagez d'utiliser les alternatives suivantes :

Supprimer la ressource et la remplacer par une nouvelle ressource de la version mise à niveau
Conserver l'ancienne version du type de ressource

Sur un noeud du cluster, prenez le rôle root octroyant une autorisation RBAC de type solaris.cluster.modify.

Pour chaque ressource dont le type doit être migré, modifiez l'état de la ressource ou de son groupe de ressources sur l'état approprié.
- Si vous pouvez migrer la ressource à tout moment, aucune action n'est requise.
- Si vous pouvez uniquement migrer la ressource lorsque la ressource n'est pas surveillée, tapez la commande suivante :
```
# clresource unmonitor resource
```
- Si vous pouvez uniquement migrer la ressource lorsque la ressource est hors ligne, tapez la commande suivante :
```
# clresource disable resource
```
  Remarque - Si d'autres ressources dépendent de la ressource que vous migrez, cette étape échoue. Dans ce cas, consultez le message d'erreur imprimé pour connaître les noms des ressources dépendantes. Ensuite, répétez cette étape en indiquant une liste délimitée par des virgules contenant la ressource que vous migrez et toutes les ressources qui en dépendent.
- Si vous pouvez uniquement migrer la ressource lorsque la ressource est désactivée, tapez la commande suivante :
```
# clresource disable resource
```
  Remarque - Si d'autres ressources dépendent de la ressource que vous migrez, cette étape échoue. Dans ce cas, consultez le message d'erreur imprimé pour connaître les noms des ressources dépendantes. Ensuite, répétez cette étape en indiquant une liste délimitée par des virgules contenant la ressource que vous migrez et toutes les ressources qui en dépendent.
- Si vous pouvez uniquement migrer la ressource lorsque le groupe de ressources est en mode sans gestion, tapez les commandes suivantes :
```
# clresource disable -g resource-group +
# clresourcegroup offline resource-group
# clresourcegroup unmanage resource-group
```
  Signification des éléments remplaçables dans ces commandes :
  
  resource-group
  
  Spécifie le groupe de ressources qui doit être en mode sans gestion.

Pour chaque ressource du type de ressource à migrer, migrez la propriété Type_version vers la nouvelle version.
Si nécessaire, définissez d'autres propriétés de la même ressource sur des valeurs appropriées à l'aide de la même commande. Pour définir ces propriétés, spécifiez l'option –p de la commande.

Pour déterminer si vous devez définir d'autres propriétés, consultez les instructions relatives à la mise à niveau du type de ressource. Vous devrez peut-être définir d'autres propriétés pour les raisons suivantes :
- Une propriété d'extension a été introduite dans la nouvelle version du type de ressource.
- La valeur par défaut d'une propriété existante a été modifiée dans la nouvelle version du type de ressource.
```
# clresource set -p Type_version=new-version \
[-p extension-property=new-value] [-p standard-property=new-value] resource
```
Remarque - Si la version existante du type de ressource ne prend pas en charge les mises à niveau vers la nouvelle version, cette étape échoue.

Restaurez l'état précédent de la ressource ou du groupe de ressources en échangeant la commande que vous avez saisie à l'Step 2.
- Si vous pouvez migrer la ressource à tout moment, aucune action n'est requise.
  Remarque - Après la migration d'une ressource pouvant être migrée à tout moment, le test de la ressource risque de ne pas afficher la version correcte du type de ressource. Le cas échéant, désactivez puis réactivez le détecteur de pannes de la ressource pour vous assurer que le test de la ressource répertorie la version correcte du type de ressource.
- Si vous pouvez uniquement migrer la ressource lorsque la ressource n'est pas surveillée, tapez la commande suivante :
```
# clresource monitor resource
```
- Si vous pouvez uniquement migrer la ressource lorsque la ressource est hors ligne, tapez la commande suivante :
```
# clresource enable resource
```
  Remarque - Si vous avez désactivé d'autres ressources dépendantes de la ressource que vous migrez à l'Step 2, vous devez également activer les ressources dépendantes.
- Si vous pouvez uniquement migrer la ressource lorsque la ressource est désactivée, tapez la commande suivante :
```
# clresource enable resource
```
  Remarque - Si vous avez désactivé d'autres ressources dépendantes de la ressource que vous migrez à l'Step 2, vous devez également activer les ressources dépendantes.
- Si vous pouvez uniquement migrer la ressource lorsque le groupe de ressources est en mode sans gestion, tapez les commandes suivantes :
```
# clresource enable -g resource-group +
# clresourcegroup manage resource-group
# clresourcegroup online resource-group
```

Exemple 2-2 Migration d'une ressource à migrer uniquement hors ligne

Cet exemple montre la migration d'une ressource à migrer uniquement lorsque la ressource est hors ligne. Le package du nouveau type de ressource contient des méthodes situées dans les nouveaux emplacements. Etant donné que les méthodes ne sont pas écrasées durant l'installation, il n'est pas nécessaire de désactiver la ressource avant que le type de ressource mis à niveau n'ait été installé.

Les caractéristiques de la ressource de cet exemple sont les suivantes :

La nouvelle version du type de ressource est 2.0.
Le nom de la ressource est myresource.
Le nom du type de ressource est myrt.
Le nouveau fichier RTR se trouve dans /opt/XYZmyrt/etc/XYZ.myrt.
Aucune dépendance n'existe dans la ressource à migrer.
Vous pouvez mettre la ressource à migrer hors ligne tout en laissant le groupe de ressources contenant en ligne.

Cet exemple part du principe que le package de mise à niveau est déjà installé sur tous les noeuds du cluster conformément aux indications du fournisseur.

# clresourcetype register -f /opt/XYZmyrt/etc/XYZ.myrt myrt
# clresource disable myresource
# clresource set -p Type_version=2.0 myresource
# clresource enable myresource

Exemple 2-3 Migration d'une ressource à migrer uniquement lorsque la ressource est non surveillée

Cet exemple montre la migration d'une ressource à migrer uniquement lorsque la ressource est non surveillée. Le package du nouveau type de ressource contient uniquement le contrôleur et le fichier RTR. Etant donné que le contrôleur est remplacé durant l'installation, la surveillance de la ressource doit être désactivée avant l'installation du package de mise à niveau.

Les caractéristiques de la ressource de cet exemple sont les suivantes :

La nouvelle version du type de ressource est 2.0.
Le nom de la ressource est myresource.
Le nom du type de ressource est myrt.
Le nouveau fichier RTR se trouve dans /opt/XYZmyrt/etc/XYZ.myrt.

Les opérations suivantes sont exécutées dans cet exemple.

La commande suivante est exécutée pour désactiver la surveillance de la ressource avant l'installation du package de mise à niveau :
```
# clresource unmonitor myresource
```
Le package de mise à niveau est installé sur tous les noeuds du cluster conformément aux instructions du fournisseur.
Pour enregistrer la nouvelle version du type de ressource, exécutez la commande suivante :
```
# clresourcetype register -f /opt/XYZmyrt/etc/XYZ.myrt myrt
```
Pour remplacer la propriété Type_version par la nouvelle version, exécutez la commande suivante :
```
# clresource set -p Type_version=2.0 myresource
```
Pour activer la surveillance de la ressource après sa migration, exécutez la commande suivante :
```
# clresource monitor myresource
```