OpenAFS for Windows 1.5.33 Release Notes

From 2ab376f5ede534d0933ff4a2f5bdeb09f735d0bb Mon Sep 17 00:00:00 2001 From: Jeffrey Altman Date: Sun, 9 Mar 2008 01:09:30 +0000 Subject: [PATCH] DEVEL15-windows-release-notes-20080308 LICENSE MIT FIXES 89132 updates for 1.5.34. includes updates to the debugging section and registry values. --- .../en_US/html/ReleaseNotes/logo.htm | 2 +- .../html/ReleaseNotes/relnotes-frames.htm | 8 +- .../en_US/html/ReleaseNotes/relnotes.htm | 145 ++++++++++++------ .../en_US/html/ReleaseNotes/toc.htm | 23 ++- .../Documentation/en_US/html/index.htm | 4 +- 5 files changed, 119 insertions(+), 63 deletions(-) diff --git a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm index a56437e97..481b77ac1 100644 --- a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm +++ b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm @@ -18,7 +18,7 @@ w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} -OpenAFS for Windows 1.5.33 Release Notes +OpenAFS for Windows 1.5.34 Release Notes - - + + - + diff --git a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/relnotes.htm b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/relnotes.htm index cfae94e19..70e8a76c0 100644 --- a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/relnotes.htm +++ b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/relnotes.htm @@ -20,7 +20,7 @@ w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} </style> <![endif]--> -<title>OpenAFS for Windows 1.5.33 Release Notes</title> +<title>OpenAFS for Windows 1.5.34 Release Notes</title> <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags" name="PostalCode"/> <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags" @@ -1098,19 +1098,21 @@ ul font-family:"Times New Roman","serif";} </style> <![endif]--> +<base target="_self"> + </head> -<body lang=EN-US link=navy vlink=maroon style='tab-interval:.5in;line-break: +<body lang=EN-US link=#000080 vlink=#800000 style='tab-interval:.5in;line-break: strict'> <div class=Section1> -<p class=MsoTitle>OpenAFS for Windows 1.5.33<br> +<p class=MsoTitle>OpenAFS for Windows 1.5.34<br> Release Notes</p> <p class=MsoBodyText>The Andrew File System (AFS) is a location-independent @@ -1493,12 +1495,12 @@ style='mso-no-proof:yes'><![if !vml]><img border=0 width=556 height=679 -src="relnotes_files/image007.jpg" alt="netidmgr_main" v:shapes="Picture_x0020_1"><![endif]></span></p> +src="relnotes_files/image002.jpg" alt="netidmgr_main" v:shapes="Picture_x0020_1"><![endif]></span></p> <p class=MsoNormal>The Network Identity Manager replaces the former KFW ticket manager, Leash, and when combined with the OpenAFS Provider, it is intended to @@ -1508,12 +1510,12 @@ Tool, Network Identity Manager with the OpenAFS Provider can easily manage AFS tokens for multiple cells from one or more Kerberos v5 identities.</p> <p class=MsoNormal align=center style='text-align:center'><span -style='mso-no-proof:yes'><![if !vml]><img border=0 width=542 height=393 -src="relnotes_files/image008.jpg" alt="netidmgr_afs_opt" v:shapes="Picture_x0020_2"><![endif]></span></p> +src="relnotes_files/image004.jpg" alt="netidmgr_afs_opt" v:shapes="Picture_x0020_2"><![endif]></span></p> <p class=MsoNormal>The AFS configuration panel for each Kerberos v5 identity is used to configure which cells credentials should be obtained for and how they @@ -1523,12 +1525,12 @@ specified.<span style='mso-spacerun:yes'> Kerberos v5 tickets as tokens, then a krb524 service can be configured.</p> <p class=MsoNormal align=center style='text-align:center'><span -style='mso-no-proof:yes'><![if !vml]><img border=0 width=542 height=393 -src="relnotes_files/image009.jpg" alt="netidmgr_afs_cfg" v:shapes="Picture_x0020_3"><![endif]></span></p> +src="relnotes_files/image006.jpg" alt="netidmgr_afs_cfg" v:shapes="Picture_x0020_3"><![endif]></span></p> <p class=MsoNormal>The OpenAFS Provider configuration panel can be used to check the status of the AFS Client Service and its version.<span @@ -3116,12 +3118,13 @@ value.   Execute "fs trace -on" to clear to the log and <h2><a name="_Toc191662124"></a><a name="_Toc139993137"></a><a name="_Toc126872214"></a><a name="_Toc115417085"></a><span style='mso-bookmark: _Toc191662124'><span style='mso-fareast-font-family:"Times New Roman"'>4.4. -Using SysInternals DbgView and ProcMon or FileMon Tools</span></span><span +Using SysInternals Debug Viewer, Process Monitor and Process Explorer Tools</span></span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h2> <p class=MsoNormal>An alternatve option to the use of "fs trace -dump" to capture internal OpenAFS Client Service events is to use a tool -such as Sysinternal's DbgView to capture real-time debugging output.  When +such as Sysinternal's +<a href="http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx">Debug Viewer</a> to capture real-time debugging output.  When the OpenAFS Client Service starts and Bit 2 of the <a href="#_Value__:_TraceOption">TraceOption</a> value in the registry is set, all trace log events are output using the Windows Debug Monitor interface @@ -3138,15 +3141,10 @@ generation of log messages. </p> <p class=MsoNormal><a name="_Toc115416150"></a><a name="_Toc126872215"></a><a name="_Toc115417086"></a><span style='mso-bookmark:_Toc115416150'>Sysinternals -ProcMon or FileMon utilities can be use to monitor the file operations +<a href="http://technet.microsoft.com/en-us/sysinternals/bb896645.aspx">Process Monitor</a> can be use to monitor the file operations requested by applications and their success or failure.   </span></p> -<p class=MsoNormal><span style='mso-bookmark:_Toc115416150'>In FileMon, use the -Volumes menu to restrict monitoring to <i>Network</i> volumes only in order to -reduce the output to just the CIFS requests.  Turn on the <i>Advanced -Output</i> option in order to log with finer granularity.</span></p> - -<p class=MsoNormal>In ProcMon, set a filter to include only events on file +<p class=MsoNormal>In Process Monitor, set a filter to include only events on file paths that refer to the AFS name space. Be sure to include both the UNC path as well as any drive letters mapped to AFS. </p> @@ -3155,6 +3153,16 @@ options in both tools to make it easier to synchronize the application requests and the resulting OpenAFS Client Service operations.   The captured data can be stored to files for inclusion in <a href="#_5._Reporting_Bugs:">bug reports</a>.</p> +<p class=MsoNormal>Sysinternal's +<a href="http://technet.microsoft.com/en-us/sysinternals/bb896653.aspx">Process +Explorer</a> is a replacement for the Windows Task Manager and so much more.  +Process Explorer can be configured to use the DbgHelp.dll from "<a href="http://www.microsoft.com/whdc/devtools/debugging/default.mspx">Microsoft +Debugging Tools for Windows</a>" as well as the debug symbols shipped as an +optional component of the OpenAFS for Windows installer.  +(Options->Configure Symbols)   Once configured the "Threads" tab of +the process properties dialog will permit the viewing of a fully documented +stack for each displayed thread.  Hint: If there is a deadlock in the cache +manager, two or more of the threads will be stuck in a call to osi_TWait().</p> <h2><a name="_Toc191662125"><span style='mso-fareast-font-family:"Times New Roman"'>4.5. Microsoft MiniDumps <br> @@ -3165,11 +3173,18 @@ Microsoft MiniDumps <br> communication there may be a serious error that can only be debugged by someone with access to the source code and a debugger.   The "fs minidump" command can be used to force the generation of a MiniDump file -containing the state of all of the threads in the AFS Client Service process.</p> +containing the state of all of the threads in the AFS Client Service process.  +The most accurate MiniDump files will be produced after installing "<a href="http://www.microsoft.com/whdc/devtools/debugging/default.mspx">Microsoft +Debugging Tools for Windows</a>".</p> <p class=MsoNormal>The <a href="#_Toc190064189">MiniDumpType</a> registry value can be used to adjust the scope of the process information included within the -dump file.</p> +dump file.  By default the MiniDump only contains the stacks of all threads +and the values of all global variables.  A much more useful MiniDump is one +that contains the contents of the heap.  Be warned, a MiniDump with heap +will be as large as the cache file.  In addition, it will include all of +the data stored within the cache.  If there are privacy concerns, do not +produce a MiniDump with heap.</p> <h2><a name="_Toc191662126"></a><a name="_Toc139993139"></a><a name="_Toc126872216"></a><a name="_Toc115417087"></a><span style='mso-bookmark: @@ -5155,7 +5170,7 @@ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> style='mso-bookmark:_Toc115416204'><span style='mso-fareast-font-family:"Times New Roman"'>Value: Daemons</span></span></span></span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h5> <p class=MsoBodyText>Type: DWORD<br> - Default: 2 (CM_CONFIGDEFAULT_DAEMONS)<br> + Default: 4 (CM_CONFIGDEFAULT_DAEMONS)<br> Variable: numBkgD</p> <p class=MsoBodyText>Number of background daemons (number of threads of cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)</p> @@ -5381,7 +5396,7 @@ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> style='mso-fareast-font-family:"Times New Roman"'>Value: TraceBufferSize</span></span></span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h5> <p class=MsoBodyText>Type: DWORD<br> - Default: 5000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br> + Default: 10000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br> Variable: traceBufSize</p> <p class=MsoBodyText>Number of entries to keep in trace log.</p> </td> @@ -5516,17 +5531,41 @@ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> <tr style='mso-yfti-irow:25;height:79.25pt'> <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt; height:79.25pt'> - <h5><a name="_Toc191662205"></a><a name="_Toc152605168"></a><a - name="_Toc115416226"></a><a name="_Toc126872295"></a><a name="_Toc139993218"></a><span - style='mso-bookmark:_Toc191662205'><span style='mso-bookmark:_Toc152605168'><span - style='mso-bookmark:_Toc115416226'><span style='mso-fareast-font-family:"Times New Roman"'>Value: - RxNoJumbo</span></span></span></span><span style='mso-fareast-font-family: + <h5> + <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value: + RxEnablePeerStats</span></h5> + <p class=MsoBodyText>Type: DWORD {0, 1}<br> + Default: 1<br> + Variable: rx_enable_peer_stats</p> + <p class=MsoBodyText>When set to 1, the Rx library collects peer statistics.</p> + <p> </td> + </tr> + <tr style='mso-yfti-irow:25;height:79.25pt'> + <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt; + height:79.25pt'> + <h5> + <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value: + Rx</span>EnableProcessStats<span style='mso-fareast-font-family: "Times New Roman"'><o:p></o:p></span></h5> - <p class=MsoBodyText>Type: DWORD {0,1}<br> - Default: 0<br> - Variable: rx_nojumbo</p> - <p class=MsoBodyText>If enabled, does not send or indicate that we are able - to send or receive RX jumbograms.</p> + <p class=MsoBodyText>Type: DWORD {0, 1}<br> + Default: 1<br> + Variable: rx_extra_process_stats</p> + <p class=MsoBodyText>When set to 1, the Rx library collects process + statistics.</p> +  </td> + </tr> + <tr style='mso-yfti-irow:26;height:124.75pt'> + <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt; + height:124.75pt'> + <h5> + <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value: + RxExtraPackets</span><span style='mso-fareast-font-family: + "Times New Roman"'><o:p></o:p></span></h5> + <p class=MsoBodyText>Type: DWORD <br> + Default: 120<br> + Variable: rx_extraPackets</p> + <p class=MsoBodyText>When set, this number of extra Rx packets are allocated + at startup.</p> </td> </tr> <tr style='mso-yfti-irow:26;height:124.75pt'> @@ -5539,12 +5578,27 @@ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> style='mso-fareast-font-family:"Times New Roman"'>Value: RxMaxMTU</span></span></span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h5> <p class=MsoBodyText>Type: DWORD<br> - Default: -1<br> + Default: 0<br> Variable: rx_mtu</p> - <p class=MsoBodyText>If set to anything other than -1, uses that value as the - maximum MTU supported by the RX interface.</p> - <p class=MsoBodyText>In order to enable OpenAFS to operate across the Cisco - IPSec VPN client, this value must be set to 1264 or smaller.</p> + <p class=MsoBodyText>If set to anything other than 0, that value is used as the + maximum send and receive MTU supported by the RX interface.</p> + <p class=MsoBodyText>In order to enable OpenAFS to operate across releases of the Cisco + IPSec VPN client prior than 5.0, this value must be set to 1264 or smaller.</p> + </td> + </tr> + <tr style='mso-yfti-irow:27;height:151.75pt'> + <td width=590 valign=top style='width:6.15in;padding:0in 5.4pt 0in 5.4pt; + height:151.75pt'> + <h5><a name="_Toc191662205"></a><a name="_Toc152605168"></a><a + name="_Toc115416226"></a><a name="_Toc126872295"></a><a name="_Toc139993218"></a> + <span style='mso-fareast-font-family:"Times New Roman"; mso-bookmark:_Toc115416226'>Value: + RxNoJumbo</span><span style='mso-fareast-font-family: + "Times New Roman"'><o:p></o:p></span></h5> + <p class=MsoBodyText>Type: DWORD {0,1}<br> + Default: 0<br> + Variable: rx_nojumbo</p> + <p class=MsoBodyText>If enabled, does not send or indicate that we are able + to send or receive RX jumbograms.</p> </td> </tr> <tr style='mso-yfti-irow:27;height:151.75pt'> @@ -6047,7 +6101,10 @@ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> initiated is dump file is generated with the "fs.exe minidump" command.</p> <p class=MsoBodyText>Valid values are dependent on the version of DbgHelp.dll - installed on the machine.  See the Microsoft Developer Library for + installed on the machine.  The best version to use is not the version + that comes with the operating system but the version that is included in the + most recent release of "<a href="http://www.microsoft.com/whdc/devtools/debugging/default.mspx">Microsoft + Debugging Tools for Windows</a>".  See the Microsoft Developer Library for further information.</p> <p class=MsoBodyText>MiniDumpNormal = 0x00000000,<br> MiniDumpWithDataSegs = 0x00000001,<br> diff --git a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/toc.htm b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/toc.htm index d45b75590..583861529 100644 --- a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/toc.htm +++ b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/toc.htm @@ -11,7 +11,7 @@ xmlns="http://www.w3.org/TR/REC-html40"> <meta name=Originator content="Microsoft Word 12"> <base target=body> <link rel=File-List href="toc_files/filelist.xml"> -<title>OpenAFS for Windows 1.5.33 Table of Contents</title> +<title>OpenAFS for Windows 1.5.34 Table of Contents</title>  + </head> <body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'> <div class=Section1> -<p class=MsoNormal><span -style='mso-no-proof:yes'><o:p></o:p></span></p> - <p class=MsoToc1 style='tab-stops:right dotted 431.5pt'><span class=MsoHyperlink><span style='mso-no-proof:yes'><a href="relnotes.htm#_Toc191662062"><span style='mso-fareast-font-family:"Times New Roman"'>1. @@ -2682,7 +2680,8 @@ font-family:"Calibri","sans-serif";mso-ascii-theme-font:minor-latin;mso-fareast- minor-latin;mso-bidi-font-family:"Times New Roman";mso-bidi-theme-font:minor-bidi; mso-no-proof:yes'><o:p></o:p></span></p> -<p class=MsoNormal><o:p> </o:p></p> +<p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal><o:p> </o:p></p> diff --git a/src/WINNT/doc/install/Documentation/en_US/html/index.htm b/src/WINNT/doc/install/Documentation/en_US/html/index.htm index d21d67411..bb69141c4 100755 --- a/src/WINNT/doc/install/Documentation/en_US/html/index.htm +++ b/src/WINNT/doc/install/Documentation/en_US/html/index.htm @@ -57,7 +57,7 @@ p <h1>OpenAFS for Windows</h1> -<h2>Version 1.5.33</h2> +<h2>Version 1.5.34</h2> <p class=MsoNormal>  </p> @@ -80,7 +80,7 @@ revised documentation to replace it at the current time.</p> <span style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>         </span></span><a -href="ReleaseNotes/relnotes-frames.htm">OpenAFS for Windows 1.5.33 +href="ReleaseNotes/relnotes-frames.htm">OpenAFS for Windows 1.5.34 Release Notes</a></p> <p style='margin-left:36.0pt;text-indent:-18.0pt;'> -- 2.39.5