Definições de configuração de cluster (Cache do Windows Server AppFabric)

Artigo
12/05/2011

Windows Server AppFabric oferece a capacidade de editar as definições de configuração do seu cluster de cache no XML ou usando o Windows PowerShell diretamente. Este tópico descreve as definições de configuração de cluster que estão disponíveis e como elas são especificadas com o XML ou Windows PowerShell. Para obter informações sobre como fazer as alterações de configuração de cluster, consulte Configurando o cluster de cache (cache do Windows Server AppFabric).

Há quatro tipos de definições configuradas nas definições de configuração de cluster:

Configurações de cluster: Descrever as definições relacionadas ao cluster de cache.
Configurações de cache: Descrever as definições relacionadas a cada um dos caches no cluster.
Configurações de host: Descrever as definições relacionadas a cada um dos hosts de cache que são membros do cluster.
Configurações do local de armazenamento de configurações de cluster: Descrever o local de armazenamento e atribuir a função de gerenciamento de cluster. Para obter mais informações sobre a função de gerenciamento de cluster, consulte Hosts principais e gerenciamento de cluster (cache do Windows Server AppFabric).

Observação

O arquivo XML produzido pelo comando Export-CacheClusterConfig do Windows PowerShell é chamado de "arquivo XML" em todo este tópico.

Importante

Muitos dos atributos e elementos descritos a seguir diferenciam maiúsculas de minúsculas. Ao modificar essas definições, é importante usar a capitalização, conforme mostrado nas tabelas a seguir.

Definições de cluster

A única maneira de criar um cluster e especificar suas definições iniciais é instalar o Windows Server AppFabric e executar o Assistente de Configuração do AppFabric em pelo menos um host de cache.

Duas definições são usadas para descrever o cluster em si: o nome e o tamanho (pequeno, médio ou grande). No arquivo XML, essas definições são atributos do elemento dataCache e são atribuídas quando o Assistente de Configuração do AppFabric é executado no primeiro servidor de cache do cluster.

Configuração	Local de configuração do XML	Definição atribuída quando...
Tamanho do cluster	O atributo `size` no elemento `dataCache`. Os valores possíveis incluem `Small`, `Medium` ou `Large`.	O tamanho do cluster é atribuído quando o serviço de cache do AppFabric é configurado no primeiro servidor de cache.

Definições de cache

A única maneira de criar um cache e especificar suas definições iniciais é usar o comando New-Cache da ferramenta de administração de cache com base no Windows PowerShell.

As definições de cache são armazenadas no nível do cluster. Por esse motivo, essas definições podem ser encontradas no arquivo XML como filho do elemento caches. No Windows PowerShell, use o comando Get-CacheConfig para exibir as definições de configuração de cache e o comando Set-CacheConfig para alterar as definições de cache.

Observação

Para alterar as definições de configuração de cache com o arquivo XML ou o comando Set-CacheConfig, é necessário reiniciar o cluster com o comando Restart-CacheCluster do Windows PowerShell. Também é possível usar o Windows PowerShell para remover e criar novamente um cache com mesmo nome (e definições diferentes) sem reiniciar o cluster.

A tabela a seguir lista as definições disponíveis para cada cache:

Configuração	Local de configuração do XML	Local de configuração do Windows PowerShell
Nome do cache	O atributo `name` no elemento `cache`.	Atribuído com o parâmetro `CacheName` no comando `New-Cache`. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.
Se as notificações de cache estiverem habilitadas	O atributo `isEnabled` no elemento `serverNotification`. Os valores podem ser `true` ou `false`. O elemento `serverNotification` é um filho do elemento `policy`, que é um filho do elemento `cache`.	Atribuído com o parâmetro `NotificationsEnabled` no comando `New-Cache`. As notificações serão habilitadas quando este parâmetro estiver presente. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.
Se o recurso de alta disponibilidade estiver habilitado	O atributo `secondaries` do elemento `cache`. A alta disponibilidade será habilitada quando esse atributo estiver definido como `1` e desabilitada quando estiver definido como `0`. Como alternativa, a remoção desse atributo desabilita o recurso de alta disponibilidade.	Atribuído com o parâmetro `Secondaries` no comando `New-Cache`. A alta disponibilidade estará habilitada quando `Secondaries` for igual a `1` e desabilitada quando `Secondaries` for igual a `0`. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.
Tipo de cache	O atributo `type` no elemento `cache`. Apenas o valor `Partitioned` (padrão) é permitido.	Atribuído com o parâmetro `Type` no comando `New-Cache`. Apenas o valor `Partitioned` (padrão) é permitido. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.
Tipo de remoção	O atributo `type` no elemento `eviction`. Os valores podem ser `LRU` para o menos usado recentemente ou `None`. O elemento `eviction` é um filho do elemento `policy`, que é um filho do elemento `cache`.	Atribuído com o parâmetro `Eviction` no comando `New-Cache`. Os valores podem ser `LRU` para o menos usado recentemente ou `None`. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.
Se a expiração estiver habilitada	O atributo `isExpirable` no elemento `expiration`. Os valores podem ser `true` ou `false`. O elemento `expiration` é um filho do elemento `policy`, que é um filho do elemento `cache`.	Atribuído com a opção `Expirable` no comando `New-Cache`. Os valores podem ser `true` ou `false`. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.
Tempo limite padrão do objeto (minutos)	O atributo `defaultTTL` no elemento `expiration`. Os valores podem ser `true` ou `false`. O elemento `expiration` é um filho do elemento `policy`, que é um filho do elemento `cache`.	Atribuído com o parâmetro `TimeToLive` no comando `New-Cache`. Exiba essa definição com o comando `Get-CacheConfig` usando o parâmetro `CacheName`.

