Procédure de mise à niveau d'un cluster de cache AppFabric (AppFabric 1.1)

Cette rubrique décrit l'exécution d'une mise à niveau en ligne et hors ligne du service de Mise en cache de Microsoft AppFabric 1.1 pour Windows Server vers une version supérieure pour un cluster de cache existant. Une mise à niveau en ligne implique de mettre à niveau les hôtes de cache séparément tandis que le cluster de cache continue de s'exécuter.

Chaque version d'Microsoft AppFabric 1.1 pour Windows Server est associée à un numéro de version particulier du service de Mise en cache d'AppFabric.

Processus de mise à niveau hors ligne

Une mise à niveau hors ligne implique un cluster de cache arrêté. Pendant qu'il est arrêté, chaque hôte de cache peut être mis à niveau séparément vers la nouvelle version d'AppFabric. À ce stade, les étapes impliquées correspondent à un sous-ensemble des étapes du processus de mise à niveau en ligne :

1. Étape 1 : mise à niveau de la fonctionnalité d'administration du cache sur l'ordinateur administratif

2. Étape 5 : mise à jour de la plage de versions de serveur autorisées afin de n'utiliser que le nouveau numéro de version

3. Étape 6 : mise à jour de la plage de versions de client autorisées afin d'inclure le nouveau numéro de version

4. Étape 7 : mise à jour du magasin de configuration du cache

5. Étape 8 : mise à jour des applications du client de cache

Processus de mise à niveau en ligne

La mise à niveau en ligne inclut les étapes suivantes :

• Étape 1 : mise à niveau de la fonctionnalité d'administration du cache sur l'ordinateur administratif

• Étape 2 : mise à jour de la plage de versions de serveur autorisées afin d'inclure le nouveau numéro de version

• Étape 3 : mise à niveau séquentielle des hôtes de cache

• Étape 4 : vérification de la mise à niveau effective des hôtes de cache

• Étape 5 : mise à jour de la plage de versions de serveur autorisées afin de n'utiliser que le nouveau numéro de version

• Étape 6 : mise à jour de la plage de versions de client autorisées afin d'inclure le nouveau numéro de version

• Étape 7 : mise à jour du magasin de configuration du cache

• Étape 8 : mise à jour des applications du client de cache

Étape 1 : mise à niveau de la fonctionnalité d'administration du cache sur l'ordinateur administratif

Pour procéder à la mise à niveau, vous devez commencer par mettre à jour la fonctionnalité d'administration du cache sur un ordinateur n'appartenant pas au cluster de cache cible. Cette fonctionnalité permet d'exécuter des commandes Windows PowerShell sur un cluster de cache. Pour ce faire, exécutez le programme d'installation d'AppFabric pour la nouvelle version de Microsoft AppFabric 1.1 pour Windows Server.

Si vous ne disposez pas d'un ordinateur distinct pour la gestion du cluster de cache, vous pouvez installer la fonctionnalité d'administration du cache de la nouvelle version d'Microsoft AppFabric 1.1 pour Windows Server sur un ordinateur n'appartenant pas au cluster de cache.

Pour exécuter les commandes Windows PowerShell sur un ordinateur administratif uniquement, vous devez commencer par exécuter la commande Use-CacheCluster et spécifier les paramètres Provider et ConnectionString. Cette opération est décrite dans la rubrique Tâches courantes de gestion d'un cluster de cache (mise en cache d'AppFabric 1.1).

Étape 2 : mise à jour de la plage de versions de serveur autorisées afin d'inclure le nouveau numéro de version

Au cours de la mise à niveau en ligne, certains serveurs exécutent l'ancienne version du service de mise en cache tandis que d'autres exécutent la version mise à niveau. Pour tenir compte de cette situation, vous devez utiliser la commande Windows PowerShell Update-CacheHostAllowedVersions afin d'augmenter la valeur de la propriété EndServerVersion. Par exemple, si vous passez de la version 1 à la version 3, vous devez utiliser la commande suivante.

Update-CacheHostAllowedVersions –EndServerVersion 3

Exécutez ensuite la commande Get-CacheHost sans paramètre afin de contrôler le changement de version. L'exemple de sortie suivant montre ce changement sur un cluster de cache à trois nœuds.

