This article describes general troubleshooting steps to take when investigating replication issues with Microsoft User Experience Virtualization (UE-V).
Common scenarios include:
- Settings replicate from one machine to the Settings Storage Path but not from a second machine.
- Settings have replicated to the Settings Storage Path in the past, but are no longer either uploading or downloading correctly.
- Settings for some applications replicate, but not for other applications.
In general, it is recommended to test settings on at least two separate client computers and optionally two user accounts (computerA and computer, userA and userB in the example below). It is also recommended to investigate using a reference application such as Notepad for testing. Most commonly, issues will fall in to one of 4 broad scenarios:
- If settings replicate for UserA but not from UserB on the same computer, the problem lies with UserB.
- If settings replicate for neither UserA nor UserB on computerA, but do successfully replicate for both users on computerB, the problem is with computerA.
- If settings do not replicate for either user on either computer, the problem most likely resides in the server hosting the Settings Store Path, or in an infrastructure issue
- If settings replicate for UserA for some applications but not others, the problem most likely resides in the configuration of the problem application's template
Depending on the scenario you are troubleshooting, use the steps below to further investigate the user(s), computer(s), or application template(s) experiencing the issue.
The checklist below provides a general framework for isolating problem user(s), computer(s), or application template(s):
1. Examine the Microsoft-User Experience Virtualization-App Agent/Operational event log located under Event Viewer\Applications and Services Logs\Microsoft\User Experience Virtualization\App Agent. A successful synchronization will record an entry like the following:
- Log Name: Microsoft-User Experience Virtualization-App Agent/Operational
- Source: Microsoft-User Experience Virtualization-App Agent
- Event ID: 2010
- Task Category: Orchestrator
- User settings for the settings location template "Microsoft Notepad" have been successfully uploaded to the settings storage location.
2. Inspect the Microsoft-User Experience Virtualization-App Agent/Operational event log for any errors or warnings pertaining to the synchronization issue you are investigating.
3. Verify that location information is being updated as expected:
- Open a PowerShell window and navigate to the appropriate subfolder under %localappdata%\Microsoft\UEV\%computername%. For each monitored template, there will be a folder that corresponds to the application's TemplateID (as reported by the Get-UEVTemplate command). Beneath this folder, the most current settings package file will be contained in a folder namedCurrent.
- Check the date modified information (type dir in PowerShell and note theLastWriteTime column, or navigate to the folder in Explorer and reference the Date Modified setting). This should roughly correspond to the time of the last modification of the application.
- Compare the modified date of the file and the file size with the current package in the user's Settings Storage Path.(Get-UevConfiguration).settingsstoragepath data.
4. Run simultaneous traces on both machines to determine the point of failure. Refer to the following Knowledge Base article for instructions on how to enable debug logging: http://support.microsoft.com/kb/2782997 - How To Enable Debug Logging in Microsoft User Experience Virtualization (UE-V).
5. If the UE-V synchronization method (SynMethod) is set to OfflineFiles (the default), verify that Client-Side Caching (also known as Offline Files) is enabled and working properly. Seehttp://technet.microsoft.com/en-us/library/bb457104.aspx for general information on how to implement and troubleshoot Client-Side Caching.
General troubleshooting notes:
- Packages will only be modified if monitored settings are changed. In order to assess whether a package is being replicated, make one or more changes to the application's settings and wait for replication changes.
- Packages are replicated only when the application is launched or exited. Exceptions to this rule are desktop background, Ease of Access, and Desktop settings (http://technet.microsoft.com/en-us/library/jj680033.aspx).
- Notepad is recommended as the preferred application for testing application data replication for UE-V because it is installed on all supported operating systems, is a relatively simple application, and familiar to most users. To test replication via Notepad, open Notepad.exe, click on Format, then click on Font... Modify the size of the font to the next available setting (i.e. change Size from 11 to 12), then click OK to save settings. Exit Notepad to commit the changes. If necessary, repeat these steps on a second computer.
Article ID: 2844022 - Last Review: Mar 4, 2015 - Revision: 1