Manager Release Notes

`Mono-spaced Bold Italic`

books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs
static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,
                 struct kvm_assigned_pci_dev *assigned_dev)
{
         int r = 0;
         struct kvm_assigned_dev_kernel *match;

         mutex_lock(&kvm->lock);

         match = kvm_find_assigned_dev(&kvm->arch.assigned_dev_head,
                                       assigned_dev->assigned_dev_id);
         if (!match) {
                 printk(KERN_INFO "%s: device hasn't been assigned before, "
                   "so cannot be deassigned\n", __func__);
                 r = -EINVAL;
                 goto out;
         }

         kvm_deassign_device(kvm, match);

         kvm_free_assigned_device(kvm, match);

out:
         mutex_unlock(&kvm->lock);
         return r;
}
# subscription-manager list --available | grep -A8 "[subscription_pool]"
# subscription-manager subscribe --pool=[subscription_pool_id]
# yum-config-manager --enable [repository_name]
# yum-config-manager --enable rhel-6-server-rhev-mgmt-agent-rpms
The User Portal refreshes LDAP and Active Directory information once per hour, so permission changes to user roles are not immediately reflected. To work around this issue, use engine-config to set the UserRefreshRate parameter to a lower value, or re-log in to the User Portal.
The Force Remove data center option should only be used after the storage is no longer needed or has been destroyed. If you have leftover data on the storage, manually remove any files under /rhev/data-center, and unmount any mount points that exist there.
Internet Explorer 8 treats the <iframe src="javascript:''" ...> tag as a non-secure item, which causes a Mixed Content pop-up warning, and a delay in installing SPICE ActiveX plugins on the user portal. To prevent this behavior, configure Internet Explorer 8 to suppress mixed content warnings using the Internet Options → Security Settings. See http://msdn.microsoft.com/en-us/library/ee264315(v=vs.85).aspx for details.
If you are using the Red Hat JBoss Application Server from Red Hat JBoss Enterprise Application Platform 6.0.1, upgrading the Red Hat Enterprise Virtualization Manager will not automatically update the application server to EAP 6.1. Although Red Hat Enterprise Virtualization Manager supports EAP 6.0.1, it is recommended to update to the latest supported Red Hat JBoss version. To upgrade to Red Hat JBoss EAP 6.1, see https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.1/html/Installation_Guide/Upgrade_the_JBoss_Enterprise_Application_Platform_6_RPM_Installation.html.
Due to the performance constraints imposed by the JavaScript engine included in Internet Explorer 8 it is not a supported client for the new Administration Portal user interface. Later versions of Internet Explorer remain supported.
The Always use the cursor keys to navigate within pages Firefox option does not work as expected for keyboard-triggered functions in the administration portal, for example when using arrow keys to select items in the Search bar. This option is disabled by default, and it is recommended to keep it that way. More information on this Firefox option can be found at http://support.mozilla.org/en-US/kb/accessibility-features-firefox-make-firefox-and-we#w_always-use-the-cursor-keys-to-navigate-within-webpages.
Windows Internet Explorer 9 has recently introduced a feature that prevents users from downloading and saving anything from an https site. IE9 will now not let users save anything from an https connection. This prohibits the download manager from saving or opening files from SSL sites the Red Hat Enterprise Virtualization Manager depends on. To fix this, go to Internet Options → Advanced → Security and remove the check mark from Do not save encrypted files to disk.
SPICE ActiveX is not supported for Internet Explorer 11 on Windows 7 and Windows 8.1. To work around this issue, use Internet Explorer 10 on Windows 7 or Windows 8.
After a Red Hat Enterprise Virtualization Hypervisor is attached to the Red Hat Enterprise Virtualization Manager and then successfully upgraded, it may erroneously appear in the administration portal with the status of Install Failed. Click on the Activate button, and the hypervisor will change to an Up status and be ready for use.
VDSM cannot start properly after a fresh installation. As a result the /var/run/vdsm/pools directory is not created and host cannot connect to the pool. Restarting VDSM solves the problem.
Importing diskless virtual machines or templates will fail, or be imported without peripheral device such as network devices. To work around this issue, redefine diskless virtual machines or templates in the destination. Do not use the export and import process.
Red Hat Enterprise Virtualization Manager only imports disk data from the Glance image provider. It does not import the instance specification such as minimum RAM value.
Previously, the time zone for a Red Hat Enterprise Linux virtual machine could be set in the Initial Run tab of the New or Edit Virtual Machine window. Now, the default time zone which is Etc/GMT is used, and it cannot be changed via the administration portal. After an upgrade, the time zones of all Red Hat Enterprise Linux virtual machines are reset to Etc/GMT. If you are using a Linux virtual machine with a non-default time zone, adjust the machine's hardware clock to your desired time zone.
When adding an Active Directory (AD) domain with the rhevm-manage-domains command, the ldapServers parameter only accepts host names and rejects IPv4 addresses. To work around this issue, the AD server needs to have a Service Principal Name (SPN) registered for the IP address of the LDAP server. Run the following commands on the AD server:

