OS X Server (Mountain Lion): configuração avançada do serviço de cache

Se tiver o OS X Server (Mountain Lion), continue lendo para saber mais sobre as configurações avançadas que podem ser utilizadas com o serviço de cache.

Se você tiver o OS X Server (Mavericks), consulte a seção "Como configurar ajustes avançados do cache" do Guia de Administração Avançada do OS X Server para saber mais sobre os ajustes avançados do serviço de cache.

Para mais informações sobre o serviço de cache, execute o app Server e escolha Ajuda do Server no menu Ajuda.


É possível especificar ajustes de configuração avançada para o serviço de cache com a linha de comando ou com a edição de /Biblioteca/Server/Caching/Config/Config.plist. A seguir, temos as chaves e a descrição dos valores.

Nota: os ajustes do arquivo config.plist não definidos a seguir não devem ser alterados.

Chave Padrão Descrição
CacheLimit 0 (ilimitado) O número máximo de bytes de espaço em disco que será usado para armazenar ativos em cache. Pode ser definido a partir do app Server.
DataPath /Biblioteca/Server/Caching/Data O caminho até o diretório usado para armazenar ativos em cache. Pode ser definido a partir do app Server.
Interface Escutar em todas as interfaces O nome de BSD de uma interface de rede que deve ser usado com o serviço de cache.
ListenRanges Nenhum Um conjunto de dicionários usado para definir quais clientes de cache serão preferidos pelos clientes de uma determinada rede. Explicamos mais detalhes a seguir.
ListenRangesOnly Falso Se ListenRangesOnly estiver definido como verdadeiro, o servidor fornecerá ativos apenas a clientes que estejam dentro dos limites especificados pela chave ListenRanges. Para usar a chave ListenRangesOnly, é necessário especificar a chave ListenRanges.
LogLevel informação O nível de detalhamento usado ao fazer registros. É possível defini-lo das seguintes formas:
  • desativado
  • erro
  • aviso
  • informação
  • detalhado
Nota: o nível de registro deve ser mantido com a configuração padrão em sistemas de produção. Aumentá-lo pode gerar uma penalização de desempenho. Se você aumentar o nível de registro acima do padrão, o registro adicional será salvo em /Biblioteca/Server/Caching/Logs/Debug.log, e não será exibido no app Server na seção Registros.
MaxConcurrentClients 0 (permitir clientes ilimitados) O número máximo permitido de solicitações simultâneas ao cliente.
Porta 0 (usar qualquer porta) O número da porta TCP em que o serviço de cache aceita solicitações de download.
ReservedVolumeSpace 25000000000 O número mínimo de bytes de espaço livre em disco que deve ser mantido para o volume que armazena os ativos em cache.

A chave ListenRanges

A chave ListenRanges pode ser usada para especificar os servidores de cache de preferência em topologias de rede avançadas, em que vários servidores de cache são usados com o mesmo endereço IP público. Por exemplo:

  • caching1.example.com usa a chave ListenRanges para especificar um intervalo de 10.0.0.1 até 10.0.0.254 e de 10.1.0.1 até 10.1.0.254.
  • caching2.example.com usa a chave ListenRanges para especificar um intervalo de 10.1.0.1 até 10.1.0.39 (observe a sobreposição com o segundo intervalo de caching1).
  • Se um cliente cujo endereço IP é 10.0.0.10 solicitar um ativo, ele será direcionado para o caching1.
  • Se um cliente cujo endereço IP é 10.1.0.10 solicitar um ativo, ele será direcionado para o chaching1 ou caching2. O servidor será escolhido aleatoriamente.
  • Se um cliente cujo endereço IP é 10.2.0.10 solicitar um ativo, ele será direcionado para o caching1 ou caching2. O servidor será escolhido aleatoriamente.
  • Se chaching1 for desligado ou passar por um corte de energia, mas caching2 continuar disponível, todos os clientes serão direcionados para caching2.

Definir valores para uma chave

Para definir uma chave com um valor simples, é possível usar serveradmin(8). Por exemplo, para definir a chave de interface como en1, é necessário executar este comando como administrador:

sudo serveradmin settings caching:Interface = en1

A chave ListenRanges tem um valor complexo, por isso é mais fácil editar /Biblioteca/Server/Caching/Config/Config.plist para configurá-la. Antes de editar esse arquivo manualmente, não se esqueça de interromper o serviço de cache e sair do app Server. Quando terminar de editar o arquivo, defina a propriedade do usuário e do grupo como _assetcache antes de iniciar o serviço de cache com este comando:

sudo chown _assetcache:_assetcache /Library/Server/Caching/Config/Config.plist

A seguir, temos um exemplo de arquivo Config.plist.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
 <dict>
   <key>CacheLimit</key>
   <!-- Set a CacheLimit of 200 GB -->
   <integer>200000000000</integer>
   <key>DataPath</key>
   <string>/Volumes/BigDisk/Caching/Data</string>
   <key>Interface</key>
   <string>en1</string>
   <key>ListenRanges</key>
   <array>
     <dict>
       <key>type</key>
       <string>IPv4</string>
       <key>first</key>
       <string>10.0.0.1</string>
       <key>last</key>
       <string>10.0.0.254</string>
     </dict>
     <dict>
       <key>type</key>
       <string>IPv4</string>
       <key>first</key>
       <string>10.1.0.1</string>
       <key>last</key>
       <string>10.1.0.254</string>
     </dict>
   </array>
   <key>ListenRangesOnly</key>
   <true/>
   <key>LogLevel</key>
   <string>info</string>
   <key>MaxConcurrentClients</key>
   <integer>100</integer>
   <key>Port</key>
   <integer>12345</integer>
   <key>ReservedVolumeSpace</key>
   <!-- Set the ReservedVolumeSpace to 1 GB -->
   <integer>1000000000</integer>
 </dict>
</plist>
Data da publicação: