Installation et configuration automatisées (mise en cache d'AppFabric 1.1)
Cette section décrit les procédures d'installation et de configuration automatiques des fonctionnalités de Mise en cache de Microsoft AppFabric 1.1 pour Windows Server. Dans le cadre d'une installation sans assistance, l'utilisateur n'accède à aucune interface car toutes les options sont spécifiées à partir de la ligne de commande. Une séquence spécifique de commandes est requise pour ajouter un hôte de cache à un cluster de cache ou supprimer un hôte de cache d'un cluster de cache. Cette section décrit les commandes relatives à ces deux scénarios. Il est également possible d'utiliser l'Assistant Configuration d'AppFabric pour configurer les fonctionnalités de mise en cache à l'aide d'une interface utilisateur. Pour plus d'informations sur l'Assistant Configuration d'AppFabric, consultez la rubrique Configuration de Windows Server AppFabric.
Cette section divise la procédure d'installation automatique en cinq tâches :
Installation des fonctionnalités de mise en cache de Windows Server AppFabric
Création d'un cluster de cache
Ajout d'un hôte de cache
Suppression d'un hôte de cache
Suppression d'un cluster de cache
Pour obtenir les scripts PowerShell qui permettent d'automatiser ces tâches, consultez les exemples suivants :
Conseil
Pour plus d'informations sur les concepts de base liés au lancement et à l'exécution des commandes Windows PowerShell, consultez la rubrique Utilisation de Windows PowerShell pour la gestion des fonctionnalités de mise en cache de Windows Server AppFabric. Avant d'exécuter ces commandes, il peut être nécessaire d'utiliser la commande Import-Module pour importer les modules Windows PowerShell pour l'administration (DistributedCacheAdministration) ou la configuration (DistributedCacheConfiguration).
Conseil
Bien que certaines des commandes suivantes doivent être exécutées localement sur l'hôte de cache cible, Windows PowerShell prend en charge l'exécution des commandes sur des ordinateurs distants. Pour plus d'informations, consultez la rubrique Exécution des commandes distantes.
Installation des fonctionnalités de Mise en cache de Microsoft AppFabric 1.1 pour Windows Server
Avant de créer un cluster de cache ou de configurer la Mise en cache d'AppFabric sur un hôte de cache, vous devez installer les fonctionnalités de Mise en cache de Microsoft AppFabric 1.1 pour Windows Server. Pour plus d'informations sur l'installation sans assistance d'AppFabric, consultez la rubrique Installation automatisée. Les fonctionnalités de mise en cache suivantes sont disponibles :
CachingService ;
CacheClient ;
CacheAdmin.
Prenons un exemple dans lequel le fichier binaire d'installation est nommé Setup.exe. Notez que le nom réel du fichier binaire varie en fonction de la plateforme choisie. L'exemple suivant montre comment effectuer l'installation sans assistance des fonctionnalités de Mise en cache d'AppFabric sur un serveur :
Setup.exe /install /i cachingservice,cacheclient,cacheadmin /l:c:\temp\setup.log
Dans cet exemple, le fichier journal est situé à l'emplacement c:\temp\setup.log. Vous pouvez consulter ce fichier journal pour examiner les résultats de l'installation. Microsoft AppFabric 1.1 pour Windows Server inclut également une nouvelle option p pour la spécification du chemin d'installation d'AppFabric.
Une fois les fonctionnalités de Mise en cache d'AppFabric installées sur un ordinateur, vous devez les configurer. Les sections suivantes décrivent la procédure d'automatisation de ce processus.
Création d'un cluster de cache
Si vous créez un cluster de cache, vous devez commencer par appeler la commande Windows PowerShell New-CacheCluster. Lors de la création d'un cluster de cache, vous devez désigner l'emplacement auquel stocker les paramètres de configuration du cluster. Vous pouvez utiliser le fournisseur System.Data.SqlClient, le fournisseur XML ou un fournisseur personnalisé. Pour plus d'informations, consultez la rubrique Modèle de configuration.
L'exemple suivant crée un petit cluster de cache. Il stocke les paramètres de configuration sur un ordinateur SQL Server nommé SQLServer1, doté d'une base de données existante nommée CacheClusterConfigurationDB.
New-CacheCluster -Provider System.Data.SqlClient -ConnectionString "Data Source=SQLServer1;Initial Catalog=CacheClusterConfigurationDB;Integrated Security=True" -Size Small
Notes
Si vous utilisez la mise en miroir de bases de données SQL Server pour améliorer la disponibilité du cluster de cache, vous devez spécifier le partenaire de basculement dans la chaîne de connexion. Pour plus d'informations, consultez la rubrique Configuration de cluster basée sur SQL Server.
L'exemple suivant crée un grand cluster de cache. Il stocke les paramètres de configuration dans un fichier XML sur un partage réseau nommé \\Server1\CacheConfigShare.
New-CacheCluster -Provider XML -ConnectionString "\\Server1\CacheConfigShare" -Size Large
Dans les deux exemples, l'appelant doit disposer des autorisations appropriées sur l'emplacement du magasin de configuration. Pour le fournisseur System.Data.SqlClient, l'appelant doit être membre du rôle db_owner sur la base de données cible ou membre du rôle sysadmin sur l'instance SQL Server. Pour le fournisseur XML, l'appelant doit disposer des autorisations de propriétaire sur le dossier partagé.
Ajout d'un hôte de cache
Pour ajouter un hôte de cache à un cluster de cache existant, vous devez respecter les étapes suivantes dans l'ordre indiqué :
| Commande/Étape | Description |
|---|---|
Register-CacheHost |
Enregistrer l'hôte de cache auprès du cluster de cache. |
Add-CacheHost |
Configurer l'hôte de cache de telle sorte qu'il fasse partie du cluster de cache. |
Add-CacheAdmin |
Configurer l'administration du cache sur l'hôte de cache actuel (facultatif). |
Configuration du pare-feu |
Autoriser le service AppFabricCachingService via le pare-feu. Autoriser également la gestion des services à distance. |
Start-CacheHost |
Démarrer le nouvel hôte de cache. |
Register-CacheHost
Vous devez utiliser la commande Register-CacheHost pour enregistrer un hôte de cache auprès d'un cluster de cache existant. Cela inclut de spécifier les numéros de port et le compte Windows du service de mise en cache. Les paramètres Provider et ConnectionString spécifient le cluster de cache cible pour le nouvel hôte de cache.
L'exemple suivant ajoute l'ordinateur hôte de cache CacheServer1 à un cluster de cache dont le magasin de configuration est situé dans un fichier XML sur le partage de fichiers \\Server1\CacheConfigShare. Le compte NT Authority\Network Service intégré est spécifié pour l'identité du service de mise en cache.
Register-CacheHost -Provider XML -ConnectionString "\\Server1\CacheConfigShare" -Account "NT Authority\Network Service" -CachePort 22233 -ClusterPort 22234 -ArbitrationPort 22235 -ReplicationPort 22236 -HostName CacheServer1
Pour le fournisseur XML, l'appelant doit disposer d'un contrôle total sur le partage réseau cible. Pour le fournisseur System.Data.SqlClient, l'appelant doit disposer des autorisations de lecture, d'écriture, de création de connexions SQL et d'ajout d'autorisations sur la base de données cible.
Contrairement à la plupart des commandes de configuration, la commande Register-CacheHost accepte un paramètre HostName et peut donc être exécutée à distance.
Add-CacheHost
La commande Add-CacheHost configure l'hôte de cache de telle sorte qu'il fasse partie du cluster de cache existant. Les paramètres Provider et ConnectionString spécifient le cluster de cache cible pour le nouvel hôte de cache.
L'exemple suivant montre comment appeler la commande Add-CacheHost.
Add-CacheHost -Provider XML -ConnectionString "\\Server1\CacheConfigShare" -Account "NT Authority\Network Service"
Cette commande doit être exécutée localement sur l'hôte de cache en cours de configuration. Par ailleurs, elle doit être exécutée depuis une session Windows PowerShell dotée de privilèges d'administrateur élevés.
Avertissement
Vous devez fournir une valeur pour le paramètre Account de la commande Add-CacheHost. Si vous ne spécifiez pas de compte, les autorisations du service de mise en cache ne seront pas correctement configurées. Dans un environnement de domaine pour lequel la sécurité est activée, le compte NT Autority\Network Service doit être utilisé.
Add-CacheAdmin
Vous pouvez utiliser la commande Add-CacheAdmin pour configurer la fonctionnalité d'administration du cache sur un hôte de cache. Cela vous permet d'administrer le cluster de cache depuis cet ordinateur à l'aide des commandes Windows PowerShell. La fonctionnalité d'administration du cache doit être installée sur l'ordinateur.
L'exemple suivant montre comment appeler la commande Add-CacheAdmin.
Add-CacheAdmin -Provider XML -ConnectionString "\\Server1\CacheConfigShare"
Cette commande doit être exécutée localement sur l'hôte de cache en cours de configuration. Par ailleurs, elle doit être exécutée depuis une session Windows PowerShell dotée de privilèges d'administrateur élevés.
Configuration du pare-feu
Pour utiliser les fonctionnalités de Mise en cache d'AppFabric, vous devez configurer le service DistributedCacheService.exe. Ce service est installé par défaut dans le répertoire « C:\Program Files\Windows Server AppFabric ».
Si vous utilisez le Pare-feu Windows, vous pouvez activer un groupe de stratégies de pare-feu automatiquement installé avec AppFabric. Les commandes Windows PowerShell suivantes activent le groupe de stratégies de pare-feu nommé « Microsoft AppFabric 1.1 pour Windows Server : service de Mise en cache d'AppFabric ». Vous devez également activer les règles de pare-feu « Gestion des services à distance » pour permettre le contrôle à distance du service de Mise en cache d'AppFabric.
netsh advfirewall firewall set rule group="Windows Server AppFabric: AppFabric Caching Service" new enable=Yes
netsh advfirewall firewall set rule name="Remote Service Management (RPC)" profile=domain new enable=Yes
netsh advfirewall firewall set rule name="Remote Service Management (RPC-EPMAP)" profile=domain new enable=Yes
netsh advfirewall firewall set rule name="Remote Service Management (NP-In)" profile=domain new enable=Yes
Start-CacheHost
Vous devez démarrer le nouvel hôte de cache si vous souhaitez qu'il participe au cluster de cache. Si le cluster de cache est arrêté, vous devez démarrer l'ensemble du cluster de cache. Le cluster de cache est arrêté si tous les hôtes le sont également. Vous pouvez déterminer si le cluster de cache est arrêté en appelant la commande Get-CacheHost sans paramètres.
Get-CacheHost
Si tous les hôtes indiquent l'état de service DOWN, démarrez le cluster de cache à l'aide de la commande Start-CacheCluster.
Start-CacheCluster
En revanche, si au moins un hôte a l'état de service UP, le cluster de cache est en cours d'exécution. Dans ce cas, utilisez la commande Start-CacheHost.
Start-CacheHost -Hostname CacheServer2 -CachePort 22233
Après le redémarrage d'un ordinateur hôte de cache, le service de mise en cache ne démarre pas automatiquement. Vous devez utiliser la commande Start-CacheHost ou Start-CacheCluster selon l'état du cluster de cache.
Vous devez exécuter cette commande depuis une session Windows PowerShell dotée de privilèges d'administrateur élevés.
Avertissement
Vous devez toujours utiliser les commandes Windows PowerShell pour démarrer et arrêter le service de mise en cache. Vous ne devez jamais démarrer ou arrêter le service AppFabricCachingService directement depuis le programme Services dans les outils d'administration.
Suppression d'un hôte de cache
Pour supprimer un hôte de cache d'un cluster de cache, vous devez respecter les étapes suivantes dans l'ordre indiqué.
| Commande/Étape | Description |
|---|---|
Stop-CacheHost |
Arrêter l'hôte de cache le cas échéant. |
Unregister-CacheHost |
Annuler l'enregistrement de l'hôte de cache auprès du cluster de cache. |
Remove-CacheHost |
Supprimer la configuration de l'hôte de cache de l'ordinateur. |
Remove-CacheAdmin |
Supprimer la configuration de la fonctionnalité d'administration du cache (facultatif). |
Configuration du pare-feu |
Supprimer les exceptions de pare-feu pour le service de mise en cache. |
Stop-CacheHost
Si vous souhaitez supprimer un hôte de cache d'un cluster existant, vous devez commencer par arrêter l'hôte de cache. Vous pouvez déterminer si l'hôte de cache est en cours d'exécution en appelant la commande Get-CacheHost. L'exemple suivant montre comment afficher les informations relatives à l'hôte de cache local.
Get-CacheHost -HostName localhost -CachePort 22233
Si la commande précédente donne des informations sur un hôte de cache spécifique, vous devez toujours consulter l'état de l'ensemble du cluster de cache avant d'arrêter un hôte de cache. Pour ce faire, appelez la commande Get-CacheHost sans paramètres.
Get-CacheHost
L'exemple de sortie suivant a été généré à partir de cette commande pour un cluster de cache incluant deux serveurs.
HostName : CachePort Service Name Service Status Version Info
-------------------- ------------ -------------- ------------
CacheServer1:22233 AppFabricCachingService UP 1 [1,1][1,1]
CacheServer2:22233 AppFabricCachingService UP 1 [1,1][1,1]
Dans cet exemple, les serveurs de cache CacheServer1 et CacheServer2 sont en cours d'exécution. Vous pouvez tenter d'arrêter un de ces hôtes de cache et garder le cluster de cache opérationnel via l'autre hôte de cache. L'exemple suivant montre comment arrêter le serveur de cache CacheServer2 à l'aide de la commande Stop-CacheHost.
Stop-CacheHost -HostName CacheServer2 -CachePort 22233 -Graceful
Remarquez l'utilisation du commutateur Graceful ajouté à la version v1.1 pour déplacer les données hors du serveur de cache vers d'autres hôtes de cache avant l'arrêt. Sans le commutateur Graceful, les données mises en cache sur l'hôte de cache arrêté sont perdues. Par ailleurs, une tentative d'arrêt de l'hôte de cache échoue si elle entraîne la perte du quorum pour les hôtes principaux ou secondaires. Pour plus d'informations sur les hôtes principaux, consultez la rubrique Hôtes principaux et gestion du cluster. Pour plus d'informations sur les hôtes secondaires, consultez la rubrique Haute disponibilité. Dans ce cas, vous devez arrêter l'ensemble du cluster de cache à l'aide de la commande Stop-CacheCluster.
Si l'arrêt de l'hôte de cache devait également arrêter le cluster de cache, utilisez plutôt la commande Stop-CacheCluster. Par exemple, examinez l'exemple de sortie suivant généré à partir de la commande Get-CacheHost.
HostName : CachePort Service Name Service Status Version Info
-------------------- ------------ -------------- ------------
CacheServer1:22233 AppFabricCachingService DOWN 1 [1,1][1,1]
CacheServer2:22233 AppFabricCachingService UP 1 [1,1][1,1]
Dans cet exemple, le serveur de cache CacheServer1 est arrêté tandis que le serveur de cache CacheServer2 est en cours d'exécution. L'arrêt du serveur de cache CacheServer2 devrait arrêter également le cluster. Plutôt que d'utiliser la commande Stop-CacheHost pour arrêter le serveur de cache CacheServer2, vous devez utiliser la commande Stop-CacheCluster.
Stop-CacheCluster
Vous devez exécuter cette commande depuis une session Windows PowerShell dotée de privilèges d'administrateur élevés.
Unregister-CacheHost
La commande Unregister-CacheHost supprime l'hôte de cache du cluster de cache.
Avertissement
La commande Stop-CacheHost doit être appelée pour arrêter un hôte de cache avant d'annuler son enregistrement. Si ce n'est pas le cas, cela peut provoquer le blocage du service.
Si cette commande est exécutée avant la commande Remove-CacheHost, vous n'avez pas besoin de spécifier de valeurs pour les paramètres Provider et ConnectionString. Si la commande est exécutée localement, vous n'avez pas non plus besoin de spécifier une valeur pour le paramètre HostName.
Unregister-CacheHost -RemoveServicePermissions
L'exemple suivant annule l'enregistrement d'un hôte de cache en spécifiant le fournisseur, la chaîne de connexion et le nom d'hôte. Il supprime l'hôte de cache nommé CacheServer2 d'un cluster de cache. Ce cluster de cache utilise le fournisseur System.Data.SqlClient, aussi la chaîne de connexion est-elle une chaîne de connexion SQL Server pointant vers un serveur de base de données nommé SQLServer1 et une base de données de configuration nommée CacheClusterConfigurationDB.
Unregister-CacheHost -Provider System.Data.SqlClient -ConnectionString "Data Source=SQLServer1;Initial Catalog=CacheClusterConfigurationDB;Integrated Security=True" + -HostName CacheServer2 -RemoveServicePermissions
Pour le fournisseur XML, l'appelant doit disposer d'un contrôle total sur le partage réseau cible. Pour le fournisseur System.Data.SqlClient, l'appelant doit disposer des autorisations de lecture, d'écriture, de suppression de connexions SQL et de suppression d'autorisations sur la base de données cible.
Contrairement à la plupart des commandes de configuration, la commande Unregister-CacheHost accepte un paramètre HostName et peut donc être exécutée à distance.
Remove-CacheHost
La commande Remove-CacheHost supprime la configuration d'hôte de cache du serveur.
Remove-CacheHost
Cette commande doit être exécutée localement sur l'hôte de cache en cours de configuration. Par ailleurs, elle doit être exécutée depuis une session Windows PowerShell dotée de privilèges d'administrateur élevés.
Remove-CacheAdmin
Si la fonctionnalité d'administration du cache est configurée sur l'hôte de cache, vous pouvez la supprimer à l'aide de la commande Remove-CacheAdmin.
Remove-CacheAdmin
Cette commande doit être exécutée localement sur l'hôte de cache en cours de configuration. Par ailleurs, elle doit être exécutée depuis une session Windows PowerShell dotée de privilèges d'administrateur élevés.
Configuration du pare-feu
Vous devez supprimer ou désactiver les exceptions dans le pare-feu pour le service de mise en cache DistributedCacheService.exe. Si vous utilisez le Pare-feu Windows, vous devez avoir activé le groupe de stratégies de pare-feu installé « Microsoft AppFabric 1.1 pour Windows Server : service de Mise en cache d'AppFabric ». Dans ce cas, vous pouvez désactiver ce groupe de stratégies à l'aide des commandes PowerShell suivantes. Si vous avez également activé les règles « Gestion des services à distance », vous pouvez les désactiver. Les règles « Gestion des services à distance » peuvent toutefois être activées pour d'autres services ou applications. Dans ce cas, vous ne devez pas désactiver ces règles.
netsh advfirewall firewall set rule group="Windows Server AppFabric: AppFabric Caching Service" new enable=No
netsh advfirewall firewall set rule name="Remote Service Management (RPC)" profile=domain new enable=No
netsh advfirewall firewall set rule name="Remote Service Management (RPC-EPMAP)" profile=domain new enable=No
netsh advfirewall firewall set rule name="Remote Service Management (NP-In)" profile=domain new enable=No
Suppression d'un cluster de cache
Si vous avez supprimé le dernier hôte de cache du cluster, vous pouvez également supprimer le magasin de configuration du cluster de cache. Pour ce faire, utilisez la commande Remove-CacheCluster. Si le cluster de cache utilise le fournisseur XML, cette commande supprime le fichier XML contenant les paramètres de configuration. Si le cluster de cache utilise le fournisseur System.Data.SqlClient, cette commande supprime les tables de la base de données spécifiée. Le partage de fichiers et la base de données ne sont pas supprimés.
Remove_CacheCluster -Provider System.Data.SqlClient -ConnectionString "Data Source=SQLServer1;Initial Catalog=CacheClusterConfigurationDB;Integrated Security=True"
Voir aussi
Concepts
2012-03-05