1. List all registered Service Principal Names:

setspn.exe -L <ad_host_name> 

2. Add the ldap server IP to the list of registered SPNs

setspn.exe -S "ldap/${AD_host_ip}" <AD_host_name>

For more information see http://technet.microsoft.com/en-us/library/cc731241%28v=ws.10%29.aspx
The current implementation of the QEMU guest agent VSS provider should only be used  as a mean to freeze the file system. It does not support the creation of shadows copies within the guest.
If the MAIL_SERVER parameter is not defined, any errors with starting the ovirt-engine-notifier are not reported, hence it is difficult to determine if the service has started successfully. To work around this issue, check the status of the service by running this command:

# service ovirt-engine-notifier status
When a virtual machine is running on a host which cannot provide the amount of guaranteed memory specified in the virtual machine configuration, the engine issues an alert. In a future release, this issue will be handled by migrating the virtual machine to a host which has sufficient memory.
Currently, after live storage migration, the auto-generated snapshot should be manually deleted after shutting down. Before live storage migration, if the 'actual size' of a disk is reported as x GB on the Administration Portal, after migration the 'actual size' of the disk is incorrectly reported as (x+y)GB. After the snapshot is manually deleted, the 'actual size' of the disk will be reported correctly on the Portal.
To prevent the risk of split brain incidents on Red Hat Storage domains, the use of shareable disks on Red Hat Storage domains is disabled. Attempting to create a shareable disk brings up a warning in the administration portal which recommends the use of Quorum on the Red Hat Storage server to ensure data integrity.

Note that this policy is only applicable for Red Hat Storage domains created as a Red Hat Storage domain type. This policy is not enforced on Red Hat Storage domains created on a POSIX domain with GlusterFS specified as the virtual file system type.
On the User Portal, the RDP console does not open on Windows 7 or 8 virtual machines when the Use Local Disks option is enabled. This is because the ActiveX plugin is served from a foreign site, which must be added to the list of trusted sites in Internet Explorer version 9 and higher.
Uninstalling the virt-viewer package does not automatically uninstall the Red Hat SpiceX client. This can cause problems when trying to reinstall later. SpiceX must be uninstalled manually from Internet Explorer using the Manage Add-ons option on the toolbar. Make sure all pages using it are closed before removing the add-on.
Previously, it appeared that users could edit the quota of a virtual machine pool using the Edit Pool window, because the quota field was enabled. The quota field is now disabled when editing a pool.
Previously the web browser sent HTTP Authorization headers for all requests to a given origin after the header has already been set for the initial request. This meant the user interface plugin infrastructure acquired a REST API session using web administration portal user credentials including domain and password information, and the session was kept alive until the user signed out of the administration portal.

To work around this issue, all user interface plugins now receive a single shared session ID based on the web administration portal user login credentials. This session times out after six hours, and the administration portal will not attempt to keep this session alive using periodic heartbeat requests. 

