1.0 Registry Keys

This section provides information about registry keys used to carry out general administrative tasks on ZENworks managed devices.

Registry Key Name

Registry Key Path

Description

Registry Key Type

Registry Key Value

AllowAnonymousAccessToContentRepo

Windows: HKLM\Software\Novell\ZCM

Linux: /etc/opt/novell/zenworks/conf/xplatzmd.properties

Allows the user to access the content-repo directory anonymously.

String

True

AllowDLUWithoutNovellClient

Windows XP (32-bit):

HKLM\Software\Novell\Nwgina

Windows Vista/ Windows 7 or Windows 10 (32-bit and 64-bit)

HKLM\Software\Novell\Authentication

To log a dynamic user with an e-directory account into a workstation using the Dynamic Local User policy.

For more information, see Implementing the Dynamic Local User Policy Without the Novell Client in the ZENworks Configuration Policies Reference.

DWORD

1

AllowNonTaskbarExplorer

HKLM\Software\Novell\ZCM\NAL\

Allows NalShell to load in the context of the non-task bar explorer.

Prevents NalShell from being loaded in the context of the non-task bar explorer.

DWORD

DWORD

1

0

AllowNonActiveNIC

HKLM\Software\Novell\ZCM

To enable ZENworks agents to allow the non-active Network Interface Cards (NICs) while detecting the network on a Windows platform.

Note: Not applicable on a ZENworks Xplat agent.

String

True

AllowPassiveModeLoginOnServers

HKLM\Software\Novell\ZCM\ZenLgn

To log in to the ZENworks console and to dynamically create user accounts for Windows 2003, Windows 2008, and Windows 2008 R2 devices. You can also use the DLU policy to create users dynamically.

NOTE:Passthrough login is not supported on Windows 2003 64-bit devices.

DWORD

1

AllowTunnelInterface

HKLM\Software\Novell\ZCM

To enable ZCM agents to consider the tunnel interface while detecting the network.

String

True/False

AllowZenInfoWithoutAdminPwd

HKLM\Software\Novell\ZCM

When the value of this key is set to True, users other than administrators can run zac zeninfo

For more information, see zac for Windows(1) in the ZENworks Command Line Utilities Reference.

String

True

APP_SETTING_ENABLE_AUTO_CLEANUP

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

If the value of this registry key is set to False, then the ZENworks agent can not perform any bundle desktop icons deletion or recreation. The desktop icon deletion and recreation will be handled by the Microsoft Windows Explorer.

String

False

AlternateAzureDomain

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\ZenLgn

To enable Azure AD login for users who migrated from LDAP.

String

LDAP user source name

AutoAcceptUnverifiableCertificate

HKEY_CURRENT_USER\Software\Novell\ZCM\Remote Management\Viewer\Settings

If the value of the registry key is set to "0", the certificate acceptance option is displayed. If the registry key value is set to "1", the option is not displayed.

DWORD

0 or 1

autowindowresize

HKCU\Software\Novell\ZCM\Remote Management\Viewer\History\device~50

*device can be IP address of hostname

If no entry is found for device, then the registry value should be created under Default key.

In a remote control session, this registry key when set enables the resizing of the remote viewer on the management console without any borders or black spaces when switching back to auto.

DWORD

Any value other than zero.

AZURE_AGENT_LOGIN_TEXT

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

To customize the message that is displayed on the Azure AD login screen.

Ensure that you log out (Windows logout) and log into the device for the settings to be effective.

String

Specify an appropriate message.

AZURE_AGENT_ERROR_TEXT

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

To customize the error message that is displayed on the Azure AD login screen.

Ensure that you log out (Windows logout) and log into the device for the settings to be effective.

String

Specify an appropriate error message.

BlankScreenFrequency

HKLM\Software\Novell\ZCM\Remote Management\Agent

During a blank screen, the managed device’s screen will flicker based on the configured time interval. The default time interval is 600 milliseconds.

DWORD

600 to 2000 milliseconds

BundleOrderingTimeSlice

HKLM\Software\Novell\ZCM

Allows you to configure the time that the agent waits before reordering the assigned bundles on a Windows managed device. The default value is 5 seconds.

For more information, see Enabling Bundle Ordering in the ZENworks Software Distribution Reference.

String

Any value greater than 0, in seconds

BUNDLE_ORDERING_TIME_LAG_SEC

/etc/opt/novell/zenworks/conf/xplatzmd.properties

Allows you to configure the amount of time that the agent waits before reordering the assigned bundles on a Linux managed device. The default value is 5 seconds.

For more information, see Enabling Bundle Ordering in the ZENworks Software Distribution Reference.

String

Any value greater than 0, in seconds

CancelOnNoResponse

Windows 32-bit

HKLM\Software\\Novell\\ZCM\\ActionHandler\CancelOnNoResponse

Windows 64-bit

HKLM\Software\\Wow6432Node\\Novell\\ZCM\\ActionHandler\CancelOnNoResponse

Allows reboot control and prompt control to set the auto continue and auto cancel options.

For more information, see “User Cancels Allowed” in the ZENworks Software Distribution Reference.

DWORD

1

cdpStats

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

Content satellite SQLite database

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

CDPWebCallWaitTimeout

HKLM\Software\Novell\ZCM

