TERMINAL SERVER WEB ACCESS


Description: This document pertains only to Terminal Server Web Access in Windows Server 2008.  It does not apply to Remote Desktop Web Connection that shipped with Windows Server 2003.

Terminal Server Web Access refers to the web site that is installed when the Terminal Server Web Access role service for Terminal Services is installed on Windows Server 2008. Although designed primarily to deploy RemoteApps via the web, Terminal Services Web Access can also be used to gain access to Terminal Servers via the web by using the Remote Desktop Web Connection tab of the web page.

This document will provide help in scoping an issue with TSWA, help you gather data that we will need when troubleshooting a problem, and also provide some troubleshooting steps or resolutions to some of the most common issues.

 

Scoping the Issue:  There are a couple of common issues with Terminal Server Web Access, and scoping the issue will depend on the symptoms that you are experiencing:

  1. Cannot load a list of RemoteApps from a remote server
  2. Terminal Services Web Access does not install, or there are errors encountered when installing the role service

 

Data Gathering:  In all instances, collecting either MPS Reports with the General, Internet and Networking, Business Networks and Server Components diagnostics, or a Performance-oriented MSDT manifest must be done.  Additional data required may include the following:

  • Details on your Terminal Server Web Access configuration, including the name of the server where a list of RemoteApps will be loaded and if you are trying to load RemoteApps from a Terminal Server Farm.
  • If you are having problems installing the Terminal Server Web Access role, ensure that you capture the Server Manager log and the CBS logs

 

Troubleshooting / Resolution:  Troubleshooting will depend on which problem you are experiencing:

Cannot load a list of RemoteApps from a remote server

Terminal Server Web Access does not install or there are errors encountered while installing the role service 

  • Terminal Server Web Access depends on several IIS components that must also be installed when the role service is installed. If there are failures during the installation of any of the required components or during the installation of TS Web Access then an error message is usually displayed in Server Manager. The results of the installation are logged into the Server Manager log and the CBS (Component Based Servicing) log. Gather the following logs and include them with your support incident:
    • Installationlog.html (%userprofile%\AppData\Roaming\Microsoft\Windows\ServerManager
    • Servermanager.log (%userprofile%\AppData\Local\Temp
    • CBS.log (%windir%\logs\CBS)
  • Other log files or event logs may be required as troubleshooting progresses, but the logs above coupled with the MPS Reports / MSDT data will give us a good start

Additional Resources: