Add KVM config info to the Install Guide
Add KVM config info from Config Reference Update Enabling KVM in the native file Update the references to QEMU and Xen Create Enabling KVM section and use it from both Config Reference and Install Guide Add reference to amd and intel subsections Change-Id: I103ec048cceefb336026823a16257d88671bf969 Closes-Bug: #1238256 Author: Nermina Miller
This commit is contained in:
nerminamiller
parent
b558315550
commit
e1587dfd0a
@ -5,23 +5,27 @@
|
||||
xml:id="kvm">
|
||||
<?dbhtml stop-chunking?>
|
||||
<title>KVM</title>
|
||||
<para>KVM is configured as the default hypervisor for Compute. <note>
|
||||
<para>There are several sections about hypervisor
|
||||
selection in this document. If you are reading this
|
||||
document linearly, you do not want to load the KVM
|
||||
module prior to installing <systemitem class="service">nova-compute</systemitem>. The
|
||||
<systemitem class="service">nova-compute</systemitem> service depends on qemu-kvm which
|
||||
installs
|
||||
<para>KVM is configured as the default hypervisor for
|
||||
Compute.</para>
|
||||
<note>
|
||||
<para>This document contains several sections about hypervisor
|
||||
selection. If you are reading this document linearly, you
|
||||
do not want to load the KVM module before you install
|
||||
<systemitem class="service">nova-compute</systemitem>.
|
||||
The <systemitem class="service">nova-compute</systemitem>
|
||||
service depends on qemu-kvm, which installs
|
||||
<filename>/lib/udev/rules.d/45-qemu-kvm.rules</filename>,
|
||||
which sets the correct permissions on the /dev/kvm
|
||||
device node.</para>
|
||||
</note></para>
|
||||
which sets the correct permissions on the /dev/kvm device
|
||||
node.</para>
|
||||
</note>
|
||||
<para>To enable KVM explicitly, add the following configuration
|
||||
options
|
||||
<filename>/etc/nova/nova.conf</filename>:<programlisting language="ini">compute_driver=libvirt.LibvirtDriver
|
||||
options to the <filename>/etc/nova/nova.conf</filename>
|
||||
file:</para>
|
||||
<programlisting language="ini">compute_driver=libvirt.LibvirtDriver
|
||||
libvirt_type=kvm</programlisting>
|
||||
The KVM hypervisor supports the following virtual machine
|
||||
image formats:<itemizedlist>
|
||||
<para>The KVM hypervisor supports the following virtual machine
|
||||
image formats:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Raw</para>
|
||||
</listitem>
|
||||
@ -34,219 +38,166 @@ libvirt_type=kvm</programlisting>
|
||||
<listitem>
|
||||
<para>VMWare virtual machine disk format (vmdk)</para>
|
||||
</listitem>
|
||||
</itemizedlist></para>
|
||||
<para>The rest of this section describes how to enable KVM on your system. You may also wish to
|
||||
consult distribution-specific documentation:<itemizedlist>
|
||||
</itemizedlist>
|
||||
<para>This section describes how to enable KVM on your system. For
|
||||
more information, see the following distribution-specific
|
||||
documentation:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><link
|
||||
xlink:href="http://fedoraproject.org/wiki/Getting_started_with_virtualization"
|
||||
>Fedora: Getting started with virtualization</link> from the Fedora project
|
||||
>Fedora: Getting started with
|
||||
virtualization</link> from the Fedora project
|
||||
wiki.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><link xlink:href="https://help.ubuntu.com/community/KVM/Installation">Ubuntu:
|
||||
KVM/Installation</link> from the Community Ubuntu documentation.</para>
|
||||
<para><link
|
||||
xlink:href="https://help.ubuntu.com/community/KVM/Installation"
|
||||
>Ubuntu: KVM/Installation</link> from the
|
||||
Community Ubuntu documentation.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><link
|
||||
xlink:href="http://static.debian-handbook.info/browse/stable/sect.virtualization.html#idp11279352"
|
||||
>Debian: Virtualization with KVM</link> from the Debian handbook.</para>
|
||||
>Debian: Virtualization with KVM</link> from the
|
||||
Debian handbook.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><link
|
||||
xlink:href="http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Virtualization_Host_Configuration_and_Guest_Installation_Guide/sect-Virtualization_Host_Configuration_and_Guest_Installation_Guide-Host_Installation-Installing_KVM_packages_on_an_existing_Red_Hat_Enterprise_Linux_system.html"
|
||||
>RHEL: Installing virtualization packages on
|
||||
an existing Red Hat Enterprise Linux
|
||||
system</link> from the Red Hat Enterprise
|
||||
Linux Virtualization Host Configuration and Guest
|
||||
Installation Guide.</para>
|
||||
>RHEL: Installing virtualization packages on an
|
||||
existing Red Hat Enterprise Linux system</link>
|
||||
from the <citetitle>Red Hat Enterprise Linux
|
||||
Virtualization Host Configuration and Guest
|
||||
Installation Guide</citetitle>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><link
|
||||
xlink:href="http://doc.opensuse.org/documentation/html/openSUSE/opensuse-kvm/cha.kvm.requires.html#sec.kvm.requires.install"
|
||||
>openSUSE: Installing KVM</link> from the openSUSE Virtualization with KVM
|
||||
manual.</para>
|
||||
>openSUSE: Installing KVM</link> from the openSUSE
|
||||
Virtualization with KVM manual.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><link
|
||||
xlink:href="http://doc.opensuse.org/products/draft/SLES/SLES-kvm_sd_draft/cha.kvm.requires.html#sec.kvm.requires.install"
|
||||
>SLES: Installing KVM</link> from the SUSE
|
||||
Linux Enterprise Server Virtualization with KVM
|
||||
>SLES: Installing KVM</link> from the SUSE Linux
|
||||
Enterprise Server Virtualization with KVM
|
||||
manual.</para>
|
||||
</listitem>
|
||||
</itemizedlist></para>
|
||||
<section xml:id="checking-kvm">
|
||||
<title>Checking for hardware virtualization support</title>
|
||||
<para>The processors of your compute host need to support virtualization technology (VT)
|
||||
(mainly Intel <emphasis role="italic">VT -x</emphasis> or AMD <emphasis role="italic"
|
||||
>AMD-v</emphasis> technologies) to use KVM.</para>
|
||||
<para>In order to check if your processor has VT support (which has to be enabled in the
|
||||
BIOS), follow on Ubuntu these steps:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Issue as root on Ubuntu:</para>
|
||||
<screen><prompt>#</prompt> <userinput>apt-get install cpu-checker</userinput>
|
||||
<prompt>#</prompt> <userinput>kvm-ok</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>If KVM is supported, the output should look something like:</para>
|
||||
<screen><computeroutput>INFO: /dev/kvm exists
|
||||
KVM acceleration can be used</computeroutput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>If KVM is supported, the output should look something like:</para>
|
||||
<screen><computeroutput>INFO: /dev/kvm exists
|
||||
KVM acceleration can be used</computeroutput></screen>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>On other distributions, follow these steps:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>Run the following as user:</para>
|
||||
<screen><prompt>$</prompt> <userinput>egrep '(vmx|svm)' --color=always /proc/cpuinfo</userinput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>If KVM is supported, the output should look something like:</para>
|
||||
<screen><computeroutput>flags : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx rdtscp lm constant_tsc arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc aperfmperf pni dtes64 monitor ds_cpl vmx est tm2 ssse3 cx16 xtpr pdcm pcid sse4_1 sse4_2 popcnt lahf_lm arat dtherm tpr_shadow vnmi flexpriority ept vpid</computeroutput></screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>If KVM is not supported, you should get no output.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<note><para>Some systems require that you enable VT support in the system BIOS. If you believe
|
||||
your processor supports hardware acceleration but the above command produced no output,
|
||||
you may need to reboot your machine, enter the system BIOS, and enable the VT
|
||||
option.</para></note>
|
||||
|
||||
<para>In the case that KVM acceleration is not supported, Compute should be configured to
|
||||
use a different hypervisor, such as <link linkend="qemu">QEMU</link> or <link
|
||||
linkend="introduction-to-xen">Xen</link>.</para>
|
||||
<xi:include href="section_kvm_enable.xml"/>
|
||||
|
||||
</section>
|
||||
|
||||
<section xml:id="enabling-kvm">
|
||||
<title>Enabling KVM</title>
|
||||
<para>KVM requires the <literal>kvm</literal> and either <literal>kvm-intel</literal> or
|
||||
<literal>kvm-amd</literal> modules to be loaded. This may have been configured
|
||||
automatically on your distribution when KVM is installed.</para>
|
||||
<para>You can check that they have been loaded using <command>lsmod</command>, as follows,
|
||||
with expected output for Intel-based
|
||||
processors:<screen><prompt>$</prompt> <userinput>lsmod | grep kvm</userinput>
|
||||
<computeroutput>kvm_intel 137721 9
|
||||
kvm 415459 1 kvm_intel</computeroutput></screen>The
|
||||
following sections describe how to load the kernel modules for Intel-based and AMD-based
|
||||
processors if they were not loaded automatically by your distribution's KVM installation
|
||||
process.</para>
|
||||
|
||||
<section xml:id="kvm-intel">
|
||||
<title>Intel-based processors</title>
|
||||
<para>If your compute host is Intel-based, run the following as root to load the kernel
|
||||
modules:<screen><prompt>#</prompt> <userinput>modprobe kvm</userinput>
|
||||
<prompt>#</prompt> <userinput>modprobe kvm-intel</userinput></screen>
|
||||
Add the following lines to <filename>/etc/modules</filename> so that these modules
|
||||
will load on reboot:<programlisting>kvm
|
||||
kvm-intel</programlisting></para>
|
||||
</section>
|
||||
<section xml:id="kvm-amd">
|
||||
<title>AMD-based processors</title>
|
||||
<para>If your compute host is AMD-based, run the following as root to load the kernel
|
||||
modules:<screen><prompt>#</prompt> <userinput>modprobe kvm</userinput>
|
||||
<prompt>#</prompt> <userinput>modprobe kvm-amd</userinput></screen>
|
||||
Add the following lines to <filename>/etc/modules</filename> so that these modules
|
||||
will load on reboot:<programlisting>kvm
|
||||
kvm-amd</programlisting></para>
|
||||
</section>
|
||||
</section>
|
||||
<section xml:id="libvirt-xml-cpu-model">
|
||||
<title>Specifying the CPU model of KVM guests</title>
|
||||
<para>The Compute service allows you to control the guest CPU model that is exposed to KVM
|
||||
virtual machines. Use cases include:<itemizedlist>
|
||||
<title>Specify the CPU model of KVM guests</title>
|
||||
<para>The Compute service enables you to control the guest CPU
|
||||
model that is exposed to KVM virtual machines. Use cases
|
||||
include:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>To maximize performance of virtual machines by exposing new host CPU
|
||||
features to the guest</para>
|
||||
<para>To maximize performance of virtual machines by
|
||||
exposing new host CPU features to the guest</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>To ensure a consistent default CPU across all machines, removing reliance
|
||||
of variable QEMU defaults</para>
|
||||
<para>To ensure a consistent default CPU across all
|
||||
machines, removing reliance of variable QEMU
|
||||
defaults</para>
|
||||
</listitem>
|
||||
</itemizedlist></para>
|
||||
<para>In libvirt, the CPU is specified by providing a base CPU model name (which is a
|
||||
shorthand for a set of feature flags), a set of additional feature flags, and the
|
||||
topology (sockets/cores/threads). The libvirt KVM driver provides a number of standard
|
||||
CPU model names. These models are defined in the file
|
||||
<filename>/usr/share/libvirt/cpu_map.xml</filename>. Check this file to determine
|
||||
which models are supported by your local installation.</para>
|
||||
<para>There are two Compute configuration options that determine the type of CPU model
|
||||
exposed to the hypervisor when using KVM, <literal>libvirt_cpu_mode</literal> and
|
||||
</itemizedlist>
|
||||
<para>In libvirt, the CPU is specified by providing a base CPU
|
||||
model name (which is a shorthand for a set of feature
|
||||
flags), a set of additional feature flags, and the
|
||||
topology (sockets/cores/threads). The libvirt KVM driver
|
||||
provides a number of standard CPU model names. These
|
||||
models are defined in the
|
||||
<filename>/usr/share/libvirt/cpu_map.xml</filename>
|
||||
file. Check this file to determine which models are
|
||||
supported by your local installation.</para>
|
||||
<para>Two Compute configuration options define which type of
|
||||
CPU model is exposed to the hypervisor when using KVM:
|
||||
<literal>libvirt_cpu_mode</literal> and
|
||||
<literal>libvirt_cpu_model</literal>.</para>
|
||||
<para>The <literal>libvirt_cpu_mode</literal> option can take one of four values:
|
||||
<literal>none</literal>, <literal>host-passthrough</literal>,
|
||||
<literal>host-model</literal> and <literal>custom</literal>.</para>
|
||||
<para>The <literal>libvirt_cpu_mode</literal> option can take
|
||||
one of the following values: <literal>none</literal>,
|
||||
<literal>host-passthrough</literal>,
|
||||
<literal>host-model</literal>, and
|
||||
<literal>custom</literal>.</para>
|
||||
<simplesect>
|
||||
<title>Host model (default for KVM & QEMU)</title>
|
||||
<para>If your <filename>nova.conf</filename> contains
|
||||
<literal>libvirt_cpu_mode=host-model</literal>, libvirt will identify the CPU
|
||||
model in <filename>/usr/share/libvirt/cpu_map.xml</filename> which most closely
|
||||
matches the host, and then request additional CPU flags to complete the match. This
|
||||
should give close to maximum functionality/performance, which maintaining good
|
||||
reliability/compatibility if the guest is migrated to another host with slightly
|
||||
different host CPUs.</para>
|
||||
<para>If your <filename>nova.conf</filename> file contains
|
||||
<literal>libvirt_cpu_mode=host-model</literal>,
|
||||
libvirt identifies the CPU model in
|
||||
<filename>/usr/share/libvirt/cpu_map.xml</filename>
|
||||
file that most closely matches the host, and requests
|
||||
additional CPU flags to complete the match. This
|
||||
configuration provides the maximum functionality and
|
||||
performance and maintains good reliability and
|
||||
compatibility if the guest is migrated to another host
|
||||
with slightly different host CPUs.</para>
|
||||
</simplesect>
|
||||
<simplesect>
|
||||
<title>Host passthrough</title>
|
||||
<para>If your <filename>nova.conf</filename> contains
|
||||
<literal>libvirt_cpu_mode=host-passthrough</literal>, libvirt will tell KVM to
|
||||
passthrough the host CPU with no modifications. The difference to host-model,
|
||||
instead of just matching feature flags, every last detail of the host CPU is
|
||||
matched. This gives absolutely best performance, and can be important to some apps
|
||||
which check low level CPU details, but it comes at a cost with respect to migration:
|
||||
the guest can only be migrated to an exactly matching host CPU.</para>
|
||||
<title>Host pass through</title>
|
||||
<para>If your <filename>nova.conf</filename> file contains
|
||||
<literal>libvirt_cpu_mode=host-passthrough</literal>,
|
||||
libvirt tells KVM to pass through the host CPU with no
|
||||
modifications. The difference to host-model, instead
|
||||
of just matching feature flags, every last detail of
|
||||
the host CPU is matched. This gives absolutely best
|
||||
performance, and can be important to some apps which
|
||||
check low level CPU details, but it comes at a cost
|
||||
with respect to migration: the guest can only be
|
||||
migrated to an exactly matching host CPU.</para>
|
||||
</simplesect>
|
||||
<simplesect>
|
||||
<title>Custom</title>
|
||||
<para>If your <filename>nova.conf</filename> file contains <literal>libvirt_cpu_mode=custom</literal>, you can
|
||||
explicitly specify one of the supported named model using the libvirt_cpu_model
|
||||
configuration option. For example, to configure the KVM guests to expose Nehalem
|
||||
CPUs, your nova.conf should contain:</para>
|
||||
<para>
|
||||
<para>If your <filename>nova.conf</filename> file contains
|
||||
<literal>libvirt_cpu_mode=custom</literal>, you
|
||||
can explicitly specify one of the supported named
|
||||
model using the libvirt_cpu_model configuration
|
||||
option. For example, to configure the KVM guests to
|
||||
expose Nehalem CPUs, your
|
||||
<filename>nova.conf</filename> file should
|
||||
contain:</para>
|
||||
<programlisting language="ini">libvirt_cpu_mode=custom
|
||||
libvirt_cpu_model=Nehalem</programlisting>
|
||||
</para>
|
||||
</simplesect>
|
||||
<simplesect>
|
||||
<title>None (default for all libvirt-driven hypervisors other than KVM &
|
||||
QEMU)</title>
|
||||
<para>If your <filename>nova.conf</filename> contains
|
||||
<literal>libvirt_cpu_mode=none</literal>, then
|
||||
libvirt will not specify any CPU model at all. It will
|
||||
leave it up to the hypervisor to choose the default
|
||||
model. This setting is equivalent to the Compute
|
||||
service behavior prior to the Folsom release.</para>
|
||||
<title>None (default for all libvirt-driven hypervisors
|
||||
other than KVM & QEMU)</title>
|
||||
<para>If your <filename>nova.conf</filename> file contains
|
||||
<literal>libvirt_cpu_mode=none</literal>, libvirt
|
||||
does not specify a CPU model. Instead, the hypervisor
|
||||
chooses the default model. This setting is equivalent
|
||||
to the Compute service behavior prior to the Folsom
|
||||
release.</para>
|
||||
</simplesect>
|
||||
</section>
|
||||
<section xml:id="kvm-performance">
|
||||
<title>KVM Performance Tweaks</title>
|
||||
<para>A recommended resource to help you improve
|
||||
the performance of KVM is
|
||||
the <link xlink:href="http://www.linux-kvm.org/page/VhostNet">VHostNet</link>
|
||||
kernel module. This module improves network performance. To load the
|
||||
kernel module, as root:
|
||||
<screen><prompt>#</prompt> <userinput>modprobe vhost_net</userinput></screen></para>
|
||||
<para>The <link
|
||||
xlink:href="http://www.linux-kvm.org/page/VhostNet"
|
||||
>VHostNet</link> kernel module improves network
|
||||
performance. To load the kernel module, run the following
|
||||
command as root:</para>
|
||||
<screen><prompt>#</prompt> <userinput>modprobe vhost_net</userinput></screen>
|
||||
</section>
|
||||
<section xml:id="kvm-troubleshooting">
|
||||
<title>Troubleshooting</title>
|
||||
<para>Trying to launch a new virtual machine instance fails
|
||||
with the <literal>ERROR</literal> state, and the following
|
||||
error appears in
|
||||
<filename>/var/log/nova/nova-compute.log</filename><screen><computeroutput>libvirtError: internal error no supported architecture for os type 'hvm'</computeroutput></screen>
|
||||
This is a symptom that the KVM kernel modules have not
|
||||
been loaded.</para>
|
||||
with the <literal>ERROR</literal>state, and the following
|
||||
error appears in the
|
||||
<filename>/var/log/nova/nova-compute.log</filename>
|
||||
file:</para>
|
||||
<screen><computeroutput>libvirtError: internal error no supported architecture for os type 'hvm'</computeroutput></screen>
|
||||
<para>This message indicates that the KVM kernel modules were
|
||||
not loaded.</para>
|
||||
<para>If you cannot start VMs after installation without
|
||||
rebooting, it's possible the permissions are not correct.
|
||||
This can happen if you load the KVM module before you've
|
||||
installed <systemitem class="service">nova-compute</systemitem>. To check the permissions, run
|
||||
<userinput>ls -l /dev/kvm</userinput> to see whether
|
||||
the group is set to kvm. If not, run <userinput>sudo
|
||||
udevadm trigger</userinput>.</para>
|
||||
rebooting, the permissions might not be correct. This can
|
||||
happen if you load the KVM module before you install
|
||||
<systemitem class="service">nova-compute</systemitem>.
|
||||
To check whether the group is set to kvm, run:</para>
|
||||
<screen><prompt>#</prompt> <userinput>ls -l /dev/kvm</userinput></screen>
|
||||
<para>If it is not set to kvm, run:</para>
|
||||
<screen><prompt>#</prompt> <userinput>sudo udevadm trigger</userinput></screen>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
101
doc/common/section_kvm_enable.xml
Normal file
101
doc/common/section_kvm_enable.xml
Normal file
@ -0,0 +1,101 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<section xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
||||
xml:id="section_kvm_enable">
|
||||
<title>Enabling KVM</title>
|
||||
<para>To perform the following steps, you must be logged in as
|
||||
the <systemitem>root</systemitem> user.</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para>To determine whether the <literal>svm</literal>
|
||||
or <literal>vmx</literal> CPU extensions are
|
||||
present, run the following command:</para>
|
||||
<screen><prompt>#</prompt> <userinput>grep -E 'svm|vmx' /proc/cpuinfo</userinput></screen>
|
||||
<para>This command generates output if the CPU is
|
||||
hardware-virtualization capable. Even if output is
|
||||
shown, you may still need to enable virtualization
|
||||
in the system BIOS for full support.</para>
|
||||
<para>If no output appears, consult your system
|
||||
documentation to ensure that your CPU and
|
||||
motherboard support hardware virtualization.
|
||||
Verify that any relevant hardware virtualization
|
||||
options are enabled in the system BIOS.</para>
|
||||
<para>Each manufacturer's BIOS is different. If you need to enable virtualization in
|
||||
the BIOS, look for an option containing the words "virtualization", "VT", "VMX", or
|
||||
"SVM." </para>
|
||||
</step>
|
||||
<step>
|
||||
<para>To list the loaded kernel modules and verify
|
||||
that the <literal>kvm</literal> modules are
|
||||
loaded, run the following command:</para>
|
||||
<screen><prompt>#</prompt> <userinput>lsmod | grep kvm</userinput></screen>
|
||||
<para>If the output includes <systemitem>kvm_intel</systemitem> or
|
||||
<systemitem>kvm_amd</systemitem>, the <systemitem>kvm</systemitem> hardware
|
||||
virtualization modules are loaded and your kernel meets the module requirements for
|
||||
OpenStack Compute.</para>
|
||||
<para>If the output does not show that the kvm module
|
||||
is loaded, run the following command to load
|
||||
it:</para>
|
||||
<screen><prompt>#</prompt> <userinput>modprobe -a kvm</userinput></screen>
|
||||
<para>Run the command for your CPU. For Intel, run
|
||||
this command:</para>
|
||||
<screen><prompt>#</prompt> <userinput>modprobe -a kvm-intel</userinput></screen>
|
||||
<para>For AMD, run this command:</para>
|
||||
<screen><prompt>#</prompt> <userinput>modprobe -a kvm-amd</userinput></screen>
|
||||
<para>Because a KVM installation can change user group
|
||||
membership, you might need to log in again for
|
||||
changes to take effect.</para>
|
||||
<para>If the kernel modules do not load automatically, please use the procedures listed
|
||||
in the subsections below.</para>
|
||||
</step>
|
||||
</procedure>
|
||||
<para>This completes the required checks to ensure that
|
||||
hardware virtualization support is available and enabled,
|
||||
and that the correct kernel modules are loaded.</para>
|
||||
<para>If the checks indicate that required hardware
|
||||
virtualization support or kernel modules are disabled or
|
||||
not available, you must either enable this support on the
|
||||
system or find a system with this support.</para>
|
||||
<note>
|
||||
<para>Some systems require that you enable VT support in
|
||||
the system BIOS. If you believe your processor
|
||||
supports hardware acceleration but the previous
|
||||
command did not produce output, you might need to
|
||||
reboot your machine, enter the system BIOS, and enable
|
||||
the VT option.</para>
|
||||
</note>
|
||||
<para>If KVM acceleration is not supported, configure Compute
|
||||
to use a different hypervisor, such as <link
|
||||
xlink:href="http://docs.openstack.org/trunk/config-reference/content/qemu.html"
|
||||
>QEMU</link> or <link
|
||||
xlink:href="http://docs.openstack.org/trunk/config-reference/content/introduction-to-xen.html"
|
||||
>Xen</link>.</para>
|
||||
<para>The following procedures will help you load the kernel modules for Intel-based and
|
||||
AMD-based processors if they did not load automatically during KVM installation.</para>
|
||||
<section xml:id="kvm-intel">
|
||||
<title>Intel-based processors</title>
|
||||
<para>If your compute host is Intel-based, run the
|
||||
following command as root to load the kernel
|
||||
modules:</para>
|
||||
<screen><prompt>#</prompt> <userinput>modprobe kvm</userinput>
|
||||
<prompt>#</prompt> <userinput>modprobe kvm-intel</userinput></screen>
|
||||
<para>Add the following lines to the
|
||||
<filename>/etc/modules</filename> file so that
|
||||
these modules load on reboot:</para>
|
||||
<programlisting>kvm
|
||||
kvm-intel</programlisting>
|
||||
</section>
|
||||
<section xml:id="kvm-amd">
|
||||
<title>AMD-based processors</title>
|
||||
<para>If your compute host is AMD-based, run the following
|
||||
command as root to load the kernel modules:</para>
|
||||
<screen><prompt>#</prompt> <userinput>modprobe kvm</userinput>
|
||||
<prompt>#</prompt> <userinput>modprobe kvm-amd</userinput></screen>
|
||||
<para>Add the following lines to
|
||||
<filename>/etc/modules</filename> file so that
|
||||
these modules load on reboot:</para>
|
||||
<programlisting>kvm
|
||||
kvm-amd</programlisting>
|
||||
</section>
|
||||
</section>
|
||||
@ -4,79 +4,11 @@
|
||||
version="5.0"
|
||||
xml:id="nova-kvm">
|
||||
<title>Enabling KVM on the Compute Node</title>
|
||||
<para>
|
||||
The OpenStack Compute Service requires hardware virtualization support
|
||||
and certain kernel modules. Follow this procedure to determine whether
|
||||
your system has hardware virtualization support and the correct kernel
|
||||
modules available. In many cases, this is installed for you by your
|
||||
distribution and you do not need to perform any additional action.
|
||||
</para>
|
||||
<para>
|
||||
All steps listed must be performed while logged into the system as the
|
||||
<systemitem>root</systemitem> user.
|
||||
</para>
|
||||
<procedure>
|
||||
<step>
|
||||
<para>
|
||||
Use the <command>grep</command> command to check for the
|
||||
presence of the <literal>svm</literal> or <literal>vmx</literal>
|
||||
CPU extensions by inspecting the <filename>/proc/cpuinfo</filename>
|
||||
file generated by the kernel:
|
||||
</para>
|
||||
<screen><prompt>#</prompt> <userinput><command>grep -E 'svm|vmx' /proc/cpuinfo</command></userinput></screen>
|
||||
<para>
|
||||
If any output is shown after running this command then the CPU
|
||||
is hardware virtualization capable. Even if output is shown,
|
||||
you may still need to enable virtualization in the system BIOS
|
||||
for full support.
|
||||
</para>
|
||||
<para>
|
||||
If output is <emphasis>not</emphasis> shown then consult your
|
||||
system documentation to ensure that your CPU and motherboard
|
||||
support hardware virtualization. Verify that any relevant
|
||||
hardware virtualization options are enabled in the system BIOS.
|
||||
</para>
|
||||
<para>
|
||||
Each manufacturer's BIOS is different. If you need to enable
|
||||
virtualization in the BIOS, look for an option containing the
|
||||
words "virtualization", "VT", "VMX", or "SVM".
|
||||
</para>
|
||||
</step>
|
||||
<step>
|
||||
<para>
|
||||
Use the <command>lsmod</command> command to list the loaded
|
||||
kernel modules and verify that the <literal>kvm</literal>
|
||||
modules are loaded:
|
||||
</para>
|
||||
<screen><prompt>#</prompt> <userinput><command>lsmod | grep kvm</command></userinput></screen>
|
||||
<para>
|
||||
If the output includes <systemitem>kvm_intel</systemitem> or
|
||||
<systemitem>kvm_amd</systemitem> then the <systemitem>kvm</systemitem>
|
||||
hardware virtualization modules are loaded and your kernel meets
|
||||
the module requirements for the OpenStack Compute Service.
|
||||
</para>
|
||||
<para>If the output does not appear to have the kvm module loaded,
|
||||
you should be able to load it with:</para>
|
||||
<screen><prompt>#</prompt> <userinput><command>modprobe -a kvm</command></userinput></screen>
|
||||
<para>then for your particular CPU, choose either intel:
|
||||
<screen><prompt>#</prompt> <userinput><command>modprobe -a kvm-intel</command></userinput></screen>
|
||||
or amd:</para>
|
||||
<screen><prompt>#</prompt> <userinput><command>modprobe -a kvm-amd</command></userinput></screen>
|
||||
<para>However, as kvm installation may change the groups your user is
|
||||
a member of, you may need to re-login for changes to take effect.
|
||||
</para>
|
||||
</step>
|
||||
</procedure>
|
||||
<para>
|
||||
This completes the required checks to ensure hardware virtualization
|
||||
support is available and enabled, and that you have the correct kernel
|
||||
modules loaded.
|
||||
</para>
|
||||
<para>
|
||||
If the checks indicated that either hardware virtualization support or
|
||||
the required kernel modules are not available or not enabled then you
|
||||
must take action to either find a system that does have the required
|
||||
hardware virtualization support and modules, or enable it on the system
|
||||
that failed the checks.
|
||||
</para>
|
||||
|
||||
<para>OpenStack Compute requires hardware virtualization support and certain kernel modules. To
|
||||
determine whether your system has hardware virtualization support and the correct kernel
|
||||
modules available and to enable KVM, use the following procedure. In many cases, this is
|
||||
installed for you by your distribution and you do not need to perform any additional action.</para>
|
||||
<xi:include href="../common/section_kvm_enable.xml"/>
|
||||
|
||||
</section>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user