Résoudre les problèmes liés au cache connecté Microsoft avec Configuration Manager
Cet article fournit des détails techniques sur Microsoft Connected Cache avec 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 Cache connecté Microsoft avec Configuration Manager.
Vérifier
Lorsque vous installez correctement le serveur de cache d’optimisation de la distribution et que vous configurez correctement les clients, ceux-ci sont téléchargés à partir du serveur de cache installé sur votre point de distribution plutôt qu’à partir d’Internet.
Vérifiez ce comportement sur un client ou sur le serveur.
Vérifier sur un client
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.
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.
Ouvrez une fenêtre PowerShell 64 bits en tant qu’administrateur.
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 etDistMgr.log
sur le serveur de siteJournaux 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 jeu de pourcentage de taille de lecteur de cache valide 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 :
- Ouvrez le Gestionnaire de services Internet.
- Sélectionnez Batteries de serveurs.
- Sélectionnez une batterie de serveurs et l’icône de proxy.
- Sous En-têtes personnalisés, remplacez la valeur
X-Forwarded-For
parX-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.