To modify the Web Service time out on a Satellite device for Windows, set this registry key value to the desired time you want.

String

Desired time in milliseconds

cleanUpStalePrintersAtPostDesktop

HKLM\SOFTWARE\Novell\ZCM\PrinterPolicy

To remove printers of the previous user session when a new user logs in to the same device.

NOTE:The printers of the previous user session will be removed only after the registry key is set and the device is rebooted.This is applicable only for Samba printers.

String

True

collectionStats

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

Collection Satellite SQLite database

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

ContentDownloadFailureLogLevel

HKLM\Software\novell\zcm

To log the content replication error messages as warnings or errors. Using this registry key on Satellite Servers, you can also prevent the logging of content replication errors by specifying the value as NoLogging.

String

NoLogging, Error, Warning

ContentCPRTempPath

HKLM\Software\novell\zcm

To change the location of the checkpoint content (.tmp) files from the default Windows temp file location to another folder on the device. You need to specify the new folder path where the .tmp files should be stored

If the registry entry is missing or if there are any issues or exceptions in creating a configured folder path for the *.tmp files, the *.tmp files will be stored in the default Windows temp location.

String

<Folder path>

defaultUICulture

HKLM\Software\Novell\ZCM

ZENworks Agent reads this registry key and loads the corresponding language resources.

If a language pack is installed on a device and the display language is set to an installed language pack that is not supported by ZENworks, then you can load resources for any of the ZENworks supported languages by setting the defaultUICulture registry key to the appropriate culture value. For example, to load English (United States) set it to en-US, or to load French (France) set it to fr-FR.

NOTE:The display language takes the following order of precedence:

  1. Installed language pack: If you install a language pack that is supported by ZENworks and make it the default language, then the Technician UI is displayed in the default language.

  2. defaultUICulture registry key: If the default language pack is not supported by ZENworks, and if you define a supported, language locale value, for this registry key, then the Technician UI is displayed based on the registry key value.

  3. OS supported language: If the default language pack is not supported, and the registry key value is not specified or if the specified value is not supported, then the UI is displayed in the OS language. However, if the OS language is also not supported, then the Technician UI is displayed in English.

String

Specify the Language Locale value.

Example for English language (United States): en-US

DefaultRealm

HKLM\Software\Novell\ZCM\ZenLgn\

To reduce the device login time, specify the user source in this registry key.

For more information, see Reducing Device Login Time by Specifying the Default User Source in the ZENworks User Source and Authentication Reference.

String

Desired User source

The DefaultRealm value is case sensitive since the realm name is case sensitive.

DeleteCustomGroups

HKLM\Software\Novell\ZCM\Dynamic Local User

This registry key will delete the Custom Groups created by the DLU policy. If the registry key is not set then Custom groups will never get deleted.

String

True

DisableCDPRestartIntervalDoubling

HKLM\SOFTWARE\Novell\ZCM

  • On Linux and Mac operating systems, configure the setting in the /etc/opt/Novell/zenworks/conf/xplatzmd.properties file.

  • On a Windows operating system, use the Registry Editor and configure the registry key: HKLM\SOFTWARE\Novell\ZCM

Based on your requirements, set the registry to True or False:

  • True: The CDP restart interval will get reset to the initial value (governed by CDPRestartInterval setting) and remain constant till the setting is changed to False.

  • False: The CDP restart interval will double if no content is available.

String

True/False

disableCachedLogin

HKLM\Software\Novell\ZCM

You can use this key to turn on the Disconnected Mode Login feature on Citrix or terminal servers. By default, this feature is disabled on Citrix or terminal servers and enabled on desktop machines.

To improve the login performance, disable the caching of credentials for disconnected mode login on terminal server class machine, by setting the value of this registry key to True.

String

True / False

DisableHonorADCacheLogin

HKLM\Software\Novell\ZCM\ZenLgn

By default, ZENworks login uses the AD cache login when the managed device is out of network or not connected to VPN. If this key is set to 1, then AD cache login will not be used and the request will be sent to the Primary Servers for authentication. It is recommended to set this key to 1 if the zone has at least one Primary Server in DMZ.

DWORD

1

DisableChangePasswordPrompt

HKLM\\SOFTWARE\\Novell\\ZCM\\ZenLgn

You can use this key to disable the change password prompt displayed by the ZENworks agent, when the password expires.

DWORD

1

DisableExplorerRestart

HKLM\Software\Novell\ZCM\GroupPolicy

This registry key ensures that ZENworks Configuration Management does not restart the Windows explorer.

String

True / False

DisableForegroundLockTimeoutReset

HKLM\Software\Novell\ZCM\NAL

This registry key is a Windows setting designed to prevent newly launched applications from moving into the foreground. By default, the ZCM agent will reset the registry key to 0 on every boot so that the ZCM applications are moved to the foreground. Setting up this registry key will prevent ZCM from resetting the ForeGroundLockTimeout registry key to 0. This helps the administrator to set the ForeGroundLockTimeout registry key to either a default value or a required value.

DWORD

0

DisablePassiveModeLogin

HKLM\Software\Novell\ZCM\ZenLgn

To disable login to the Management Zone when the user logs in through the Microsoft or Novell client.

DWORD

Any value other than zero

