Oracle Linux Virtualization Manager - Release Notes PDF
Oracle Linux Virtualization Manager - Release Notes PDF
Oracle Linux Virtualization Manager - Release Notes PDF
F25126-06
November 2020
Oracle Legal Notices
This software and related documentation are provided under a license agreement containing restrictions on use and
disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement
or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute,
exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or
decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find
any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of
the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any
programs embedded, installed or activated on delivered hardware, and modifications of such programs) and
Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end users are
"commercial computer software" or "commercial computer software documentation" pursuant to the applicable
Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, reproduction,
duplication, release, display, disclosure, modification, preparation of derivative works, and/or adaptation of i) Oracle
programs (including any operating system, integrated software, any programs embedded, installed or activated
on delivered hardware, and modifications of such programs), ii) Oracle computer documentation and/or iii) other
Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract. The
terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such
services. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications that may create a risk
of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to
take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation
and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous
applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their
respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used
under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc, and the AMD
logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The
Open Group.
This software or hardware and documentation may provide access to or information about content, products, and
services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an
applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any
loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as
set forth in an applicable agreement between you and Oracle.
Table of Contents
Preface .............................................................................................................................................. v
About this document ......................................................................................................................... vii
1 Introduction ..................................................................................................................................... 1
2 What's New .................................................................................................................................... 3
3 Requirements and Scalability Limits ................................................................................................. 5
3.1 Engine Host Requirements ................................................................................................... 5
3.2 KVM Host Requirements ...................................................................................................... 6
3.3 Firewall Requirements .......................................................................................................... 7
3.3.1 Engine Host Firewall Requirements ............................................................................ 7
3.3.2 Remote Component Firewall Requirements ................................................................. 8
3.3.3 KVM Host Firewall Requirements ............................................................................... 9
3.4 Storage Requirements ........................................................................................................ 10
3.5 Scalability Limits ................................................................................................................. 10
3.6 Guest Operating System Requirements ............................................................................... 11
4 Technology Preview ...................................................................................................................... 13
5 Deprecated Features ..................................................................................................................... 15
6 Known Issues ............................................................................................................................... 17
6.1 Oracle Linux Virtualization Manager Issues .......................................................................... 17
6.2 Global Configuration Issues ................................................................................................ 18
6.3 Compute Issues ................................................................................................................. 20
6.4 Network Issues ................................................................................................................... 25
6.5 Storage Issues ................................................................................................................... 30
6.6 Virtual Machine Issues ........................................................................................................ 32
7 Feedback and Support .................................................................................................................. 39
iii
iv
Preface
The Oracle® Linux Virtualization Manager documentation provides information on installing and configuring
a virtualization environment that you can use to manage compute, network and storage resources.
Audience
This document is intended for both new and existing users of Oracle® Linux Virtualization Manager. It is
assumed that readers are familiar with virtualization and have a general understanding of Windows and
UNIX platforms.
Documentation Location
The documentation for this product is available at:
https://docs.oracle.com/en/virtualization/oracle-linux-virtualization-manager/
Conventions
The following text conventions are used in this document:
• boldface: Boldface type indicates graphical user interface elements associated with an action, or terms
defined in text or the glossary.
• italic: Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular
values.
• monospace: Monospace type indicates commands within a paragraph, URLs, code in examples, text
that appears on the screen, or text that you enter.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website
at
https://www.oracle.com/corporate/accessibility/.
v
vi
About this document
This document is part of the documentation set for Oracle Linux Virtualization Manager, which is available
at https://docs.oracle.com/en/virtualization/oracle-linux-virtualization-manager/.
This document provides a summary of the new features, changes, fixed bugs, and known issues in the
Oracle Linux Virtualization Manager. It contains last-minute information, which may not be included in
the main body of documentation.
This document explains how to install, configure and get started with the Oracle Linux Virtualization
Manager. There is an example scenario that covers some of the basic procedures for setting up the
environment, such as, adding hosts and storage, creating virtual machines, configuring networks,
working with templates, and backup and restore tasks. In addition, there is information on upgrading
your engine and hosts as well as deploying a self-hosted configuration.
This document provides common administrative tasks for Oracle Linux Virtualization Manager. In
addition, you will find information on setting up users and groups, configuring high-availability, memory
and CPUs, configuring and using event notifications, configuring vCPUs and virtual memory.
In addition to the Oracle Linux Virtualization Manager documentation, you can also refer to the upstream
documentation:
• oVirt Documentation
vii
viii
Chapter 1 Introduction
Oracle Linux Virtualization Manager is a complete solution for managing the compute, network and storage
resources and the virtual machines, in enterprise-class virtualization environments.
Oracle Linux is the operating system on which Oracle Linux Virtualization Manager is installed. Oracle
Linux Virtualization Manager is free to download and includes all patches and updates, under the same
licensing restrictions as Oracle Linux.
The packages needed to install the Oracle Linux Virtualization Manager are available from the Oracle
Linux yum server at http://yum.oracle.com, and from the Oracle Unbreakable Linux Network (ULN) at
https://linux.oracle.com.
This release is based on the oVirt 4.3.6 release. This document is in addition to the upstream oVirt 4.3.6
Release Notes.
In addition to the Oracle Linux Virtualization Manager documentation, see oVirt Documentation.
1
2
Chapter 2 What's New
The following new features are included with Release 4.3.6 of Oracle Linux Virtualization Manager.
In Oracle Linux Virtualization Manager, a self-hosted engine is a virtualized environment where the
engine runs inside a virtual machine on the hosts in the environment. The virtual machine for the engine
is created as part of the host configuration process. And, the engine is installed and configured in parallel
to the host configuration. For additional information, see Self-Hosted Engine Deployment in the Oracle
Linux Virtualization Manager: Getting Started Guide.
• Gluster 6 integration
Oracle Linux Virtualization Manager has been integrated with Gluster 6, an open source scale-out
distributed file system, to provide a hyperconverged solution where both compute and storage are
provided from the same hosts. Gluster volumes residing on the hosts are used as storage domains in the
Manager to store the virtual machine images. Oracle Linux Virtualization Manager is run as a self-hosted
engine within a virtual machine on these hosts. For additional information, see Deploying GlusterFS
Storage in the Oracle Linux Virtualization Manager: Getting Started Guide.
• Oracle® Linux 8
• CentOS 8
• Virt-v2v utility
The virt-v2v utility converts virtual machines from other hypervisors, including their disk images and
metadata, for use with Oracle Linux Virtualization Manager and Oracle Linux KVM. The virt-v2v utility
converts Oracle Linux, RedHat Enterprise Linux, CentOS and Windows virtual machines running on
Oracle VM and imports them for use in Oracle Linux Virtualization Manager.
3
4
Chapter 3 Requirements and Scalability Limits
Table of Contents
3.1 Engine Host Requirements ........................................................................................................... 5
3.2 KVM Host Requirements .............................................................................................................. 6
3.3 Firewall Requirements .................................................................................................................. 7
3.3.1 Engine Host Firewall Requirements .................................................................................... 7
3.3.2 Remote Component Firewall Requirements ........................................................................ 8
3.3.3 KVM Host Firewall Requirements ....................................................................................... 9
3.4 Storage Requirements ................................................................................................................ 10
3.5 Scalability Limits ......................................................................................................................... 10
3.6 Guest Operating System Requirements ....................................................................................... 11
The following sections provide detailed requirements for a Oracle Linux Virtualization Manager Release
4.3.6 environment as well as the scalability limitations.
• Oracle Linux 7 Update 7 (or later) with Minimal Install selected as the base environment for the
installation.
• Unbreakable Enterprise Kernel Release 5 Update 1 (or later) or Unbreakable Enterprise Kernel Release
6
The following table identifies the specific system hardware requirements for the host system where you
want to install Oracle Linux Virtualization Manager.
Table 3.1
Resource Minimum Recommended
CPU 64-bit dual-core CPU 64-bit quad core or greater
CPU
Memory 4 GB of available system RAM 16 GB or greater of
system RAM
Note
If Data
Warehouse
is installed
and if memory
is being
consumed
by existing
processes,
consider
using the
recommended
amount
of system
memory.
5
KVM Host Requirements
For information about x86-based servers that are certified for Oracle Linux with UEK, see the Hardware
Certification List for Oracle Linux and Virtualization.
For more details about system requirements and known issues with installation, see:
Important
Oracle does not support Oracle Linux Virtualization Manager on systems where
the ol7_preview, ol7_developer, ol7_developer_kvm_utils, or
ol7_developer_EPEL repositories are enabled, or where software from these
repositories is currently installed on the systems where the Manager will run.
Even if you follow the instructions in this document, you may render your platform
unsupported if these repositories or channels are enabled or software from these
channels or repositories is installed on your system.
Note
For detailed information on the supported Oracle Linux version, see the Oracle®
Linux: KVM User's Guide.
• Unbreakable Enterprise Kernel Release 5 Update 1 (or later) or Unbreakable Enterprise Kernel Release
6, depending on the Oracle Linux version.
• 64-bit dual-core CPU
Recommended: Multiple CPUs
The CPUs must support either the Intel VT-x or the AMD AMD-V hardware virtualization extensions and
the extensions must be enabled in the host's BIOS. The CPUs must also support the No eXecute flag
(NX).
• 2 GB RAM
Maximum Tested: 6 TB
The amount of RAM required varies depending on guest operating system requirements, guest
application requirements, and guest memory activity and usage.
• 1 network interface card (NIC) with bandwidth of at least 1 Gbps
Recommended: 2 or more NICs with bandwidth of at least 1 Gbps
6
Firewall Requirements
Multiple NICs are recommended so that NICs can be dedicated for network intensive activities, such as
virtual machine migration.
• 60 GB of locally accessibly, writable disk space dedicated to Oracle Linux Virtualization Manager,
allocated as follows:
Allocation Size
/ (root) 30 GB
/boot 1 GB
/var 29 GB
For information about x86-based servers that are certified for Oracle Linux with UEK, see the Hardware
Certification List for Oracle Linux and Virtualization.
Warning
Do not install any third-party watchdogs on your Oracle Linux KVM hosts, as they
can interfere with the watchdog daemon provided by VDSM.
Do not install any other applications on the Oracle Linux KVM hosts as they may
interfere with the operation of the KVM hypervisor.
For more details about system requirements and known issues with installation, see:
Note
The following ports are the default ports. The Setup program enables you to choose different ports for
some of the configuration options, see Engine Configuration Options in the Oracle Linux Virtualization
Manager: Getting Started Guide.
Table 3.2 Oracle Linux Virtualization Manager Host Firewall Requirements
Port Protocol Source Destination Purpose
Not ICMP Oracle Linux KVM Manager host (Optional) Diagnostics
applicable hosts
7
Remote Component Firewall Requirements
VM Portal clients
VM Portal clients
8
KVM Host Firewall Requirements
External systems
6100 TCP Administration Portal WebSocket proxy WebSocket proxy access to the noVNC or
clients host HTML 5 virtual machine consoles
To disable automatic firewall configuration when adding a KVM host, clear the Automatically configure
host firewall check box under Advanced Parameters. Then use the following information to manually
configure the firewall.
VM Portal clients
5989 TCP,UDP Common Information KVM hosts (Optional) CIMOM connections
Model Object
Manager (CIMOM) Only required if you use CIMOM to monitor
virtual machines running on the host
6081 UDP KVM hosts KVM hosts (Optional) Open Virtual Network (OVN)
connections
Client machines
16514 TCP KVM hosts KVM hosts Virtual machine migration using libvirt
9
Storage Requirements
Storage devices in Oracle Linux Virtualization Manager are referred to as data domains, which are used
to store virtual hard disks, snapshots, ISO files, and templates. Every data center must have at least one
data domain. Data domains cannot be shared between data centers.
10
Guest Operating System Requirements
Component Maximum
Hosts per domain Unlimited
Logical volumes per block domain 1500
LUNs per block-based storage device 300
Disk size 500 TiB (limited to 8 TiB by default)
For detailed information on the supported guest operating systems, see the Oracle® Linux: KVM User's
Guide.
11
12
Chapter 4 Technology Preview
The following features of Oracle Linux Virtualization Manager are currently still under development, but are
made available for testing and evaluation purposes:
• Data warehouse service and history database and engine database installation or migration to a
separate host.
• Additional functionality to the Admin Portal through custom user interface plugins.
• External providers that provide external resources to Oracle Linux Virtualization Manager.
• The ovirt-engine-rename command (the oVirt Engine Rename Tool) changes the fully qualified
DNS name of Oracle Linux Virtualization Manager.
• The engine-config command (the Engine Configuration Tool) changes to global configuration
settings for Oracle Linux Virtualization Manager.
• USB Filter Editor used to create the usbfilter.txt policy file for filtering USB devices on Windows
client devices.
Configuring additional internal local user domains for Oracle Linux Virtualization Manager.
• External directory server apart from Active Directory and OpenLDAP Standard Schema (options 3 and 9
when you use the ovirt-engine-extension-aaa-ldap-setup command).
• Users log in automatically to the Administration Portal or VM Portal using the credentials obtained from a
Kerberos or LDAP server (single sign-on).
Compute
• Data center or cluster with compatibility version 4.2 or previous.
• CPU quality of service (QoS) entries to control the amount processing capability virtual machines can
access on hosts.
• Trusted compute pools to deploy virtual machines on clusters that use Intel Trusted Execution
Technology (Intel TXT).
13
Network
Network
• Host network interfaces configured to use ethtool or Fibre Channel over Ethernet (FCoE) custom
properties.
• PCI network cards attached directly to virtual machines (PCI passthrough or SR-IOV).
• Network bonds that use bond modes 0 (round-robin policy), 2 (XOR policy), 3 (broadcast policy), and 5
(adaptive transmit load balancing policy).
• Host quality of service entries that to control the bandwidth a logical network uses on a physical
interface.
• External network providers, including the Open Virtual network (OVN) provider.
• Networks and interfaces managed with the Cisco Unified Computing System (UCS).
Storage
• Wipe after delete functionality to zero out used blocks in virtual disks.
• Storage quality of service (QoS) entries to control the maximum throughput and I/O operations for virtual
disks in a storage domain.
• Disk profiles to define the maximum throughput and I/O for virtual disks in a storage domain.
• Automatic installs of guest additions in Windows guests using the Application Provisioning Tool (APT).
• User log in automatically to virtual machines using their Oracle Linux Virtualization Manager credentials
(single sign-on).
• User log in automatically to virtual machines using the credentials obtained from a Kerberos or LDAP
server (single sign-on).
• Host devices directly attached to virtual machines, including SCSI devices such as disks, PCI devices
such as NICs and GPUs, and USB devices such as webcams (passthrough or SR-IOV).
• Virtual machine authentication using smart cards on client devices (smart card authentication).
• Remote access to USB devices on Windows client devices using the usbdk driver (USB redirection).
• Virtual NUMA nodes configured on virtual machines and pinned them to NUMA nodes on a physical
host.
14
Chapter 5 Deprecated Features
The following features are marked as deprecated in the upstream release and may be removed in a future
release.
• Log Collector Analyzer Tool. The Log Collector Analyzer Tool (ovirt-log-collector-
analyzer) is a command-line tool that analyzes and reports on the Oracle Linux Virtualization Manager
environment.
• Export Storage Domains. Export domains are temporary storage repositories that are used to copy
and move images between data centers and Oracle Linux Virtualization Manager environments. Use
data domains instead.
• ISO Storage Domains. ISO domains store ISO files which you can attach to virtual machines and
use to install and boot operating systems and applications. Use data domains instead.
• ISO Uploader Tool. The ISO Uploader Tool (engine-iso-uploader) is a command-line tool for
uploading ISO images to an ISO storage domain. Use the Administration Portal or the REST API to
upload ISO images to data domains instead.
• ovirt-shell Command Line Interface. The ovirt-shell command line interface has not been
updated to support any new features added to the upstream release since version 4.0. For automation
purposes, either use the REST API or another tool such as Ansible.
• USB Clerk. USB Clerk is a service that is able to install and uninstall USB drivers in Windows virtual
machines. Use the usbdk driver instead.
15
16
Chapter 6 Known Issues
Table of Contents
6.1 Oracle Linux Virtualization Manager Issues .................................................................................. 17
6.2 Global Configuration Issues ........................................................................................................ 18
6.3 Compute Issues ......................................................................................................................... 20
6.4 Network Issues ........................................................................................................................... 25
6.5 Storage Issues ........................................................................................................................... 30
6.6 Virtual Machine Issues ................................................................................................................ 32
In addition to the known issues for Oracle Linux Virtualization Manager Release 4.3.6 listed here, you
should also check the following documents:
• Unbreakable Enterprise Kernel: Release Notes for Unbreakable Enterprise Kernel Release 5
Solution: Only use the fully qualified domain name to access Oracle Linux Virtualization Manager. Proper
hostname resolution must be in place.
Bug: 29062264
Bug: 29167472
Setup Scripts for Active Domain Restrict Users to Verify for Root AD Forest
and Not a Specific Subdomain
When attempting to configure authentication using the ovirt-engine-extension-aaa-ldap
extension, you can add only the forest domain for authentication. When attempting to use the subdomain,
you see the following warning and error messages:
[ INFO ] Resolving Global Catalog SRV record for subdomain1.mydomain.domain.local
17
Active Directory Profile Missing After Restoring the Engine
Solution: Issue also occurs in the upstream oVirt release. There is no workaround for this behavior.
Bug: 29182338
3. Add the IP address of the Active Directory to the /etc/host and /etc/resolve.conf files,
respectively.
Bug: 29410228
Bug: 29494264
Solution: There is no workaround for this behavior. Issue also occurs in the upstream oVirt release.
Bug: 29525988
• Virtual Machine Can Be Started on a KVM Host Whose CPU Utilization Exceeds the HighUtilization
Property Set for an Evenly_Distributed Scheduling Policy
• CPU Load Not Evenly Load Balanced for an Evenly_Distributed Scheduling Policy
18
Virtual Machine Started on KVM Host Whose Virtual Machine Count Exceeds the
HighVirtual MachineCount Property Set for an Evenly_Distributed Scheduling Policy
• Power_Saving Scheduling Policy Not Shutting Down Any of the KVM Hosts in a Cluster with CPU
Utilization Less Than 20%
• Virtual Machine Not Migrating After Exceeding the MaxFreeMemoryForOverUtilized Property Value for a
Power_Savings Scheduling Policy
Virtual Machine Started on KVM Host Whose Virtual Machine Count Exceeds
the HighVirtual MachineCount Property Set for an Evenly_Distributed
Scheduling Policy
A virtual machine started on a KVM host whose virtual machine count exceeded the number of virtual
machines set in the HighVMCount property for an Evenly_Distributed scheduling policy. Based on the
scheduling policy configured in this scenario, load balancing should have been triggered and this virtual
machine should have started on another KVM host in the cluster.
Bug: 29168788
Bug: 29171712
Bug: 29172270
Power_Saving Scheduling Policy Not Shutting Down Any of the KVM Hosts in
a Cluster with CPU Utilization Less Than 20%
In a cluster with 3 running KVM hosts and with 4 running virtual machines, a Power_Savings scheduling
policy is configured with the EnableAutomaticHostPowerManagement property set to true when the
19
Virtual Machine Not Migrating After Exceeding the MaxFreeMemoryForOverUtilized
Property Value for a Power_Savings Scheduling Policy
CPU and memory is found to be low on the KVM hosts. After this policy is set, the KVM hosts are not being
shutdown and the virtual machines are not being migrated, even though the CPU utilization is less than
20%. Given the configured Power_Savings scheduling policy for this scenario, some of the hosts should
have been shutdown.
Bug: 29418541
Bug: 29419399
Bug: 29425062
Solution: If a user requires MacPoolAdmin privileges, ensure that the user is assigned the
MacPoolAdmin role at the System level on the Manager.
Bug: 29534106
20
KVM Host Under the Control of a Engine Host Can Be Accidentally
Added to Another Manager Host Without Validation of Its Current State
• Duplicate KVM Host Cannot Be Moved into Maintenance Mode After Host Addition Fails
• SSH Connection Hangs When Adding a New KVM Host with Firewalld Disabled to the Engine
• Creating a New Cluster in a Non-Default Data Center Without a Management Network Causes Dialog
Box to Hang and Generates Uncaught Exception in UI Log
• Host Console Indicates KVM Host Is Registered on the Engine Host After Its Removal
KVM Host Under the Control of a Engine Host Can Be Accidentally Added to
Another Manager Host Without Validation of Its Current State
When an KVM host is already deployed on a Manager host, you can add this KVM host to another
Manager host, causing this Manager host to take the KVM host away from the original owning Manager
host. Adding a KVM host that is already under the control of a Manager host is highly not recommended,
but it can be done by accident. In this event, the KVM host that resides on the original owning Manager
host changes to a status of Nonreponsive and all virtual machines running on it change to a status of
Unknown. When you attempt to put the nonresponsive host into Maintenance mode, the following error
message is generated:
Error while executing action: Cannot switch Host to Maintenance mode.
Host still has running VMs on it and is in Non Responsive state.
Solution: For information about the workaround for this issue, refer to the related issue Removing a
Stolen, Defunct, Nonresponsive, or Destroyed KVM Host .
Bug: 29127349
Duplicate KVM Host Cannot Be Moved into Maintenance Mode After Host
Addition Fails
If you add a KVM host that is running virtual machines to the Manager host and you attempt to add the
same KVM host using a different host name (either IP address or FQDN), the Manager host fails to add
this KVM host. When you try moving the failed KVM host into Maintenance mode to remove it from the
Manager, it causes the KVM host to be stuck in Preparing for Maintenance mode.
Solution: Migrate all virtual machines that are UP on the running KVM host to a different KVM host in
the cluster. Doing that changes the status on the failed KVM host to Maintenance mode. You can them
remove the KVM host.
Bug: 29127707
SSH Connection Hangs When Adding a New KVM Host with Firewalld
Disabled to the Engine
SSH Connection hangs when adding a new KVM host with firewalld disabled to the Manager.
Solution: There is no workaround for this behavior. The SSH connection is eventually restored after some
delay.
21
Bridge Is Not Cleaned When Undeploying and Removing a KVM Host
Bug: 29135914
Solution: Networking resources should be manually removed or cleaned after removing the KVM host
from the Manager host, and the default management network, ovirtmgmt, should not be modified.
A tool is available upstream that you can use to remove the networks that are configured by VDSM from a
KVM host. For more information, refer to https://gerrit.ovirt.org/#/c/79495/.
Bug: 29167000
2. Click Configure Later when prompted on the Data Center - Guide Me dialog box.
3. Create a new cluster by adding the cluster to the new data center, giving the cluster a new name but
leaving the Management Network blank.
4. Click OK.
Note
The dialog box then hangs, but there are no error messages that are generated in the engine.log
file; however, an uncaught exception is generated in the ui.log file.
After this issue is encountered, each time the new data center is clicked, a UI exception is generated.
It is also observed that the new data center could be removed, even though the new cluster and a host
in this data center still reside on this Manager.
Solution: If you encounter this issue, there are two possible workarounds:
• Close the dialog box, delete the data center, and create a new data center. Creating a new data center
brings back the ovirtmgmt management network.
Or:
• Close the dialog box, create a new network in this data center, and when creating the new cluster, select
this new network as the management network.
Bug: 29385759
22
Incomplete Error Message Stopping a KVM Host
2. On the Hosts pane, click Management and from the drop-down list select Stop.
Although this error message is incomplete, it is accurate; however, the message does not provide a
workaround.
Solution: The Status of the KVM host must be UP before you can stop the KVM host. Try setting the KVM
host to Maintenance mode and then stopping it. If this does not work, you must log in to the KVM host,
resolve the issue, and bring it back up.
Bug: 29298704
Host Console Indicates KVM Host Is Registered on the Engine Host After Its
Removal
The Host Console indicates that an KVM host is still registered on the Manager host after it has been
removed from the Manager host. This issue is observed in the following scenario.
a. On the Hosts pane, put the KVM host in Maintenance mode by clicking Management and then
selecting Maintenance from the drop-down list.
b. Click Installation and then select Reinstall from the drop-down list.
c. Click Hosted Engine and then select Undeploy from the drop-down list.
d. Click OK.
e. Then set the KVM host to Maintenance mode again and click Remove to open the Remove
Host(s) confirmation window and click OK.
The Host Engine Setup screen indicates that the system is already registered to the removed KVM
host.
Bug: 29444179
23
Removing a Stolen, Defunct, Nonresponsive, or Destroyed KVM Host
For example, a KVM host that is already in use by a Manager host can be added as a New Host by a
different Manager host. In this scenario, the original Manager is unable to communicate with its KVM host.
Because the KVM host has a running a virtual machine, attempts to put the host into Maintenance mode
are rejected with the following error message:
Host still has running VMs on it, and is Non responsive state
Solution: There are two available methods for handling this situation:
• Method to resolve the issue of a host being taken over by another Manager host.
Method to Resolve the Issue of a Host Being Taking Over by Another Engine Host
When the new Manager host takes over the KVM host, the following symptoms are observed:
• On the original owning Manager host, the KVM host shows a status of Connecting and the virtual
machines show up as running.
• On the new Manager host, copies of the virtual machines show up as external_vm-name and they are
running.
After powering off the KVM host, the following events occur:
• The KVM host eventually goes into a status of NonResponsive on both Manager hosts .
• The following events are triggered for this KVM host on both Manager hosts: Handling non
responsive Host host-name.
1. Click More Actions and select Confirm Host has been Rebooted from the drop-down list.
This action causes the virtual machines to be marked as Down on the Managers and the host to
display a value of 0 under the Virtual Machines column. The virtual machines may now be migrated
by the old manager to another host if that is permitted by the Migration Mode settings of the virtual
machines.
When the KVM host comes back up, SSH to it and remove all authorized keys.
# rm /root/.ssh/authorized_keys*
24
Network Issues
Then, on the original owning Manager host, reinstall the KVM host using password authentication (for
simplicity).
Note
If the installation fails on the setup due to network issues causing the KVM host to
go into a NonResponsive status on the Manager host, set the KVM host back to
Maintenance mode and reinstall it with an SSH key.
• The virtual machines that were running on the KVM host show a status of Unknown.
• The following events are generated on the Manager host for this KVM host:
Handling non responsive Host host-name
1. Click More Actions and select Confirm Host has been Rebooted from the drop-down list.
This action causes the virtual machines to be shutdown and the host to display a value of 0 under the
Virtual Machines column.
For more information about these methods, refer to Doc ID 2540819.1 in the Oracle Support Knowledge
Base.
Bug: 29685904
• Engine Does Not Update the IP Address of a Virtual Machine When Switching the Virtual Machine
Network for a Running Virtual Machine
• Default Route Still Set to Yes After Default Route Role Is Removed from Connected Network
• Exception Generated When VLAN Network Is Added with Interface Name Longer Than 15 Characters
• Adding KVM Host Connected to VLAN Network Fails When VLAN Network Is Not Configured on
Management Network
• KVM Host Becomes Non-Operational When a Bondport Connected to Virtual Machine Network Changed
from an Unsupported Mode to a Supported Mode
25
MAC Address Displayed on the Engine for the Non-Primary
Subordinate Port of a Bond Not Synchronized With KVM Host
• Network Label Failure Generates Illegal Network Parameters Error When Performing Other Network
Operations on the KVM Host
MAC Address Displayed on the Engine for the Non-Primary Subordinate Port
of a Bond Not Synchronized With KVM Host
After a bond is created on an KVM host with 2 subordinate ports, the MAC address of the non-primary
subordinate port is changed to be the same as the primary subordinate port on the KVM host, but the
Manager continues to display the previous MAC address of the subordinate port.
Bug: 29049447
Engine Does Not Update the IP Address of a Virtual Machine When Switching
the Virtual Machine Network for a Running Virtual Machine
In a scenario where a virtual machine is running with one VNIC interface connected to a VM network, it is
observed that the Manager allows the user to change the VNIC interface for the running virtual machine
to a different VM network. This action causes the virtual machine to lose its VM network and to become
inaccessible (that is, its IP address is no longer pingable). The Manager, however, still displays its old IP
address and does not generate any error messages.
Bug: 29060999
Default Route Still Set to Yes After Default Route Role Is Removed from
Connected Network
Changing the default route on a network that is attached to a host and that has virtual machines connected
to that network is illegal and is rejected by VDSM. The Manager host gets notified about the request failure
and logs the error, but the Manager is unaware of the failure; that is, the Manage Networks pane shows
that default route change was successful.
Solution: When you modify the network configuration, make sure the interface configuration accurately
reflects the most recent changes.
Bug: 29133844
26
Adding KVM Host Connected to VLAN Network Fails When
VLAN Network Is Not Configured on Management Network
The VLAN ID ranges from 0 to 4096, which is a maximum of four characters and the total interface name
has a limit of 15 characters. This is a Linux kernel limitation. The maximum interface name length is
defined by the kernel headers and is a global limit, affecting all applications.
Solution: Limit interface names to 15 characters (including periods and VLAN IDs).
Bug: 29221397
Adding KVM Host Connected to VLAN Network Fails When VLAN Network Is
Not Configured on Management Network
Adding a KVM host that is connected to a VLAN network fails when the ovirtmgmt management network
is not configured on the VLAN network.
Solution: All servers that are part of a single cluster must be on the same VLAN management network.
3. Click Edit.
4. Select the Enable VLAN tagging checkbox and enter the VLAN tag ID in the text entry field.
Make sure that the VLAN tag ID is the same as the VLAN ID set on the host interface to be connected
to the ovirtmgmt management network.
6. Click New.
9. Click Setup Host Networks and add the ovirtmgmt management network to the appropriate
interface.
Bug: 29245869
27
KVM Host Becomes Non-Operational When a Bondport Connected to Virtual
Machine Network Changed from an Unsupported Mode to a Supported Mode
Bug: 29311422
Note
No issues occur when performing these actions in reverse; that is, changing a VM
network to a non-VM network and then changing the bond mode accordingly.
2. Change the network mode to a VM Network by editing the network in the Manager and selecting the
VM Network checkbox.
The following error is generated: Network nameis attached to bond number. VM networks
cannot be attached to bonds in mode 0, 5 or 6.
4. Change the bond mode to a mode available for a VM network (1, 2, or 4) and click OK.
After the network setup window closes, the Sync All Network button appears again, indicating that the
network is out of sync, and the host becomes non-operational.
Solution: You can click Sync All Networks again to bring the KVM host up. Alternatively, to bring the
KVM host up, you can put this KVM host in Maintenance mode and activate it after the network is back in
sync.
Bug: 29312752
In this situation, when you attempt to remove the UP port (primary port) in the Setup Host Networks
dialog box, the Manager generates the following Operation Canceled error message:
Error while executing action HostSetupNetworks: Could not connect to peer host
This error message, which is generated during the removal of the subordinate port, is referring to the new
connection that cannot be established, even though the removal of the primary port has already occurred.
28
Network Scale Limitation When Adding Networks to a KVM Host
Solution: There is no workaround for this behavior. In this situation, you need to make sure the remaining
communication between the bondport and the management network are not interrupted after the
subordinate port is removed, otherwise the host loses connection with the Manager and becomes non-
responsive.
Bug: 29338703
Bug: 29383782
After this network configuration error, attempting to perform other network operations on the KVM host
generates the following Operation Canceled error message:
Error while executing action HostSetupNetworks: Illegal Network parameters
Solution: You must resolve the network label failure before other network operations can be performed.
Bug: 29424399
Solution: Shut down the virtual machine before editing the VNIC. A known issue in the upstream oVirt
release.
Bug: 29456945
29
Storage Issues
This is a Linux kernel limitation, bridge names must be 15 characters or less, and must not contain any
special characters.
Solution: Limit VM network names to 15 characters and avoid any special characters.
Bug: 29409851
• Manager Not Updating the Size of an iSCSI-Based Virtual Disk After ZFS Storage Resized
• Virtual Machine Templates Can Be Imported with MAC Addresses Not in Range for the MAC Address
Pool
• Oracle Linux Virtualization Manager Does Not Prevent Adding a Direct LUN Disk Being Used by an
Active Storage Domain
• Microsoft Windows 8 (and Later) Virtual Machines Disabling Third-Party Mini-Port Drivers
• Manager Does Not Prevent Attaching VirtIO-SCSI Disks to OL6U10_X86 Virtual Machines
Solution: This is an upstream bug, however, you do have two workaround options:
• Change an ISO with a virtual machine booted using either a local storage domain or an NFS storage
domain.
• Stop the virtual machine before changing the ISO or mount the ISO on the virtual machine.
Bug: 31598688
Bug: 29220930
30
Decreasing the Storage Size Used in Storage Domains Is Not Recommended
Solution: Do not decrease the storage size used in storage domains in your virtualization environment.
Bug: 29285337
Manager Not Updating the Size of an iSCSI-Based Virtual Disk After ZFS
Storage Resized
The Oracle Linux Virtualization Manager is not updating the size of an iSCSI-based virtual disk after the
ZFS storage is resized. This issue is seen after creating an LUN, attaching the virtual disk to a running
virtual machine, resizing the LUN, and restarting VDSM. After the refreshing the Disks pane, the iSCSI-
based virtual disk size does not update accordingly. However, when checking the iSCSI disk on the SPM
host, the size of the disk is correctly updated.
Bug: 29370809
Solution: If there is a MAC address range restriction for your virtualization environment, the workaround
is to manually change the MAC address to an address within the range of the MAC address pool before
starting the virtual machine.
Bug: 29449334
Oracle Linux Virtualization Manager Does Not Prevent Adding a Direct LUN
Disk Being Used by an Active Storage Domain
The Manager prevents creating a storage data domain on LUNs that are being used by direct LUN disks.
The Manager, however, does not prevent adding a direct LUN disk that is being used by an active storage
domain.
Solution: There is no workaround for this behavior. If you attempt to add a direct LUN disk that is being
used by an active storage domain, the Manager prompts you to approve the operation with the following
warning message: This message might be unrecoverable and destructive!
Bug: 29465439
31
Manager Does Not Prevent Attaching VirtIO-SCSI Disks to OL6U10_X86 Virtual Machines
Solution:To bring back the third-party mini-port drivers, perform the following steps:
3. Open the Command Prompt in the Microsoft Windows virtual machine and set the machine to boot in
Safe Mode.
> bcdedit /set {current} safeboot minimal
6. Reset the bcdedit setting to boot the virtual machine in Normal Mode.
> bcdedit /deletvalue {current} safeboot
Bug: 29472477
Solution: There is no workaround for this behavior. Do not attach VirtIO-SCSI disks to OL6U10_X86
virtual machines.
Bug: 29499061
• Virtual Machines Not Migrated As Expected Through Virtual Machine Affinity and Host Affinity Rules Set
to Active and Enforcing
• Cannot Start or Edit Virtual Machine Imported from OVA with More Than Three Disks
• Changing Watchdog Actions on a Running Virtual Machine Requires a Virtual Machine Restart for New
Attribute to Take Effect
• Importing Several OVA Files Resulted in Only One Virtual Machine Being Imported
• Migration Mode Greyed Out When Setting Pinning-to-Host Setting for a Virtual Machine
• Cannot Assign Virtual Machine from a Virtual Machine Pool: Manager Claims That the Virtual Machine Is
Attached When It Is Not
32
Virtual Machine Does Not Boot with Allow Privileged SCSI I/O Option Enabled
• Manager Does Not Generate a Warning Message to Prevent OVA Export from a Virtual Machine Whose
Guest OS Is Installed on a Direct LUN Disk
• Manager Allows OVA Export from a Virtual Machine Whose Guest OS Is Installed on a Direct LUN Disk
• Manager Does Not Prevent Virtual Machine Shutdown When Creating a Snapshot
• Engine Exception When Unplugging a NIC Connected to a Virtual Machine Network on a Running Virtual
Machine
• Highly Available Virtual Machine Not Started on Other Host When Source Host Dies Unexpectedly
• VNC Console Session for a Running Virtual Machine Closes During Virtual Machine Migration
• Migrate VM Dialog Box Cannot Be Closed While a Virtual Machine Is Being Started
• Unable to Perform CPU Hot Unplug with Default Machine Type (pc-i440fx-2.6) for Oracle Linux Virtual
Machine
• VM Portal Displays Error for User With Super User Permission When VM in Pool is Running
• Cannot Import OVA Files That Contain More Than 1 Virtual Machine
Virtual Machine Does Not Boot with Allow Privileged SCSI I/O Option Enabled
If you have configured a virtual machine on Oracle Linux 7.7 with a physical LUN and the Allow Privileged
SCSI I/O option enabled, the virtual machine does not boot and reports an error:
libvirtError: Requested operation is not valid: unpriv_sgio is not supported
by this kernel
Solution: Do not use the Allow Privileged SCSI I/O option if your virtual machine has access to a physical
LUN.
Bug: 31021044
Solution: Enabling the VM Affinity Rule or the Host Affinity Rule Enforcing option imposes strict limits on
whether virtual machines can start or be migrated. With VM Affinity Rule Enforcing enabled (shown as
Hard in the list of Affinity Groups), the system does not migrate a virtual machine to a host different from
where the other virtual machines in its affinity group are running, even if attempting to satisfy a Host Affinity
Rule that only permits the virtual machines to run on a host other than where they are presently running.
The workaround for both VM and Host affinity rules is to not enable enforcing unless all scenarios including
migration scenarios are understood. The rules are not disabled if you do not select the Enforcing option;
it changes the enforcement from Hard to Soft, permitting the system to temporarily break the rule as
adjustments in virtual machine placement are made.
Bug: 29190112
33
Cannot Start or Edit Virtual Machine Imported from OVA with More Than Three Disks
Cannot Start or Edit Virtual Machine Imported from OVA with More Than Three
Disks
When a Microsoft Windows virtual machine is imported from an OVA with more than 3 disks, the virtual
machine cannot be started or edited.
Solution: If you want to import a Microsoft Windows virtual machine from an OVA with more than 3 disks,
the workaround is to set the disks to inactive after the import and before you reboot. Then, change the
disk connection protocol from IDE to virtio-scsi.
Bug: 30776581
The issue is that even though watchdog action is changed to poweroff, the attribute value did not take
effect immediately. The virtual machine must first be restarted before the new attribute takes effect.
Solution: There is no workaround for this behavior. If a watchdog action is changed on a running virtual
machine, you must restart the virtual machine for the attribute changes to take effect.
Bug: 29213956
Solution:This behavior is expected, as the guest hooks are enabled depending on the migration policy that
is configured, and the guest agent hook mechanism is disabled for migration policies set to Legacy. To
use guest agent hooks, you must use one of the other available migration policy types.
Bug: 29261746
Importing Several OVA Files Resulted in Only One Virtual Machine Being
Imported
When importing virtual machines, multiple OVA files can be selected, but only one virtual machine is
actually imported. If there is a limitation, the Manager should block attempts to import multiple OVA files.
Bug: 29373795
Solution: There is no workaround for this behavior. The KVM host eventually starts up several minutes
later.
34
Migration Mode Greyed Out When Setting Pinning-to-Host Setting for a Virtual Machine
Bug: 29393228
Migration Mode Greyed Out When Setting Pinning-to-Host Setting for a Virtual
Machine
This issue is observed in a 2-host cluster. The steps to reproduce the issue are as follows:
1. Edit a virtual machine by selecting the Highly Available checkbox on the High Availability tab, and
click OK.
2. Edit the virtual machine and update the pinning-to-host settings by selecting Specific Hosts and
adding the two hosts from the drop-down list on the Host tab, and click OK.
After doing completing these steps, the Migration Mode drop-down list is greyed out. This option
should be available in this scenario.
Solution: Try changing the pinning-to-host option to Any Host in Cluster and then change the setting
back to Specific Hosts again.
Bug: 29374044
Cannot Assign Virtual Machine from a Virtual Machine Pool: Manager Claims
That the Virtual Machine Is Attached When It Is Not
After creating a virtual machine pool with 10 virtual machines, setting the Maximum number of VMs per
user field to 10, and granting permissions to a user, the user correctly attaches some virtual machines.
Later the user tries to attach more virtual machines, but the Manager generates the following error,
indicating that virtual machines are already attached when they are not:
PoolName:
Cannot attach VM to VM-Pool. VM-Pool is already attached to a User.
Cannot allocate and run VM from VM-Pool. There are no available VMs in the VM-Pool.
Solution: A known issue in the upstream oVirt release. There is no workaround for this behavior.
Bug: 29379502
Manager Does Not Generate a Warning Message to Prevent OVA Export from
a Virtual Machine Whose Guest OS Is Installed on a Direct LUN Disk
The Manager does not generate an warning message that prevents OVA export from a virtual machine
whose guest OS is installed on a direct LUN disk.
Bug: 29432214
35
Manager Does Not Prevent Virtual Machine Shutdown When Creating a Snapshot
Bug: 29432323
When inspecting the Manager log, the follow message is seen repeatedly:
[org.ovirt.engine.core.bll.SerialChildCommandsExecutionCallback]
(EE-ManagedThreadFactory-engineScheduled-Thread-34)
[7363ae20-1f20-451c-8318-215f122fcc15] Command 'CreateSnapshotForVm' (id:
'b50fee33-204b-4fc0-a8e6-d40c7f58d485') waiting on child command id:
'3c843771-8b8f-4c07-9230-822bd2892481' type:'AddDisk' to complete
2019-03-08 03:55:22,992Z INFO
Bug: 29457750
When inspecting the Manager log, you may see the following EngineException:
EngineException: org.ovirt.engine.core.vdsbroker.vdsbroker.VDSErrorException:
VDSGenericException: VDSErrorException: Failed to HotUnplugNicVDS, error =
Timeout detaching <Interface name=vnet3, type=bridge, mac=00:21:f6:00:04:6b
at 0x7f6d30377868>, code = 50 (Failed with error DEACTIVATE_NIC_FAILED and
code 50)
Bug: 29460927
Highly Available Virtual Machine Not Started on Other Host When Source Host
Dies Unexpectedly
Highly available virtual machines are not started on the other host when the source host is powered off or
dies unexpectedly.
Solution: If a host that has running highly available virtual machines is powered off or dies unexpectedly
and the virtual machines do not have additional split-brain prevention mechanisms in place (such as
Sanlock, VM leases, or VM resume), you may be required to use the Confirm 'Host has been Rebooted'
option from the More Actions drop-down list on the Hosts pane before the Manager allows the highly
available virtual machines on the host to be restarted on the other host.
Bug: 29491043
36
VNC Console Session for a Running Virtual Machine Closes During Virtual Machine Migration
VNC Console Session for a Running Virtual Machine Closes During Virtual
Machine Migration
If you have an VNC console open for an active virtual machine during virtual machine migration, the
session closes. This behavior occurs when using either the native client or noVNC.
Bug: 29491251
Bug: 29498386
Unable to Perform CPU Hot Unplug with Default Machine Type (pc-i440fx-2.6)
for Oracle Linux Virtual Machine
The CPU hot unplug feature on the Manager is not working with the default emulated machine type for
Oracle Linux virtual machines (pc-i440fx-2.6).
Solution: To enable CPU hot unplug feature for a particular Oracle Linux virtual machine, you must
perform the following steps:
2. Change the Custom Emulated Machine to pc-i440fx-2.7 by performing the following steps in the
Administration Portal:
b. Select the Oracle Linux virtual machine and click Edit Virtual Machine.
Bug: 29517731
VM Portal Displays Error for User With Super User Permission When VM in
Pool is Running
If a user with SuperUser permission logs into the VM Portal and a VM in a Pool is in a running state, the
VM Portal displays an error message "Sorry, VM Portal is currently having some issues."
37
Cannot Import OVA Files That Contain More Than 1 Virtual Machine
Solution: For users who require access to the VM Portal, create a new user who does not have
SuperUser permission and log into the VM Portal as that new user.
Bug: 30770232
Cannot Import OVA Files That Contain More Than 1 Virtual Machine
If an Open Virtualization Appliance file contains more than one virtual machine, then the virtual machines in
the file cannot be imported. The import begins and appears to import the first virtual machine, but then the
import fails and no virtual machine are installed successfully.
Bug: 30771759
Solution: The workaround is to click on the Edit button and then close the pop-up by clicking on OK,
which sets the value to VNC.
Bug: 30807213
38
Chapter 7 Feedback and Support
Support for the Oracle Linux Virtualization Manager is available to customers with an Oracle Linux Premier
Support subscription. Refer to the Oracle® Linux 7: Licensing Information User Manual for information
about Oracle Linux support levels.
If you are reporting an issue, please provide the following information where applicable:
• Description of the problem, including the situation where the problem occurs, and its impact on your
operation.
• Machine type, operating system release, browser type and version, locale and product release, including
any patches you have applied, and other software that might be affecting the problem.
• Detailed steps on the method you have used, to reproduce the problem.
To use the log collector tool to generate an archive file for Oracle Support, perform the following steps:
To use the log collector tool, you are required to log in as the root user and provide the administration
credentials for the Manager.
The ovirt-log-collector -h command displays usage information, including a list of all valid
options for the ovirt-log-collector command.
When the ovirt-log-collector command is run without specifying any additional parameters,
its default behavior is to collect all logs from the Manager and its attached hosts. This command also
collect database logs unless this collection is excluded using the --no-postgresql command option.
After the log collector tools performs the log collection, the collected logs are placed in an archive file
under the /tmp/logcollector directory. The log collector tool automatically assigns a name to the
archive file.
39
40