Citrix Virtual Apps and Desktops

Log policy settings

This section contains policy settings that configure Profile Management logging.

Active Directory actions

This setting enables or disables verbose logging of actions performed in the Active Directory.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured in the Citrix Studio, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Common information

This setting enables or disables verbose logging of common information.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Common warnings

This setting enables or disables verbose logging of common warnings.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Enable logging

This setting enables or disables Profile Management logging in debug (verbose logging) mode. In debug mode, extensive status information is logged in the log files located in “%SystemRoot%\System32\Logfiles\UserProfileManager”.

By default, this setting is disabled and only errors are logged.

Citrix recommends enabling this setting only if you are troubleshooting Profile Management.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured here or in the .ini file, only errors are logged.

File system actions

This setting enables or disables verbose logging of actions performed in the file system.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

File system notifications

This setting enables or disables verbose logging of file systems notifications.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Logoff

This setting enables or disables verbose logging of user logoffs.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Logon

This setting enables or disables verbose logging of user logons.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Maximum size of the log file

This setting specifies the maximum permitted size for the Profile Management log file, in bytes.

By default, this value is set to 1048576 bytes (1 MB).

Citrix recommends increasing the size of this file to 5 MB or more, if you have sufficient disk space. If the log file grows beyond the maximum size:

  • An existing backup of the file (.bak) is deleted
  • The log file is renamed to .bak
  • A new log file is created

The log file is created in %SystemRoot%\System32\Logfiles\UserProfileManager.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured here or in the .ini file, the default value is used.

Path to log file

This setting specifies an alternative path to save the Profile Management log file.

By default, this setting is disabled and log files are saved in the default location: %SystemRoot%\System32\Logfiles\UserProfileManager.

The path can point to a local drive or a remote network-based drive (UNC path). Remote paths can be useful in large distributed environments but they might create significant network traffic, which might be inappropriate for log files. For provisioned, virtual machines with a persistent hard drive, set a local path to that drive. This setting ensures that the log files are preserved when the machine restarts. For virtual machines without a persistent hard drive, setting a UNC path allows you to retain the log files. However, the system account for the machines must have write access to the UNC share. Use a local path for any laptops managed by the offline profiles feature.

If a UNC path is used for log files, Citrix recommends that an appropriate access control list is applied to the log file folder. This setting ensures that only authorized user or computer accounts can access the stored files.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured here or in the .ini file, the default location %SystemRoot%\System32\Logfiles\UserProfileManager is used.

Personalized user information

This setting enables or disables verbose logging of personalized user information.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Policy values at logon and logoff

This setting enables or disables verbose logging of policy values when a user logs on and off.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Registry actions

This setting enables or disables verbose logging of actions performed in the registry.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information

Registry differences at logoff

This setting enables or disables verbose logging of any differences in the registry when a user logs off.

By default, this setting is disabled.

When enabling this setting, make sure the Enable logging setting is also enabled.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured in the Citrix Studio or in the .ini file, the following is logged:

  • Errors
  • General information
Log policy settings