DisablePassiveModeLoginPrompt

HKLM\Software\Novell\ZCM\ZenLgn

To disable the ZENworks login prompt that appears if login through the Microsoft client or Novell client fails. For more information, see Locate the following key in the registry on the user’s device: in the ZENworks User Source and Authentication Reference.

DWORD

Any value other than zero

DisableShortcutScanning

HKLM\Software\Novell\ZCM\

To prevent the scan, during every refresh, for bundle icons that are pinned or unpinned by the end-user in the Start menu and the Taskbar.

Applicable for Windows 10 and later.

DWORD

Any value other than zero

DisableZENCredentialProvider

HKLM\Software\Novell\ZCM\ZenLgn

The ZENworks Credential Provider filters the Windows Password Credential Provider. When you install the ZENworks Agent on the Windows Vista or later versions and Windows 2008 Server or later versions device that has third-party products with Credential Providers installed, multiple user tiles are displayed.

For more information, see “Disabling the ZENWorks Credential Provider on a Device” in the ZENworks User Source and Authentication Reference.

DWORD

1

DLUHelperThreadWaitRetries

HKLM\Software\Novell\ZCM\ZenLgn

To set retries for applying the DLU policy successfully on slower devices or devices where services take more time for initialization.

DWORD

Any value greater than 10 (Default is 10)

DnDLogger

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

Windows Proxy SQLite database

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

DonotFetchUserGroups

HKLM\Software\Novell\ZCM\AgentSettings

To significantly improve the time taken to log in to a managed device, if a Dynamic Local User policy that has no login restrictions configured is assigned to the device.

For more information, see Dynamic Local User Policy in the ZENworks Configuration Policies Reference.

String

True

Dontdisplaylastusername

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System

This key removes any user account names from the Windows logon welcome screen and forces user to enter password and user name when logging in.

DWORD

1

DontUpdateGroupMemberships

Windows 32-bit:

HKLM\Software\Novell\Nwgina\DynamicLocalUser

Windows 64-bit:

HKLM\Software\Wow6432Node\Novell\Nwgina\DynamicLocalUser

To update group memberships of the user on the managed device.

For more information, see Unable to update the group membership of the user on the managed device in the ZENworks Configuration Policies Reference.

String

0

DisableBlankScreen

HKLM\Software\Novell\ZCM\Remote Management\Agent

To disable the blank screen option during remote management.

DWORD

Any value other than zero

eDIRLogin

HKLM\Software\Novell\ZCM\ZenLgn\

This key helps you to identify the login domain of the user. If the value is set to 1, the user is in Novell eDirectory.

DWORD

1

EnableBatchRefresh

HKLM\Software\Novell\ZCM\

To refresh the user sessions on a device in batches, set this registry key value to 1.

For more information, see The partial or the general refresh of a terminal server might cause high usage of system resources and take considerable time to refresh the server in the ZENworks Agent Reference.

String

1

EnableAccessLog

HKLM\Software\Novell\ZCM\Satellite

Enables access log for jetty. Default value is true. Restart the jetty service for the changes to take effect.

String

True

EnableCredManForceLogin

HKLM\Software\Novell\ZCM

To enable Credential Manager force login.

String

True

EnableEDirPasswordForFA

Windows 32-bit:

HKLM\Software\Novell\Nwgina\DynamicLocalUser

Windows 64-bit:

HKLM\Software\Wow6432Node\Novell\Nwgina\DynamicLocalUser

To enable a Dynamic Local User in logging in to a device again after logging out of the managed device that is disconnected from the network.

For more information, see Dynamic Local User Policy Troubleshooting in the ZENworks Configuration Policies Reference.

DWORD

1

EnableSeamlessLogin

HKLM\Software\Novell\ZCM\ZenLgn\

Enables seamless authentication for a user on a device.

This registry key will ensure that all user sources are searched to identify the user who has logged in.

For more information, see Enabling Seamless Authentication on a Device in the ZENworks User Source and Authentication Reference.

DWORD

1

EnableSecretStore

HKLM\Software\Novell\ZCM\ZenLgn\

To log in to a ZENworks server that has a Secret Store configured, set this registry key value to 1.

For more information, see Authenticating in to a ZENworks Server That Has Novell SecretStore Configured in the ZENworks User Source and Authentication Reference.

DWORD

1

EnableStatusMessages

HKLM\Software\Novel1\Authentication

To disable the login status messages on a device screen, set this registry key value to 0.

For more information, see Disabling the Login Status Messages Display on the Device Screen in the ZENworks User Source and Authentication Reference.

DWORD

0

EnableTraditionalCasa

HKLM\Software\Novell\ZCM

To enable the older Casa Auth Client component and micasa as secret store, by setting the value of this registry key to True.

This registery key is used in the following scenarios:

  • When you do not want to change the existing CASA Auth Client and micasa component to newly added CASA components.

  • If a user has issues due to the newly added CASA Auth Client component, the user can switch to the older CASA components.

