Definições de configuração de host do cache (cache do Windows Server AppFabric)

As configurações de host de cache do Windows Server AppFabric são armazenadas em dois locais: no nível do cluster nas configurações do cluster e no nível do host de cache em cada host de cache individual.

Configurações de host de cache no nível do cluster

As configurações de host de cache, armazenadas no nível do cluster, são relacionadas à maneira que o host de cache funciona como um participante no cluster, por exemplo, o consumo de memória e as configurações da porta de rede para a comunicação. As configurações de cache no nível do cluster são discutidas em Definições de configuração de cluster (Cache do Windows Server AppFabric).

A maior parte das configurações no nível do cluster também estão disponíveis com a ferramenta de administração de cache com base no Windows PowerShell para exibição e edição. Para obter mais informações, consulte Usando o Windows PowerShell para gerenciar os recursos de cache do Windows Server AppFabric.

Configurações de host de cache no nível do host

As configurações de host de cache, armazenadas em cada host de cache, são funcionais e estão relacionadas às configurações necessárias para que o software seja executado. Por exemplo, eles definem o local em que o host de cache pode localizar o armazenamento de configuração e a maneira como os coletores de log podem ser configurados.

Para armazenar as configurações de host de cache, cada host de cache utiliza um arquivo de configuração, denominado DistributedCacheService.exe.config. Esse arquivo é automaticamente criado e configurado durante a instalação e está localizado na pasta .\Windows\System32\AppFabric. As configurações utilizadas nesse arquivo de configuração não devem ser editadas na maioria dos casos. O único momento que esse arquivo pode ser editado é durante a definição do nível do log e durante a alteração do local do log.

Observação

Outras configurações localizadas no arquivo DistributedCacheService.exe.config, que não estão descritas aqui, são usadas pelo AppFabric para operações internas.

Configurações do elemento dataCacheConfig

As configurações no elemento dataCacheConfig são significantes para o host de cache em relação ao cluster de cache. As configurações, como nome de clusters, configuração de cluster, local de armazenamento da configuração de cluster e nome do serviço de hospedagem de cache, podem ser localizadas no elemento dataCacheConfig.

As configurações no elemento dataCacheConfig, descritas na tabela a seguir, também são usadas pela ferramenta de administração do PowerShell durante a utilização do comando Use-CacheCluster sem nenhum parâmetro. Para obter mais informações, consulte Usando o Windows PowerShell para gerenciar os recursos de cache do Windows Server AppFabric.

Configuração Local da configuração XML

Nome do servidor de cache

O atributo hostName do elemento dataCacheConfig.

Cadeia de conexão do local de configuração do cluster

O elemento connectionString do elemento clusterConfig. O elemento clusterConfig é um filho do elemento dataCacheConfig.

Observação

Ao utilizar o banco de dados do SQL Server para armazenar configurações de cluster, a cadeia de conexão do SQL Server é armazenada com texto limpo no arquivo DistributedCacheService.exe.config. Sempre que possível, utilize a segurança integrada do Windows para proteger o banco de dados, para que as senhas não sejam solicitadas em cadeias de conexão.

Exemplo

O exemplo a seguir mostra a aparência do arquivo de configuração do host de cache, DistributedCacheService.exe.config.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <!-- Microsoft.ApplicationServer.Caching.Core assembly name is hard-coded -->
    <section name="dataCacheConfig" type="Microsoft.ApplicationServer.Caching.DataCacheConfigSection, Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
    <section name="fabric" type="Microsoft.Fabric.Common.ConfigFile, Microsoft.WindowsFabric.Common, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" allowLocation="true" allowDefinition="Everywhere" />
    <section name="dataCache" type="Microsoft.ApplicationServer.Caching.DataCacheSection, Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
  </configSections>
  <dataCacheConfig cacheHostName="AppFabricCachingService">
    <log location="" logLevel="-1" />
    <clusterConfig provider="System.Data.SqlClient" connectionString="Data Source=SqlServer1;Initial Catalog=CacheConfigDB;Integrated Security=True" />
  </dataCacheConfig>
  <fabric>
    <section name="param" path="">
      <key name="VersionInfoClass" value="Microsoft.ApplicationServer.Caching.ServerVersionInfo, Microsoft.ApplicationServer.Caching.Server" />
      <key name="DroppedReplicaKeepDuration" value="0" />
      <key name="ClusterStableNodeUpInterval" value="10" />
      <key name="ReplicationQueueCapacity" value="128" />
      <key name="CopyQueueCapacity" value="2" />
      <key name="ReplicationTempListCapacity" value="1024" />
      <key name="ReplicationTempListInitialSize" value="128" />
      <key name="ReplicationRetryInterval" value="12" />
      <key name="ThrowOnAssert" value="true" />
    </section>
  </fabric>
  <dataCache size="Small">
    <hosts>
      <host replicationPort="22236" arbitratorPort="22235" clusterPort="22234" hostId="1739552749" size="1228" leadHost="true" account="NT AUTHORITY\NETWORK SERVICE" name="localhost" cacheHostName="AppFabricCachingService" cachePort="22233" />
    </hosts>
  </dataCache>
  <runtime>
    <gcServer enabled="true" />
  </runtime>
  <startup>
    <supportedRuntime version="v4.0.30125" />
  </startup>
</configuration>

Consulte também

Conceitos

Definições de configuração do aplicativo (Cache do Windows Server AppFabric)
Definições de configuração de cluster (Cache do Windows Server AppFabric)
Solucionando problemas de cache do Windows Server AppFabric
Usando o Windows PowerShell para gerenciar os recursos de 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