Definições de host

A única maneira de criar um host e especificar suas definições iniciais é instalar o Windows Server AppFabric em um servidor e executar o Assistente de Configuração do AppFabric para configurar o Serviço de Cache. Você tem a opção de criar um novo cluster de cache ou usar um cluster de cache existente.

O cluster de cache deve controlar cada host de cache que é um membro do cluster. No arquivo XML, um elemento host é usado para especificar cada host no cluster. No Windows PowerShell, os comandos Get-CacheConfig eSet-CacheConfig podem ser usados para exibir ou reconfigurar a configuração do host de cache.

As definições disponíveis para cada host de cache são as seguintes:

Configuração	Local de configuração do XML	Local de configuração do Windows PowerShell
Nome do servidor de cache	O atributo `name` no elemento `host`. O elemento `host` é um filho do elemento `hosts`.	Atribuído com base no nome do computador. Exiba essa definição com o comando `Get-CacheHostConfig`.
Nome do host de cache (nome do serviço de hospedagem)	O atributo `cacheHostName` no elemento `host`. O valor padrão é `DistributedCacheService`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Exiba essa definição com o comando `Get-CacheHostConfig`.
Número da porta do cache (o valor padrão é 22233)	O atributo `cachePort` no elemento `host`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Reconfigure essa definição com o parâmetro `CachePort` do comando `Set-CacheHostConfig`. Exiba essa definição com o comando `Get-CacheHostConfig`.
Número da porta do cluster (o valor padrão é 22234)	O atributo `clusterPort` no elemento `host`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Reconfigure essa definição com o parâmetro `ClusterPortNumber` do comando `Set-CacheHostConfig`. Exiba essa definição com o comando `Get-CacheHostConfig`.
Designação do host principal	O atributo `leadHost` no elemento `host`. Os valores podem ser `true` ou `false`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Exiba essa definição com o comando `Get-CacheHostConfig`.
Tamanho do cache (MB, espaço total alocado para armazenamento de dados no host do cache)	O atributo `size` no elemento `host`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Reconfigure essa definição com o parâmetro `CacheSize` do comando `Set-CacheHostConfig`. Exiba essa definição com o comando `Get-CacheHostConfig`.
Baixa marca d´água	O atributo `lowWaterMark` no elemento `host`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Reconfigure essa definição com o parâmetro `LWM` do comando `Set-CacheHostConfig`. Exiba essa definição com o comando `Get-CacheHostConfig`.
Alta marca d´água	O atributo `highWaterMark` no elemento `host`. O elemento `host` é um filho do elemento `hosts`.	Atribuído no momento da instalação. Reconfigure essa definição com o parâmetro `HWM` do comando `Set-CacheHostConfig`. Exiba essa definição com o comando `Get-CacheHostConfig`.

Definições de local de armazenamento de configuração de cluster

As definições de local de armazenamento de configuração são atribuídas quando os recursos de cache do AppFabric são configurados primeiro. Eles descrevem o local de armazenamento e atribuem a função de gerenciamento de cluster.

No arquivo XML, essas definições estão especificadas no elemento partitionStoreConnectionSettings, um filho do elemento advancedProperties (que é um filho do elemento dataCache).

No Windows PowerShell, o nome do provedor e a cadeia de caracteres da conexão devem ser especificados quando você definir o contexto para o cluster com o comando Use-CacheCluster. Se esses parâmetros não forem fornecidos ao Windows PowerShell, eles serão retirados do local de armazenamento de configuração do cluster.

As definições relacionadas a essas propriedades são as seguintes:

Configuração	Local de configuração do XML	Definição atribuída quando...
Função de gerenciamento de cluster	O atributo `leadHostManagement` do elemento `partitionStoreConnectionSettings`, um filho do elemento `advancedProperties`. Os valores são `true` para os hosts principais ou `false` para SQL Server. Se as definições de configuração do cluster forem armazenadas em uma pasta compartilhada, o único valor válido será `true`.	A função de gerenciamento de cluster é atribuída no momento da configuração, dependendo de onde você armazena as definições de configuração do cluster. Para obter mais informações, consulte Hosts principais e gerenciamento de cluster (cache do Windows Server AppFabric).
Propriedades de Segurança	As propriedades de segurança do cluster de cache são definidas no nó `securityProperties` do elemento `advancedProperties`. O atributo `mode` pode ser definido como `None` ou `Transport`. O atributo `protectionLevel` pode ser definido como um dos seguintes valores: `None`, `Sign` ou `EncryptAndSign`.	Os valores padrão para o cluster são modo `Transport` e nível de proteção `EncryptAndSign`. Se o nó `securityProperties` não for fornecido ou se qualquer um dos atributos não existir, os valores padrão serão aplicados. As propriedades de segurança podem ser alteradas com o comando `Set-CacheClusterSecurity` do Windows PowerShell.

Consulte também

Conceitos

Editar definições de configuração de cluster (Cache do Windows Server AppFabric)
Opções de armazenamento de configuração de cluster (Cache do Windows Server AppFabric)
Usando o Windows PowerShell para gerenciar os recursos de cache do Windows Server AppFabric
Definições de configuração do aplicativo (Cache do Windows Server AppFabric)
Configurando o cluster de cache (cache do Windows Server AppFabric)
Conceitos de cache do Windows Server AppFabric
Desenvolvendo um cliente de cache (cache do Windows Server AppFabric)

2011-12-05

Compartilhar via