IMPORTANT:ZENworks Agent maintains the following secret stores for caching the user credentials:

  • HKLM\Software\Novell\ZCM\EnableTraditionalCasa (Reg_SZ): A successful log in is required after setting to True and log off or log in again. This will ensure that credentials will be cached in old CASA store and will be used for further cache logins using old CASA store.

  • HKLM\Software\Novell\ZCM\EnableTraditionalCasa (Reg_SZ): A successful log in is required after setting to False and log off or log in again. This will ensure that credentials will be cached in newly added CASA store and will be used for further cache logins using old CASA store.

String

True / False

EnableZENMemoryCache

HKLM\Software\Novell\ZCM

To improve the login performance on Terminal servers, enable the caching of objects in memory.

String

True / False

EnableZENMemoryKeyCache

HKLM\Software\Novell\ZCM

This registry key creates a memory cache for storing keys of all the cached entires. You can use this memory cache to look up if a particular entry is cached or not, in a Terminal server multiuser login scenario. If the entry is not cached, then the unnecessary access to the persistent cache can be avoided.

String

True / False

EndUserSettings

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

End user settings and preferences SQLite database

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

EndUserSettingMaxAgeDays

HKLM\Software\Novell\ZCM

This registry key retains the end-user pin or unpin settings for 30 days by default. You can change default settings.

If any bundles are not getting used, after certain period the user location preferences for those bundles are cleared.

Applicable for Windows 10 or later.

DWORD

fileInfo

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

ZenCache SQLite database for file information.

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

ForceHKLMandNoDPAPI

HKLM\Software\Protocom\SecureLogin

To log into the ZENworks Server, while logging into a Windows Vista device, set this registry key value to 1.

DWORD

1

ForceDAUCleanUp

HKLM\SOFTWARE\Novell\ZCM\ActionHandler\

Force DAU cleanup after rebooting the device and without the user logging into the device. From ZENworks 2020 Update 2 and later versions, you can set this registry key and force DAU cleanup after reboot without user login.

String

True

Full

HKLM\Software\Novell\ZCM\Migration\MSIOptions\

Displays a full user interface (Wizard dialog boxes, progress information, error messages and prompts, and so forth).

String

/qf

GPOSecuritySettingsTimeout

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\GroupPolicy

On Logout, while applying GPO Security settings, the process ends in an endless wait which hinders the DLU policy handler and Browser bookmark policy handlers to run, in turn causing policy issues. To handle, the endless wait, add the registry key and set the value to 4000, which is the ideal time.

String

4000

By default, the value is 50000. If the registry key is added then the timeout value will be overridden to 4000.

HonorActionHandlerSetting

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\ActionHandler\

Helps environment variables to get resolved in different bundle action context. For example: If the bundle action is set to run as system user, then all the environment variables in the bundle action data will be resolved in the system context.

String

True

HonorClient32WorkstationOnlyCheckbox

HKLM\Software\Novell\ZCM\ZenLgn

To log in directly into a Windows XP workstation that has both the Novell Client and the ZENworks Agent installed, set this registry key value to 1.

For more information, see Logging Directly in to a Workstation That has Both Novell Client and ZENworks Agent Installed in the ZENworks User Source and Authentication Reference.

DWORD

1

HonorLocationChangeForContentDownload

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

This registry key allows you to define if the content download that is in progress should honor the new location change based on the CSR ,or should continue downloading the content from the previous location whenever there is a location change.

By default, the value is considered as 'True' if the registry does not exist or is not set to 'False'.

String

True

HonorTESSFireSchedule

HKLM\Software\Novell\ZCM\

If the pastdue schedule is not enabled, prior to triggering the event, the Scheduler will check if the current time is within the configured schedule. If it is not, the schedule will be skipped.

String

True

HonorWorkstationOnlyLogin

HKLM\Software\Novell\ZCM\

To log in directly into a Windows Vista/ Windows 7/Windows 8 or Windows 10 workstation that has both the Novell Client and the ZENworks Agent installed, set this registry key value to 1.

For more information, see Logging Directly in to a Workstation That has Both Novell Client and ZENworks Agent Installed in the ZENworks User Source and Authentication Reference.

DWORD

1

HKLM\SOFTWARE\Novell\ZCM\INV_CDF

To launch the Collection Data Form (CDF) in the background.

By default the CDF will appear in front of an active application. Use this registry key to reverse the default behavior.

IgnorePrezenworksSecuritySettings(REG_SZ)

HKLM\Software\Novell\ZCM\GroupPolicy

To exclude the local group policy security settings from being backed-up and restored.

String

True

IsNalLoggingDisabled

HKLM\Software\Novell\ZCM\\NAL\

To disable debug logging for Nalshell.

NOTE:This registry key can be used only when the managed device logging is set to Debug and above.

DWORD

1

JettyConfigSendServerVersion

HKLM\Software\Novell\ZCM\Satellite

Allows users to remove Satellite Server information from the HTTP header.

Restart the jetty service for the changes to take effect.

String

False

LocalAccountTokenFilterPolicy

HKLM\Software\Microsoft\Windows\CurrentVersion\Policies\System\LocalAccountTokenFilterPolicy

Windows Vista (32-bit)

Windows Server 2008(32-bit)

Windows 7 and Windows Server 2008 R2(32-bit)

Allows remote users to log in and not be forced to be guest. For more information see, Enabling Classic File Sharing in the ZENworks Discovery, Deployment, and Retirement Reference.

DWORD

1

LogoffCheckSysModules

