Configurer le cache d’homologue pour les clients Configuration Manager

Article
12/05/2023

S’applique à : Microsoft Endpoint Configuration Manager (current Branch)

Le cache d’homologue est une solution intégrée pour Microsoft Endpoint Configuration Manager qui permet aux clients de partager du contenu avec d’autres clients directement à partir de leur cache local. Il étend les solutions de déploiement de contenu traditionnelles, telles que les points de distribution. Utilisez le cache d’homologue pour gérer le déploiement de contenu sur les clients dans des emplacements distants. Pour plus d’informations, consultez Cache d’homologue pour les clients Configuration Manager.

Configurer les paramètres du client du cache d’homologue

Pour permettre aux clients d’être des sources de cache d’homologue, procédez comme suit :

Dans la console Configuration Manager, créez un regroupement d’appareils. Déterminez les clients que vous souhaitez activer en tant que sources de cache d’homologues et ajoutez-les à la collection.
Accédez à l’espace de travail Administration , puis sélectionnez le nœud Paramètres client .
Sélectionnez Créer des paramètres d’appareil client personnalisés, spécifiez un nom et une description, puis sélectionnez le groupe Paramètres du cache du client .
Dans le volet de navigation, sélectionnez Paramètres du cache du client, définissez Activer comme source de cache d’homologue sur Oui, puis spécifiez les ports.
Sélectionnez OK pour enregistrer les paramètres.
Déployez ce paramètre client personnalisé sur le regroupement d’appareils que vous avez créé à l’étape 1.

Vous n’avez pas besoin d’activer les clients de cache d’homologue. Lorsque vous autorisez les clients à être des sources de cache d’homologue, le point de gestion les inclut dans la liste des sources d’emplacement de contenu.

Modifications sur les clients qui jouent le rôle de sources de cache d’homologue

Lorsque le paramètre de cache client est déployé sur le regroupement d’appareils, les modifications suivantes s’affichent sur les sources de cache d’homologue :

Dans la classe WMI, instance CCM_SuperPeerClientConfig.SiteSettingsKey=1 sous ROOT\ccm\Policy\Machine\ActualConfig:

La valeur de la propriété CanBeSuperPeer est remplacée par True.

Les entrées suivantes sont enregistrées CcmExec.log :

Notifying endpoint 'SuperPeerController' of 1 settings change(s).
Notifying endpoint 'SuperPeerController' of __InstanceModificationEvent settings change on object CCM_SuperPeerClientConfig.SiteSettingsKey=1 for user 'SID'.

Les entrées suivantes sont enregistrées CAS.log :

SuperPeerController main thread has started.
SuperPeerController has started

Un message d’état de type rubrique 7201 est généré. Les entrées suivantes sont enregistrées StateMessage.log :

Adding message with TopicType 7201 and TopicId Super Peer is now active to WMI
State message(State ID : 2) with TopicType 7201 and TopicId Super Peer is now active has been recorded for SYSTEM

Modification sur le point de gestion

Le message d’état est au format XML, puis envoyé au point de gestion (MP_RelayEndpoint) via CCMMessaging.

L’entrée suivante s’affiche dans le fichier MP_Relay.log :

Message Body :
<?xml version="1.0" encoding="UTF-16"?>
<Report><ReportHeader><Identification><Machine><ClientInstalled>1</ClientInstalled><ClientType>1</ClientType><ClientID>GUID:xxxx</ClientID><ClientVersion>5.00.9040.1015</ClientVersion><NetBIOSName>TestClient</NetBIOSName><CodePage>437</CodePage><SystemDefaultLCID>1033</SystemDefaultLCID><Priority>1</Priority></Machine></Identification></ReportDetails></ReportHeader><ReportBody><Topic ID="Super Peer is now active" Type="7201" IDType="0" User="" UserSID=""/><State ID="2"Criticality="0"/><StateDetails Type="1"><![CDATA[<ContentList><Content id="CAS00015" version="1" Flag="0"/></ContentList>]]></StateDetails><UserParameters Flags="0" Count="1"><Param>8003</Param></UserParameters></StateMessage></ReportBody></Report>

Lorsque le serveur de site reçoit le message d’état, il appelle la spUpdateSuperPeerStatus procédure stockée pour mettre à jour les tables suivantes :

SuperPeers
SuperPeerContentMap

Configurer les options de groupe de limites pour les téléchargements d’homologues

Dans la console Configuration Manager, accédez à l’espace de travail Administration, puis sélectionnezGroupes de limitesde configuration> de hiérarchie.
Recherchez le groupe de limites qui contient les clients de cache d’homologues et les sources de cache d’homologue.
Cliquez avec le bouton droit sur le groupe de limites, puis sélectionnez Propriétés.
Sélectionnez l’onglet Options , puis activez le paramètre Autoriser les téléchargements d’homologues dans ce groupe de limites .

Exemple de scénario

L’exemple suivant est utilisé pour montrer le fonctionnement du cache d’homologue pendant le déploiement de contenu.

Déployer une application sur la source de cache d’homologue

