Article ID: 930702
Article Last Modified on 3/8/2007
APPLIES TO
- Microsoft SoftGrid for Terminal Services
- Microsoft SoftGrid for Windows Desktops
SYMPTOMS
When you start an application or update a Desktop Configuration Server from Microsoft SoftGrid Client Management, you receive the following error message:
Additionally, the following error is logged in the SoftGrid Client log file (Sftlog.txt):
RESOLUTION
You receive an error message when you start an application
To troubleshoot this problem, follow these steps:
Verify that the protocol, the server name, and the port are correct. If these items are incorrect, the application will not start. The protocol, server name, and port are specified in the HREF attribute of the CODEBASE element in the .osd file.
HREF="protocol://server_name:port"
The default protocol is Real-Time Streaming Protocol (RTSP). The alternative protocol is RTSPS.
The default server name is %SFT_SOFTGRIDSERVER%. This environment variable must be configured on the SoftGrid clients. This variable can be replaced with the host name, with the DNS name, or with the IP address of the server or of the load balancing device.
The default port is 554. Alternative ports include but are not limited to 332 and 443. The following is an example of the HREF attribute.HREF="rtsp://%SFT_SOFTGRIDSERVER%:554/DefaultApp.sft" HREF="rtsps://%SFT_SOFTGRIDSERVER%:332/DefaultApp.sft"
- If the protocol, the server name, and the port are valid, verify that the SoftGrid Virtual Application Server service is started. To do this, follow these steps:
- From Administrative Tools, start Services.
- Locate SoftGrid Virtual Application Server in the Name column.
- Verify that the Status column reports Started.
- If the service is not started, right-click SoftGrid Virtual Application Server, and then click Start.
- If the service cannot start, search the Softricity Knowledgebase for an error message.
- Verify that the client can "ping" the server name. To do this, follow these steps:
- Open a Command Prompt window.
- Type ping SERVERNAME PORT, and then press ENTER. For example, type ping %SFT_SOFTGRIDSERVER%. If the PING command is successful, you receive the following message:
If the PING command is unsuccessful, you receive the following message:
- Verify that the client can use the telnet command to communicate with the server and with the port.
- Open a Command Prompt window.
- Type telnet SERVERNAME PORT, and then press ENTER. For example, type telnet %SFT_SOFTGRIDSERVER% 554. If the connection is successful, the window will be blank. In this case, press ENTER two times. You will receive the following message:
If the connection is unsuccessful, you will receive the following message:
- If the client can "ping" but not "telnet" to the server, verify that port traffic between the client and the server is not restricted by a firewall or by other software. To do this, contact a network administrator.
You receive an error message when you update a Desktop Configuration Server
To troubleshoot this problem, follow these steps:
- If the server name is incorrect, the update will fail. To verify the host name of the server, follow these steps:
- From Administrative Tools, start SoftGrid Client Management.
- Click Desktop Configuration Servers.
- Right-click the server that is reporting the error code, and then click Properties.
- Verify that the server name that is specified in Host Name is correct.
- If the server name is correct, verify that the client can "ping" the host name. To do this, type ping
Server_name
, and then press ENTER. If the PING command is successful, you receive the following message:If the ping is unsuccessful, you receive the following message:
- If the client cannot "ping" the server, a network-related issue may be preventing the client from communicating with the server. The network-related issue must be corrected before an application can be streamed. In this case, contact a network administrator.
Keywords: kbexpertiseinter kbtshoot KB930702