HKLM\System\CurrentControlSet\Control\Citrix\wfshell\TWI

To completely terminate a session on the Citrix server and ensure that policies are unenforced on the device.

For more information, see Closing a published application or logging out of the shared desktop of a Citrix server fails to terminate the session on the Citrix server in the ZENworks Configuration Policies Reference.

String

Change the value from ZCMUMHelper.exeto ZenUserDaemon.exe, ZCMUMHelper.exe

ManualDeviceRefresh

HKLM\Software\Novell\ZCM\

To disable the general refresh for a device session on a Windows device, set this registry key value to Disabled.

For more information, see By default, the general refresh on a Windows device refreshes both the device and user sessions. in the ZENworks Agent Reference.

String

Enabled/Disabled

MigrateWithParentOptions

HKLM\Software\Novell\ZCM\Migration\MSIOptions\

MSPs are migrated in Silent mode.

String

0

MaxValue

HKLM\Software\Novell\ZCM\ZenLgn\History\ZenCacheLimit

To specify the number of credentials that can be cached on a device at any point of time, use this registry key.

DWORD

Specify a number from 1 to 100

MaxLogFileSize

HKLM\Software\Novell\ZCM\ZenLgn\MaxLogFileSize

To retain the old logs and append the new logs in the zenlgn.log file, specify in Kilo Bytes.

DWORD

1024

MaxLogFileSize

HKLM\Software\Novell\NWGINA\MaxLogFileSize

To retain the old logs and append the new logs in the nwgina.log file, specify in Kilo Bytes.

DWORD

1024

MaxZenPrinterProcessingTimeOut

 

To set a default value that forces the Printer policy handler to wait for a set amount of time.

For more information, see Printer Policy Troubleshooting in the ZENworks Configuration Policies Reference.

String

Specify an appropriate time out value in seconds.

MergedCacheRequired

HKLM\Software\Novell\ZCM\GroupPolicy

To enable the merged cache feature, set this registry key to a non-zero value.

String

Any value other than zero

maxinitialscreen

HKCU\Software\Novell\ZCM\Remote Management\Viewer\History\device~50

*device can be IP name or hostname

If no entry is found for device, then the registry value should be created under Default key.

Before launching remote control session, enable the registry key to auto-fit the remote viewer in the Management Console screen, when the scale by setting is set to auto in the ZENworks Remote Management Viewer options window.

DWORD

Any value other than zero.

mdstatus

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

Status Library SQLite database

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

NalShellDelay

HKLM\Software\Novell\ZCM\NAL

Configure delay time in seconds for NalShell in the registry key. Based on the configured time in the registry parameter explorer delays the loading process of Nalshell.

DWORD

Specify any value in seconds other than zero.

objInfo

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\CacheDBPragmas

ZenCache Object Info database

String

Journal Mode=Wal;Synchronous=Normal;

For information on the modes see:

PassiveMode

HKLM\Software\Novell\NWGINA

To start Novell SecureLogin seamlessly, set this registry key value to 1.

For more information, see Troubleshooting User Sources in the ZENworks User Source and Authentication Reference.

DWORD

1

PERMISSION_MSG_POSTPONES_REMAINING

HKLM\Software\Novell\ZCM\System Update

The value of this key determines the number of times the user can postpone an update.

For more information, see Configuring the System Update Behavior of the ZENworks Agent in the ZENworks System Updates Reference.

String

Specify the number of times you need to postpone the update.

PersistPolicyatUserLogout

HKLM\Software\Novell\ZCM\GroupPolicy

To persist the user association with the Group Policy Object (GPO) even after logging out of the device.

The settings persists only if the same user logs into the device all the time.

For more information, see User associated Group Policy Object does not persist after logging out of the device

String

Any value other than null

PingRetryCount

HKLM\Software\Novell\ZCM\

Controls the number of retries the ZENworks Agent attempts after failing to connect to a ZENworks Server during a device refresh. The default is 1 retry.

For more information, see Troubleshooting the ZENworks Agent in the ZENworks Agent Reference.

String

Any value. Use 0 to specify no retries.

PreferredCollectionRollUpServer

64 bit Windows (Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP):

HKLM\Software\Wow6432Node\Novell\ZCM\Satellite\PreferredCollectionRollUpServer

32 and 64 bit Windows (Windows 7 and Windows Server 2008 R2, and later):

HKLM\Software\Novell\ZCM\Satellite\PreferredCollectionRollUpServer

To assign a different Primary Server to the Satellite, to roll up collection items instead of using a parent Primary Server.

NOTE:The server URL should use the HTTPS scheme, as the communication between Satellite Servers and Primary Servers is over SSL. If the server URL does not begin with any scheme, by default, the communication is over HTTPS.

String

Multiple URLs delimited by ‘,’

Examples:

  • https://rrt-sles11sp3.epm.blr.novell.com:443/

  • https://10.71.56.94

    If the port number is 443, specifying it is optional. However, if the port number is any other value, then you need to specify it.

PrintWaitTime

HKLM\Software\Novell\ZCM\PrinterPolicy

To install a Samba or a network printer by using a Printer policy.

For more information, see Printer Policy Troubleshooting in the ZENworks Configuration Policies Reference.

String

200

ProceedPatchUninstallSetting

