6.5 ZENworks Configuration Management Tuning Parameters

This section provides information about the scenarios you might encounter if the parameters configured for a Citrix server are not appropriately tuned as per the deployment environment:

6.5.1 User Sessions on a Citrix Server Fail to Terminate

Terminating a thin client application that is running on a Citrix server might not close the user session on the server. Consequently, when the user logs out of the server, the roaming profile data for the user session is not saved.

To close the user session on the Citrix server, perform the following steps on the server:

  1. Open the Registry Editor.

  2. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI.

  3. Change the value of LogoffCheckSysModules from ZCMUMHelper.exe to ZenUserDaemon.exe.

  4. Reboot the device.

6.5.2 High Utilization of Resources on a Citrix Server

During a partial or general refresh of the ZENworks Adaptive Agent on a terminal session of a Citrix server, the agent simultaneously refreshes the sessions of all the users logged into the terminal server. If too many users have logged into the terminal server, this might cause high usage of system resources, and subsequently the ZENworks Adaptive Agent might take considerable time to refresh the terminal server.

To avoid high utilization of resources on the Citrix server:

  1. Open the Registry Editor.

  2. Go to HKLM\Software\Novell\ZCM\.

  3. Create a string called EnableBatchRefresh and set its value to 1. By default, the number of user sessions that can be simultaneously refreshed is 5.

  4. (Optional) If you want to change the default number of user sessions that must be simultaneously refreshed, create a string called maxUserRefreshThreads and set the desired value.

6.5.3 High Consumption of Memory on a Citrix Server

On a Citrix server or a terminal server, if a user disconnects a session without logging out from it, the session exists in the disconnected state. This might cause high memory consumption of the agent service.

To avoid high consumption of memory on the Citrix server, do one of the following:

  • Ensure that the users log out from a session instead of just disconnecting the session.

  • Set a time limit to automatically log out from a disconnected session. For detailed information, see the Microsoft Knowledgebase.

6.5.4 Disabling Random Refresh Might Cause the ZENworks Adaptive Agent to Crash on a Citrix Server

If Random Refresh for the ZENWorks Adaptive Agent is disabled and if multiple users log in to the Citrix server at the same time, then all the sessions try to refresh at the same time. This can cause resource contention, and subsequently causes the agent to crash because the cache access is not synchronized. To avoid this, Random Refresh must be enabled for the ZENWorks Adaptive Agent.

6.5.5 Logging in to the User Source on a ZENworks Server is Slow

Logging in to the user source on a ZENworks Server from the managed device might take some time because the login process executes the device refresh synchronously.

To speed up the login process, perform the following steps to execute the device refresh asynchronously:

  1. Open the Registry Editor.

  2. Go to HKEY_LOCAL_MACHINE\Software\Novell\ZCM

  3. Create a string called ZENLoginUserRefreshAsync and set its value to TRUE.

  4. Log in to the device again.

IMPORTANT:If you change the login process to execute the device refresh asynchronously, the latest policies might not be immediately available. With this change, you make the login performance more important than the accuracy of the policies.