Résoudre les problèmes liés à Microsoft Connected Cache dans Configuration ManagerTroubleshoot Microsoft Connected Cache in Configuration Manager

Cet article fournit des détails techniques concernant Microsoft Connected Cache dans Configuration Manager.This article provides technical details about Microsoft Connected Cache in Configuration Manager. Servez-vous-en pour résoudre les problèmes que vous pouvez rencontrer dans votre environnement.Use it to help troubleshoot issues that you may have in your environment. Pour plus d’informations sur son fonctionnement et la manière de l’utiliser, consultez Microsoft Connected Cache dans Configuration Manager.For more information on how it works and how to use it, see Microsoft Connected Cache in Configuration Manager.

Notes

Depuis la version 1910, cette fonctionnalité s’appelle Microsoft Connected Cache.Starting in version 1910, this feature is now called Microsoft Connected Cache. Avant, elle portait le nom de « cache en réseau d’optimisation de la livraison ».It was previously known as Delivery Optimization In-Network Cache.

VérifierVerify

Lorsque vous installez correctement le serveur de cache d’optimisation de la distribution et que vous configurez correctement des clients, ces derniers sont téléchargés à partir du serveur de cache installé sur votre point de distribution et non d’Internet.When you correctly install the Delivery Optimization cache server, and correctly configure clients, they download from the cache server installed on your distribution point rather than the internet.

Vérifiez ce comportement sur un client ou sur le serveur.Verify this behavior on a client or on the server.

Vérifier sur un clientVerify on a client

  1. Sur un client exécutant Windows 10 version 1809 ou ultérieure, téléchargez du contenu géré par le cloud.On client running Windows 10, version 1809 or later, download cloud-managed content. Pour plus d’informations sur les types de contenu pris en charge par Connected Cache, consultez Vérifier Connected Cache.For more information on the types of content that Connected Cache supports, see Verify Connected Cache.

  2. Ouvrez PowerShell et exécutez la commande suivante : Get-DeliveryOptimizationStatusOpen PowerShell and run the following command: Get-DeliveryOptimizationStatus

Par exemple :For example:

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.Notice that the BytesFromCacheServer attribute isn't zero.

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.If the client isn't configured correctly, or the cache server isn't installed correctly, the Delivery Optimization client falls back to the original cloud source. L’attribut BytesFromCacheServer est alors égal à zéro.Then the BytesFromCacheServer attribute will be zero.

Vérifier sur le serveurVerify on the server

Commencez par vérifier que les propriétés du Registre sont correctement configurées : HKLM\SOFTWARE\Microsoft\Delivery Optimization In-Network Cache.First, verify the registry properties are configured correctly: HKLM\SOFTWARE\Microsoft\Delivery Optimization In-Network Cache. Par exemple, l’emplacement du cache du lecteur est PrimaryDrivesInput\DOINC-E77D08D0-5FEA-4315-8C95-10D359D59294, où PrimaryDrivesInput peut correspondre à plusieurs lecteurs tels que C,D,E.For example, the drive cache location is PrimaryDrivesInput\DOINC-E77D08D0-5FEA-4315-8C95-10D359D59294, where PrimaryDrivesInput can be multiple drives such as C,D,E.

Utilisez ensuite la méthode ci-après pour simuler une demande de téléchargement du client sur le serveur avec les en-têtes obligatoires.Next, use the following method to simulate a client download request to the server with the mandatory headers.

  1. Ouvrez une fenêtre PowerShell 64 bits en tant qu’administrateur.Open a 64-bit PowerShell window as an administrator.
  2. Exécutez la commande suivante et remplacez le nom ou l’adresse IP de votre serveur pour <DoincServer> :Run the following command, and replace the name or IP address of your server for <DoincServer>:
Invoke-WebRequest -URI "http://<DoincServer>/mscomtest/wuidt.gif" -Headers @{"Host"="b1.download.windowsupdate.com"}

La sortie doit ressembler à celle-ci :The output looks similar to the following example:

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 :The following attributes indicate success:

  • StatusCode : 200
  • StatusDescription : OK

