Citrix NFuse Web Server Debugging & Analysis Tool 

This tool is provided by Citrix Technical Support to help troubleshoot IIS-related configuration issues.

Introduction

Download DebugASP.zip 

This tool is an Active Server Page (ASP) script for use by Citrix web server administrators. The purpose of this tool is to inspect a web server running Microsoft Internet Information Services (IIS) and report on its status as an NFuse Classic web server, a Citrix Secure Gateway Secure Ticket Authority (STA), or a MetaFrame server providing the Citrix XML Service through IIS.

The tool enumerates the following information about the server from which it is executed:

• All web sites, the interfaces from which they are served, and their document root directories

• The version and configuration detalis for NFuse Classic

• Settings affecting the delivery of the XML service through IIS

• Settings affecting the operation of a CSG STA through IIS

• ASP Application objects and variables

• ASP Session objects and variables

• Client web browser cookies (for the current web site only)

• All IIS HTTP server variables

Included in this package are the following sample output files that demonstrate the information returned by the tool under a variety of different circumstances:

Sample-good.htm:

• Server has MetaFrame XP, NFuse Classic 1.7, CSG STA and XML Service running on IIS

• All components were functioning properly at the time when the report was generated

Sample-bad.htm:

• Same server as above, but the debug.asp file was run from a new web site whose document root did not agree with NFuse.conf settings

• The /Scripts virtual directory did not exist, yielding errors with the STA and the XML service delivery

Sample-nonadmin.htm:

• Same server as above, but logged in as a normal user instead of a web server administrator

Usage Instructions

On an NFuse Classic 1.7 web server:

1. Log into the web server as a member of the local Administrators group

2. Copy the debug.asp file into the Inetpub\wwwroot\Citrix\NFuse17 (or equivalent) folder.

3. Log into NFuse Classic and reproduce the problem you wish to debug.

4. After reproducing the problem, point your browser to http://your-server-name/Citrix/NFuse17/debug.asp

5. Read the output that is returned for this page. Any known problems or popular misconfigurations will be detected and displayed in red text.

6. (Optional) From your browser Edit menu, choose Select All and then Copy. Run notepad.exe, paste the contents into a text file and e-mail the text to your Citrix support representative.

On non-NFuse web servers, or servers running NFuse 1.61 or earlier:

1. Log into the web server as a member of the local Administrators group

2. Copy the debug.asp file into the web site document root folder, usually \InetPub\wwwroot.

3. Reproduce the problem you wish to debug.

4. After reproducing the problem, point your browser to http://your-server-name/debug.asp

5. Read the output that is returned for this page. Any known problems or popular misconfigurations will be detected and displayed in red text.

6. (Optional) From your browser Edit menu, choose Select All and then Copy. Run notepad.exe, paste the contents into a text file and e-mail the text to your Citrix support representative.

On Project Columbia web servers:

1. Log into the web server as a member of the local Administrators group

2. Copy the debug.asp file into the existing Columbia folder, replacing the debug.asp file that already exists there.

3. Log into Columbia and reproduce the problem you wish to debug.

4. After reproducing the problem, point your browser to http://your-server-name/Columbia-folder/debug.asp

5. Read the output that is returned for this page. Any known problems or popular misconfigurations will be detected and displayed in red text.

6. (Optional) From your browser Edit menu, choose Select All and then Copy. Run notepad.exe, paste the contents into a text file and e-mail the text to your Citrix support representative.

Usage Notes, Restrictions, and Known Problems

This section includes important notes and tips.
PLEASE READ IT CAREFULLY BEFORE USING THIS TOOL.

1. Citrix recommends that you remove the debug.asp file from your web server after it has been used in order to prevent unauthorized users from obtaining configuration details about your server.