Upgrading to UE-V 2.0
Updated: December 2, 2013
Applies To: User Experience Virtualization 2.0
If an earlier version of the Microsoft User Experience Virtualization (UE-V) Agent was deployed in your computing environment, you must install the UE-V 2.0 agent to support new features of UE-V 2.0. The following describes how to upgrade the UE-V Agent.
Upgrade the UE-V 2.0 Agent
The UE-V Agent is the core of a UE-V deployment. The UE-V 2.0 Agent introduces a number of new features and modifies how and when the agent uploads content to the settings storage share. The upgrade process automates these changes. To upgrade the UE-V Agent, run the UE-V Agent install package, AgentSetup.exe, AgentSetupx86.msi, or AgentSetupx64.msi, on users’ computers.
|When you upgrade the UE-V Agent, you must use the same installer type,.exe file or .msi packet, that installed the previous UE-V Agent. For example, use the UE-V 2.0 AgentSetup.exe to upgrade UE-V 1.0 Agents that were installed by using AgentSetup.exe.|
The following configurations are preserved when the Agent Setup program runs:
Settings storage path
Scheduled tasks – Interval settings are reset to their defaults.
|A computer with UE-V 2.0 settings location templates that are registered in the UE-V 1.0 Agent register errors in the Windows Event Log.|
Microsoft System Center 2012 Configuration Manager or another enterprise software distribution tool can be used to automate and distribute the UE-V Agent upgrade.
We recommend the upgrade of all of the UE-V 1.0 Agents in a computing environment, but it is not required. UE-V 2 settings location templates can interact with a UE-V 1.0 agent because they only share the settings from the settings storage path. We recommend, however, to move the deployments to a single agent version to simplify management and to support UE-V.
Repair the UE-V Agent after an unsuccessful upgrade
You might experience errors after you attempt one of the following operations:
Upgrade from UE-V 1.0 to UE-V 2.0
Upgrade to a newer version of Windows, for example, from Windows 7 to Windows 8 or from Windows 8 to Windows 8.1.
Uninstall the agent after upgrading the UE-V Agent
To resolve this issue, attempt to repair the UE-V Agent. At the command prompt, on the computer where the agent is installed, enter the following command.
msiexec.exe /f "<path to msi file>" /quiet /norestart /l*v "%temp%\UE-VAgentInstaller.log
You can then retry the uninstall process or upgrade by installing the newer version of the UE-V Agent.