Configurar o cache par para clientes do Configuration Manager

Artigo
12/14/2024

Aplica-se a: Microsoft Endpoint Configuration Manager (branch atual)

O cache par é uma solução interna para o Microsoft Endpoint Configuration Manager que permite que os clientes compartilhem conteúdo com outros clientes diretamente de seu cache local. Ele estende as soluções tradicionais de implantação de conteúdo, como pontos de distribuição. Use o cache par para ajudar a gerenciar a implantação de conteúdo para clientes em locais remotos. Para obter mais informações, consulte Cache par para clientes do Configuration Manager.

Definir configurações de cliente de cache par

Para permitir que os clientes sejam fontes de cache de mesmo nível, siga estas etapas:

No console do Configuration Manager, crie uma coleção de dispositivos. Determine quais clientes você deseja habilitar como fontes de cache de mesmo nível e adicione-os à coleção.
Vá para o espaço de trabalho Administração e selecione o nó Configurações do Cliente.
Selecione Criar Configurações de Dispositivo Cliente Personalizadas, especifique um nome e uma descrição e, em seguida, selecione o grupo Configurações de Cache do Cliente.
No painel de navegação, selecione Configurações de Cache do Cliente, defina Habilitar como fonte de cache par como Sim e especifique as portas.
Selecione OK para salvar as configurações.
Implante essa configuração de cliente personalizada na coleção de dispositivos que você criou na etapa 1.

Você não precisa habilitar clientes de cache de peer. Quando você permite que os clientes sejam fontes de cache par, o ponto de gerenciamento os inclui na lista de fontes de local de conteúdo.

Alterações em clientes que atuam como fontes de cache de mesmo nível

Quando a configuração de cache do cliente for implantada na coleção de dispositivos, você verá as seguintes alterações nas fontes de cache par:

Na instância CCM_SuperPeerClientConfig.SiteSettingsKey=1 da classe WMI em ROOT\ccm\Policy\Machine\ActualConfig:

O valor da propriedade CanBeSuperPeer é alterado para True.

As seguintes entradas são registradas 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'.

As seguintes entradas são registradas CAS.log:

SuperPeerController main thread has started.
SuperPeerController has started

Uma mensagem de estado do tipo de tópico 7201 é gerada. As seguintes entradas são registradas 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

Alteração no ponto de gerenciamento

A mensagem de estado é formatada como XML e, em seguida, enviada para o ponto de gerenciamento (MP_RelayEndpoint) por meio de CCMMessaging.

Você verá a seguinte entrada no arquivo 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>

Quando o servidor do site recebe a mensagem de estado, ele chama o spUpdateSuperPeerStatus procedimento armazenado para atualizar as seguintes tabelas:

SuperPares
SuperPeerContentMap

Configurar opções de grupo de limites para downloads de pares

No console do Configuration Manager, vá para o espaço de trabalho Administração e selecione Grupos de Limites de Configuração>de Hierarquia.
Localize o grupo de limites que contém os clientes de cache de mesmo nível e as fontes de cache de mesmo nível.
Clique com o botão direito do mouse no grupo de limites e selecione Propriedades.
Selecione a guia Opções e habilite a configuração Permitir downloads de pares neste grupo de limites.

Cenário de exemplo

O exemplo a seguir é usado para mostrar como o cache par funciona durante a implantação de conteúdo.

Implantar um aplicativo na origem do cache par

Quando um aplicativo é implantado e instalado na origem do cache de peer, o serviço Content Access gera uma mensagem de estado do tipo de tópico 7200. A seguinte entrada é registrada StateMessage.log:

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

A mensagem de estado é enviada para o ponto de gerenciamento por meio de CCMMessaging.

Quando o servidor do site recebe essa mensagem de estado, a tabela SuperPeerContentMap é atualizada.

Implantar um aplicativo no cliente de cache par

O cliente baixa a política para o aplicativo. Para uma implantação Necessária , o cliente envia a solicitação ao ponto de gerenciamento para locais de conteúdo.

As seguintes entradas são registradas 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

Observação

Como a opção Permitir downloads de pares neste grupo de limites está habilitada no grupo de limites, AllowSuperPeer é definido como 1 na solicitação. Caso contrário, AllowSuperPeer será definido como 0 na solicitação.

Para usar a origem do cache par para download de conteúdo, habilite a opção Permitir downloads de pares neste grupo de limites para cada grupo de limites que contém o cliente.

O ponto de gerenciamento responde retornando a lista de locais de conteúdo. Você também pode encontrar a lista em 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 também mostra os locais de conteúdo que incluem a origem do cache par e os pontos de distribuição:

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

Os clientes de cache par priorizam fontes de cache par para baixar conteúdo. Essa precedência é mostrada na seguinte entrada em 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'.