HostName : CachePort Service Name            Service Status Version Info
-------------------- ------------            -------------- ------------
CACHESERVER1:22233 AppFabricCachingService UP             1 [1,3][1,1]
CACHESERVER2:22233 AppFabricCachingService UP             1 [1,3][1,1]
CACHESERVER3:22233 AppFabricCachingService UP             1 [1,3][1,1]

Dans cet exemple, la colonne Version Info contient la valeur 1 [1,3][1,1]. Celle-ci correspond aux informations de version suivantes :

Avant de continuer, vous devez vérifier que les hôtes de cache ont été mis à jour vers la plage cible de serveurs autorisés. Si la mise à jour de la plage de versions de serveur d'un ou plusieurs hôtes de cache échoue, vous devez éteindre ceux-ci avant de continuer. Pour ce faire, utilisez la commande Windows PowerShell Stop-CacheNonUpdatedHosts. La commande Get-CacheHost peut être utilisée en premier pour identifier les serveurs non mis à jour qui doivent être arrêtés. L'exemple suivant arrête les hôtes de cache dont la plage de versions n'a pas été modifiée avec les valeurs 1 et 3, et dont la version de service est 1.

Stop-CacheNonUpdatedHosts -Version 1 -BeginServerVersion 1 –EndServerVersion 3

Étape 3 : mise à niveau séquentielle des hôtes de cache

Pour effectuer une mise à niveau en ligne, les hôtes de cache doivent être arrêtés et mis à niveau séparément. La procédure suivante décrit les opérations requises pour chaque hôte de cache dans le cluster de cache.

1. Sur l'ordinateur d'administration de la mise en cache, utilisez Windows PowerShell pour exécuter la commande Stop-CacheHost et arrêter l'hôte de cache.

   Avertissement

   Si la fonctionnalité de haute disponibilité n'est pas utilisée, l'arrêt d'un hôte de cache peut provoquer la perte des données mises en cache. Avec la fonctionnalité de haute disponibilité activée, les clients peuvent quand même recevoir des exceptions temporaires résolues lors de nouvelles tentatives si l'exécution du cluster n'est pas interrompue.

2. Sur l'hôte de cache arrêté, procédez à la mise à niveau d'Microsoft AppFabric 1.1 pour Windows Server vers la nouvelle version en exécutant le programme d'installation de la nouvelle version.

3. Une fois la mise à niveau terminée, utilisez la commande Start-CacheHost pour redémarrer l'hôte de cache.

4. Exécutez ensuite la commande Get-CacheClusterHealth. Vérifiez que tous les numéros figurent dans la catégorie « Healthy » et que les fractions de cache sont stabilisées entre les hôtes de cache. Vérifiez également que la colonne « Unallocated fraction » ou « Unallocated named cache fractions » ne comporte pas d'entrée. Pour ce faire, exécutez la commande Get-CacheClusterHealth à plusieurs reprises jusqu'à ce que les fractions de cache soient stabilisées.

5. Répétez ces étapes pour l'hôte de cache suivant dans le cluster de cache.

L'utilisation des commandes Windows PowerShell suivantes n'est pas prise en charge dans le cadre de cette partie du processus. Vous ne devez pas utiliser ces commandes tant que tous les hôtes de cache ne sont pas mis à jour vers la nouvelle version et que la plage de versions de serveur de début n'est pas mise à jour vers la nouvelle version.

Les commandes qui génèrent une erreur ont un texte semblable à ce qui suit : ErrorCode<ERRPS024>:SubStatus<ES0001>:This command is not currently allowed. Changes to the cache cluster configuration is restricted during a rolling upgrade of the caching service.

* La commande Update-CacheHostAllowedVersions ne génère pas d'erreur si tous les hôtes de cache dans le cluster exécutent la même version du service de Mise en cache d'AppFabric.

Étape 4 : vérification de la mise à niveau effective des hôtes de cache

Une fois les hôtes de cache mis à niveau, utilisez la commande Get-CacheHost pour afficher la version du service de mise en cache sur chaque hôte de cache. Elles doivent toutes correspondre à la nouvelle version pour pouvoir continuer. Prenons l'exemple suivant de sortie de la commande Get-CacheHost :

HostName : CachePort Service Name            Service Status Version Info
-------------------- ------------            -------------- ------------
CACHESERVER1:22233 AppFabricCachingService UP             3 [1,3][1,1]
CACHESERVER2:22233 AppFabricCachingService UP             3 [1,3][1,1]
CACHESERVER3:22233 AppFabricCachingService UP             1 [1,3][1,1]

Dans cet exemple, les deux premiers serveurs exécutent désormais le service de mise en cache mis à jour avec la version 3. Toutefois, l'ordinateur CACHESERVER3 exécute l'ancienne version du service de mise en cache avec la version 1. Cet hôte de cache doit être mis à niveau à l'aide de l'étape précédente ou être arrêté pour continuer le processus de mise à niveau.

Étape 5 : mise à jour de la plage de versions de serveur autorisées afin de n'utiliser que le nouveau numéro de version

Utilisez la commande Update-CacheHostAllowedVersions pour définir la valeur BeginServerVersion sur la nouvelle version.

Update-CacheHostAllowedVersions –BeginServerVersion 3

L'exemple suivant montre le résultat de la commande Get-CacheHost une fois cette étape terminée sur un cluster à trois nœuds dont la version cible est 3.

HostName : CachePort Service Name            Service Status Version Info
-------------------- ------------            -------------- ------------
CACHESERVER1:22233 AppFabricCachingService UP             3 [3,3][1,1]
CACHESERVER2:22233 AppFabricCachingService UP             3 [3,3][1,1]
CACHESERVER3:22233 AppFabricCachingService UP             3 [3,3][1,1]

À ce stade, vous pouvez utiliser les commandes Windows PowerShell disponibles, ainsi que les nouvelles fonctionnalités fournies par la mise à niveau.

Étape 6 : mise à jour de la plage de versions de client autorisées afin d'inclure le nouveau numéro de version

Les applications conçues pour utiliser les nouvelles fonctionnalités du client de cache doivent pouvoir communiquer avec le cluster de cache mis à niveau. Utilisez la commande Update-CacheHostAllowedVersions pour inclure la nouvelle version dans la plage de versions de client de cache autorisées. L'exemple suivant effectue cette opération en définissant le paramètre EndClientVersion sur la valeur 3.

Update-CacheHostAllowedVersions -EndClientVersion 3

L'exemple suivant montre le résultat de cette modification dans la sortie de la commande Get-CacheHost.

HostName : CachePort Service Name            Service Status Version Info
-------------------- ------------            -------------- ------------
CACHESERVER1:22233 AppFabricCachingService UP             3 [3,3][1,3]
CACHESERVER2:22233 AppFabricCachingService UP             3 [3,3][1,3]
CACHESERVER3:22233 AppFabricCachingService UP             3 [3,3][1,3]

À ce stade, vous pouvez mettre à jour les applications de façon à ce qu'elles utilisent les nouveaux assemblys et fonctionnalités du client de cache. Si vous souhaitez limiter les clients de cache à ceux de la nouvelle version uniquement, vous pouvez également utiliser la commande Update-CacheHostAllowedVersions pour définir le paramètre BeginClientVersion sur le nouveau numéro de version. Vous pouvez également conserver une plage de versions pour permettre aux anciens et nouveaux clients de continuer à utiliser le cluster de cache. Si vous décidez de limiter les clients de cache à une version spécifique, vous devez commencer par mettre à jour ces clients vers cette version avant de modifier la valeur BeginClientVersion.

Étape 7 : mise à jour du magasin de configuration du cache

Mettez à jour le magasin de configuration du cache à l'aide de la commande Update-CacheConfigurationStore. Cette commande ne peut être utilisée qu'une fois tous les hôtes de cache mis à jour.

Update-CacheConfigurationStore

Cette commande traduit notamment les noms d'hôte dans la configuration du cluster de cache pour utiliser leur nom de domaine complet (FQDN).

Étape 8 : mise à jour des applications du client de cache

Comme indiqué dans l'étape précédente, les applications du client de cache doivent utiliser les nouveaux assemblys de Mise en cache d'AppFabric pour exécuter les nouvelles fonctionnalités de Mise en cache d'AppFabric ou communiquer avec un cluster de cache dont la plage de versions est limitée à la dernière version (par exemple, 3,3).

Il est important de noter que les assemblys de Mise en cache d'AppFabric ne sont plus enregistrés dans le Global Assembly Cache (GAC). Vous devez donc localiser les fichiers binaires des applications du client de cache et les assemblys de Mise en cache d'AppFabric. Vous pouvez également utiliser la section <assemblyBinding> du fichier de configuration des applications. L'élément <codeBase> peut pointer vers l'emplacement des assemblys.

  2012-03-05