PR#307: Technical review on getting started with virtualization completed. - fedora-docs/quick-docs

fedora-docs / quick-docs

#307 Technical review on getting started with virtualization completed.

Merged 3 years ago by pbokoc. Opened 3 years ago by copperi.

fedora-docs/ copperi/quick-docs technical-review-virtualization into master

Technical review on getting started with virtualization completed.

Jan Kuparinen • 3 years ago

533b421

modules/ROOT/pages/_partials/proc_creating-virtual-machines.adoc

file modified

+7 -7

		`@@ -53,14 +53,14 @@`

		`[source,shell,subs="attributes"]`
		`----`
		`- dd if=/dev/zero of=/var/lib/libvirt/images/guest.img bs=1M count=20480`
		`+ # sudo dd if=/dev/zero of=/var/lib/libvirt/images/guest.img bs=1M count=20480`
		`----`

		`you can also use fallocate(1):`

		`[source,shell,subs="attributes"]`
		`----`
		`- fallocate -l 20480M /var/lib/libvirt/images/guest.img`
		`+ # sudo fallocate -l 20480M /var/lib/libvirt/images/guest.img`
		`----`

		`===== Raw File (Sparse)`
		`@@ -69,8 +69,8 @@`

		`[source,shell,subs="attributes"]`
		`----`
		`- rm -f /var/lib/libvirt/images/guest.img`
		`- truncate --size=20480M /var/lib/libvirt/images/guest.img`
		`+ # sudo rm -f /var/lib/libvirt/images/guest.img`
		`+ # sudo truncate --size=20480M /var/lib/libvirt/images/guest.img`
		`----`


		`@@ -79,7 +79,7 @@`

		`[source,shell,subs="attributes"]`
		`----`
		`- # qemu-img create -f qcow2 /var/lib/libvirt/images/guest.qcow2 20480`
		`+ # sudo qemu-img create -f qcow2 /var/lib/libvirt/images/guest.qcow2 20480`
		`----`

		`More information about libvirt storage options can be found at https://libvirt.org/storage.html.`
		`@@ -88,7 +88,7 @@`

		`[source,shell,subs="attributes"]`
		`----`
		`- # virt-install --name Fedora{MAJOROSVER} \`
		`+ # sudo virt-install --name Fedora{MAJOROSVER} \`
		`--description 'Fedora {MAJOROSVER} Workstation' \`
		`--ram 4096 \`
		`--vcpus 2 \`
		`@@ -117,7 +117,7 @@`
		`+`
		`[source,shell,subs="attributes"]`
		`----`
		`- # virt-manager`
		`+ # sudo virt-manager`
		`----`
		`+`
		`. Open a connection to a hypervisor by navigating to menu:File[Add connection].`

modules/ROOT/pages/_partials/proc_installing-virtualization-software.adoc

file modified

+17 -22

		`@@ -13,23 +13,18 @@`
		`$ 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`
		`+ Description: These packages provide a graphical virtualization environment.`
		`+ Mandatory Packages:`
		`+ virt-install`
		`+ Default Packages:`
		`+ libvirt-daemon-config-network`
		`+ libvirt-daemon-kvm`
		`+ qemu-kvm`
		`+ virt-manager`
		`+ virt-viewer`
		`+ Optional Packages:`
		`libguestfs-tools`
		`- python-libguestfs`
		`+ python3-libguestfs`
		`virt-top`
		`----`

		`@@ -37,28 +32,28 @@`
		`+`
		`[source,shell,subs="attributes"]`
		`----`
		`- # dnf install @virtualization`
		`+ # sudo dnf install @virtualization`
		`----`
		`+`
		`Alternatively, to install the mandatory, default, and optional packages, run:`
		`+`
		`[source,shell,subs="attributes"]`
		`----`
		`- # dnf group install --with-optional virtualization`
		`+ # sudo dnf group install --with-optional virtualization`
		`----`
		`+`
		. After the packages install, start the `libvirtd` service:
		`+`
		`[source,shell,subs="attributes"]`
		`----`
		`- # systemctl start libvirtd`
		`+ # sudo systemctl start libvirtd`
		`----`
		`+`
		`To start the service on boot, run:`
		`+`
		`[source,shell,subs="attributes"]`
		`----`
		`- # systemctl enable libvirtd`
		`+ # sudo systemctl enable libvirtd`
		`----`
		`+`
		`. To verify that the KVM kernel modules are properly loaded:`
		`@@ -66,8 +61,8 @@`
		`[source,shell,subs="attributes"]`
		`----`
		`$ lsmod \| grep kvm`
		`- kvm_amd 55563 0`
		`- kvm 419458 1 kvm_amd`
		`+ kvm_amd 114688 0`
		`+ kvm 831488 1 kvm_amd`
		`----`
		`+`
		If this command lists `kvm_intel` or `kvm_amd`, KVM is properly configured.

modules/ROOT/pages/_partials/ref_managing-virtual-machines.adoc

file modified

+6 -6

		`@@ -13,15 +13,15 @@`
		`# 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.`
		`+ If you are not root, you will be prompted to enter the root password.`
		`. 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/.
		+ For further information about `virt-manager`, see https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/virtualization_deployment_and_administration_guide/sect-creating_guests_with_virt_manager[RedHat virt-manager guide].

		- Bugs in the `virt-manager` tool should be reported in http://bugzilla.redhat.com[Bugzilla] against the `virt-manager`
		+ Bugs in the `virt-manager` tool should be reported in https://bugzilla.redhat.com[Bugzilla] against the `virt-manager`
		`component.`


		`@@ -90,7 +90,7 @@`

		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.
		+ Bugs in the `virsh` tool should be reported in https://bugzilla.redhat.com[Bugzilla] against the libvirt component.


		`[[remote-management]]`
		`@@ -98,6 +98,6 @@`

		`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 non-root users via SSH, see the setup instructions in https://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.`
		`+ * 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 https://wiki.libvirt.org/page/TLSSetup.`

modules/ROOT/pages/_partials/ref_other-virtualization-options.adoc

file modified

+1 -1

		`@@ -9,7 +9,7 @@`
		`[[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.`
		`+ 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 https://myoung.fedorapeople.org/dom0). For a guide on how to install and setup a Fedora Xen host, see https://wiki.xen.org/wiki/Fedora_Host_Installation[Fedora Host Installation] page on the Xen Project wiki.`

		`[[openstack]]`
		`== OpenStack`

modules/ROOT/pages/getting-started-with-virtualization.adoc

file modified

-2

		`@@ -3,8 +3,6 @@`
		`[id='getting-started-with-virtualization']`
		`= Getting started with virtualization`

		`- include::{partialsdir}/unreviewed-message.adoc[]`
		`-`
		`Fedora uses the libvirt family of tools as its virtualization solution.`

		`include::{partialsdir}/proc_enabling-hardware-virtualization-support.adoc[leveloffset=+1]`

copperi commented 3 years ago

Completed technical review on getting started with virtualization.

Metadata Update from @ankursinha:
- Pull-request tagged with: needs committer review

3 years ago

rebased onto 84eee7931caa172e8b17037beceb769559e04c54

3 years ago

rebased onto 533b421

3 years ago

pbokoc commented 3 years ago

Looks good, thank you.

One note though - when you're fixing an open issue, please, mention its number in the PR (if it's in the same repo, then Pagure creates the link automatically if you type #<number>, in this case, #211 - #211), and ideally also mention the PR number in the issue's comments when you create it. It makes it easier for us to keep track of what's been fixed.

Pull-Request has been merged by pbokoc

3 years ago