Professional Documents
Culture Documents
0
Troubleshooters Guide
Table of Contents
About this document ..........................................................................................3 1. Whats new in Web Interface 4.0 ........................................................................4 1.1 New features for the end user........................................................................4 1.2 New features for the administrator..................................................................4 1.3 Installer changes ........................................................................................5 1.4 XML Service changes ...................................................................................5 1.5 Design changes ..........................................................................................5 2. Platform support ............................................................................................6 2.1 Supported Server Platforms ...........................................................................6 2.2 Supported Web Browsers ..............................................................................6 3. Installation and site management........................................................................7 3.1 Types of sites............................................................................................7 3.2 Changes made during site creation ..................................................................7 3.2.1 Whats installed ...................................................................................7 3.2.2 Whats not installed...............................................................................8 3.2.3 Windows 2000 Domain Controllers not supported ............................................8 3.3 Web Interface 4.0 command-line installation and site management ..........................8 3.3.1 Web Interface 4.0 for Windows command-line installation.................................9 3.3.2 WebInterfaceSetup.exe command line options............................................. 10 3.3.3 Site Definition Strings........................................................................... 10 3.3.4 Web Interface for Windows Examples........................................................ 12 3.3.5 Web Interface for UNIX Site Creation ........................................................ 13 3.3.6 Web Interface for UNIX Example.............................................................. 14 3.4 Remote Configuration................................................................................ 14 3.4.1 Site registration.................................................................................. 16 3.4.2 Limitations and caveats ........................................................................ 17 3.4.3 Mistakes to avoid ................................................................................ 18 3.4.4 Remote Configuration of Web Interface for UNIX .......................................... 18 4. MetaFrame Presentation Server Site Changes........................................................ 22 4.1 URL Filtering........................................................................................... 22 4.2 Language Packs ....................................................................................... 22 4.3 Novell Authentication via LDAP .................................................................... 24 4.4 Support for Token-only Logins with RSA SecurID 6.0............................................ 25 5. Core Feature Specifications ............................................................................. 28 5.1 User Authentication .................................................................................. 28 5.1.1 Explicit Authentication ......................................................................... 28 5.1.2 Single sign on..................................................................................... 31 5.1.3 Smart Card Authentication..................................................................... 32 5.1.4 Change password ................................................................................ 35 5.2 Enumerating Applications ........................................................................... 36 5.3 Determining the target MetaFrame server address ............................................. 41 5.4 NFuse Ticketing ....................................................................................... 44 5.5 Address Translation .................................................................................. 47 5.5.1 Getting the Real Client IP from Secure Gateway 3.0 ...................................... 49 5.5.2 Address Translation Logic ...................................................................... 50 5.6 Workspace Control.................................................................................... 52 5.6.1 Unique Client Names............................................................................ 58 5.7 Using Secure Gateway with Web Interface ....................................................... 58 6. Troubleshooting techniques ............................................................................. 64 6.1 Event-based Logging ................................................................................. 64 6.2 Disable the default error message ................................................................. 64 6.3 Enable Tracing in ASP.NET .......................................................................... 66
6.4 Troubleshooting ASP.NET Errors.................................................................... 68 6.4.1 Try a Simple ASPX File .......................................................................... 68 6.4.2 IIS ASP.NET Registration ........................................................................ 69 7. Reference Materials ...................................................................................... 71 7.1 Features not available on Web Interface for UNIX .............................................. 71 7.2 XML Service Dependencies .......................................................................... 72 7.3 IMA Error Codes Relayed by the XML Service ..................................................... 73 7.3.1 Error Handling in Presentation Server 4.0 and beyond .................................... 73 7.4 HTTP Server Environment Variables ............................................................... 79 7.5 Debug.aspx............................................................................................. 82