CTX118622
XenDesktop
XenDesktop_all
Performance,Third Party
2016-04-15
2015-02-10
This article describes how to use the Citrix Symbol Server to obtain the symbol files necessary to debug Citrix products.

Objective

This article describes how to use the Citrix Symbol Server to obtain the symbol files necessary to debug Citrix products.

Background

Debugging symbols are required to debug running systems or crash dump files. Symbols contain information that is not used by binaries as they run but is useful for debugging. During the debugging process, you can use the Citrix Symbol Server to download only the symbols required to debug a particular issue or scenario as opposed to downloading all the symbols for a particular product before starting a debugging session.

Requirements

The Citrix Symbol Server currently contains public debug symbols for the following Citrix products:

XenApp

  • Presentation Server 3.0 and hotfixes for all languages (English, French, Spanish, German, and Japanese)

  • Presentation Server 4.0 and hotfixes for all languages (English, French, Spanish, German, and Japanese)

  • Presentation Server 4.5 and hotfixes for all languages (English, French, Spanish, German, and Japanese)

  • XenApp 5.0 and hotfixes for some languages (English, French, Spanish, German, and Japanese)

  • XenApp 6.x and hotfixes for some languages (English, French, Spanish, German, and Japanese)

XenDesktop

  • XenDesktop 4.0 and hotfixes for English and Japanese languages

  • XenDesktop 5.0 and hotfixes for English and Japanese languages

The computer retrieving the symbol files must have HTTP access to http://ctxsym.citrix.com/symbols.

Note: You must use a debugging tool to connect to the Citrix Symbol Server. Connections made directly from a web browser return a 403 error (Access Denied).

The WDK and WinDbg downloads?? package contains the components necessary to retrieve symbols from the Citrix Symbol Server. Citrix recommends configuring the debugger to download Windows operating system symbols from Microsoft’s Symbol Server. Refer to Use the Microsoft Symbol Server to obtain debug symbol files?? for instructions on how to use the Microsoft Symbol Server to acquire Windows operating system symbol files.


Instructions

To acquire debug symbols for the Citrix products listed in the Requirements section:

  • Add the Citrix Symbol Server to the symbol path in your debugging tool of choice:

     SRV*<your local symbol folder>*http://ctxsym.citrix.com/symbols

    <Your local symbol folder> is a directory or share you want?? to use to cache symbol files (for example, c:\symbols or \\fileserver\share).
    Note: A cache is recommended because it prevents redundant (and time-consuming) downloads.

  • Citrix also recommends configuring the debugger to download Windows operating system symbols from Microsoft’s Symbol Server. A symbol path including both Microsoft and Citrix symbol servers is:

     SRV*<your local symbol folder>*http://ctxsym.citrix.com/symbols;SRV*<your local symbol folder>*http://msdl.microsoft.com/download/symbols.
  • Another common method used to set the symbol path is to set the _NT_SYMBOL_PATH environment variable. Refer to the Setting the _NT_SYMBOL_PATH environment variable section in Use the Microsoft Symbol Server to obtain debug symbol files?? for detailed instructions.

  • The symchk.exe tool included in the WDK and WinDbg downloads?? package can be used to download symbols prior to a debugging session. This method is useful to avoid download delays during a debugging session or when the debugging host does not have consistent Internet access. See SymChk.exe utility to download symbols section in?? Use the Microsoft Symbol Server to obtain debug symbol files?? for detailed instructions.


Additional Resources

Citrix provides symbol packages in the form of .zip files for the initial releases of XenApp as well as each hotfix rollup pack. For further information, refer to the?? Symbol Files Location?? section of the respective hotfix rollup pack download page.

Checksum warning messages like the following are common when analyzing dump files:

 *** WARNING: Unable to verify checksum for binary.exe

These warnings occur when the debugger cannot verify if the symbols match the binary. This is a common warning when debugging a mini dump from a system that does not have the software that includes the binary installed. Possible workarounds include setting the image file search path in the debugger to a directory that includes the binary mentioned in the warning or performing the debug directly from a system with the software installed. See the sections titled, "Verifying Symbols," and, "Executable Image Path," in the Debugging Tools for Windows help file for more information.

To report problems with the Citrix Symbol Server, send an email to?? symsrv@citrix.com and provide the following information:

Note: Enable noisy symbol loading with the?? !sym noisy?? command before performing these steps.

  • The output of the?? version?? command.

  • The output of the?? .sympath?? command.

  • The output of the?? .reload /f?? command and the command that is failing. Ensure to enable noisy symbol loading ( see Step 1) before performing this step.

  • The output for the?? lmv?? command.


Disclaimer

These software applications are provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.

Applicable Products


 

Join the conversation

Citrix Discussions

Open a case

Citrix Support

特别说明


本文来源为Citrix.com所有,翻译后版权归翻译者所有.如需转载请注明出处.

文档版本


.

广告招租


最新留言


.

广告招租


.