HKLM\SOFTWARE\Novell\ZCM\PatchManagement

Allows you to uninstall a patch bundle.

From ZENworks 11.3.1 onwards, the Uninstall application if not used within_days option in the Uninstall Options dialog will not be honored for Patch bundles. Use this registry key to honor this option for Patch bundles.

String

True

Progress

HKLM\Software\Novell\ZCM\Migration\MSIOptions\

Displays simple progress information and error messages/prompts.

String

/qb!

QuickTaskMaxWaitTime

HKLM\\SOFTWARE\\Novell\\ZCM\\ActionHandler

To configure the Quicktask refresh waiting time on the agents.

DWORD

Any value between 20 to 200 seconds.

The default value is 200 seconds. If there are fewer devices in the zone, this value can be reduced.

read-timeout

Windows: HKLM\Software\Novell\ZCM

Linux:

/etc/opt/novell/zenworks/conf/xplatzmd.properties

To set the read time out value of an Agent on a device, set this registry key value to 100.

For more information, see Troubleshooting the ZENworks Agent in the ZENworks Agent Reference.

String

100

ReadCachedDN

HKLM\Software\Novell\ZCM\ZenLgn

Enables the ZENworks agent to avoid using the cached Distinguished Name (DN) on the managed device when the user attempts to log into ZENworks Server.

This registry key needs to be used when the sAMAccountName and the Common Name for the user objects are different in ActiveDirectory. If this key is not used on the managed device, ZENworks login might fail when a change is made to the user object (Example: Moving an object to a different container or renaming the user name.)

DWORD

0 - To avoid using the cached DN.1 - To use the cached DN.

ReApplyPolicyatDeviceStartup

HKLM\Software\Novell\ZCM\GroupPolicy

To apply Group policy again at device startup even if there is no change in the group policy. This is useful when group policy has security settings, which are not registry configurable. For example: Deny local login.

For more information, see Windows Group Policy Troubleshooting in the ZENworks Configuration Policies Reference.

String

Any value other than null

ReApplyPolicyatUserPredeskTop

HKLM\Software\Novell\ZCM\GroupPolicy

If you have assigned Group Policy settings to a user, they might not always apply on the device.

For more information, see Windows Group Policy Troubleshooting in the ZENworks Configuration Policies Reference.

String

Any value other than null

REBOOT_MSG_POSTPONES_REMAINING

HKLM\Software\Novell\ZCM\System Update

This key specifies the number of times that you can postpone a reboot of an update.

For more information, see Configuring the System Update Behavior of the ZENworks Agent in the ZENworks System Updates Reference.

String

Specify the number of times to postpone an update.

Reduced

HKLM\Software\Novell\ZCM\Migration\MSIOptions\

Displays a full user interface with wizard dialog boxes suppressed

String

/qr

RemoveZenPrintersAtLogout

HKLM\SOFTWARE\Novell\ZCM

To uninstall all installed user assigned printers at logout.You cannot uninstall the user assigned printers at logout, If the value is False.

For more information, see The user-assigned printers are not uninstalled at logout in the ZENworks Configuration Policies Reference.

String

False/True

RestartAgentOnCertActivation

Windows: HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

Linux: etc/opt/novell/zenworks/conf/xplatzmd.properties

To restart the ZENworks agent service after certificate activation.After certificate activation, the ZENworks agent service gets restarted in the following scenarios:

  • When the value of this registry key is set to true/True.

  • When the CA expires.

String

False/True

runBookmarksMappedDrive

HKLM\SOFTWARE\Novell\ZCM

To enforce Browser Bookmarks policy on a managed device, which has redirected home directory for saving bookmarks.

For more information, see Bookmark policy fails with a redirected home directory in the ZENworks Configuration Policies Reference.

String

True

ScheduleRetries

HKLM\Software\Novell\ZCM\

If a bundle with an assignment schedule fails to execute on a device, an attempt to execute the bundle on the device is made five times, by default.

For more information, see Assigning Existing Bundles to Devices in the ZENworks Software Distribution Reference.

String

0

seticonondesktop

HKLM\Software\Novell\ZCM\NAL

Allows you to create the shortcut icons for bundles.

DWORD

1

SendRegKeyOnEveryRefresh

HKLM\Software\Novell\ZCM\

Sends the registration key in the initial-web-service file on every refresh.

If this value is not set to True, the agent will send the registration key only during initial registration, and during a network connect or disconnect.

String

True

SendChildPatchBundleStatus

SOFTWARE\Novell\ZCM\

By default, the SendChildPatchBundleStatus flag is enabled. The agent will upload the child patch bundle status to the server even if the registry is not created. Uploading child patch status to the server causes additional overhead on the server to process the status of child patch bundles also overhead on the agent to upload the status of child patch bundles.

To disable, add the SendChildPatchBundleStatus key and set to false.

String

True

ShowChangePasswordMenuItem

HKLM\Software\Novell\ZCM\ZenLgn

Controls the behavior of displaying or hiding the ChangePassword menu item options.

  • True: Displays the ChangePassword menu option in the ZENworks Application tray icon.

  • False: The ChangePassword menu option in the ZENworks Application tray icon will be hidden.

String

True/False

ShowRebootPromptOnDesktopUnlock

