How to configure DFSR logging

Taikoma: Microsoft Windows Server 2003 Service Pack 2

Source: Microsoft Support

RAPID PUBLISHING


RAPID PUBLISHING ARTICLES PROVIDE INFORMATION DIRECTLY FROM WITHIN THE MICROSOFT SUPPORT ORGANIZATION. THE INFORMATION CONTAINED HEREIN IS CREATED IN RESPONSE TO EMERGING OR UNIQUE TOPICS, OR IS INTENDED SUPPLEMENT OTHER KNOWLEDGE BASE INFORMATION.

Symptom




By default DFSR debug logging is already turned on in a quite verbose setting to log up to 100 files with 200000 lines in the %windir%\debug folder, as a compressed Winzip compatible file: DFSRxxxxx.log.gz and DFSRxxxxx.log (currently used). This will consume about 75-100MB disk space and represents a kind of history of DFSR activity. In certain troubleshooting conditions it may be necessary to extend this history, since older information will be overwritten.


The recommended way to change these debug log settings is via the WMI Command line interface WMIC.


The changes will be immediately realized by the DFSR service without the need to restart DFSR.


SETTING: Debug Log Severity


Default: 4


Range: 1-5


WMIC syntax: wmic /namespace:\\root\microsoftdfs path dfsrmachineconfig set debuglogseverity=5




NOTE: For the most issues the default severity 4 is sufficient.


SETTING: Debug Log Messages


Default: 200000


Range: 1000 to 4294967295 (FFFFFFFF)


WMIC syntax: wmic /namespace:\\root\microsoftdfs path dfsrmachineconfig set maxdebuglogmessages=400000


 


SETTING: Debug Log Files


Default: 1000

Range: 1 to 100000

WMIC syntax: wmic /namespace:\\root\microsoftdfs path dfsrmachineconfig set maxdebuglogfiles=200


 


SETTING: Debug Log File Path


Default: %windir%\debug


WMIC syntax: wmic /namespace:\\root\microsoftdfs path dfsrmachineconfig set debuglogfilepath="d:\dfsrlogs"


 


NOTE: The path must be created manually before, if not available the default value %windir%\debug will be used.


 


SETTING: Enable Debug Logging


Default: TRUE


Range: TRUE or FALSE


WMIC syntax: wmic /namespace:\\root\microsoftdfs path dfsrmachineconfig set enabledebuglog=true


 


NOTE:  Debug logging is enabled by default


 


You can check your configuration with the tool DFSRDIAG:


dfsrdiag DumpMachineCfg /Mem:DFSRMember1


 


Machine Configuration Parameters:


   ConflictHighWatermarkPercent   : 90


   ConflictLowWatermarkPercent    : 60


   DebugLogFilePath               : C:\WINDOWS\debug


   DebugLogSeverity               : 4


   Description                    :


   DsPollingIntervalInMin         : 60


   EnableDebugLog                 : TRUE


   EnableLightDsPolling           : TRUE


   LastChangeNumber               : 1


   LastChangeSource               :


   LastChangeTime                 : 20050830140044.000000-000


   MaxDebugLogFiles               : 200


   MaxDebugLogMessages            : 400000


   RpcPortAssignment              : 0


   StagingHighWatermarkPercent    : 90


   StagingLowWatermarkPercent     : 60


 


You can also realize the debug log settings in the header of every log file:


·         FRS Log Sequence:3 Index:6 Computer:DFSRMember1 TimeZone:W. Europe Daylight Time (GMT+-2:00) Build:[Nov 23 2005 00:36:45 built by: dnsrv_r2] Enterprise=1


·         Configuration logLevel:4 maxEntryCount:400000 maxFileCount:200 LogPath:\\.\C:\WINDOWS\debug\


 



 

More Information




DFSR Registry setting for more verbose event logging


 


SETTING: Event Log Verbosity


Output: DFS Replication event log


 


Value Path: HKLM\SYSTEM\CurrentControlSet\Services\Dfsr\Parameters


Value Name: Enable Verbose Event Logging


Value Type: REG_DWORD


Value Data: 1


 


NOTE: Although the registry value does not exist by default, the following events are suppressed by default unless verbose event logging is enabled:


 


2002 EVENT_DFSR_VOLUME_INITIALIZED


3002 EVENT_DFSR_RG_INITIALIZED


3004 EVENT_DFSR_RG_STOPPED


4002 EVENT_DFSR_CS_INITIALIZED


5006 EVENT_DFSR_CONNECTION_OUTCONNECTION_ESTABLISHED


5004 EVENT_DFSR_CONNECTION_INCONNECTION_ESTABLISHED



MaxDebugLogFiles Note

The maximum is 10,000 on Windows Server 2003 R2 and 100,000 on all later operating systems. The default is 100 logs in Windows Server 2003 R2 and Windows Server 2008, and 1000 logs in Windows Server 2008 R2 and later operating systems.

DISCLAIMER


MICROSOFT AND/OR ITS SUPPLIERS MAKE NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY, RELIABILITY OR ACCURACY OF THE INFORMATION CONTAINED IN THE DOCUMENTS AND RELATED GRAPHICS PUBLISHED ON THIS WEBSITE (THE “MATERIALS”) FOR ANY PURPOSE. THE MATERIALS MAY INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS AND MAY BE REVISED AT ANY TIME WITHOUT NOTICE.


TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MICROSOFT AND/OR ITS SUPPLIERS DISCLAIM AND EXCLUDE ALL REPRESENTATIONS, WARRANTIES, AND CONDITIONS WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF TITLE, NON INFRINGEMENT, SATISFACTORY CONDITION OR QUALITY, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE MATERIALS.