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:
- Cannot load a list of RemoteApps from a remote server
- 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
- This problem is normally caused by not adding the computer account of the Terminal Server Web Access server into the local TS Web Access Computers local group on the RemoteApp server
- If you are trying to load a list of RemoteApps from a remote server and the server name is actually for a Terminal Server farm, you must install the following hotfix from Microsoft KB 957801: The query fails when you enter the terminal server farm name int eh TS Web Access Administration window to query remote program information in Windows Server 2008
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
- TechNet: Terminal Server Web Access
- Microsoft KB 957801: The query fails when you enter the terminal server farm name in the TS Web Access Administration window to query remote program information in Windows Server 2008
- Microsoft KB Article 943887: RDC client requirements for Terminal Services WebAccess in Windows Server 2008