VMware vSphere Replication 5.1.2 Release Notes
VMware vSphere Replication 18.104.22.168 | 01 OCT 2014 | Build 2170306
VMware vSphere Replication 22.214.171.124 | 22 JUL 2014 | Build 1905350
VMware vSphere Replication 5.1.2 | 16 JAN 2014 | Build 1527968
Last updated: 10 MAR 2016
Check for additions and updates to these release notes.
For information about the vSphere Replication 5.1.2.x patch releases, see the corresponding Knowledge Base articles.
What's in the Release Notes
These release notes cover the following topics:
VMware vSphere Replication 5.1.2 is available in the following languages:
- Simplified Chinese
Installation and Upgrade
See Installing vSphere Replication for information on installing vSphere Replication.
When updating vSphere Replication to version 5.1.2, see http://kb.vmware.com/kb/2037630 for the patch update sequence for vSphere 5.1 and its compatible VMware products. To upgrade vSphere Replication to 5.1.2, you must first upgrade its vCenter Server to at least version 5.1. See the interoperability matrix for further information on supported versions.
See Upgrading vSphere Replication for information on upgrading the appliance. vSphere Replication supports the following upgrade paths:
- vSphere Replication 5.1.1 to vSphere Replication 5.1.2
- vSphere Replication 126.96.36.199 to vSphere Replication 5.1.2
- vSphere Replication 5.1.0 to vSphere Replication 5.1.2
- Site Recovery Manager 5.0.1/vSphere Replication 1.0.1 to vSphere Replication 5.1.2.
- Site Recovery Manager 5.0.2/vSphere Replication 1.0.2 to vSphere Replication 5.1.2.
- Site Recovery Manager 5.0.3/vSphere Replication 1.0.3 to vSphere Replication 5.1.2. See Upgrade vSphere Replication in Site Recovery Manager Installation and Configuration.
The upgrade URL for upgrading the vSphere Replication appliance to version 5.1.2 via the virtual appliance management interface (VAMI) is:
For the VAMI upgrade URL to use for a vSphere Replication 5.1.2.x patch release, see the KB article for that release.
IMPORTANT: Do not select the option in Update > Settings in the VAMI to automatically update vSphere Replication. If you select automatic updates, VAMI updates vSphere Replication to the latest 5.x version, which might be incompatible with vCenter Server 5.1.x. Leave the update setting set to No automatic updates.
You do not need to wait for a full synchronization to complete when you update vSphere Replication. When you update vCenter Server and vSphere Replication at the primary site, the source host continues to send replication data to the secondary site. When you update the secondary site, synchronization stops temporarily while the vSphere Replication server is updated and then resumes automatically.
Operational Limits for vSphere Replication
The operational limits of vSphere Replication 5.1.2 are the same as for vSphere Replication 5.1. See http://kb.vmware.com/kb/2034768.
Open Source Components
The copyright statements and licenses applicable to the open source software components distributed in vSphere Replication 5.1.2 are available at the vSphere Downloads site. You can also download the source files for any GPL, LGPL, or other similar licenses that require the source code or modifications to source code to be made available for the most recent generally available release of vSphere Replication.
Caveats and Limitations
vSphere Replication has certain operational limits. To ensure successful virtual machine replication, you must verify that your virtual infrastructure respects certain limits before you start the replication.
- vSphere Replication appliance and vSphere Replication server appliances are subject to Novell Security Advisory CVE-2008-5161
Novell Security Advisory CVE-2008-5161 relates to the SUSE Linux Enterprise Server (SLES) SP1, the operating system for the vSphere Replication appliance and vSphere Replication server appliances. Novell states in the advisory document at http://support.novell.com/security/cve/CVE-2008-5161.html that the security risks are low. If necessary, to further mitigate the security risks, you can follow the Novell advisory to modify your SSH configurations. For the vSphere Replication appliance and vSphere Replication server appliances, you can retain just the AES ciphers by adding the following directive in the sshd_config and ssh_config files:
Disable RC4 and all other CBC ciphers, including arcfour256, arcfour, aes128-cbc, and aes256-cbc.
- If you use the vCenter Server Appliance, updating the vCenter Server Appliance might make the vSphere Web Client inaccessible. See vCenter Server 5.1.0a Release Notes for details.
Workaround: Reboot the vCenter Server appliance.
- Updating vSphere Replication might lead to a timeout exception when logging into the vSphere Web Client for the first time after the update to vSphere Replication 188.8.131.52. See Known Issues in the vSphere Web Client release notes for details.
Workaround: Log out of the vSphere Web Client after the update, clear the cache of your browser, and log in again.
- You can only deploy one vSphere Replication appliance on a vCenter Server instance. Deploying more than one vSphere Replication appliance is not prohibited, but might lead to unexpected results.
- Each vSphere Replication management server can manage a maximum of 500 replicated virtual machines.
- vSphere Replication supports a maximum disk size of 2032GB.
- vSphere Replication does not support upgrading the VMware Tools package in the vSphere Replication appliance.
The following issues have been fixed in this release.
- Configure replication operation fails with Invalid UTF-8 character ... (a surrogate character) for any virtual machine that has surrogate Unicode characters in the name.
This issue has been resolved in this release.
- vSphere Replication cannot access datastores through hosts with multiple management virtual NICs and posts DatastoreInaccessibleEvent in vCenter Server: vSphere Replication cannot access datastore.
If a host is configured with multiple virtual NICs and you select more than one NIC for management traffic, vSphere Replication registers only the first NIC and uses it to access target datastores. If the vSphere Replication server address is not on the first management network of the host, vSphere Replication does not communicate with the host. This has been fixed.
- Reconfiguring replication to include a disk that was previously excluded, and using a replication seed for this disk, results in vSphere Replication erroneously removing the replication seed.
If you have a replication with an excluded disk and later reconfigure the replication to include that disk, and then you manually copy a disk file to use as a replication seed, vSphere Replication removes the copied .vmdk file, ignoring the fact that it was an initial copy that was not created by vSphere Replication. This requires you to copy the .vmdk file to the target site again. This has been fixed.
- Guest OS Quiescing option is unavailable for virtual machines running Windows Server 2012.
When configuring vSphere Replication on a virtual machine with a Windows Server 2012 guest operating system, the option to enable guest OS quiescing is unavailable.
This has been fixed.
The following known issues have been discovered through rigorous testing and will help you understand some behavior you might encounter in this release.
- NEW A vulnerability in the glibc library allows remote code execution
Your vSphere Replication appliance might be impacted by a vulnerability in the glibc that allows remote code execution.
Workaround: See KB 2144289
Missing vSphere Replication permissions after upgrading the vSphere Replication appliance, certificate or IP change.
If you upgrade the vSphere Replication appliance , or if for some other reason the certificate or the IP address of the vSphere Replication appliance changes, the permissions that are assigned to the default VRM user roles are deleted.
This problem is observed every time the vSphere Replication extension is unregistered and registered with the vCenter Server extension manager.
Workaround: The permissions that are assigned to custom roles are not removed. Clone the predefined VRM roles and create your custom roles before upgrading the vSphere Replication appliance, or changing its certificate or IP address.
- Connection status between two sites does not change to disconnected after you change the vSphere Replication certificate for one of the sites.
If you have two remote sites A and B and the status of the connection is Connected, if you change the certificate of the vSphere Replication appliance at site B, the connection status might not change to Disconnected. When invoking replication operations, vSphere Replication notifies you about the certificate problem.
Workaround: Log out and log in to the vSphere Web Client. Reconnect sites A and B.
- Connectivity problems between the vSphere Replication management server and vCenter Server or vSphere Replication server expose a memory leak that causes vSphere Replication operations to fail.
Resolve the connectivity problem and restart the vSphere Replication management server.
- vSphere Web Client contains a non-functioning option that binds replication traffic to a specific vmknic.
If you use this option, the setup fails due to the underlying connectivity issue.
Workaround: Manually edit the
esx.conf to remove the incorrect tag value for the specific vmknic or reconfigure the tagged vmknic to be reachable by vSphere Replication.
- DB2 Databases require system temporary tablespace with 16K page size
If you use vSphere Replication with a DB2 database, vSphere Replication requires system
temporary table space with at least 16K page size.
If DB2 does not provide system temporary table space with at least 16K page size,
configuring vSphere Replication with an external DB2 database fails.
The virtual appliance management interface (VAMI) shows the following error:
Error applying startup configuration: Please check the provided DB information.
The /opt/vmware/hms/logs/hms-configtool.log file in the vSphere Replication
appliance contains the following error message:
ERROR com.vmware.hms.configtool.App [main] (..hms.configtool.App) |
Error while configuring HMS, exit code DATABASE_ERROR
com.vmware.hms.configtool.ConfigToolException: Database requires further configuration:
Need system temporary tablespace with at least 16384 bytes pagesize.
The problem occurs only when you use a DB2 database.
- Cannot reconfigure replication after switching from embedded database to existing external database.
If you configure vSphere Replication with an external database and configure replication within the same site, then switch to the embedded database, the replication is not available, which is as designed. If you switch back to the external database, the replication is in error state. Reconfiguring the replcation fails with the following error: ManagedObjectNotFound
Workaround: When restoring the vSphere Replication database to the previous external or embedded database, you must reset its contents.
- If you change the vCenter Server certificate, then log into vSphere Replication, you might see CannotVerifyCredentialsFault.
If you change the vCenter Server certificate you lose connectivity to vSphere Replication and when you try to log in to vSphere Replication you see this error:
Workaround: Power off and power on the vSphere Replication appliance.
- Cannot configure a virtual machine with physical mode RDM disk even if the disk is excluded from replication.
If you configure a replication for a virtual machine with physical mode, you might see the
VRM Server generic error. Check the documentation for any troubleshooting information.
The detailed exception is: HMS can not set disk UUID for disks of VM : MoRef:
type = VirtualMachine, value = , serverGuid = null'.
- While generating support logs, the VAMI displays a syntax error and exception.
If you use the VAMI to generate a vSphere Replication support bundle, you might see the following error:
Uncaught Exception: ... syntax error.
Workaround: Open the VAMI in a new browser window and click Generate.
- Configuring replication with vSphere Replication fails if the virtual machine contains two disks on different datastores.
See KB 2012610
- Newly added remote site does not appear on local site when paired at remote site in the same session.
If you have two remote sites A and B and you connect site A to site B on the remote site, you can see the connection between the sites at the remote location. If you are still logged into local site A, then either wait 5 minutes to see the connection on the local site or log out and log into the local site to see the remote site connection on the local site.
- vSphere Replication recovery fails with
Error creating test bubble image for group ... The detailed exception is
Error while getting host mounts for datastore:<managed-object-id>... or
The object has already been deleted or has not been completely created.
If you run a test recovery or a planned recovery and the recovery plan fails with the specific exception, the LUN used for storing replication data has been temporarily disconnected from ESXi. When reconnected, replication continues as normal and no replication data is lost. The exception occurs during these scenarios:
- vSphere Replication cannot locate the LUN as the LUN has changed its internal ID.
- The target datastore internal ID changes when the host containing the target datastore is removed from vCenter inventory and later added.
You must manually reconfigure the replication to refresh the new ID.
Workaround: If the primary site is no longer available, contact VMware Support for instructions about adding a special configuration entry in the vSphere Replication appliance database that triggers an automatic fix of the changed internal datastore ID to allow recovery.
If the primary site is still available:
- In the vSphere Replication view, select a site, right-click a virtual machine and select Reconfigure.
- Click Next, and click Browse to change the location of the files on the datastore that has been disconnected and then reconnected, and select the same datastore and folder locations as before.
- Reuse the existing disks and reconfigure the replication of the virtual machine. The vSphere Replication management server picks up the changed datastore identity (managed object ID) in vCenter Server.
- Wait for the initial sync to finish. This sync uses existing disks and checks for data consistency.
- vSphere Replication reports "Datastore is not accessible" for datastores at a host added to vCenter Server inventory while registering vSphere Replication server.
vSphere Replication selects all supported hosts from vCenter inventory and enables them as part of vSphere Replication registration. If you add a host to vCenter while vSphere Replication is still being registered, vSphere Replication does not select this host and it cannot access datastores on the recovery site.
Workaround: Disconnect and reconnect the host in the vCenter inventory for vSphere Replication to enable it.
- Synchronize virtual machine operation fails with vSphere Replication generic error: The requested instance with Id=<...> was not found on the remote site.
Although the operation reports failure, the virtual machine state is successfully synchronized to the target site. This error can occur when you request a synchronize operation.
Workaround: Rerun the failed operation.
- EULA content in the OVF deploy wizard displays corrupted characters on Internet Explorer 8 and 9 when you deploy vSphere Replication on localized operating systems.
Workaround: Use Mozilla Firefox or Google Chrome.
- vSphere Replication server registration might take a long time depending on the number of hosts in the vCenter Server inventory.
If the vCenter Server inventory contains a few hundred or more hosts, the Register VR server task takes an hour or more to complete, as vSphere Replication updates each host's SSL thumbprint registry. The vCenter Server Events pane displays Host is configured for vSphere Replication for each host as the vSphere Replication server registration task progresses.
Workaround: Wait for the registration task to complete. After it finishes, you can use vSphere Replication for incoming replication traffic.
- Recovering a virtual machine using the "Recover with latest available data" option is possible when the source virtual machine is powered on.
If you select the option Recover with latest available data when recovering a virtual machine, it is possible to perform the recovery while the source virtual machine is powered on. However, the network cards of the recovered virtual machine are disconnected when it powers on. If you select "Recover with recent changes" when you recover a virtual machine, it is not possible to complete the recovery if the source virtual machine is powered on.
Workaround: Ensure that the source virtual machine is powered off before you connect the recovered virtual to the network.
- Recovering a virtual machine with vSphere Replication 5.1 fails to power on the recovered virtual machine.
If a replicated virtual machine is attached to a distributed virtual switch and you attempt to perform a recovery in an automated DRS cluster, the recovery operation succeeds but the resulting virtual machine cannot be powered on.
Workaround: Edit the recovered virtual machine settings to attach it to the correct network.
- Recovery does not start.
In rare cases, recovery might not start after you complete the Recovery wizard. Clicking Finish closes the wizard, but no recovery task begins.
Workaround: Run the recovery again.
- Deploying the vSphere Replication results in an invalid target datastore error.
Deploying the vSphere Replication by using OVF Tool or the vSphere Web Client results in an error if the target datastore is in a folder. The error message is
Invalid target datastore specified (vim.Datastore:datastore).
Workaround: Deploy vSphere Replication on a datastore that is not in a folder, or use the vSphere Client instead of the vSphere Web Client to deploy the vSphere Replication OVF.