Paramètres de configuration du cluster (mise en cache de Windows Server AppFabric)

Article
12/05/2011

Windows Server AppFabric permet de modifier les paramètres de configuration de votre cluster de cache dans le code XML ou en utilisant directement Windows PowerShell. Cette rubrique décrit les paramètres de configuration du cluster disponibles et la manière de les spécifier avec XML ou Windows PowerShell. Pour plus d'informations sur la modification de la configuration du cluster, consultez la rubrique Configuration du cluster de cache (mise en cache de Windows Server AppFabric).

Les paramètres de configuration du cluster sont de quatre types :

Paramètres du cluster : décrire les paramètres relatifs au cluster de cache.
Paramètres de cache : décrire les paramètres relatifs à chacun des caches du cluster.
Paramètres d'hôte : décrire les paramètres relatifs à chacun des hôtes de cache membres du cluster.
Emplacement de stockage de la configuration du cluster : décrire l'emplacement du stockage et désigner le rôle de gestion du cluster. Pour plus d'informations sur le rôle de gestion du cluster, consultez la rubrique Hôtes principaux et gestion du cluster (mise en cache de Windows Server AppFabric).

Notes

Dans cette rubrique, le fichier XML produit par la commande Windows PowerShell Export-CacheClusterConfig est appelé « fichier XML ».

Important

Un grand nombre des attributs et éléments décrits ci-dessous sont sensibles à la casse. Lorsque vous les modifiez, il est important de respecter la casse utilisée dans les tableaux suivants.

Paramètres du cluster

La seule manière de créer un cluster et de spécifier ses paramètres initiaux consiste à installer Windows Server AppFabric et à exécuter l'Assistant Configuration d'AppFabric sur au moins un hôte de cache.

Deux paramètres sont utilisés pour décrire le cluster proprement dit : le nom et la taille (petit, moyen ou grand). Dans le fichier XML, ces paramètres sont définis en tant qu'attributs de l'élément dataCache et sont attribués quand l'Assistant Configuration d'AppFabric s'exécute sur le premier serveur de cache du cluster.

Paramètre	Emplacement de la configuration XML	Paramètre attribué quand…
Taille de cluster	Attribut `size` de l'élément `dataCache`. Les valeurs possibles sont `Small`, `Medium` ou `Large`.	La taille de cluster est attribuée quand le service de mise en cache d'AppFabric est configuré sur le premier serveur de cache.

Paramètres de cache

La seule manière de créer un cache et de spécifier ses paramètres initiaux consiste à utiliser la commande New-Cache de l'outil d'administration du cache basé sur Windows PowerShell.

Les paramètres du cache sont stockés au niveau du cluster. C'est pourquoi ces paramètres figurent dans le fichier XML en tant qu'enfant de l'élément caches. Dans Windows PowerShell, utilisez la commande Get-CacheConfig pour afficher les paramètres de configuration du cache et la commande Set-CacheConfig pour modifier les paramètres du cache.

Notes

Pour modifier les paramètres de configuration du cache avec le fichier XML ou la commande Set-CacheConfig, vous devez redémarrer le cluster entier avec la commande Windows PowerShell Restart-CacheCluster. Vous pouvez également utiliser Windows PowerShell pour supprimer, puis recréer un cache du même nom (avec des paramètres différents) sans redémarrer le cluster.

Le tableau suivant répertorie les paramètres disponibles pour chaque cache :

Paramètre	Emplacement de la configuration XML	Emplacement de la configuration Windows PowerShell
Nom du cache	Attribut `name` de l'élément `cache`.	Attribué avec le paramètre `CacheName` dans la commande `New-Cache`. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.
Si les notifications de cache sont activées	Attribut `isEnabled` de l'élément `serverNotification`. La valeur peut être `true` ou `false`. L'élément `serverNotification` est un enfant de l'élément `policy`, qui est lui-même un enfant de l'élément `cache`.	Attribué avec le paramètre `NotificationsEnabled` dans la commande `New-Cache`. Les notifications sont activées quand ce paramètre est présent. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.
Si la fonctionnalité de haute disponibilité est activée	Attribut `secondaries` de l'élément `cache`. La haute disponibilité est activée quand cet attribut est défini sur `1` et désactivée quand il est défini sur `0`. La suppression de cet attribut désactive également la fonctionnalité de haute disponibilité.	Attribué avec le paramètre `Secondaries` dans la commande `New-Cache`. La haute disponibilité est activée quand la valeur de `Secondaries` est `1` et désactivée quand la valeur de `Secondaries` est `0`. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.
Type de cache	Attribut `type` de l'élément `cache`. Seule la valeur `Partitioned` (par défaut) est autorisée.	Attribué avec le paramètre `Type` dans la commande `New-Cache`. Seule la valeur `Partitioned` (par défaut) est autorisée. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.
Type d'éviction	Attribut `type` de l'élément `eviction`. Les valeurs peuvent être `LRU` pour dernier récemment utilisé ou `None`. L'élément `eviction` est un enfant de l'élément `policy`, qui est lui-même un enfant de l'élément `cache`.	Attribué avec le paramètre `Eviction` dans la commande `New-Cache`. Les valeurs peuvent être `LRU` pour dernier récemment utilisé ou `None`. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.
Si l'expiration est activée	Attribut `isExpirable` de l'élément `expiration`. La valeur peut être `true` ou `false`. L'élément `expiration` est un enfant de l'élément `policy`, qui est lui-même un enfant de l'élément `cache`.	Attribué avec le commutateur `Expirable` dans la commande `New-Cache`. La valeur peut être `true` ou `false`. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.
Délai d’inactivité d'objet par défaut (minutes)	Attribut `defaultTTL` de l'élément `expiration`. La valeur peut être `true` ou `false`. L'élément `expiration` est un enfant de l'élément `policy`, qui est lui-même un enfant de l'élément `cache`.	Attribué avec le paramètre `TimeToLive` dans la commande `New-Cache`. Affichez ce paramètre avec la commande `Get-CacheConfig` en utilisant le paramètre `CacheName`.

