This page refers to an older version of the product.View the current version of the online Help.
Advanced Personalization 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.
Manage Advanced Settings
- Select the User Personalization navigation button.
-
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.
- 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 or local profiles. |
| AutomaticeArchiveEndTime | 07:00 | The time (hh:mm) at which automatic archiving and purging finishes. The timezone settings from the personalization database will be utilized. |
| AutomaticArchiveIntervalDays | 1 | The number of days between automatic archives |
| AutomaticArchiveStartTime | 01:00 | The time (hh:mm) at which automatic 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 | 86400 | 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. |
| InactiveProfileExpiryDays | 180 | The expiry time (in days) 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. |
| jpgquality | 80 | 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. |
| LegacyDeleteDelayDays | 30 |
The number of days after which legacy data, if present, is deleted. To disable this setting, apply a 0 value. |
| 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. |
|
UpgradeFbrToHive |
true |
When true, endpoints upgrade '.fbr' registry files to '.hive' registry files. Once set to 'true', this setting cannot be set back to 'false'. For information about using this setting with the Profile Migration PowerShell Interface, see UpgradeFBRtohive. |
| version | 3.0 |
The file exchange protocol to be used during client-server communication. 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. |