Operational logging

Events related to service lifetime and operations fall into Service Operation category and are specified in table below.

ID Severity Description Comment
100 Success Service started
101 Success Service stopped
102 Success Autodiscover record updated. Record: %1 Logged every time PDS successfully updates its DNS SRV record
202 Error Failed to update Autodiscover record. Record: %1 Error: %2 Logged in case that PDS fails to update its DNS SRV record
103 Success Autodiscover record removed Record: %1 Logged when PDS removes its DNS SRV record. Only happens when SrvRecordUnregisterOnShutdown parameter is set to true
203 Error Failed to remove Autodiscover record. Record: %1 Error: %2 Logged in case that PDS fails to remove its DNS SRV record
104 Information Registering autodiscover SRV record with following: Domain: %1 Host: %2 Port: %3 Priority: %4 Weight: %5 TTL: %6 Logged before registration of DNS SRV record. Shows parameters of SRV record being registered.
305 Warning Expiration time exists but password empty. This typically happens when service does not have properly configured permissions in AD. Please verify configuration and if needed, fix permissions via Set-AdmPwdServiceAccountPermission cmdlet. Forest: %1 Computer: %2 User: %3 Logged in case that service detects that response for local admin password retrieval contains timestamp of password expiration, but not a password itself. This is to notify administrator of solution that PDS may not have enough permissions to read password from AD
106 Information Key Pair loaded Id: %1 Logged when PDS successfully loads key pair from keystore Note: Custom implementations of keystore are expected to implement logging of this event.
207 Error File based keystore does not exist. No keys will be loaded. Keystore folder: %1

Logged when PDS does not find keystore folder pointed to by Pds – KeyStore – path parameter (see PDS configuration for details)
208 Error Error during Autodiscover registration/unregistration. Error: %1 Logged when PDS encounters unexpected error during SRV record registration/deregistration
209 Error Could not load information about forest %1. Error: %2 Forest will be ignored until next service start. Logged when PDS is not able to reach supported forest
210 Error Could not get ACL of directory object; returning AccessDenied to caller. Object DN: %1 Logged when PDS is not able to reach DC of forest where PDS is installed
211 Error Could not load information about implicit local forest. Error: %1 Please fix the error and restart the service to retry. Logged when PDS is not able to get ACL for managed machine or Managed Domain Account
212 Error

Could not open listener for service %1.
Error: %2
Verify that service port is not occupied by other program.
When PDS is co-hosted with DNS server, then DNS server may occupy many UDP ports including PDS UDP port used for centralized reporting. If this is a case, you can make the port available by the following PowerShell commands:

$Setting=Get-DnsServerSetting -All
$Setting.SocketPoolExcludedPortRanges='61184-61184'
Set-DnsServerSetting $Setting

Logged when PDS is not able to open listener on configured TCP or UDP port

Notes: Service name can be one of following:

  • PDS: For PDS core service that listens on 61184/tcp by default
  • CentralizedReporting: For clientralized client reporting service that listens on 61184/udp by default