Résoudre les problèmes Microsoft cache connecté dans Configuration Manager

  • Article

Cet article fournit des détails techniques sur Microsoft cache connecté dans Configuration Manager. Utilisez-la pour résoudre les problèmes que vous pouvez rencontrer dans votre environnement. Pour plus d’informations sur son fonctionnement et son utilisation, consultez Microsoft Cache connecté dans Configuration Manager.

Vérifier

Lorsque vous installez correctement le serveur de cache d’optimisation de la distribution et que vous configurez correctement les clients, ils téléchargent à partir du serveur de cache installé sur votre point de distribution plutôt que sur Internet.

Vérifiez ce comportement sur un client ou sur le serveur.

Vérifier sur un client

  1. Sur un client exécutant une version prise en charge de Windows 10 ou une version ultérieure, téléchargez du contenu géré dans le cloud. Pour plus d’informations sur les types de contenu pris en charge par le cache connecté, consultez Types de contenu pris en charge.

  2. Ouvrez PowerShell et exécutez la commande suivante : Get-DeliveryOptimizationStatus.

    Par exemple :

    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

Notez que l’attribut BytesFromCacheServer n’est pas égal à zéro.

Si le client n’est pas configuré correctement ou si le serveur de cache n’est pas installé correctement, le client d’optimisation de la distribution revient à la source cloud d’origine. L’attribut BytesFromCacheServer sera alors égal à zéro.

Vérifier sur le serveur

Tout d’abord, vérifiez que les propriétés du Registre sont correctement configurées : HKLM\SOFTWARE\Microsoft\Delivery Optimization In-Network Cache. Par exemple, l’emplacement du cache de lecteur est PrimaryDrivesInput\DOINC-E77D08D0-5FEA-4315-8C95-10D359D59294, où PrimaryDrivesInput peut être plusieurs lecteurs, tels que C,D,E.

Ensuite, utilisez la méthode suivante pour simuler une demande de téléchargement du client sur le serveur avec les en-têtes obligatoires.

  1. Ouvrez une fenêtre PowerShell 64 bits en tant qu’administrateur.

  2. Exécutez la commande suivante et remplacez le nom ou l’adresse IP de votre serveur pour <DoincServer>:

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

    La sortie ressemble à l’exemple suivant :

    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

    Les attributs suivants indiquent la réussite :

    • StatusCode : 200
    • StatusDescription : OK

Fichiers journaux

  • Journal d’installation du routage des demandes d’application (ARR) : %temp%\arr_setup.log

  • Journal d’installation du serveur de cache connecté : SMS_DP$\Ms.Dsp.Do.Inc.Setup\DoincSetup.log sur le point de distribution et DistMgr.log sur le serveur de site

  • Journaux des opérations IIS (Internet Information Services) : Par défaut, %SystemDrive%\inetpub\logs\LogFiles

  • Journal des opérations du serveur de cache connecté : C:\Doinc\Product\Install\Logs

    Conseil

    Entre autres utilisations, ce journal peut vous aider à identifier les problèmes de connectivité avec le cloud Microsoft.

Codes d’erreur d’installation

Lorsque Configuration Manager installe le composant Cache connecté sur le point de distribution, le tableau suivant répertorie les codes d’erreur possibles qui peuvent se produire :

Code d'erreur Description de l’erreur
0x00000000 Opération réussie
0x00000BC2 Réussite, redémarrage requis
0x00000643 Échec de l’installation générique
0x00D00001 L’installation du cache connecté ne peut être exécutée que si Internet Information Services (IIS) a été installé
0x00D00002 La configuration du cache connecté ne peut être exécutée que si un « site web par défaut » existe sur le serveur
0x00D00003 Vous ne pouvez pas installer le cache connecté si le routage des demandes d’application (ARR) est déjà installé
0x00D00004 La configuration du cache connecté ne peut être exécutée que si le routage des demandes d’application (ARR) a été installé par le script Install.ps1
0x00D00005 La configuration du cache connecté nécessite une session PowerShell exécutée en tant qu’administrateur
0x00D00006 La configuration du cache connecté ne peut être exécutée qu’à partir d’un environnement PowerShell 64 bits
0x00D00007 La configuration du cache connecté ne peut être exécutée que sur un serveur Windows Server
0x00D00008 Échec : le nombre de lecteurs de cache spécifié doit correspondre au nombre de pourcentages de taille de lecteur de cache spécifiés
0x00D00009 Échec : un ID de nœud de cache valide doit être fourni
0x00D0000A Échec : un ensemble de lecteurs de cache valide doit être fourni
0x00D0000B Échec : un pourcentage de taille de lecteur de cache valide doit être fourni
0x00D0000C Échec : Un jeu de pourcentage de taille de lecteur de cache valide ou une taille de lecteur de cache en Go doit être fournie
0x00D0000D Échec : Un pourcentage de taille de lecteur de cache valide défini et une taille de lecteur de cache en Go ne peuvent pas être fournis à la fois
0x00D0000E Échec : le nombre de lecteurs de cache spécifié doit correspondre au nombre de lecteurs de cache en Go spécifiés
0x00D0000F Échec : Impossible de sauvegarder le fichier applicationhost.config de $AppHostConfig vers $AppHostConfigDestinationName
0x00D00010 Échec : Impossible de sauvegarder le fichier de web.config site web par défaut de $WebsiteConfigFilePath vers $WebConfigDestinationName
0x00D00011 Échec : une exception s’est produite dans SetupARRWebFarm.ps1
0x00D00012 Échec : une exception s’est produite dans SetupARRWebFarmRewriteRules.ps1
0x00D00013 Échec : une exception s’est produite dans SetupARRWebFarmProperties.ps1
0x00D00014 Échec : une exception s’est produite dans SetupAllowableServerVariables.ps1
0x00D00015 Échec : une exception s’est produite dans SetupFirewallRules.ps1
0x00D00016 Échec : une exception s’est produite dans SetupAppPoolProperties.ps1
0x00D00017 Échec : une exception s’est produite dans SetupARROutboundRules.ps1
0x00D00018 Échec : une exception s’est produite dans SetupARRDiskCache.ps1
0x00D00019 Échec : une exception s’est produite dans SetupARRProperties.ps1
0x00D0001A Échec : une exception s’est produite dans SetupARRHealthProbes.ps1
0x00D0001B Échec : une exception s’est produite dans VerifyIISSItesStarted.ps1
0x00D0001C Échec : une exception s’est produite dans SetDrivesToHealthy.ps1
0x00D0001D Échec : une exception s’est produite dans VerifyCacheNodeSetup.ps1
0x00D0001E Vous ne pouvez pas installer le cache connecté si le site web par défaut n’est pas sur le port 80
0x00D0001F Échec : l’allocation de lecteur de cache en pourcentage ne peut pas dépasser 100
0x00D00020 Échec : l’allocation de lecteur de cache en Go ne peut pas dépasser l’espace libre du lecteur
0x00D00021 Échec : l’allocation de lecteur de cache en pourcentage doit être supérieure à 0
0x00D00022 Échec : l’allocation de lecteur de cache en Go doit être supérieure à 0
0x00D00023 Échec : une exception s’est produite dans RegisterScheduledTask_CacheNodeKeepAlive
0x00D00024 Échec : une exception s’est produite dans RegisterScheduledTask_Maintenance
0x00D00025 Échec : une exception s’est produite lors de la configuration des règles de réécriture pour la batterie de serveurs HTTPS : $FarmName
0x00D00026 Échec : une exception s’est produite lors de la configuration des règles de réécriture pour la batterie de serveurs HTTP : $FarmName
0x00D00027 Vous ne pouvez pas installer le cache connecté, car l’installation du logiciel dépendant « Routage des demandes d’application (ARR) » a échoué. Consultez le fichier journal situé dans %temp%\arr_setup.log

Configurations IIS

L’installation du serveur de cache connecté apporte plusieurs modifications à la configuration IIS sur le point de distribution.

Routage des demandes d’application

Le serveur de cache connecté installe et configure le routage des demandes d’application IIS. Pour éviter les conflits potentiels, ce composant ne peut pas déjà être installé sur le point de distribution.

Variables de serveur autorisées

Après avoir installé le serveur de cache connecté, le site web par défaut contient les variables de serveur local suivantes :

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

Règles de réécriture

Le serveur de cache connecté ajoute les règles de réécriture suivantes :

Règles de réécriture entrante

  • 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

Règles de réécriture de trafic sortant

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

En-têtes personnalisés IIS

Si les demandes avec X-Forwarded-For des en-têtes sont bloquées sur un serveur proxy, autorisez l’en-tête sur le serveur proxy ou modifiez le nom d’en-tête personnalisé dans IIS pour chaque batterie de serveurs.

Pour modifier le nom d’en-tête personnalisé pour chaque batterie de serveurs :

  1. Ouvrez le Gestionnaire de services Internet.
  2. Sélectionnez Batteries de serveurs.
  3. Sélectionnez une batterie de serveurs et l’icône de proxy.
  4. Sous En-têtes personnalisés, remplacez la valeur X-Forwarded-For par X-Forwarded-For-<custom-name>.

Gérer les ressources du serveur

L’espace disque requis pour chaque serveur de cache connecté peut varier en fonction des exigences de mise à jour de votre organisation. L’espace disque de 100 Go doit être suffisant pour mettre en cache le contenu suivant :

  • Une mise à jour des fonctionnalités
  • Deux à trois mois de mises à jour qualité et Microsoft 365 Apps
  • applications Microsoft Intune et applications de boîte de réception Windows

Le serveur de cache connecté ne doit pas consommer beaucoup de mémoire système ou de temps processeur. Après avoir installé le serveur de cache connecté, si vous remarquez une consommation importante de ressources de processus ou de mémoire, analysez les fichiers journaux IIS et ARR.

Si les fichiers journaux IIS et ARR occupent trop d’espace sur le serveur, vous pouvez utiliser plusieurs méthodes pour gérer les fichiers journaux. Pour plus d’informations, consultez Gestion du stockage de fichiers journaux IIS.

Voir aussi

Microsoft le cache connecté dans Configuration Manager