HKLM\\SOFTWARE\\Novell\\ZCM\\SystemUpdate

After completing the system update, displays the reboot prompt immediately when the desktop is unlocked.

String

True

ShowCancelInPrompt

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\ActionHandler\ShowCancelInPrompt

Displays the Cancel button when the Prompt User action is configured with the Users Canceled Allowed value set as 1 or more.

If the value of this registry key is set to True then the Cancel button is displayed, else, the Postpone button is displayed.

String

True

ShowDefaultNotifications

HKLM\SOFTWARE\Novell\ZCM\SystemUpdate

By enabling this key, the explorer will not be restarted during System Update and all the System Update notifications will be displayed as metro notifications. This key is applicable only for Windows 10 (version 1903) or later platforms.

String

True

ShowPowerOptions

SOFTWARE\Novell\ZCM\ZAPP

To avoid the display of the power options when zapp is launched in shell mode or launched using the /s command line parameter.

If the value is set to False, the power options will not be displayed in the shell mode or when launched using the /s parameter.

String

False

ShowToolTips

HKLM\SOFTWARE\Novell\ZCM\ZAPP

To prevent the display of tooltips in ZENworks Application (ZAPP).

If the registry key is set to False, tooltips will not appear in ZAPP.

If the registry key is set to anything other than False, tooltips will appear in ZAPP

String

False

ShutdownOnTimeout

Windows: HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\ActionHandler

Linux: etc/opt/novell/zenworks/conf/xplatzmd.properties

To cancel the reboot or shutdown action on a device when the value of this registry key is set to No and the user does not act on User Cancel prompt.

To reboot a device when the value of ShutdownOnTimeout registry key is set to Yes.

String

Yes/No

Silent

HKLM\Software\Novell\ZCM\Migration\MSIOptions\

Displays no user interface.

String

/qn

SkipIPrintClientValidation

HKLM\Software\Novell\ZCM\Migration

To migrate an iPrint policy that does not have the policy setup file associated with it, set the value of this registry key to false.

String

False /True

SkipUserPermissionOnDeviceLock

HKLM\Software\Novell\ZCM\Remote Management\Agent

If the registry value is set to 1 on the managed device, it skips the permission from local Windows user (even with “Ask User Permission” setting enabled in the effective remote management policy) when remote operator initiates remote management operation to the same device in the locked state.

After adding the registry key, restart the Remote Management services or restart the device.

DWORD

1/0

SkipZAPPLaunch

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\ZAPP\SkipZAPPLaunch

To ensure that ZAPP is not launched by the policy handler.

String

True

SortDLUPolicies

HKLM\SOFTWARE\Novell\ZCM\Dynamic Local User

By enabling this registry key, the ZENworks agent is forced to select the first policy by alphabetically ordering the DLU policies that are assigned to a user.

String

True

TimeToWaitBeforeLocationSwitch

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

This registry key is used to define the time to wait before switching to an unknown location, whenever there is a location change. By default, it is 5000 milliseconds if the key is not defined.

This means if the content download process comes in an unknown location between network switching from location 1 to location 2, it will wait for 5000 milliseconds and then trigger a “ConfigLocationChanged” event on the agent.

If this key is set to 0 then it will trigger “ConfigLocationChanged” as soon it sees an unknown location.

Integer (in milliseconds)

Unknown

TurnOffDFSCheckForUNC

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM

This registry key is enabled to skip the DFS verification on the UNC path.

Enables faster access of CIFS shares.

String

True

UMUserFullName

HKLM\Software\Novell\ZCM\Usage

For user login name, to change the setting from User ID to Full Name mode, set this registry value to 1.

For more information, see Troubleshooting the ZENworks Agent in the ZENworks Agent Reference.

String

1 / 0

upload-timeout

Windows: HKLM\Software\Novell\ZCM\

Linux:/etc/opt/novell/zenworks/conf/xplatzmd.properties

To set the default upload timeout value of an Agent on a managed device, set this registry key value to 200.

For more information, see Troubleshooting the ZENworks Agent in the ZENworks Agent Reference.

String

200

USBChanges

HKLM\Software\Novell-ZES\Debug

Works in conjunction with the VolumeChanges registry key to disable scanning of USB devices.

Activates previously unrecognized USB devices.

DWORD

0

UseProxyForRoles

HKLM\Software\Novell\ZCM\

Determines the usage of HTTP proxy for the following server roles: Configuration, Collection, Content or Authentication.

String

A comma-separated list of server roles. The server roles could be any of the following: CONFIGURATION,CONTENT, AUTHENTICATION or COLLECTION.

Example: For the CONTENT role (single role), the registry key value should be "CONTENT"and for the CONFIGURATION, COLLECTION and AUTHENTICATION roles (multiple roles), the value should be “CONFIGURATION,COLLECTION, AUTHENTICATION”.

UserDaemonRetries

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\UserDaemon\UserDaemonRetries

If user is not logged in to the device, then this configuration determines how many times the HKCU bundle system requirement retries to get the user daemon.

DWORD

Specify a number.

VolumeChanges

HKLM\Software\Novell-ZES\Debug

Works in conjunction with the USBChanges registry key to disable scanning of USB devices.

Activates previously unrecognized USB devices.

DWORD

0

