From: "Juraj Linkeš" <juraj.linkes@pantheon.tech>
To: thomas@monjalon.net, david.marchand@redhat.com,
Honnappa.Nagarahalli@arm.com, ohilyard@iol.unh.edu,
lijuan.tu@intel.com
Cc: dev@dpdk.org, "Juraj Linkeš" <juraj.linkes@pantheon.tech>
Subject: [RFC PATCH v1 5/8] dts: merge DTS vm_images/README.md to DPDK
Date: Wed, 6 Apr 2022 15:31:48 +0000 [thread overview]
Message-ID: <20220406153151.2917346-6-juraj.linkes@pantheon.tech> (raw)
In-Reply-To: <20220406153151.2917346-1-juraj.linkes@pantheon.tech>
---
dts/vm_images/README.md | 64 +++++++++++++++++++++++++++++++++++++++++
1 file changed, 64 insertions(+)
create mode 100644 dts/vm_images/README.md
diff --git a/dts/vm_images/README.md b/dts/vm_images/README.md
new file mode 100644
index 0000000000..1a59810d43
--- /dev/null
+++ b/dts/vm_images/README.md
@@ -0,0 +1,64 @@
+# DTS VM Images
+
+This folder contains utilities to create VM
+images for use in virtio testing.
+
+## Host Requirements
+
+The host MUST have qemu/kvm with libvirtd installed
+and set up.
+
+The host MUST be the same architecture as the VM
+you are building.
+
+The host MUST have podman and either docker or have podman
+aliased as docker (running "docker" calls podman).
+
+## Creating a VM
+
+Use the "create_vm_image.py" script to create the vm image.
+If you do not have the required containers on your system,
+it will build them.
+
+The root password it asks for is what to set the VM's
+root password to, not the root password of the system
+you run the script on.
+
+``` --debug ``` will enable debug output from guestfs
+tools. This produces a lot of output and you shouldn't
+use it unless something is going wrong.
+
+The base image MUST be a "cloud ready" or "prebuilt"
+image, meaning you cannot use an installer ISO. It also
+must be in the qcow2 format, (use qemu-img to convert it).
+Most distros will have a "cloud image" which is in the
+correct format. This base image will not be modified
+by the build script.
+
+The output image is where all of the modifications go and
+it is the image that you should use with DTS.
+
+## Supported Distros
+
+Currently, only RHEL 8 family distros and Ubuntu 20.04 are
+supported. Debian might work, but it is untested. Most
+testing has gone to Ubuntu 20.04.
+
+## Architectures
+
+Due to the way that guestfs tools work, they must run
+under kvm, but the host needs to have a kernel image
+that can be used to boot the VM. It may be possible
+to work around this issue using containers, but
+several days of experimentation kept running into
+more and more complex issues with the interactions
+between libguestfs and docker/podman. As such,
+your best bet is to build your VMs on either a
+bare-metal system of your desired architecture
+or inside a VM already being emulated as your desired
+architecture. This second approach may run into
+issues with the hypervisor, since not all hypervisors
+support nested virtualization by default. Since you need
+an appropriate kernel image installed as well, it may
+be easiest to build VMs using whatever distro you already
+use for most of your servers.
--
2.20.1
next prev parent reply other threads:[~2022-04-06 15:32 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-04-06 15:31 [RFC PATCH v1 0/8] merge DTS repo config and tools " Juraj Linkeš
2022-04-06 15:31 ` [RFC PATCH v1 1/8] dts: merge DTS format.sh " Juraj Linkeš
2022-04-06 15:31 ` [RFC PATCH v1 2/8] dts: merge DTS pyproject.toml " Juraj Linkeš
2022-04-06 15:31 ` [RFC PATCH v1 3/8] dts: merge DTS requirements.txt " Juraj Linkeš
2022-04-06 15:31 ` [RFC PATCH v1 4/8] dts: merge DTS vm_images/Dockerfile " Juraj Linkeš
2022-04-06 15:31 ` Juraj Linkeš [this message]
2022-04-06 15:31 ` [RFC PATCH v1 6/8] dts: merge DTS vm_images/create_vm_image.py " Juraj Linkeš
2022-04-06 15:31 ` [RFC PATCH v1 7/8] dts: merge DTS vm_images/make_build_container.sh " Juraj Linkeš
2022-04-06 15:31 ` [RFC PATCH v1 8/8] dts: merge DTS vm_images/network-init.sh " Juraj Linkeš
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220406153151.2917346-6-juraj.linkes@pantheon.tech \
--to=juraj.linkes@pantheon.tech \
--cc=Honnappa.Nagarahalli@arm.com \
--cc=david.marchand@redhat.com \
--cc=dev@dpdk.org \
--cc=lijuan.tu@intel.com \
--cc=ohilyard@iol.unh.edu \
--cc=thomas@monjalon.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).