Environment Manager powered by AppSense

Advanced Settings

Advanced Settings enable an administrator to make changes to specific database and communications settings. Changes made to any setting within here will affect the operation of user personalization for all managed endpoints. Advanced Settings should only be added as advised by Support.

With this option, new settings can be created whilst existing ones can be removed, edited or restored to their original install value.

In this section:

Manage Advanced Settings

  1. Select the User Personalization navigation button.
  2. From the Manage ribbon, click Advanced Settings.

    The Advanced Settings dialog displays. Any settings displayed in bold are those which have been edited or added to the default settings.

  3. Change the Advanced Settings list as required:
    • Change value - Click in the value for the required setting enter a new one.
    • Add an Advanced Setting - Click Add, enter the Name, Value and optional Description for a new Advanced Setting and click Close.
    • Remove an Advanced Setting - Highlight an Advanced Setting and click Remove.
    • Restore the Advanced Settings list - Click Restore to reset the list to its initial install state; all values are reset and any created entries are removed.

Caution: If VirtualizationFiles or VirtualizationRegistry are set to false, personalization will not function correctly.
Adjusting the setting for offline_restorerate and offline_samples can impact on personalization performance.
Do not change these values unless advised by our Support team.

Advanced Settings List

Environment Manager contains the following global settings:

Group Default Value Description
ArchiveLocalProfilesOnly true Set whether to archive all profiles or only local profiles.
AutomaticArchiveIntervalDays 1 Set the number of days between when archives are created.
AutomaticArchiveStartTime 01:00 The time (hh:mm) at which daily archiving and purging takes place. The timezone settings from the personalization database will be utilized.

If the time is not in the correct format, archiving will not work and an error message will appear in the Windows Application log on the Personalization Server. If there are multiple Personalization Servers error messages will appear on all servers.

The time zone of this time is the time zone of the SQL Server machine - not the Personalization Server machines. This is to match the 8.0 behavior (when archiving was done by SQL Server Agent).

commsloggingenabled false Enables or disables communications logging on the managed endpoints. True or false.

When set to true, all clients produce logs of communications with the personalization server.  These logs show all personalization activity to give confidence that personalization is working correctly.  The logs are by default written to the user’s local application data folder, for example, C:\Users\username\AppData\Local\AppSense\Environment Manager\CommsLogs, but if diagnostic logging is enabled the logs are written instead to logdirectory\user’ssid\CommsLogs.

Comms logging may be enabled for an individual endpoint by defining the registry DWORD value HKEY_LOCAL_MACHINE\Software\Appsense\Environment Manager\CommsLoggingEnabled on the endpoint and setting it to 1.  To enable for a single user define HKEY_CURRENT_USER\Software\Appsense\Environment Manager\CommsLoggingEnabled instead.

When diagnostic logging is enabled on an endpoint, all the information that appears in the comms logs will also appear in the diagnostic logs too - the comms logs merely provide a short summary of personalization activity.

configpoll 600 The interval (in seconds) in which the managed endpoints poll the personalization server for configuration changes

Setting this value to 60 seconds or less leads to a large increase in memory from the WinHTTP code.

daysofcommslogtokeep 3 When communications logging is enabled (using the commsloggingenabled option), this setting specifies the number of days logs to retain.
debug false Enables logging of synchronizer activity for each application on all endpoints.  These logs are written to the profile cache for each application in the logs subdirectory directory. For example, C:\appsensevirtual\S-1-5-21-3975584332-491336430-3592548699-1104\{58A6B7A8-C2F6-43E1-88AC-07531B5D53A8}\notepad\logs.
desktopinclusions jpg;jpeg;bmp;ico;cur;ani File types to be included for personalization of desktop settings for a user.
DNS_Resolve_Timeout 5 The timeout (in seconds) for the managed endpoint to resolve the personalization server name when attempting synchronization of data.
HTTP_Connect_Timeout 5 The managed endpoint to personalization server reconnect timeout (in seconds). This setting is only valid once the managed endpoint has received and loaded the personalization configuration for the first time.
HTTP_Receive_Timeout 30 The managed endpoint to personalization server receive timeout (in seconds). This setting is only valid once the managed endpoint has received and loaded the personalization configuration for the first time.
HTTP_Send_Timeout 30 The managed endpoint to personalization server send timeout (in seconds). This setting is only valid once the managed endpoint has received and loaded the personalization configuration for the first time.
InactiveProfileExpiryMonths 0 The expiry time (in months) for inactive profiles, after which time they are deleted. Set to 0 to disable this option.
InactiveUserExpiryADCheck true If set to true, users are only deleted if they no longer exist in active directory. This setting is only applicable if the InactiveUserExpiryDays is non-zero.
InactiveUserExpiryDays 180 The expiry time for inactive users. If a user does not log in within the specified time, their profile is deleted. Set to 0 to disable this option.
InactiveUserExpiryMonths 0 The expiry time (in months) for inactive users. If a user does not log in between the specified time, their profile is deleted. Set to 0 to disable this option.
jpgquality 50 The amount of compression to apply (as a percentage) used when converting a desktop wallpaper from BMP to JPG for personalization database storage. 100 = best quality, no compression. 0 = worst quality, maximum compression.
LegacyFbrDeleteDelayDays 30