WaitForDesktopToUnlock

HKEY_LOCAL_MACHINE\Software\Novell\zcm\SystemUpdate

To postpone the reboot of the device, after a system update, till a user logs into the device.

String

True/False

WaitForZENService

HKLM\Software\Novell\ZCM\

To enable the user to login even when the ZEN Agent Service has not started.

DWORD

0 - ZENworks Agent will not wait for the ZEN Agent Service to start during user login.1 - ZENworks Agent will wait for the ZEN Agent Service to start during user login.

WaitToKillServiceTimeout

HKLM\Software\Novell\ZCM\ActionHandler

Allows you to configure the service timeout value for services managed by ZENworks. If this registry key is not configured, then default Windows timeout values will be used.

String

Any positive integer value. (Example: 30000 for 30 seconds)

WaitForWatcher

HKLM\SOFTWARE\Novell\ZCM\SystemUpdate

Forces a device reboot after the device is updated, even if the user is not logged-in.

String

False

WEBUSAGE_FIREFOX

HKLM\Software\Novell\ZCM\

To Enable or Disable Web Usage Tracking on Firefox. By default Web Usage Tracking will be enabled on Firefox.

String

True/False

WEBUSAGE_IE

HKLM\Software\Novell\ZCM\

To Enable or Disable Web Usage Tracking on Internet Explorer. By default Web Usage Tracking will be enabled on Internet Explorer.

String

True/False

WEBUSAGE_CHROME

HKLM\Software\Novell\ZCM\

To Enable or Disable Web Usage Tracking on Chrome. By default Web Usage Tracking will be disabled on Chrome.

NOTE:If you enable web application usage on the Chrome browser, the browser might hang intermittently.

String

True/False

WEBUSAGE_EDGE

HKLM\Software\Novell\ZCM\

To Enable or Disable Web Usage Tracking on the Edge browser. By default Web Usage Tracking will be disabled on the Edge browser.

NOTE:If you enable web application usage on the Edge browser, the browser might hang intermittently.

String

True/False

WEB_SERVER_PORT

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\

To set the QuickTask port on the ZENworks managed device.

For more information, refer to TID 7016363 in the knowledgebase.

DWORD

A 32-bit number.

ZenNotifyConnectionTimeOut

HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ZCM\

To configure the timeout value in seconds for a ZENworks service to update the ZenNotifyIcon Progress window.

The ZENworks service calls the ZenNotifyicon process to update the bundle's progress in the ZenNotifyIcon Progress window, and waits for ZenNotifyIcon to update the bundle's progress and return the call.

If the ZenNotifyIcon process does not return the call to the ZENworks service within the timeout period, then the ZENworks service will proceed to the next action in the bundle schedule.

DWORD

Any value greater than zero (in seconds).

ZENThreadPoolMax

HKLM\Software\Novell\ZCM\

This registry key defines the maximum thread count in ZENworks thread pool. The default value is 150 on a Terminal server and 50 on other devices.

String

Specify a number.

ZENThreadPoolMin

HKLM\Software\Novell\ZCM

This registry key defines the minimum thread count in ZENworks thread pool. The default minimum thread count is 3. Specify a number greater than the default value.

String

Specify a number.

IMPORTANT:ZISWINClear

HKLM\Software\Novell\ZCM

When this string value is set to 1, ZISWIN clears all the Image Safe data and exits without performing any other task.

For more information, see Novell ZENworks ISD Service in .ZENworks Preboot Services and Imaging Reference

String

1

ZISWIN DIsabled

HKLM\Software\Novell\ZCM

When this string value is set to 1, ZISWIN exits without performing any task.

For more information, see ZENworks Preboot Services and Imaging Reference.

String

1

ZISWIN Reset Flag

HKLM\Software\Novell\ZCM

When this string value is set to 1, ZISWIN sets the Just Imaged flag to FALSEexits without performing any other task.

For more information, see the ZENworks Preboot Services and Imaging Reference.

String

1

ZISWIN Do Not Restore Mask

HKLM\Software\Novell\ZCM

You can use this DWORD to specify the Image Safe data component that you do not want ZISWIN to restore to the Windows registry after a successful completion of an image. This value is interpreted as a mask.

For more information, see the ZENworks Preboot Services and Imaging Reference.

DWORD

Desired value of the Image Safe data component.

ZISWIN SYSPrep Restore Mask

HKLM\Software\Novell\ZCM

If you are using the SYSPrep process to mask the Image Safe data components, then use this registry key.

For more information, see ZENworks Imaging Engine Commands in the ZENworks Preboot Services and Imaging Reference.

DWORD

Desired value of the Image Safe data component.

ZISWIN Do Not Collect Mask

HKLM\Software\Novell\ZCM

You can use this DWORD to specify the components that you do not want ZISWIN to collect in the Image Safe data.

For more information, see Component Masks in the ZENworks Preboot Services and Imaging Reference.

DWORD

Desired value of the Image Safe data component.

ZISWIN Clear Mask

HKLM\Software\Novell\ZCM

You can use this DWORD to specify the components that you want ZISWIN to clear from the Image Safe data.

For more information, see Component Masks in the ZENworks Preboot Services and Imaging Reference.

DWORD

Desired value of the Image Safe data component.