Basic Troubleshooting Techniques


Although troubleshooting any distributed system can be challenging and time-consuming, applying a structured methodology to troubleshooting can help sort through possible causes and reveal the root cause of most problems.

This section includes troubleshooting procedures for some of the more common problems found in an SBC environment.

Connections

One of the most common problems in the SBC environment that requires troubleshooting involves connectivity. When users cannot connect to the MetaFrame servers, there are numerous possibilities to consider.

  • The ICA Client is not configured properly This is often the problem if only one user cannot connect to the farm. If the user is using Program Neighborhood, check the server location address by selecting the connection, right-clicking, and selecting the Properties option. The proper server location address should be entered in the Address List box by clicking the Add button. Note that if TCP/IP + HTTP is the protocol being used, the appropriate XML port must be entered when adding the server location. If the Program Neighborhood Agent is being used, make sure the Web Interface URL is correct.

  • The MetaFrame server is not accepting any more connections Check to make sure logons have not been disabled by launching the CMC, highlighting the server(s) in question, right-clicking, and selecting Properties. Next, click the MetaFrame XP Settings option and make sure in the Control Options section that the Enable Logons To This Server check box is selected.

  • The MetaFrame server's load level is too high If the load level of a server is too high, new sessions will not be directed to the server. Check the load on the server from within the CMC. Highlight the server(s) in question and click the Load Manager Monitor tab. If the server is reporting a full load, check the Load Evaluators to make sure they are appropriate. This can also be checked by running qfarm /load from a command prompt. A server at maximum load will report load as 10000.

  • The listeners are down Listeners (both ICA and RDP) are the control mechanism by which new sessions are established to MetaFrame XP servers. The state of the listeners can be checked from the CMC. Click the server(s) in question and select the Sessions tab. The listeners for both ICA (ICA-tcp) and RDP (RDP-Tcp) will be shown and should be in a listen state. If either is in a down state, new connections cannot be established to the server, and the listener should be reset by right-clicking the listener and selecting Reset. If this does not bring the listener back to a listen state, reboot the MetaFrame server. Also verify that nothing else is using port 1494. A common way to check connectivity to the MetaFrame servers is to run the following from a command prompt:

    telnet <insert server name> 1494

    The response should be ΔΔICAΔΔICAΔΔICA, which is an ICA Banner from the Citrix server. This output will continue until the Telnet session is broken or times out. If this does not appear there may be a problem with the listeners.

  • There are not enough idle sessions available By default, there are two idle sessions available for logons. If more than two connections are made before one of the idle sessions frees up, an error is received on the client when trying to connect. Typically, if the user attempts to connect again, they will be able to log on. If errors of this nature occur during peak login times, increase the number of idle sessions by editing the HKLM\System\CurrentControlSet\Control\Terminal Server\IdleWinStationPoolCount registry key.

  • There are network issues present This could be on the server or client side of the network. The main items to verify include the following: are the server's network cards functioning properly; are routers and switches between the client and server configured correctly; are firewall settings blocking ICA traffic; and are client network cards configured and functioning properly. As mentioned earlier, one of the best ways to establish connectivity to the Citrix server is to run the following from a command prompt:

    telnet <insert server name> 1494

    The response should be ΔΔICAΔΔICAΔΔICA, which is an ICA Banner from the Citrix server. If this does not appear and the ICA listener is up and running, then something is blocking communication from the client to the server.

  • Core services not functional Both the Independent Management Architecture (IMA) and Citrix XML services must be running for a MetaFrame XP server to function properly. Check both of these service states by selecting Control Panel | Administrative Tools | Services to ensure they are both in a Started state. If their status shows blank, right-click the service and select the Start option.

Shadowing Users