Fichiers journauxLog files

  • Journal d’installation d’ARR : %temp%\arr_setup.logARR setup log: %temp%\arr_setup.log

  • Journal d’installation du serveur de cache d’optimisation de la distribution : SMS_DP$\Ms.Dsp.Do.Inc.Setup\DoincSetup.log sur le point de distribution et DistMgr.log sur le serveur de siteDO cache server setup log: SMS_DP$\Ms.Dsp.Do.Inc.Setup\DoincSetup.log on the distribution point, and DistMgr.log on the site server

  • Journaux des opérations IIS : Par défaut, %SystemDrive%\inetpub\logs\LogFilesIIS operational logs: By default, %SystemDrive%\inetpub\logs\LogFiles

  • Journal des opérations du serveur de cache d’optimisation de la distribution : C:\Doinc\Product\Install\LogsDO cache server operational log: C:\Doinc\Product\Install\Logs

    Conseil

    Entre autres utilisations, ce journal peut vous aider à identifier les problèmes de connectivité avec le cloud Microsoft.Among other uses, this log can help you identify connectivity issues with the Microsoft cloud.

Codes d’erreur du programme d’installationSetup error codes

Quand Configuration Manager installe le composant Connected Cache sur le point de distribution, le tableau suivant liste les codes d’erreur qui peuvent se produire :When Configuration Manager installs the Connected Cache component on the distribution point, the following table lists the possible error codes that might occur:

