Event Logs

  • Article

BranchCache has an operational log and a security log. The operational log is the main Event Log for the BranchCache service. It is separate from the Windows Application Log. The operational log appears in the Event Viewer UI at “Applications and Services Logs\Microsoft\Windows\PeerDist\Operational.” The following table shows the main events for deployment and diagnostic purposes.

Event Name Event Description

ServiceStartupEvent

The BranchCache service started successfully.

ServiceShutdownEvent

The BranchCache service stopped successfully.

ServiceStartupFailedEvent

The BranchCache service failed to start.

ConfigChangeEvent

A configuration change was detected (registry keys).

HCDetectedBothServerAndClientSettingsEvent

This computer is configured as a Hosted Cache computer and it is also configured to use Hosted Cache. Only one of these options can be used on a given computer. Please fix the configuration by using the netsh commands.

DiscoveryBlockedByFirewallEvent

The port used for discovering the availability of cached content on this client is blocked by the firewall. As a result, other clients on the network cannot discover this client. Run the command netsh branchcache set service distributed from an elevated command prompt. This opens the needed firewall port (3702 inbound UDP) for enabling discovery. Alternatively, you can manually open this port in the firewall. Refer to the deployment guide for more details.

DownloadBlockedByFirewallEvent

The port used for serving content to requesting clients is blocked by the firewall. As a result, other clients on the network (including the Hosted Cache) will not be able to retrieve content from this client. Please run the command netsh branchcache set service from an elevated command prompt to set the service mode. This opens the needed firewall port (80 inbound TCP). Alternatively, you can manually open this port in the firewall. Refer to the deployment guide for more details.

HCProtocolBlockedByFirewallEvent

The port used by the Hosted Cache for accepting incoming client offers for content is blocked by the firewall. As a result, clients will not be able to add content to the Hosted Cache. Run the command netsh branchcache set service hostedserver from an elevated command prompt. This opens the needed firewall port (by default port 443 inbound TCP). Alternatively, you can manually open this port in the firewall. Refer to the deployment guide for more details.

UrlReservationRequiredEvent

The HTTP namespace used for serving content to requesting clients is not reserved. Run the command netsh http add urlacl url=https://+:80/116B50EB-ECE2-41ac-8429-9F9E963361B7 sddl=D:(A;;GX;;;NS) from an elevated command prompt to reserve the namespace. Refer to the deployment guide for more details.

RepublishFailedToAllocateEvent

BranchCache could not free enough space in the local cache to accommodate the content being added. Run the command netsh branchcache set cachesize from an elevated command prompt to increase the cache size. Refer to the deployment guide for more details.

PublishFailedToInitializeEvent

BranchCache could not publish the content. Possible reasons are:

  • The publication directory location is not on an NTFS partition.

  • The path is too long (typically, greater than 190 characters).

  • The path does not exist.

  • BranchCache service does not have the permissions to write to the directory location.

Run the command netsh branchcache set publicationcache from an elevated command prompt. Refer to the deployment guide for more details.

PublishFailedEvent

BranchCache could not publish the content with content-id: %2 because the publication cache size was exceeded or the hard disk drive did not have enough space. Run the command netsh branchcache set publicationcachesize from an elevated command prompt to increase the cache size. Refer to the deployment guide for more details.

DownloadFromPeerFailedEvent

A request message sent to another BranchCache client failed with error %6.

DownloadFromHCFailedEvent

A request message sent to the BranchCache Hosted Cache failed with error %6.

PeerQuarantinedEvent

Another BranchCache client has been quarantined by this client for approximately %2 seconds. Possible reasons are that the client served invalid data or that it repeatedly failed to serve data in a timely fashion.

InvalidMessageEvent

An invalid request message has been received from another BranchCache client. The request has been dropped.

PeerRequestDeniedEvent

A content retrieval request from another BranchCache client has been denied with error %2.

UnableToConnectToHCEvent

BranchCache tried to offer content to the Hosted Cache on %1, but there was an error connecting to it (error code: %2). Possible reasons are the Hosted Cache location is incorrect, the port number used is not configured correctly on the client, or the port to connect to is not enabled in the firewall on the Hosted Cache.

Run the command netsh branchcache set service hostedclient on the client from an elevated command prompt. Also run the command netsh branchcache set service hostedserver on the Hosted Cache from an elevated command prompt. Refer to the deployment guide for more details.

HCOfferTimedOutEvent

BranchCache tried to offer content to the Hosted Cache, but the request to the Hosted Cache timed out. Possible reasons are:

  • The Hosted Cache may be under heavy load.

  • The Hosted Cache is not reachable due to the port not being open in the firewall on the Hosted Cache. Run the command netsh branchcache set service hostedserver on the Hosted Cache from an elevated command prompt.

  • The Hosted Cache enabled client authentication and the client was not joined to the domain. Join your client to the domain. Alternatively, run the command netsh branchcache set service hostedserver clientauthentication=none from an elevated command prompt.

  • The Hosted Cache location configured on the client is invalid. Run the command netsh branchcache set service hostedclient on the client from an elevated command prompt.

Refer to the deployment guide for more details.

AccumulatedEvent

%2 instance(s) of event id %1 occurred.

FirewallRulesInconsistencyEvent

The firewall rules for the BranchCache service are configured incorrectly. Run the command netsh branchcache set service with the appropriate service mode to set the firewall configuration correctly. Refer to the deployment guide for more details.

ClientDllServiceDisabledEvent

The BranchCache service could not be started because it is disabled in the Service Control Manager. In the Service Control Manager on a client computer, change the service startup type to Manual. In the Service Control Manager on a server, change the service startup type to Automatic.

LoadPersistedCacheFailedEvent

BranchCache was unable to load the cache (error code: %1, sub code: %2). Possible reasons are that the cache file was corrupted or it had a different version.

LoadPersistedCacheSucceededEvent

The BranchCache service started and loaded a cache file from a disk that was saved on the hard disk drive.

SavePersistedCacheSucceededEvent

BranchCache saved a cache file to the hard disk drive.

SavePersistedCacheFailedEvent

The BranchCache service stopped and was unable to save the cache file to the hard disk drive.

ServiceShutdownStartEvent

The BranchCache service shutdown is commencing.

SSLCertNotConfiguredEvent

An SSL certificate is not bound to the BranchCache port on the Hosted Cache server. As a result, clients cannot add content to the Hosted Cache. Run the command netsh http add sslcert from an elevated command prompt to bind a certificate.

RepublishFailedToInitializeEvent

BranchCache cannot initialize the local cache at the location [Path].Possible reasons are that the local cache directory location is not on an NTFS partition, the path is too long (typically, greater than 190 characters) or does not exist, or the BranchCache service does not have the permissions to write to the directory location. Run the command netsh branchcache set localcache from an elevated command prompt.