The number of days after which legacy FBR files are deleted from a profile where a hive file has been created by a later client. To disable this setting, apply a 0 value.

This setting is only applied if the UpgradeFbrHive property is enabled following an upgrade.

linkfailretrypolltimescales 90 The configuration poll period (in seconds) used by the managed endpoint when communication with the personalization server is lost.
ManagePersistentDat false Enable management of the persistent.dat file on the client. If set to false, persistent.dat is not saved to the database.
maxlinkfailbackoffsecs 1800 Used with minlinkfailbackoffsecs to create a random offline config polling time for clients. This ensures that when clients go offline, they do not poll the server simultaneously, which could result in spike in the server load.
minlinkfailbackoffsecs 300 Used with maxlinkfailbackoffsecs to create a random offline config polling time for clients. This ensures that when clients go offline, they do not poll the server simultaneously, which could result in spike in the server load.
MonthsOfUsageDataToKeep 6 The number (in months) of usage data to keep for user applications. Usage data older than this value are deleted by the daily archiving job.
Network_Path_Support False

Enables or disables the personalization of application settings stored on network paths and mapped drives. These must also have been configured as inclusions within personalization.

When set to False network drives are not personalized and application settings are not written to the virtual cache.

Change the setting to True to personalize any application settings written to included network folders.

NumberOfArchivesToKeep 5 Used by the daily archive job, this defines the number of daily archives to retain.
offline_restorerate 100 The communication rate (in kb/second) above which the managed endpoint considers communication with the personalization server to be restored and hence online. This value must be higher than the offline_failrate value.

Adjusting the Global Settings can impact on Personalization performance.

This value is provided for support purposes and should not be modified by the end user.

offline_samples 4 The number of samples, in a moving average, used by the managed endpoint to measure the link transfer rate and detect an offline condition.

Adjusting the Global Settings can impact on Personalization performance.

This value is provided for support purposes and should not be modified by the end user.

PingWebServerTimeOfDayLocal 01:05 Local time that background services ping corresponding servers. It should be set to a time after the personalization server’s daily recycle time.
ProfileCleanupDelayDays 30 The delay before endpoints clean extraneous data from profiles after a change to inclusions or exclusions. Set to 0 for no delay or -1 to disable the cleanup function.
pvcdebug 0 The Personalization Virtualization Component (PVC) debug level for all managed endpoints. 0 is disabled. 10 is verbose.
Setting this value will enable PVC debugging on all endpoints and will have a detrimental effect on performance as well as heavy use of disk space.  It is recommended instead to enable debugging on a per-endpoint basis using registry settings.
ReplicationType none Used in replicated SQL environments to identify master / slave / none for archiving purposes. This value is set by the archiving script and is not recommended to be changed by the user.
syncpoll 900 The interval (in seconds) between managed endpoint retries of failed synchronizations when offline resiliency is enabled.
transport http Transport Type. Only required for backwards compatibility with older versions of the Environment Manager Agent.

This value is provided for support purposes and should not be modified by the end user.

version 3.0 This value is no longer used and will be removed in future versions of Environment Manager.
virtualzationfiles true Enable or disable User Personalization of files for all managed endpoints. True or false.

This value is provided for support purposes and should not be modified by the end user.

virtualizationregistry true Enable or disable User Personalization of registry settings for all managed endpoints. True or false.

This value is provided for support purposes and should not be modified by the end user.


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other