VMware Mirage 5.2 Release Notes
VMware Mirage 5.2 | 9 December 2014
These release notes cover the following topics:
About VMware Mirage
VMware Mirage offers a unique solution for managing physical or virtual desktops, laptops, and BYOD devices
that combines centralized management for IT and local execution for
end users. When Mirage is installed on a Windows PC, it centralizes a complete
virtual copy of that end point to the data center and keeps it synchronized. The
synchronization includes changes from a user's Windows PC being uploaded to the
data center, and changes from IT being downloaded and applied directly to the
user's Windows PC. Mirage enables central image management of desktops while
still allowing local execution at the user end point.
What's New in Mirage 5.2?
Mirage 5.2 introduces features that improve management of Mirage components. Included are the following new features and improvements:
- Mirage can be used with restricted virtual machines, enabling administrators to manage BYOD devices using Horizon FLEX. Documentation for Horizon FLEX is located at https://www.vmware.com/support/pubs/horizon-flex-pubs.html.
- Mirage supports upgrading WEPOS devices to POSReady 2009.
- Administrators can specify drives, including non-system drives, for the branch reflector cache. A new CVD alarm alerts administrators when a branch reflector cache is unavailable.
- Mirage uses persistent VSS on Windows 7, Windows 8, and Windows 8.1 machines, which enables Mirage to perform more efficient upload operations.
- Administrators can perform a centralization flow using Mirage PowerCLI cmdlets in Microsoft PowerShell.
- Web reports include increased functionality.
- Administrators can export reports in XLS format.
- Administrators can select a specific time for the report time frame and report schedule, for example, 12:30pm.
- Administrators can rename report templates.
- When administrators delete a report template, the reports that have been generated from that template are retained.
- The report template grid displays the report schedule interval and the report type icon.
- Administrators can manually change the IP address for the Mirage Gateway server using the Mirage Management console.
Known Limitations with Mirage 5.2
The following limitations are known in this Mirage release.
- Mirage supports up to 1,000,000 files per CVD on 32-bit systems. There are no file limits on 64-bit systems.
- Local user profiles on a reference machine are deployed only in a base
layer when used in Windows 7 migration or base layer provisioning. In image assignment and layer
updates, only the default local user profile is deployed. Applications that require
the creation and use of local user profiles are not suitable for
inclusion in a base layer or an app layer.
- During the streaming restore process, applications cannot access offline files
before the Mirage service has started, which might impact their normal
operation. You can extend the minimal restore setup to accommodate these
specific applications. For further information, see the VMware Mirage Administrator's Guide.
- All changes to the CVD on the server (base layer assignment, policy
change) only propagate to the client on the next synchronization interval
(by default, 1 hour, customizable by policy). Use the Sync Device action from
the Mirage Management console or the Sync Now action from the endpoint device to
- If the account password for a machine has expired after a restore operation, you
might not be able to connect to the domain. This is a known issue with Active
Directory and backups. See http://support.microsoft.com/kb/175468.
- Mirage requires the default Windows Shadow Copy Provider 1.0. Use the line: vssadmin list providers command to
view the VSS providers installed on the computer.
- Mirage does not support the Windows Fast User Switching option. You must
disable it on the endpoint and reference machines before capturing a base
- Mirage only uploads and stores the main NTFS stream of a file. All
other streams are not uploaded to, or restored from, a CVD.
- Changes to a .pst file are uploaded from the endpoint into the CVD once a day.
To ensure that the .pst file is successfully uploaded to the CVD before
you perform a restore operation of a CVD to a new hardware, type zeroes in the LastFullUploadTicks value in the registry:
HKEY_LOCAL_MACHINE\SOFTWARE\Wanova\Mirage Desktop Service\LastFullUploadTicks = 00 00 00 00 00 00 00 00
and click Sync Now.
- Mirage does not support applying a base layer to an endpoint that removes or installs Kaspersky antivirus software. See http://kb.vmware.com/kb/2048424 for additional details and a solution.
- When restoring a CVD that does not have Sophos SafeGuard Encryption installed to a machine that does have SafeGuard installed, the restoring procedure might fail. See http://kb.vmware.com/kb/2081607 for additional details and a solution.
- If you work with multiple volumes, note the following:
- Content of non-fixed drives (network maps, volatile devices such as
Disk-on-key) is not uploaded to the server.
- When assigning a base layer or an app layer to the endpoint, Windows fixed-drive letters
on the endpoint must be the same as on the reference machine from which the
base layer or app layer was captured. (For example, it cannot be C: on a CVD and D: on a
- By default, only the system volume is uploaded to the CVD. You can add
volume drive letters to the upload policy to upload additional volumes.
- Base layering and app layering do not currently support SQL Express or SQL Server.
- When reverting to Windows XP after an OS migration from Windows XP to Windows 7, 802.1X settings might not be preserved.
- Mirage only supports delivery of a full Microsoft Office suite to endpoints that do not already have a Microsoft Office suite installed.
- Mirage does not support delivery of two, full Microsoft Office suites in different layers.
- Mirage does not support scenarios in which an endpoint has more than one version of a full Microsoft Office suite.
- Windows system restore points do not work on machines that have Mirage installed.
- Mirage does not support in-place OS migration scenarios on machines that have McAfee Endpoint Encryption enabled.
- Mirage does not support the deployment of different versions of Microsoft Office applications in different layers, as part of the same deployment procedure.
Issues Addressed in this Release
The following issues have been resolved since the last Mirage release.
- In rare cases, after you perform a layer update, Windows might fail to install drivers for one or more hardware devices.
- When the Mirage Gateway server is deployed in a different subnet than the Mirage Management server, and the Mirage Gateway server is secured using SNAT, you cannot manage the Mirage Gateway server through the Mirage Management console.
- The step for configuring network properties is missing from the deployment procedure for the Mirage Gateway OVA.
- In rare cases, during base layer provisioning of a Windows 8.1 machine, the machine might fail with stop error 0xc000000e.
- When you archive multiple CVDs in a single operation, the database might deadlock.
- In rare cases, a system hive copied from VSS might be corrupt.
- In rare cases, after restoring a CVD that contains layers, the Mirage client might not work when new layers are assigned.
- After you perform a base layer update that contains Microsoft Office 2013 suite and applications from different service packs, when you open Microsoft Excel the Microsoft Office document cache needs to be repaired error message displays.
- When a base layer is assigned to a target machine, performing a CleanState uninstall procedure does not remove all files from WVI.
- When SNAT is configured, the status of the Mirage Gateway server is down.
- When the root domain naming context attribute is different than the default domain context attribute, user authentication for the Mirage Gateway server fails.
- After you perform a hardware migration procedure of machines that have SteelHead mobile, you cannot view IP settings.
- When you specify 1024 years for the timespan of a report, the report fails to generate.
- In the Mirage Management console, you cannot sort CVDs by IP address.
Known Issues in Mirage 5.2
The following known issues affect the Mirage 5.2 release.
- If you apply a Windows 8.1 base layer that has a different Windows product ID than the one in the CVD, assigning the CVD to a different hardware device might cause user-installed Windows Store applications to not work. Clicking Repair when you try to launch the Windows Store applications might not repair them.
Workaround: Reinstall any user-installed Windows Store applications that do not work.
- When performing an in-place Windows 8 migration, McAfee AntiVirus software might prevent Mirage from setting the correct access rights on directories. You might not be able to create or edit files.
Workaround: Before you start the OS migration, disable McAfee access protection. For more information, see http://kb.vmware.com/kb/2052489
- When you update a base layer or app layer, the power settings might be re-configured to the power settings of the reference machine.
Workaround: Add the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power\User\PowerSchemes\ActivePowerScheme exclusion to the base image rules.
- After performing an OS migration, if you try to revert to the previous OS image, the migration might fail due to lack of available disk space. Mirage does not consume local disk space for local files that are identical to the files in the reverted CVD image and in the same path.
Workaround: Verify that the available disk space is greater than the size of the previous OS image. You can run the disk-cleanup utility and delete Windows installations to increase space.
- When you perform an OS Migration from Windows 7 with Sophos SafeGuard 5.6 in the base layer to Windows 8.1 with Sophos SafeGuard 6.1 in the base layer, the migration might fail.
Workaround: Before starting the OS migration, remove Sophos SafeGuard 5.6 from the Windows 7 base layer. After you migrate to Windows 8.1, install Sophos SafeGuard 6.1 on the Windows 8.1 machine.
- Mirage does not detect the compatibility of a processer with the Hybrid Sleep capability of Windows 7 and Windows 8.1. After performing an OS migration from Windows 7 to Windows 8.1, the Hybrid Sleep function might not work.
Workaround: Before you capture base layers for OS migration, disable Hybrid Sleep on the reference machine.
- When you try to install an OS using a Mirage boot USB that has been configured for Windows 8.1 U1, the installation might fail.
Workaround: When you configure the Mirage boot USB for Windows 8.1, do not use Update 1.
- In rare cases, McAfee's Access Protection mechanism might block Mirage operations, such as downloading base layers, OS migration, provisioning, and so on.
Workaround: Exclude the Mirage service from security products.
- When you have an endpoint that has Symantec Endpoint Protection (SEP) version 12.1.671.4971 installed that you are migrating from Windows XP to Windows 7, the migration might fail.
Workaround: Before starting the migration procedure, either uninstall SEP or upgrade to a newer version of SEP.
- If you perform a base layer or app layer update that removes a Web-browser application that an end user has specified as their default Web browser, the end user might receive an error message when opening Websites or HTML files.
Workaround: Advise the end user to re-install the Web browser or select another default Web browser.
- When you perform a layer procedure that results in multiple versions of Microsoft Visio on a single machine, the Microsoft Office configuration window might display on an end user's machine when they open Microsoft Visio.
Workaround: This is a known issue with Microsoft Office. See http://support.microsoft.com/kb/298947 and http://support.microsoft.com/kb/314392.
- When you perform a layer procedure that includes Microsoft Office, if you open a Microsoft Office application before the "completing system updates" phase is finished, the Microsoft Office configuration window might appear.
Workaround: Wait for all layer assignment procedures to finish before you run any Microsoft Office applications.
- In rare cases, when you deliver a base layer that includes a Windows Live account, some sysprep operations might fail.
Workaround: Do not capture a base layer that includes a Windows Live account. If you deliver a base layer that includes a Windows Live account and the user experiences issues, recapture the base layer without a Windows Live account.
- When you perform a base layer procedure, the static IP address configured on the endpoint is not preserved.
Workaround: To preserve the static IP address that is configured on the endpoint follow this procedure.
- Write a pre-VSS script that uses "netsh" to save the network settings in C:\Wanova Volume Information.
- Write a post-provisioning script that uses "netsh" to import the network settings. Run the C:\Program Files\Wanova\Mirage Service\Wanova.Desktop.Control.exe -unlock file before you access C:\Wanova Volume Information\ and run the C:\Program Files\Wanova\Mirage Service\Wanova.Desktop.Control.exe -lock file after you access C:\Wanova Volume Information\.
- When two or more Microsoft Office applications are installed on a machine, and at least one is part of a layer, the interoperability of the remaining Microsoft Office applications might not work.
Workaround: There is no workaround for this issue.
- When you assign a layer that includes a Microsoft Office 2013 product to a machine that already has a Microsoft Office 2013 SP1 product installed, Microsoft Office might not work.
Workaround: Recapture the layer to include Microsoft Office 2013 SP1.
- When you deploy a layer that includes Microsoft Office products to a machine that already has Microsoft products installed, and the architectures are different, you cannot manually install Microsoft Office products on the machine.
Workaround: There is no workaround for this issue.
- When you deploy a layer that includes a Microsoft Office product, and you update the Microsoft Office product, if you remove the layer that includes the Microsoft Office product, you might not be able to manually install Microsoft Office products.
Workaround: See http://support.microsoft.com/kb/290301
- When you migrate a CVD that has Microsoft Office 2013 installed, the Microsoft Office license activation does not migrate and Microsoft Office is in an unlicensed state.
Workaround: Manually activate the Microsoft Office license from any application.
- When you deliver a program in an app layer, a taskbar shortcut or desktop shortcut is automatically created. When you remove the program from the layer, Mirage does not delete the shortcut.
Workaround: There is no workaround for this issue.