Lorsqu’une application est déployée et installée sur la source du cache d’homologue, le service d’accès au contenu génère un message d’état de type de rubrique 7200. L’entrée suivante est enregistrée StateMessage.log :

State message(State ID : 1) with TopicType 7200 and TopicId Cache add CAS00015.1 has been recorded for SYSTEM

Le message d’état est envoyé au point de gestion via CCMMessaging.

Lorsque le serveur de site reçoit ce message d’état, la table SuperPeerContentMap est mise à jour.

Déployer une application sur le client de cache d’homologue

Le client télécharge la stratégie pour l’application. Pour un déploiement Obligatoire , le client envoie une demande au point de gestion pour les emplacements de contenu.

Les entrées suivantes sont enregistrées LocationServices.log :

ContentLocationRequest : <ContentLocationRequest SchemaVersion="1.00" BGRVersion="1" ClientInOperation="PT0M" ExcludeFileList=""><Package ID="CAS00015" Version="1"
DeploymentFlags="9223372036855313105"/><AssignedSite SiteCode="P01"/><ClientLocationInfo LocationType="SMSPackage" DistributeOnDemand="0" UseAzure="1" AllowWUMU="0" UseInternetDP="0" AllowHTTP="1" AllowSMB="1" AllowMulticast="1" AllowSuperPeer="1" DPTokenAuth="1"><ADSite Name="Default-First-Site-Name"/><Forest Name="Contoso.Com"/><Domain Name="Contoso.Com"/><IPAddresses><IPAddress SubnetAddress="192.X.X.X" Address="192.X.X.X"/></IPAddresses><Adapters><Adapter Name="Ethernet" IfType="6" PhysicalAddressExists="1" DnsSuffix="abc.com" Description="Network Adapter"/></Adapters><BoundaryGroups BoundaryGroupListRetrieveTime="2021-04-03T14:03:16.603" IsOnVPN="0"><BoundaryGroup GroupID="5" GroupGUID="xxxx" GroupFlag="0"/><DOINCServers><DOINCServer DOINCServer="P01.Contoso.Com"/></DOINCServers></BoundaryGroups></ClientLocationInfo></ContentLocationRequest> LocationServices

Remarque

Étant donné que l’option Autoriser les téléchargements d’homologues dans ce groupe de limites est activée dans le groupe de limites, AllowSuperPeer est défini sur 1 dans la requête. Sinon, AllowSuperPeer est défini sur 0 dans la requête.

Pour utiliser la source du cache d’homologue pour le téléchargement de contenu, activez l’option Autoriser les téléchargements d’homologues dans ce groupe de limites pour chaque groupe de limites qui contient le client.

Le point de gestion répond en retournant la liste des emplacements de contenu. Vous trouverez également la liste dans LocationServices.log :

Calling back with the following distribution points 
Distribution Point='https://TestClient.Contoso.Com:8003/SCCM_BranchCache$/CAS00015', Locality='SUBNETPEER', Version='9040', Capabilities='<Capabilities SchemaVersion="1.0"><Property Name="SSLState" Value="63"/></Capabilities>', Signature='', ForestTrust='TRUE', BlockInfo='0'        
Distribution Point='http://P01.Contoso.com/SMS_DP_SMSPKG$/CAS00015', Locality='SUBNET', Version='9040', Capabilities='<Capabilities SchemaVersion="1.0"><Property Name="SSLState" Value="0"/></Capabilities>', Signature='http://P01.Contoso.Com/SMS_DP_SMSSIG$/CAS00015', ForestTrust='TRUE', BlockInfo='0'        
Distribution Point='https://P01.Contoso.Com/CCMTOKENAUTH_SMS_DP_SMSPKG$/CAS00015', Locality='SUBNET', Version='9040', Capabilities='<Capabilities SchemaVersion="1.0"><Property Name="SSLState" Value="0"/><Property Name="AuthMethod" Value="1024"/></Capabilities>', Signature='https://P01.Contoso.Com/CCMTOKENAUTH_SMS_DP_SMSSIG$/CAS00015', ForestTrust='TRUE', BlockInfo='0'

ContentTransferManager.log affiche également les emplacements de contenu qui incluent la source du cache homologue et les points de distribution :

ContentTransferManager    4324 (0x10e4)    Persisted locations for CTM job {139431E9-B106-49DC-B7A8-543D55110DE6}:
(SUBNETPEER) https://TestClient.Contoso.Com:8003/SCCM_BranchCache$/CAS00015
(SUBNET) http://P01.Contoso.Com/SMS_DP_SMSPKG$/CAS00015
(SUBNET) https://P01.Contoso.Com/CCMTOKENAUTH_SMS_DP_SMSPKG$/CAS00015

Les clients du cache d’homologue donnent la priorité aux sources de cache d’homologue pour télécharger le contenu. Cette priorité est indiquée dans l’entrée suivante dans DataTransferService.log :

 DTSJob {0C3B06F6-E85D-4C54-9B4F-0B316B33AA5B} created to download from 'https://TestClient.Contoso.Com:8003/SCCM_BranchCache$/CAS00015' to 'C:\windows\ccmcache\1'.