The plugin is in charge of keeping its session alive, and if no plugin interacts with the REST API session via the provided ID for more than six hours, the session will time out.
Previously, VDSM's documented port range for SPICE was 5634 to 6166, but it used libvirt's default range of 5900 to 65535. Consequently, firewalls set according to this range could erroneously block SPICE traffic. Now, VDSM uses the 5900 to 6923 range for SPICE, which allows concurrent running of up to 512 virtual machines using the SPICE console.
The engine-notifierd has been renamed ovirt-engine-notifier, and its configuration files are now located at /etc/ovirt-engine/notifier/notifier.con.d/*.conf.
When trying to attach a domain to a data center with no active host, an error message of "Cannot edit repository" appears. This has been fixed, and when reproduced, the appropriate error of "Cannot attach domain" appears.
A failure in the virtual machine hibernation process (for example, a VDSM hook error) caused the virtual machine to be stuck in a Saving state, even though it is actually Up. Only restarting the Manager could resolve this issue. A new internal status has been added to flag different phases of the hibernation process, allowing better recovery. Now, the virtual machine returns to the Up state when the hibernation process fails, allowing users to continue using the virtual machine as normal.
Previously, Unassigned was the default option for the Operating System field in the New or Edit Virtual Machine window. This option has now been deprecated, and replaced with Other OS.

Channel name	Channel label	Details
`Red Hat Enterprise Linux Server (v. 6 for 64-bit x86_64)`	`rhel-x86_64-server-6`	Provides the Red Hat Enterprise Linux 6 Server.
`RHEL Server Supplementary (v. 6 64-bit x86_64)`	`rhel-x86_64-server-supplementary-6`	Provides the virtio-win package, which provides the Windows VirtIO drivers for use in virtual machines.
`Red Hat Enterprise Virtualization Manager (v. 3.3 x86_64)`	`rhel-x86_64-server-6-rhevm-3.3`	Provides the Red Hat Enterprise Virtualization Manager, rhevm-sdk package and ovirt-sdk Python library.
`Red Hat JBoss Application Platform (v 6) for 6Server x86_64`	`jbappplatform-6-x86_64-server-6-rpm`	Provides the supported release of the Red Hat JBoss application platform on which the Manager runs.

Channel name	Channel label	Details
`Red Hat Enterprise Linux Server (v. 6 for 64-bit x86_64)`	`rhel-x86_64-server-6`	Provides the Red Hat Enterprise Linux 6 Server.
`Red Hat Enterprise Virt Management Agent (v 6 x86_64)`	`rhel-x86_64-rhev-mgmt-agent-6`	Provides the QEMU and KVM packages required for using Red Hat Enterprise Linux servers as virtualization hosts.

Channel name	Channel label	Details
`RHEL Server Supplementary (v. 6 64-bit x86_64)`	`rhel-x86_64-server-supplementary-6`	Provides the spice-usb-share and kmod-kspiceusb-rhel60 for Red Hat Enterprise Linux 6, which enables USB redirection (legacy mode) on Red Hat Enterprise Linux 6 clients.
`RHEL Supplementary EUS (v. 5.9.z for 64-bit x86_64)`	`rhel-x86_64-server-supplementary-5.9.z`	Provides the spice-usb-share and kmod-kspiceusb-rhel5u6 for Red Hat Enterprise Linux 5, which enables USB redirection (legacy mode) on Red Hat Enterprise Linux 5 clients.
`Red Hat Enterprise Virt Agent (v.6 Server for x86_64)`	`rhel-x86_64-rhev-agent-6-server`	Provides the rhev-guest-agent, which allows you to monitor virtual machine resources.

Subscription pool	Repository name	Details
`Red Hat Enterprise Linux Server`	`rhel-6-server-supplementary-rpms`	Provides the Red Hat Enterprise Linux 6 Server.
`Red Hat Enterprise Virtualization`	`rhel-6-server-rhevm-3.3-rpms`	Provides the Red Hat Enterprise Virtualization Manager.
`Red Hat JBoss Enterprise Application Platform`	`jb-eap-6-for-rhel-6-server-rpms`	Provides the supported release of the Red Hat JBoss application platform on which the Manager runs.

Subscription pool	Details
`Red Hat Enterprise Linux Server`	Provides the Red Hat Enterprise Linux 6 Server.
`Red Hat Enterprise Virtualization Management Agents (RPMs)`	Provides the QEMU and KVM packages required for using Red Hat Enterprise Linux servers as virtualization hosts.

Manager Release Notes

Release notes for Red Hat Enterprise Virtualization Manager 3.3

Tim Hildred

Cheryn Tan

Legal Notice

Preface

1. Document Conventions

1.1. Typographic Conventions

1.2. Pull-quote Conventions

1.3. Notes and Warnings

2. Getting Help and Giving Feedback

2.1. Do You Need Help?

2.2. We Need Feedback!

Chapter 1. Introduction

1.1. Introduction to Red Hat Enterprise Virtualization

1.2. Red Hat Network Channels

1.2.1. Required Red Hat Network Channels

1.2.2. Additional Packages from Red Hat Network

1.3. Red Hat Subscription Manager

1.3.1. Red Hat Subscription Manager Entitlements and Repositories

Chapter 2. What's New?

2.1. Administration Portal Features

2.2. Infrastructure Features

2.3. Developer Features

2.4. Networking Features

2.5. Quota Features

2.6. Storage Features

2.7. User Portal Features

2.8. SPICE Features

Chapter 3. Technical Notes

3.1. Recommended Practices

3.2. Known Issues

3.3. Resolved Issues

3.4. Deprecated Functionality

3.5. Security

Revision History

Client Operating System	Wan Optimizations	Dynamic Console Resizing	SPICE Proxy Support	Full High Definition Display	Multiple Monitor Support
RHEL 5.8+	No	No	No	Yes	Yes
RHEL 6.2 - 6.4	No	No	No	Yes	Yes
RHEL 6.5 +	Yes	Yes	Yes	Yes	Yes
Windows XP (All versions)	Yes	Yes	Yes	Yes	Yes
Windows 7 (All versions)	Yes	Yes	Yes	Yes	Yes
Windows 8 (All Versions)	Yes	Yes	Yes	Yes	Yes
Windows Server 2008	Yes	Yes	Yes	Yes	Yes
Windows Server 2012	Yes	Yes	Yes	Yes	Yes