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

  • Artigo

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