openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-06 15:46:57 +01:00
Code Issues Releases Activity

1 new assembly to cover the one-off installation of qemu-guest-agent. The meat of the assembly is in 1 new module, but also points to the wizards(web console) and VirtIO drivers for Win VMs (separate PR). This assembly is then referenced in the 'additional networks' assembly to cover all bases.

Browse Source
This commit is contained in:
Andrew Burden
2019-06-06 21:06:11 +02:00
parent 1dc5c12839
commit fbe6f1459a
3 changed files with 57 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
cnv/cnv_users_guide/cnv-attaching-vm-multiple-networks.adoc
View File

@@ -27,4 +27,7 @@ in the previous section.
include::modules/cnv-vm-create-nic-web.adoc[leveloffset=+1]
include::modules/cnv-networking-wizard-fields-web.adoc[leveloffset=+1]
include::modules/cnv-networking-wizard-fields-web.adoc[leveloffset=+1]
Install the optional xref:../../cnv/cnv_users_guide/cnv-installing-qemu-guest-agent.adoc[QEMU guest agent] on the virtual machine so that the host can display relevant information about the additional networks.

21
cnv/cnv_users_guide/cnv-installing-qemu-guest-agent.adoc Normal file
View File

@@ -0,0 +1,21 @@
[id="cnv-installing-qemu-guest-agent"]
= Installing the QEMU guest agent on virtual machines
include::modules/cnv-document-attributes.adoc[]
:context: cnv-installing-qemu-guest-agent
toc::[]
The QEMU guest agent is a daemon that runs on the virtual machine. The agent
passes network information on the virtual machine, notably the IP address of
additional networks, to the host.
include::modules/cnv-installing-qemu-guest-agent-on-linux-vm.adoc[leveloffset=+1]
You can also install and start the QEMU guest agent using the
*cloud-init*:*Use custom script* field of the wizard when creating either
virtual machines or virtual machines templates in the web console.
For Windows virtual machines, the QEMU guest agent is included in the
VirtIO drivers, which can be installed on
xref:../../cnv/cnv_users_guide/cnv-installing-virtio-drivers-on-existing-windows-vm.adoc#cnv-installing-virtio-drivers-on-existing-windows-vm[an existing Windows virtual machine] or
xref:../../cnv/cnv_users_guide/cnv-installing-virtio-drivers-on-new-windows-vmi#cnv-installing-virtio-drivers-on-new-windows-vm.adoc[during the installation of Windows on the virtual machine].

32
modules/cnv-installing-qemu-guest-agent-on-linux-vm.adoc Normal file
View File

@@ -0,0 +1,32 @@
// Module included in the following assemblies:
//
// * cnv_users_guide/cnv-installing-qemu-guest-agent.adoc
[id="cnv-installing-qemu-guest-agent-on-linux-vm_{context}"]
= Installing QEMU guest agent on a Linux virtual machine
The `qemu-guest-agent` is widely available and available by default in Red Hat
virtual machines. Install the agent and start the service
.Procedure
. Access the virtual machine command line through one of the consoles or by SSH.
. Install the QEMU guest agent on the virtual machine:
+
----
$ yum install -y qemu-guest-agent
----
. Start the QEMU guest agent service:
+
----
$ systemctl start qemu-guest-agent
----
. Ensure the service is persistent:
+
----
$ systemctl enable qemu-guest-agent
----