mirror of
https://pagure.io/fedora-docs/quick-docs.git
synced 2024-11-28 14:56:35 +00:00
added virtualization topics
This commit is contained in:
Dayle Parker
parent
048353c1d9
commit
8279cf1e82
5 changed files with 308 additions and 0 deletions
0
en-US/modules/con_qemu_libvirt.adoc
Normal file
0
en-US/modules/con_qemu_libvirt.adoc
Normal file
53
en-US/modules/proc_creating_virtual_machines.adoc
Normal file
53
en-US/modules/proc_creating_virtual_machines.adoc
Normal file
|
|
@ -0,0 +1,53 @@
|
||||||
|
[[creating-a-fedora-guest]]
|
||||||
|
== Creating a Fedora guest
|
||||||
|
|
||||||
|
The installation of Fedora guests using Anaconda is supported. The
|
||||||
|
installation can be started on the command-line using the `virt-install`
|
||||||
|
program or in the user interface program `virt-manager`.
|
||||||
|
|
||||||
|
[[creating-a-guest-with-virt-install]]
|
||||||
|
Creating a guest with virt-install
|
||||||
|
|
||||||
|
|
||||||
|
`virt-install` is a command-line based tool for creating virtualized
|
||||||
|
guests. Refer to
|
||||||
|
http://virt-tools.org/learning/install-with-command-line/ for
|
||||||
|
understanding how to use this tool. Execute `virt-install --help` for
|
||||||
|
command line help.
|
||||||
|
|
||||||
|
`virt-install` can use kickstart files, for example
|
||||||
|
`virt-install -x ks=kickstart-file-name.ks`.
|
||||||
|
|
||||||
|
If graphics were enabled, a VNC window will open and present the
|
||||||
|
graphical installer. If graphics were not enabled, a text installer will
|
||||||
|
appear. Proceed with the Fedora installation.
|
||||||
|
|
||||||
|
[[creating-a-guest-with-virt-manager]]
|
||||||
|
=== Creating a guest with virt-manager
|
||||||
|
|
||||||
|
. Start Virtual Machine Manager by navigating to
|
||||||
|
menu:Applications[System Tools], or by running the following command:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virt-manager"
|
||||||
|
----
|
||||||
|
+
|
||||||
|
[NOTE]
|
||||||
|
====
|
||||||
|
If you encounter an error message when starting Virtual Machine Manager, run the above command as a non-root user, without the `su -c`.
|
||||||
|
The user interface will prompt for the root password.
|
||||||
|
====
|
||||||
|
+
|
||||||
|
. Open a connection to a hypervisor by navigating to menu:File[Add
|
||||||
|
connection].
|
||||||
|
. Choose *qemu* for KVM, or *Xen* for Xen.
|
||||||
|
. Choose *local* or select a method to connect to a remote hypervisor.
|
||||||
|
. After a connection is opened, click the new icon next to the
|
||||||
|
hypervisor, or right-click on the active hypervisor and select *New*.
|
||||||
|
. Configure the virtual machine following the steps in the *New VM* wizard.
|
||||||
|
. Click *Finish* at the end of the wizard to provision the guest operating system. After a few moments a VNC
|
||||||
|
window will appear. Proceed with the Fedora installation.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
83
en-US/modules/proc_installing_virtualization_software.adoc
Normal file
83
en-US/modules/proc_installing_virtualization_software.adoc
Normal file
|
|
@ -0,0 +1,83 @@
|
||||||
|
[[installing-the-virtualization-packages]]
|
||||||
|
== Installing the virtualization packages
|
||||||
|
|
||||||
|
When installing Fedora, you can install the virtualization packages by
|
||||||
|
selecting *Virtualization* in the *Base Group* in the installer. See https://docs.fedoraproject.org/f27/install-guide/install/Installing_Using_Anaconda.html[Installing Using Anaconda].
|
||||||
|
|
||||||
|
|
||||||
|
For existing Fedora installations, you can install the virtualization tools via the command line using the Virtualization Package Group. To view the packages, run:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ dnf groupinfo virtualization
|
||||||
|
|
||||||
|
Group: Virtualization
|
||||||
|
Group-Id: virtualization
|
||||||
|
Description: These packages provide a virtualization environment.
|
||||||
|
|
||||||
|
Mandatory Packages:
|
||||||
|
=virt-install
|
||||||
|
|
||||||
|
Default Packages:
|
||||||
|
=libvirt-daemon-config-network
|
||||||
|
=libvirt-daemon-kvm
|
||||||
|
=qemu-kvm
|
||||||
|
=virt-manager
|
||||||
|
=virt-viewer
|
||||||
|
|
||||||
|
Optional Packages:
|
||||||
|
guestfs-browser
|
||||||
|
libguestfs-tools
|
||||||
|
python-libguestfs
|
||||||
|
virt-top
|
||||||
|
----
|
||||||
|
+
|
||||||
|
. Run the following command to install the mandatory and default packages in the virtualization group:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "dnf install @virtualization"
|
||||||
|
----
|
||||||
|
+
|
||||||
|
Alternatively, to install the mandatory, default, and optional packages, run:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "dnf group install with-optional virtualization"
|
||||||
|
----
|
||||||
|
+
|
||||||
|
. After the packages install, start the `libvirtd` service:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c systemctl start libvirtd
|
||||||
|
----
|
||||||
|
+
|
||||||
|
To start the service on boot, run:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c systemctl enable libvirtd
|
||||||
|
----
|
||||||
|
+
|
||||||
|
. To verify that the KVM kernel modules are properly loaded:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ lsmod | grep kvm
|
||||||
|
kvm_amd 55563 0
|
||||||
|
kvm 419458 1 kvm_amd
|
||||||
|
----
|
||||||
|
+
|
||||||
|
If this command lists `kvm_intel` or `kvm_amd`, KVM is properly
|
||||||
|
configured. See How_to_debug_Virtualization_problems#Ensuring_system_is_KVM_capable[
|
||||||
|
Ensuring system is KVM capable] for troubleshooting tips. (NEEDS EDITING)
|
||||||
|
|
||||||
|
[[networking-support]]
|
||||||
|
=== Networking Support
|
||||||
|
|
||||||
|
By default, libvirt will create a private network for your guests on the
|
||||||
|
host machine. This private network will use a 192.168.x.x subnet and not
|
||||||
|
be reachable directly from the network the host machine is on. However,
|
||||||
|
virtual guests can use the host machine as a gateway and can connect out
|
||||||
|
via it. If you need to provide services on your guests that are
|
||||||
|
reachable via other machines on your host network you can use iptables
|
||||||
|
DNAT rules to forward in specific ports, or you can set up a bridged environment.
|
||||||
|
|
||||||
|
See the http://wiki.libvirt.org/page/Networking[libvirt networking setup
|
||||||
|
page] for more information on how to setup a bridged network.
|
||||||
|
|
||||||
125
en-US/modules/proc_managing_virtual_machines.adoc
Normal file
125
en-US/modules/proc_managing_virtual_machines.adoc
Normal file
|
|
@ -0,0 +1,125 @@
|
||||||
|
[[managing-virtual-machines]]
|
||||||
|
== Managing Virtual Machines
|
||||||
|
|
||||||
|
When the installation of the guest operating system is complete, it can
|
||||||
|
be managed using the `virt-manager` program or via command line
|
||||||
|
using `virsh`.
|
||||||
|
|
||||||
|
[[managing-guests-with-virt-manager]]
|
||||||
|
=== Managing guests with virt-manager
|
||||||
|
|
||||||
|
. Start the Virtual Machine Manager by navigating to
|
||||||
|
menu:[Applications]System Tools, or run:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virt-manager"
|
||||||
|
----
|
||||||
|
+
|
||||||
|
If you are not root, you will be prompted to enter the root
|
||||||
|
password. Choose `Run unprivileged` to operate in read-only non-root
|
||||||
|
mode.
|
||||||
|
+
|
||||||
|
. Choose the host you wish to manage and click *Connect* in the "Open
|
||||||
|
Connection" dialog window.
|
||||||
|
. The list of virtual machines is displayed in the main window. Guests
|
||||||
|
that are running will display a ">" icon. Guests that are not running
|
||||||
|
will be greyed out.
|
||||||
|
. To manage a particular guest, double click on it, or right click and
|
||||||
|
select "Open".
|
||||||
|
. A new window for the guest will open that will allow you to use its
|
||||||
|
console, see information about its virtual hardware and start, stop, and pause
|
||||||
|
it.
|
||||||
|
|
||||||
|
For further information about `virt-manager`, see
|
||||||
|
http://virt-manager.et.redhat.com/.
|
||||||
|
|
||||||
|
Bugs in the `virt-manager` tool should be reported in
|
||||||
|
http://bugzilla.redhat.com[Bugzilla] against the `virt-manager`
|
||||||
|
component.
|
||||||
|
|
||||||
|
[[managing-guests-with-virsh]]
|
||||||
|
=== Managing guests with virsh
|
||||||
|
|
||||||
|
The `virsh` command line utility allows you to manage virtual
|
||||||
|
machines on the command line. The `virsh` utility is built around the libvirt management API:
|
||||||
|
|
||||||
|
* `virsh` has a stable set of commands whose syntax and semantics are
|
||||||
|
preserved across updates to the underlying virtualization platform.
|
||||||
|
* `virsh` can be used as an unprivileged user for read-only operations
|
||||||
|
(e.g. listing domains, listing domain statistics).
|
||||||
|
* `virsh` can manage domains running under Xen, QEMU/KVM, ESX or other
|
||||||
|
back-ends with no perceptible difference to the user.
|
||||||
|
|
||||||
|
To start a virtual machine:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh create <name of virtual machine>"
|
||||||
|
----
|
||||||
|
|
||||||
|
|
||||||
|
To list the virtual machines currently running:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh list"
|
||||||
|
----
|
||||||
|
|
||||||
|
To list all virtual machines, running or not:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh list --all"
|
||||||
|
----
|
||||||
|
|
||||||
|
To gracefully power off a guest:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh shutdown <virtual machine (name | id | uuid)>"
|
||||||
|
----
|
||||||
|
|
||||||
|
To non gracefully power off a guest:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh destroy <virtual machine (name | id | uuid)>"
|
||||||
|
----
|
||||||
|
|
||||||
|
To save a snapshot of the machine to a file:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh save <virtual machine (name | id | uuid)> <filename>"
|
||||||
|
----
|
||||||
|
|
||||||
|
To restore a previously saved snapshot:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh restore <filename>"
|
||||||
|
----
|
||||||
|
|
||||||
|
To export the configuration file of a virtual machine:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh dumpxml <virtual machine (name | id | uuid)"
|
||||||
|
----
|
||||||
|
|
||||||
|
For a complete list of commands available for use with `virsh`:
|
||||||
|
+
|
||||||
|
----
|
||||||
|
$ su -c "virsh help"
|
||||||
|
----
|
||||||
|
|
||||||
|
Or consult the manual page: `man virsh`
|
||||||
|
|
||||||
|
Bugs in the `virsh` tool should be reported in
|
||||||
|
http://bugzilla.redhat.com[Bugzilla] against the `libvirt` component.
|
||||||
|
|
||||||
|
|
||||||
|
[[remote-management]]
|
||||||
|
=== Remote management
|
||||||
|
|
||||||
|
The following remote management options are available:
|
||||||
|
|
||||||
|
* If using non-root users via SSH, see the setup instructions in http://wiki.libvirt.org/page/SSHSetup
|
||||||
|
* If using root for access via SSH, then create SSH keys for root, and
|
||||||
|
use `ssh-agent` and `ssh-add` before launching `virt-manager`.
|
||||||
|
* To use TLS, set up a local certificate authority and issue x509 certs
|
||||||
|
to all servers and clients. For information on configuring this option,
|
||||||
|
see http://wiki.libvirt.org/page/TLSSetup.
|
||||||
|
|
||||||
47
en-US/modules/ref_other_virtualization_options.adoc
Normal file
47
en-US/modules/ref_other_virtualization_options.adoc
Normal file
|
|
@ -0,0 +1,47 @@
|
||||||
|
[[other-virtualization-options]]
|
||||||
|
== Other virtualization options
|
||||||
|
|
||||||
|
[[qemukvm-without-libvirt]]
|
||||||
|
=== QEMU/KVM without libvirt
|
||||||
|
|
||||||
|
QEMU/KVM can be invoked directly without libvirt, however you cannot to use tools such as `virt-manager`, `virt-install`, or `virsh`. Plain
|
||||||
|
QEMU (without KVM) can also virtualize other processor architectures
|
||||||
|
like ARM or PowerPC.
|
||||||
|
|
||||||
|
[[xen]]
|
||||||
|
=== Xen
|
||||||
|
|
||||||
|
Fedora can run as a Xen guest operating system and also be used as a Xen host (with the latter being true from Fedora 16; for using an earlier version of
|
||||||
|
Fedora as a Xen host, check out the experimental repo available at
|
||||||
|
http://myoung.fedorapeople.org/dom0). For a guide on how to install and
|
||||||
|
setup a Fedora Xen host, see http://wiki.xen.org/wiki/Fedora_Host_Installation[Fedora Host Installation] page on the Xen Project wiki.
|
||||||
|
|
||||||
|
[[openstack]]
|
||||||
|
=== OpenStack
|
||||||
|
|
||||||
|
OpenStack consists of a number of services for running infrastructure as a service (IaaS) clouds. They are the Object Store (Swift), Compute (Nova) and Image (Glance) services.
|
||||||
|
|
||||||
|
[[opennebula]]
|
||||||
|
=== OpenNebula
|
||||||
|
|
||||||
|
OpenNebula is an open source toolkit for data center virtualization.
|
||||||
|
|
||||||
|
[[ovirt]]
|
||||||
|
=== oVirt
|
||||||
|
|
||||||
|
The https://www.ovirt.org/[oVirt project] is an open virtualization
|
||||||
|
project providing a end-to-end, server virtualization
|
||||||
|
management system with advanced capabilities for hosts and guests,
|
||||||
|
including high availability, live migration, storage management, system
|
||||||
|
scheduler, and more.
|
||||||
|
|
||||||
|
[[troubleshooting-and-known-issues]]
|
||||||
|
== Troubleshooting and known issues
|
||||||
|
|
||||||
|
For a list of known unresolved issues, as well as troubleshooting tips,
|
||||||
|
see link:How_to_debug_Virtualization_problems[How to debug
|
||||||
|
virtualization problems]
|
||||||
|
|
||||||
|
See a typo, something missing or out of date, or anything else which can be
|
||||||
|
improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.
|
||||||
|
|
||||||
Loading…
Reference in a new issue