Paramètres d'hôte

La seule manière de créer un hôte et de spécifier ses paramètres initiaux consiste à installer Windows Server AppFabric sur un serveur, puis à exécuter l'Assistant Configuration d'AppFabric pour configurer le service de mise en cache. Vous avez la possibilité de créer un cluster de cache ou de joindre un cluster de cache existant.

Le cluster de cache doit assurer le suivi de chaque hôte de cache membre du cluster. Dans le fichier XML, un élément host est utilisé pour spécifier chaque hôte dans le cluster. Dans Windows PowerShell, les commandes Get-CacheConfig et Set-CacheConfig permettent d'afficher et de reconfigurer la configuration de l'hôte de cache.

Les paramètres disponibles pour chaque hôte de cache sont les suivants :

Paramètre	Emplacement de la configuration XML	Emplacement de la configuration Windows PowerShell
Nom du serveur de cache	Attribut `name` de l'élément `host`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué sur la base du nom d'ordinateur. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Nom de l'hôte de cache (nom du service d'hôte)	Attribut `cacheHostName` de l'élément `host`. La valeur par défaut est `DistributedCacheService`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Numéro de port du cache (la valeur par défaut est 22233).	Attribut `cachePort` de l'élément `host`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Reconfigurez ce paramètre avec le paramètre `CachePort` de la commande `Set-CacheHostConfig`. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Numéro de port du cluster (la valeur par défaut est 22234).	Attribut `clusterPort` de l'élément `host`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Reconfigurez ce paramètre avec le paramètre `ClusterPortNumber` de la commande `Set-CacheHostConfig`. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Désignation d'hôte principal	Attribut `leadHost` de l'élément `host`. Les valeurs peuvent être `true` ou `false`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Taille de cache (Mo) (espace total alloué au stockage de données sur l'hôte de cache)	Attribut `size` de l'élément `host`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Reconfigurez ce paramètre avec le paramètre `CacheSize` de la commande `Set-CacheHostConfig`. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Limite inférieure	Attribut `lowWaterMark` de l'élément `host`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Reconfigurez ce paramètre avec le paramètre `LWM` de la commande `Set-CacheHostConfig`. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.
Limite supérieure	Attribut `highWaterMark` de l'élément `host`. L'élément `host` est un enfant de l'élément `hosts`.	Attribué au moment de l'installation. Reconfigurez ce paramètre avec le paramètre `HWM` de la commande `Set-CacheHostConfig`. Affichez ce paramètre avec la commande `Get-CacheHostConfig`.

Paramètres d'emplacement de stockage de la configuration du cluster

Les paramètres d'emplacement de stockage de la configuration du cluster sont attribués lors de la première configuration des fonctionnalités de mise en cache d'AppFabric. Ils décrivent l'emplacement du stockage et désignent le rôle de gestion du cluster.

Dans le fichier XML, ces paramètres sont spécifiés dans l'élément partitionStoreConnectionSettings, enfant de l'élément advancedProperties (lui-même enfant de l'élément dataCache).

Dans Windows PowerShell, le nom de fournisseur et la chaîne de connexion doivent être spécifiés lorsque vous définissez un contexte pour le cluster avec la commande Use-CacheCluster. Si ces paramètres ne sont pas fournis à Windows PowerShell, ils sont tirés de l'emplacement de stockage de la configuration du cluster.

Les paramètres liés à ces propriétés sont les suivants :

Paramètre	Emplacement de la configuration XML	Paramètre attribué quand…
Rôle de gestion du cluster	Attribut `leadHostManagement` de l'élément `partitionStoreConnectionSettings`, enfant de l'élément `advancedProperties`. Les valeurs sont `true` pour des hôtes principaux ou `false` pour SQL Server. Si les paramètres de configuration du cluster sont stockés dans un dossier partagé, la seule valeur valide est `true`.	Le rôle de gestion du cluster est attribué au moment de la configuration en fonction de l'emplacement où vous stockez les paramètres de configuration de votre cluster. Pour plus d'informations, consultez la rubrique Hôtes principaux et gestion du cluster (mise en cache de Windows Server AppFabric).
Propriétés de sécurité	Les propriétés de sécurité du cluster de cache sont définies dans le nœud `securityProperties` de l'élément `advancedProperties`. L'attribut `mode` peut être défini sur `None` ou `Transport`. L'attribut `protectionLevel` peut être défini sur `None`, `Sign` ou `EncryptAndSign`.	Les valeurs par défaut pour le cluster sont le mode `Transport` et le niveau de protection `EncryptAndSign`. Si le nœud `securityProperties` n'est pas fourni ou si l'un des attributs est manquant, les valeurs par défaut sont appliquées. Les propriétés de sécurité peuvent être modifiées à l'aide de la commande Windows PowerShell `Set-CacheClusterSecurity`.

Voir aussi

Concepts

Modification des paramètres de configuration du cluster (mise en cache de Windows Server AppFabric)
Options de stockage de la configuration du cluster (mise en cache de Windows Server AppFabric)
Utilisation de Windows PowerShell pour la gestion des fonctionnalités de mise en cache de Windows Server AppFabric
Paramètres de configuration de l'application (mise en cache de Windows Server AppFabric)
Configuration du cluster de cache (mise en cache de Windows Server AppFabric)
Concepts relatifs à la mise en cache de Windows Server AppFabric
Développement d'un client de cache (mise en cache de Windows Server AppFabric)

2011-12-05

Partager via