Many end-user problems can be resolved without physically visiting the user by utilizing the shadowing technology included with MetaFrame. Permissions for shadowing are best set up in a Citrix Policy and only granted to administrators and managers within the company. Shadowing rights enable the control of a user session to instruct the user on how to perform a certain function, troubleshoot client-side problems, or promote general education about applications, printing, and system orientation. There are a couple of ways to initiate shadowing. One can be started from within the CMC by right-clicking the user sessions to be shadowed and selecting the Shadow option. Another method is to use the Shadow Taskbar found on the ICA Administrator Toolbar. A popular way to give managers access to shadowing without giving them permissions to the CMC is to publish the Shadow Taskbar program as a published application.

Troubleshooting the SQL Datastore

If you are utilizing a SQL Datastore there are several troubleshooting tips that can assist the administrator in discovering and fixing connectivity problems. The following list consolidates the most common problems encountered with the SQL Datastore and how to correct the issues.

  • The wrong credentials are supplied for SQL authentication During the configuration of a SQL Datastore, a username and password are entered, which are used for accessing the Datastore database. If this username or password is changed without updating the DSN used to connect to the Datastore, connectivity problems will be encountered.

  • The DSN is configured for NT authentication not SQL authentication Ensure that the DSN file is configured for the proper method of authentication by opening the Data Sources (ODBC) from within Control Panel | Administrative Tools.

  • The network connection between the SQL server and the MetaFrame server is down Test connectivity by using Data Sources (ODBC) utility from within Control Panel | Administrative Tools by selecting the DSN and clicking the Configure button.

  • Log space Ensure you have the Truncate Log At Checkpoint option selected or have adequate backups scheduled to ensure that the logs do no grow unnecessarily.

  • Worker threads In larger farms (greater than 256 servers), the number of worker threads needs to be increased for proper operation. This can be achieved by using the SQL Server Enterprise Manager, right-clicking the server name, selecting properties, then clicking the Processor tab and changing the Maximum worker thread count from 256 to a number greater than the number of servers in the farm.

Troubleshooting IMA

The IMA service and underlying subsystems are the core of MetaFrame XP and must be running on all farm servers for proper operation. The following list consolidates the most common problems encountered with the IMA service and how to correct the issues.

  • If an error is received after booting a MetaFrame server that states one or more services failed to start, and the non-starting service is the IMA service, allow the service more time to start since the initial load on the IMA service will cause delays past the default six-minute timeout of the service manager.

  • If a direct connection to the DS is being used, verify that ODBC connectivity exists.

  • If the Local Host Cache (LHC) (imalhc.mdb) is missing, corrupt, or provides incorrect information, start by refreshing the LHC and then move on to re-creating the LHC. To refresh the LHC, run the following from a command prompt: dsmaint refreshlhc. If this fails, re-create the LHC with the following command: dsmaint recreatelhc.

  • Review the Event Viewer logs for any errors, and research the Citrix Knowledge Center (support.citrix.com), or contact your local Citrix reseller to assist in troubleshooting.

If the ODBC Connection Fails

If using direct mode connections to the DS, ODBC connectivity is required for proper operation of the IMA service. If ODBC issues are suspected, try the following:

  • Verify the name of the DSN file the IMA service is using by looking in the registry setting HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\IMA\DataSourceName.

  • Reinstall the latest compatible version of MDAC to verify that the correct ODBC files are installed.

  • Enable ODBC tracing for further troubleshooting.

Other Common Problems

Other common problems revolve around licensing, such as when servers will not accept product licenses. If problems do occur while adding product licenses to a MetaFrame XP server, connect to the CMC, right-click the server, and select the Set MetaFrame Product Code option. Verify that the appropriate code is set for the server. Once this is verified, run the clicense refresh command from a command prompt to refresh active licensing. If there are still problems, stop and restart the IMA service.




Citrix Metaframe Access Suite for Windows Server 2003(c) The Official Guide
Citrix Access Suite 4 for Windows Server 2003: The Official Guide, Third Edition
ISBN: 0072262893
EAN: 2147483647
Year: 2003
Pages: 158

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net