Compartilhar via

Resolver problemas da Cache Ligada da Microsoft com o Configuration Manager

  • Artigo

Este artigo fornece detalhes técnicos sobre a Cache Ligada da Microsoft com o Configuration Manager. Utilize-o para ajudar a resolver problemas que possa ter no seu ambiente. Para obter mais informações sobre como funciona e como utilizá-la, veja Microsoft Connected Cache with Configuration Manager (Cache Ligada da Microsoft com o Configuration Manager).

Verify

Quando instala corretamente o servidor de cache da Otimização da Entrega e configura corretamente os clientes, estes são transferidos a partir do servidor de cache instalado no ponto de distribuição em vez da Internet.

Verifique este comportamento num cliente ou no servidor.

Verificar num cliente

  1. Num cliente com uma versão suportada do Windows 10 ou posterior, transfira conteúdo gerido pela cloud. Para obter mais informações sobre os tipos de conteúdo suportados pela Cache Ligada, veja Tipos de conteúdo suportados.

  2. Abra o PowerShell e execute o seguinte comando: Get-DeliveryOptimizationStatus.

    Por exemplo:

    PS C:\> Get-DeliveryOptimizationStatus

FileId                      : ec523d49c4f7c3c4444f0d9b952286ce40fdcee4
FileSize                    : 549064
TotalBytesDownloaded        : 549064
PercentPeerCaching          : 0
BytesFromPeers              : 0
BytesFromHttp               : 0
Status                      : Caching
Priority                    : Background
BytesFromCacheServer        : 549064
BytesFromLanPeers           : 0
BytesFromGroupPeers         : 0
BytesFromInternetPeers      : 0
BytesToLanPeers             : 0
BytesToGroupPeers           : 0
BytesToInternetPeers        : 0
DownloadDuration            : 00:00:00.0780000
HttpConnectionCount         : 2
LanConnectionCount          : 0
GroupConnectionCount        : 0
InternetConnectionCount     : 0
DownloadMode                : 99
SourceURL                   : http://au.download.windowsupdate.com/c/msdownload/update/software/defu/2019/09/am_delta_p
                            atch_1.301.664.0_ec523d49c4f7c3c4444f0d9b952286ce40fdcee4.exe
NumPeers                    : 0
PredefinedCallerApplication : WU Client Download
ExpireOn                    : 9/6/2019 8:36:19 AM
IsPinned                    : False

Repare que o BytesFromCacheServer atributo não é zero.

Se o cliente não estiver configurado corretamente ou o servidor de cache não estiver corretamente instalado, o cliente de Otimização da Entrega reverterá para a origem da cloud original. Em seguida, o BytesFromCacheServer atributo será zero.

Verificar no servidor

Primeiro, verifique se as propriedades do registo estão configuradas corretamente: HKLM\SOFTWARE\Microsoft\Delivery Optimization In-Network Cache. Por exemplo, a localização da cache da unidade é PrimaryDrivesInput\DOINC-E77D08D0-5FEA-4315-8C95-10D359D59294, onde PrimaryDrivesInput podem ser múltiplas unidades, como C,D,E.

Em seguida, utilize o seguinte método para simular um pedido de transferência de cliente para o servidor com os cabeçalhos obrigatórios.

  1. Abra uma janela do PowerShell de 64 bits como administrador.

  2. Execute o seguinte comando e substitua o nome ou endereço IP do servidor para <DoincServer>:

    Invoke-WebRequest -URI "http://<DoincServer>/mscomtest/wuidt.gif" -Headers @{"Host"="b1.download.windowsupdate.com"}

    O resultado é semelhante ao seguinte exemplo:

    PS C:\WINDOWS\system32> Invoke-WebRequest -URI "http://SERVER01.CONTOSO.COM/mscomtest/wuidt.gif" -Headers @{"Host"="b1.download.windowsupdate.com"}


StatusCode        : 200
StatusDescription : OK
Content           : {71, 73, 70, 56...}
RawContent        : HTTP/1.1 200 OK
                    X-HW: 1567797125.dop019.se2.t,1567797125.cds058.se2.s,1567797125.dop114.at2.r,1567797125.cds079.at2
                    .p,1567797125.cds058.se2.p
                    X-CCC: cdP+dRBgUCoZO1mezA9zhg2VwQ7P1JWTh9k+GhfQmu8=_SLwv...
Headers           : {[X-HW, 1567797125.dop019.se2.t,1567797125.cds058.se2.s,1567797125.dop114.at2.r,1567797125.cds079.a
                    t2.p,1567797125.cds058.se2.p], [X-CCC,
                    cdP+dRBgUCoZO1mezA9zhg2VwQ7P1JWTh9k+GhfQmu8=_SLwvtSBQdT3uPQ5ikBe1ABMbdYIIncem+h5dtcLI6GY=],
                    [X-CID, 100], [Accept-Ranges, bytes]...}
RawContentLength  : 969710

    Os seguintes atributos indicam êxito:

    • StatusCode : 200
    • StatusDescription : OK

Arquivos de log

  • Registo de configuração do Encaminhamento de Pedidos de Aplicação (ARR): %temp%\arr_setup.log

  • Registo de configuração do servidor de Cache Ligada: SMS_DP$\Ms.Dsp.Do.Inc.Setup\DoincSetup.log no ponto de distribuição e DistMgr.log no servidor do site

  • Registos operacionais dos Serviços de Informação Internet (IIS): por predefinição, %SystemDrive%\inetpub\logs\LogFiles

  • Registo operacional do servidor de Cache Ligada: C:\Doinc\Product\Install\Logs

    Dica

    Entre outras utilizações, este registo pode ajudá-lo a identificar problemas de conectividade com a Microsoft Cloud.

Configurar códigos de erro

Quando o Configuration Manager instala o componente cache ligada no ponto de distribuição, a tabela seguinte lista os possíveis códigos de erro que podem ocorrer:

Código de erro Descrição de erro
0x00000000 Êxito
0x00000BC2 Com êxito, é necessário reiniciar
0x00000643 Falha de instalação genérica
0x00D00001 A configuração da Cache Ligada só pode ser executada se os Serviços de Informação Internet (IIS) tiverem sido instalados
0x00D00002 A configuração da Cache Ligada só pode ser executada se existir um "Web Site Predefinido" no servidor
0x00D00003 Não pode instalar a Cache Ligada se o Encaminhamento de Pedidos de Aplicação (ARR) já estiver instalado
0x00D00004 A configuração da Cache Ligada só pode ser executada se o Encaminhamento de Pedidos de Aplicação (ARR) tiver sido instalado pelo script Install.ps1
0x00D00005 A configuração da Cache Ligada requer uma sessão do PowerShell em execução como Administrador
0x00D00006 A configuração da Cache Ligada só pode ser executada a partir de um ambiente do PowerShell de 64 bits
0x00D00007 A configuração da Cache Ligada só pode ser executada num Windows Server
0x00D00008 Falha: o número de unidades de cache especificadas tem de corresponder ao número de percentagens de tamanho da unidade de cache especificadas
0x00D00009 Falha: tem de ser fornecido um ID de nó de cache válido
0x00D0000A Falha: tem de ser fornecido um conjunto de unidades de cache válido
0x00D0000B Falha: tem de ser fornecido um conjunto de percentagem de tamanho de unidade de cache válido
0x00D0000C Falha: tem de ser fornecido um conjunto de percentagem de tamanho de unidade de cache válido ou o tamanho da unidade de cache em GB
0x00D0000D Falha: um conjunto de percentagem de tamanho da unidade de cache válido e o tamanho da unidade de cache em GB não podem ser fornecidos
0x00D0000E Falha: o número de unidades de cache especificadas tem de corresponder ao tamanho das unidades de cache em GB especificado
0x00D0000F Falha: não foi possível fazer uma cópia de segurança do ficheiro de applicationhost.config de $AppHostConfig para $AppHostConfigDestinationName
0x00D00010 Falha: não foi possível fazer uma cópia de segurança do ficheiro de web.config de Web Site Predefinido de $WebsiteConfigFilePath para $WebConfigDestinationName
0x00D00011 Falha: ocorreu uma exceção no SetupARRWebFarm.ps1
0x00D00012 Falha: ocorreu uma exceção no SetupARRWebFarmRewriteRules.ps1
0x00D00013 Falha: ocorreu uma exceção no SetupARRWebFarmProperties.ps1
0x00D00014 Falha: ocorreu uma exceção no SetupAllowableServerVariables.ps1
0x00D00015 Falha: ocorreu uma exceção no SetupFirewallRules.ps1
0x00D00016 Falha: ocorreu uma exceção no SetupAppPoolProperties.ps1
0x00D00017 Falha: ocorreu uma exceção no SetupARROutboundRules.ps1
0x00D00018 Falha: ocorreu uma exceção no SetupARRDiskCache.ps1
0x00D00019 Falha: ocorreu uma exceção no SetupARRProperties.ps1
0x00D0001A Falha: ocorreu uma exceção no SetupARRHealthProbes.ps1
0x00D0001B Falha: ocorreu uma exceção no VerifyIISSItesStarted.ps1
0x00D0001C Falha: ocorreu uma exceção no SetDrivesToHealthy.ps1
0x00D0001D Falha: ocorreu uma exceção no VerifyCacheNodeSetup.ps1
0x00D0001E Não pode instalar a Cache Ligada se o Web Site Predefinido não estiver na porta 80
0x00D0001F Falha: a alocação da unidade de cache em percentagem não pode exceder os 100
0x00D00020 Falha: a alocação da unidade de cache em GB não pode exceder o espaço livre da unidade
0x00D00021 Falha: a alocação da unidade de cache em percentagem tem de ser superior a 0
0x00D00022 Falha: a alocação da unidade de cache em GB tem de ser superior a 0
0x00D00023 Falha: ocorreu uma exceção no RegisterScheduledTask_CacheNodeKeepAlive
0x00D00024 Falha: ocorreu uma exceção no RegisterScheduledTask_Maintenance
0x00D00025 Falha: ocorreu uma exceção ao configurar as regras de reescrita para o farm HTTPS: $FarmName
0x00D00026 Falha: ocorreu uma exceção ao configurar as regras de reescrita para o farm HTTP: $FarmName
0x00D00027 Não é possível instalar a Cache Ligada porque o software dependente "Encaminhamento de Pedidos de Aplicação (ARR)" não foi instalado. Veja o ficheiro de registo localizado em %temp%\arr_setup.log

Configurações do IIS

A instalação do servidor de Cache Ligada efetua várias modificações à configuração do IIS no ponto de distribuição.

Encaminhamento de pedidos de aplicação

O servidor de Cache Ligada instala e configura o Encaminhamento de Pedidos de Aplicação do IIS. Para evitar potenciais conflitos, o ponto de distribuição ainda não pode ter este componente instalado.

Variáveis de servidor permitidas

Depois de instalar o servidor de Cache Ligada, o site predefinido tem as seguintes variáveis de servidor local :

  • HTTP_HOST
  • QUERY_STRING
  • X-CCC
  • X-CID
  • X-DOINC-OUTBOUND

Reescrever regras

O servidor de Cache Ligada adiciona as seguintes regras de reescrita:

Regras de reescrita de entrada

  • Doinc_ForwardToFarm_shswda01.download.manage-selfhost.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_swdc01.manage.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_swdc02.manage.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_dl.delivery.mp.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_officecdn.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_b1.download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_officecdn.microsoft.com.edgesuite.net_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_au.b1.download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_assets1.xboxlive.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_au.download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_emdl.ws.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_tlu.dl.delivery.mp.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_assets2.xboxlive.com_E77D08D0-5FEA-4315-8C95-10D359D59294

Regras de reescrita de saída

  • Doinc_Outbound_SetHeader_X_CID_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_Outbound_SetHeader_X_CCC_E77D08D0-5FEA-4315-8C95-10D359D59294

Cabeçalhos personalizados do IIS

Se os pedidos com X-Forwarded-For cabeçalhos estiverem bloqueados num servidor proxy, permita o cabeçalho no servidor proxy ou altere o nome do cabeçalho personalizado no IIS para cada farm de servidores.

Para alterar o nome do cabeçalho personalizado para cada farm de servidores:

  1. Abra o Gerenciador do IIS.
  2. Selecione Farms de Servidores.
  3. Selecione um farm de servidores e o ícone de proxy.
  4. Em Cabeçalhos Personalizados, altere o valor X-Forwarded-For para X-Forwarded-For-<custom-name>.

Gerir recursos do servidor

O espaço em disco necessário para cada servidor de Cache Ligada pode variar consoante os requisitos de atualização da sua organização. O espaço em disco de 100 GB deve ser suficiente para colocar em cache o seguinte conteúdo:

  • Uma atualização de funcionalidades
  • Dois a três meses de qualidade e atualizações do Microsoft 365 Apps
  • Aplicações do Microsoft Intune e aplicações de caixa de entrada do Windows

O servidor de Cache Ligada não deve consumir muita memória do sistema ou tempo do processador. Depois de instalar o servidor de Cache Ligada, se notar um consumo significativo de recursos de memória ou processo, analise os ficheiros de registo do IIS e do ARR.

Se os ficheiros de registo do IIS e do ARR ocuparem demasiado espaço no servidor, existem vários métodos que pode utilizar para gerir os ficheiros de registo. Para obter mais informações, veja Gerir o armazenamento de ficheiros de registo do IIS.

Confira também

Cache Ligada da Microsoft com o Configuration Manager