Code d'erreurError code Description de l’erreurError description
0x000000000x00000000 Opération réussieSuccess
0x00000BC20x00000BC2 Opération réussie, redémarrage nécessaireSuccess, reboot required
0x000006430x00000643 Échec d’installation génériqueGeneric install failure
0x00D000010x00D00001 L’installation de Connected Cache ne peut être exécutée que si Internet Information Services (IIS) a été installéConnected Cache setup can only be run if Internet Information Services (IIS) has been installed
0x00D000020x00D00002 L’installation de Connected Cache ne peut être exécutée que si un « site web par défaut » existe sur le serveurConnected Cache setup can only be run if a 'Default Web Site' exists on the server
0x00D000030x00D00003 Vous ne pouvez pas installer Connected Cache si Application Request Routing (ARR) est déjà installéYou can't install Connected Cache if Application Request Routing (ARR) is already installed
0x00D000040x00D00004 L’installation de Connected Cache ne peut être exécutée que si Application Request Routing (ARR) a été installé par le script Install.ps1Connected Cache setup can only be run if Application Request Routing (ARR) was installed by the Install.ps1 script
0x00D000050x00D00005 L’installation de Connected Cache nécessite l’exécution d’une session PowerShell en tant qu’administrateurConnected Cache setup requires a PowerShell session running as Administrator
0x00D000060x00D00006 L’installation de Connected Cache ne peut être exécutée qu’à partir d’un environnement PowerShell 64 bitsConnected Cache setup can only be run from a 64-bit PowerShell environment
0x00D000070x00D00007 L’installation de Connected Cache ne peut être exécutée que sur un serveur WindowsConnected Cache setup can only be run on a Windows Server
0x00D000080x00D00008 Échec : Le nombre de lecteurs de cache spécifié doit correspondre au nombre de pourcentages de taille de lecteur de cache spécifiéFailure: The number of cache drives specified must match the number of cache drive size percentages specified
0x00D000090x00D00009 Échec : Un ID de nœud de cache valide doit être fourniFailure: A valid cache node ID must be supplied
0x00D0000A0x00D0000A Échec : Un jeu de lecteurs de cache valide doit être fourniFailure: A valid cache drive set must be supplied
0x00D0000B0x00D0000B Échec : Un jeu de pourcentages de taille de lecteur de cache valide doit être fourniFailure: A valid cache drive size percent set must be supplied
0x00D0000C0x00D0000C Échec : Un jeu de pourcentages de taille de lecteur de cache ou une taille de lecteur de cache en Go valide doit être fourniFailure: A valid cache drive size percent set or cache drive size in GB must be supplied
0x00D0000D0x00D0000D Échec : Un jeu de pourcentages de taille de lecteur de cache et une taille de lecteur de cache en Go ne peuvent pas être fournis tous les deuxFailure: A valid cache drive size percent set and cache drive size in GB cannot both be supplied
0x00D0000E0x00D0000E Échec : Le nombre de lecteurs de cache spécifié doit correspondre au nombre de tailles de lecteur de cache en Go spécifiéFailure: The number of cache drives specified must match the number of cache drive size in GB specified
0x00D0000F0x00D0000F Échec : Impossible de sauvegarder le fichier applicationhost.config de $AppHostConfig vers $AppHostConfigDestinationNameFailure: Couldn't back up the applicationhost.config file from $AppHostConfig to $AppHostConfigDestinationName
0x00D000100x00D00010 Échec : Impossible de sauvegarder le fichier web.config du site web par défaut de $WebsiteConfigFilePath vers $WebConfigDestinationNameFailure: Couldn't back up the Default Web Site web.config file from $WebsiteConfigFilePath to $WebConfigDestinationName
0x00D000110x00D00011 Échec : Une exception s’est produite dans SetupARRWebFarm.ps1Failure: An exception occurred in SetupARRWebFarm.ps1
0x00D000120x00D00012 Échec : Une exception s’est produite dans SetupARRWebFarmRewriteRules.ps1Failure: An exception occurred in SetupARRWebFarmRewriteRules.ps1
0x00D000130x00D00013 Échec : Une exception s’est produite dans SetupARRWebFarmProperties.ps1Failure: An exception occurred in SetupARRWebFarmProperties.ps1
0x00D000140x00D00014 Échec : Une exception s’est produite dans SetupAllowableServerVariables.ps1Failure: An exception occurred in SetupAllowableServerVariables.ps1
0x00D000150x00D00015 Échec : Une exception s’est produite dans SetupFirewallRules.ps1Failure: An exception occurred in SetupFirewallRules.ps1
0x00D000160x00D00016 Échec : Une exception s’est produite dans SetupAppPoolProperties.ps1Failure: An exception occurred in SetupAppPoolProperties.ps1
0x00D000170x00D00017 Échec : Une exception s’est produite dans SetupARROutboundRules.ps1Failure: An exception occurred in SetupARROutboundRules.ps1
0x00D000180x00D00018 Échec : Une exception s’est produite dans SetupARRDiskCache.ps1Failure: An exception occurred in SetupARRDiskCache.ps1
0x00D000190x00D00019 Échec : Une exception s’est produite dans SetupARRProperties.ps1Failure: An exception occurred in SetupARRProperties.ps1
0x00D0001A0x00D0001A Échec : Une exception s’est produite dans SetupARRHealthProbes.ps1Failure: An exception occurred in SetupARRHealthProbes.ps1
0x00D0001B0x00D0001B Échec : Une exception s’est produite dans VerifyIISSItesStarted.ps1Failure: An exception occurred in VerifyIISSItesStarted.ps1
0x00D0001C0x00D0001C Échec : Une exception s’est produite dans SetDrivesToHealthy.ps1Failure: An exception occurred in SetDrivesToHealthy.ps1
0x00D0001D0x00D0001D Échec : Une exception s’est produite dans VerifyCacheNodeSetup.ps1Failure: An exception occurred in VerifyCacheNodeSetup.ps1
0x00D0001E0x00D0001E Vous ne pouvez pas installer Connected Cache si le site web par défaut n’est pas sur le port 80You can't install Connected Cache if the Default Web Site isn't on port 80
0x00D0001F0x00D0001F Échec : L’allocation du lecteur de cache en pourcentage ne peut pas dépasser 100Failure: The cache drive allocation in percentage can't exceed 100
0x00D000200x00D00020 Échec : L’allocation du lecteur de cache en Go ne peut pas dépasser l’espace libre du lecteurFailure: The cache drive allocation in GB cannot exceed the drive's free space
0x00D000210x00D00021 Échec : L’allocation du lecteur de cache en pourcentage doit être supérieure à 0Failure: The cache drive allocation in percentage must be greater than 0
0x00D000220x00D00022 Échec : L’allocation du lecteur de cache en Go doit être supérieure à 0Failure: The cache drive allocation in GB must be greater than 0
0x00D000230x00D00023 Échec : Une exception s’est produite dans RegisterScheduledTask_CacheNodeKeepAliveFailure: An exception occurred in RegisterScheduledTask_CacheNodeKeepAlive
0x00D000240x00D00024 Échec : Une exception s’est produite dans RegisterScheduledTask_MaintenanceFailure: An exception occurred in RegisterScheduledTask_Maintenance
0x00D000250x00D00025 Échec : Une exception s’est produite lors de la configuration des règles de réécriture pour la batterie de serveurs HTTPS : $FarmNameFailure: An exception occurred setting up the rewrite rules for HTTPS farm: $FarmName
0x00D000260x00D00026 Échec : Une exception s’est produite lors de la configuration des règles de réécriture pour la batterie de serveurs HTTP : $FarmNameFailure: An exception occurred setting up the rewrite rules for HTTP farm: $FarmName
0x00D000270x00D00027 Vous ne pouvez pas installer Connected Cache, car l’installation du logiciel dépendant « Application Request Routing (ARR) » a échoué.You can't install Connected Cache because dependent software "Application Request Routing (ARR)" failed to install. Consultez le fichier journal à l’emplacement %temp%\arr_setup.logSee the log file located at %temp%\arr_setup.log

Configurations IISIIS configurations

L’installation du serveur de cache d’optimisation de la distribution apporte plusieurs modifications à la configuration IIS sur le point de distribution.The DO cache server install makes several modifications to the IIS configuration on the distribution point.

Routage des demandes d’applicationApplication request routing

Le serveur de cache d’optimisation de la distribution installe et configure le composant IIS Application Request Routing (ARR).The DO cache server installs and configures IIS Application Request Routing (ARR). Pour éviter les conflits potentiels, ce composant ne peut pas être déjà installé sur le point de distribution.To avoid potential conflicts, the distribution point can't already have this component installed.

Variables serveur autoriséesAllowed server variables

Une fois que vous avez installé le serveur de cache d’optimisation de la distribution, le site web par défaut a les variables serveur locales suivantes :After you install the DO cache server, the default web site has the following local server variables:

  • HTTP_HOSTHTTP_HOST
  • QUERY_STRINGQUERY_STRING
  • X-CCCX-CCC
  • X-CIDX-CID
  • X-DOINC-OUTBOUNDX-DOINC-OUTBOUND

Règles de réécritureRewrite rules

Le serveur de cache d’optimisation de la distribution ajoute les règles de réécriture suivantes :The DO cache server adds the following rewrite rules:

Règles de réécriture entrantesInbound rewrite rules

  • 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 sortantesOutbound rewrite rules

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

Gérer les ressources serveurManage server resources

L’espace disque nécessaire pour chaque serveur de cache d’optimisation de la distribution peut varier en fonction des exigences de mise à jour de votre organisation.Disk space required for each DO cache server may vary, based on your organization's update requirements. Un espace de 100 Go doit suffire pour mettre en cache le contenu suivant :100 GB should be enough space to cache the following content:

  • Une mise à jour des fonctionnalitésA feature update
  • Deux à trois mois de mises à jour de qualité et de Microsoft 365 AppsTwo to three months of quality and Microsoft 365 Apps updates
  • Applications Microsoft Intune et applications fournies avec WindowsMicrosoft Intune apps and Windows inbox apps

Le serveur de cache d’optimisation de la distribution ne doit pas consommer beaucoup de mémoire système ou de temps processeur.The DO cache server shouldn't consume much system memory or processor time. Si, après avoir installé le serveur de cache d’optimisation de la distribution, vous constatez une consommation importante des ressources de mémoire ou de traitement, analysez les fichiers journaux IIS et ARR.After you install the DO cache server, if you notice significant process or memory resource consumption, analyze the IIS and ARR log files.

Si les fichiers journaux IIS et ARR prennent trop de place sur le serveur, vous pouvez utiliser plusieurs méthodes pour gérer les fichiers journaux.If the IIS and ARR log files take up too much space on the server, there are several methods you can use to manage the log files. Pour plus d’informations, consultez Gestion du stockage des fichiers journaux IIS.For more information, see Managing IIS Log File Storage.

Voir aussiSee also

Microsoft Connected Cache dans Configuration ManagerMicrosoft Connected Cache in Configuration Manager