mirror of
git://git.yoctoproject.org/meta-virtualization.git
synced 2025-07-05 13:25:22 +02:00
xen: add README for testing
Signed-off-by: Bruce Ashfield <bruce.ashfield@gmail.com>
This commit is contained in:
Bruce Ashfield
parent
d2238e7287
commit
249c79e20b
173
recipes-extended/images/README-xen.md
Normal file
173
recipes-extended/images/README-xen.md
Normal file
|
|
@ -0,0 +1,173 @@
|
|||
This README contains information on the xen reference images
|
||||
and testing / usability information
|
||||
|
||||
Images
|
||||
------
|
||||
|
||||
xen-image-minimal:
|
||||
|
||||
This is the reference xen host image. It currently requires systemd
|
||||
and xen as DISTRO_FEATURES.
|
||||
|
||||
All required dependencies are included for typical execution (and
|
||||
debug) of guests.
|
||||
|
||||
xen-guest-image-minimal:
|
||||
|
||||
This is the reference guest / domU image. Note that it boots the
|
||||
same kernel as the xen host image (unless multiconfig is used
|
||||
to differentiate).
|
||||
|
||||
It creates tarballs, ext4 and qcow images for testing purposes.
|
||||
|
||||
bundling
|
||||
--------
|
||||
|
||||
Guests can be bundled automatically through the following mechanisms:
|
||||
|
||||
- via the variable XEN_BUNDLED_GUESTS
|
||||
- via a xen configuration file in the deploy directory of the format
|
||||
xen-guest-bundle-*.cfg
|
||||
|
||||
The guests can be built via OE, or be 3rd party guests. They just
|
||||
must be in the deploy directory so they can be copied into the rootfs
|
||||
of the xen host image
|
||||
|
||||
Type 1) XEN_BUNDLED_GUESTS
|
||||
|
||||
If XEN_BUNDLED_GUESTS is used, it is simply a colon separated list of
|
||||
rootfs:kernels. Normal variable rules apply, so it can be set in a
|
||||
local.conf, or in a bbappend to the image recipe.
|
||||
|
||||
An example would be:
|
||||
|
||||
XEN_BUNDLED_GUESTS = "xen-guest-image-minimal-qemuarm64.rootfs.ext4:Image"
|
||||
|
||||
These point at symlinks created in the image deploy directory, or they
|
||||
can be specific images/kernels without the symlink.
|
||||
|
||||
Type 2) A Xen guest configuration file
|
||||
|
||||
If xen guest configuration files are found in the deploy directories
|
||||
the kernel and disk information contained within them will be processed
|
||||
and modified for the xen host. The kernel and guest image will be
|
||||
copied to the appropriate location, and the config made to match.
|
||||
|
||||
These files following the naming convention: xen-guest-bundle*.cfg
|
||||
|
||||
Guests of type #1 generate a configuration file that is picked up as
|
||||
type #2.
|
||||
|
||||
An example config file follows:
|
||||
|
||||
name = "xen-guest"
|
||||
memory = 512
|
||||
vcpus = 1
|
||||
disk = ['file:xen-guest-image-minimal-qemuarm64.rootfs.ext4,xvda,rw']
|
||||
vif = ['bridge=xenbr0']
|
||||
kernel = "Image"
|
||||
extra = "root=/dev/xvda ro console=hvc0 ip=dhcp"
|
||||
|
||||
It should also be noted that when a xen-guest-image-minimal is built
|
||||
with the XEN_GUEST_AUTO_BUNDLE varaible set to True, a configuration
|
||||
file for type #2 will be generated and the guest bundled automatically
|
||||
when the host image is built.
|
||||
|
||||
kernel and rootfs are copied to the target in /var/lib/xen/images/
|
||||
|
||||
configuration files are copied to: /etc/xen
|
||||
|
||||
Guests can be launched after boot with: xl create -c /etc/xen/<config file>
|
||||
|
||||
Build and boot
|
||||
--------------
|
||||
|
||||
Using a reference qmeuarm64 MACHINE, the following are the commands
|
||||
to build and boot a guest.
|
||||
|
||||
local.conf contains:
|
||||
|
||||
XEN_BUNDLED_GUESTS = "xen-guest-image-minimal-qemuarm64.rootfs.ext4:Image"
|
||||
|
||||
% bitbake xen-guest-image-minimal
|
||||
% bitbake xen-image-minimal
|
||||
|
||||
% runqemu qemuarm64 nographic slirp qemuparams="-m 4096" tmp/deploy/images/qemuarm64/xen-image-minimal-qemuarm64.rootfs.ext4
|
||||
|
||||
Poky (Yocto Project Reference Distro) 5.1 qemuarm64 hvc0
|
||||
|
||||
qemuarm64 login: root
|
||||
|
||||
WARNING: Poky is a reference Yocto Project distribution that should be used for
|
||||
testing and development purposes only. It is recommended that you create your
|
||||
own distribution for production use.
|
||||
|
||||
root@qemuarm64:~# uname -a
|
||||
Linux qemuarm64 6.10.11-yocto-standard #1 SMP PREEMPT Fri Sep 20 22:32:26 UTC 2024 aarch64 GNU/Linux
|
||||
root@qemuarm64:~# ls /etc/xen/
|
||||
auto
|
||||
cpupool
|
||||
scripts
|
||||
xen-guest-bundle-xen-guest-image-minimal-qemuarm64--20241112174803.cfg
|
||||
xl.conf
|
||||
root@qemuarm64:~# ls /var/lib/xen/images/
|
||||
Image--6.10.11+git0+4bf82718cf_6c956b2ea6-r0-qemuarm64-20241018190311.bin
|
||||
xen-guest-image-minimal-qemuarm64.rootfs-20241111222814.ext4
|
||||
|
||||
root@qemuarm64:~# ip a s
|
||||
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue qlen 1000
|
||||
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
|
||||
inet 127.0.0.1/8 scope host lo
|
||||
valid_lft forever preferred_lft forever
|
||||
inet6 ::1/128 scope host noprefixroute
|
||||
valid_lft forever preferred_lft forever
|
||||
2: enp0s1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel master xenbr0 qlen 1000
|
||||
link/ether 52:54:00:12:35:02 brd ff:ff:ff:ff:ff:ff
|
||||
3: sit0@NONE: <NOARP> mtu 1480 qdisc noop qlen 1000
|
||||
link/sit 0.0.0.0 brd 0.0.0.0
|
||||
4: xenbr0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue qlen 1000
|
||||
link/ether ee:e4:a8:24:24:e7 brd ff:ff:ff:ff:ff:ff
|
||||
inet 10.0.2.15/24 brd 10.0.2.255 scope global dynamic xenbr0
|
||||
valid_lft 86354sec preferred_lft 86354sec
|
||||
inet6 fec0::ece4:a8ff:fe24:24e7/64 scope site dynamic noprefixroute flags 100
|
||||
valid_lft 86356sec preferred_lft 14356sec
|
||||
inet6 fe80::ece4:a8ff:fe24:24e7/64 scope link
|
||||
valid_lft forever preferred_lft forever
|
||||
|
||||
root@qemuarm64:~# xl create -c /etc/xen/xen-guest-bundle-xen-guest-image-minimal-qemuarm64--20241112174803.cfg
|
||||
|
||||
qemuarm64 login: root
|
||||
|
||||
WARNING: Poky is a reference Yocto Project distribution that should be used for
|
||||
testing and development purposes only. It is recommended that you create your
|
||||
own distribution for production use.
|
||||
|
||||
root@qemuarm64:~# uname -a
|
||||
Linux qemuarm64 6.10.11-yocto-standard #1 SMP PREEMPT Fri Sep 20 22:32:26 UTC 2024 aarch64 GNU/Linux
|
||||
|
||||
root@qemuarm64:~# wget example.com
|
||||
Connecting to example.com (93.184.215.14:80)
|
||||
wget: can't open 'index.html': File exists
|
||||
root@qemuarm64:~# rm index.html
|
||||
root@qemuarm64:~# wget example.com
|
||||
Connecting to example.com (93.184.215.14:80)
|
||||
saving to 'index.html'
|
||||
index.html 100% |********************************| 1256 0:00:00 ETA
|
||||
'index.html' saved
|
||||
|
||||
From the host:
|
||||
|
||||
Connection to 127.0.0.1 closed.
|
||||
build4 [/home/bruc.../qemuarm64]> ssh -p 2222 root@127.0.0.1
|
||||
Last login: Tue Nov 12 20:42:57 2024 from 10.0.2.2
|
||||
|
||||
WARNING: Poky is a reference Yocto Project distribution that should be used for
|
||||
testing and development purposes only. It is recommended that you create your
|
||||
own distribution for production use.
|
||||
|
||||
root@qemuarm64:~# xl list
|
||||
Name ID Mem VCPUs State Time(s)
|
||||
Domain-0 0 192 4 r----- 696.2
|
||||
xen-guest 1 512 1 -b---- 153.0
|
||||
root@qemuarm64:~# xl destroy xen-guest
|
||||
|
||||
|
|
@ -1,84 +0,0 @@
|
|||
1 xl
|
||||
2 xl list
|
||||
3 xl console
|
||||
4 xl console -n 0
|
||||
5 xl -n0 console
|
||||
6 xl -n 0 console
|
||||
7 xl console -n 0
|
||||
8 xl console Domain-0
|
||||
9 xm
|
||||
10 wget
|
||||
11 wget https://www.alpinelinux.org/downloads/
|
||||
12 wget https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-standard-3.19.1-x86_64.iso
|
||||
13 rm alpine-standard-3.19.1-x86_64.iso
|
||||
14 wget https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-virt-3.19.1-x86_64.iso
|
||||
15 mount -t iso9660 -o loop /data/alpine-virt-3.19.1-x86_64.iso /media/cdrom
|
||||
16 ll
|
||||
17 ls
|
||||
18 mount -t iso9660 -o loop alpine-virt-3.19.1-x86_64.iso /media/cdrom^
|
||||
19 ls /media/
|
||||
20 mkdir /media/cdrom
|
||||
21 mount -t iso9660 -o loop alpine-virt-3.19.1-x86_64.iso /media/cdrom
|
||||
22 ls /media/cdrom/
|
||||
23 df -kh .
|
||||
24 dd if=/dev/zero of=/data/a1.img bs=1M count=300
|
||||
25 mkdir /data
|
||||
26 dd if=/dev/zero of=/data/a1.img bs=1M count=300
|
||||
|
||||
|
||||
-------------------
|
||||
|
||||
ssh from the host (if using slirp): https://docs.yoctoproject.org/dev-manual/qemu.html
|
||||
|
||||
ssh root@127.0.0.1 -p 2222
|
||||
|
||||
-------------------
|
||||
|
||||
Install a guest:
|
||||
|
||||
https://wiki.alpinelinux.org/wiki/Create_Alpine_Linux_PV_DomU
|
||||
|
||||
|
||||
----------------
|
||||
|
||||
Add this:
|
||||
autoballoon=0
|
||||
|
||||
to:
|
||||
|
||||
/etc/xen/xl.conf
|
||||
|
||||
----------------
|
||||
|
||||
# /etc/xen/a1.cfg
|
||||
|
||||
# Alpine Linux PV DomU
|
||||
|
||||
# Kernel paths for install
|
||||
kernel = "/media/cdrom/boot/vmlinuz-virt"
|
||||
ramdisk = "/media/cdrom/boot/initramfs-virt"
|
||||
extra="modules=loop,squashfs console=hvc0"
|
||||
|
||||
# Path to HDD and iso file
|
||||
disk = [
|
||||
'format=raw, vdev=xvda, access=w, target=/data/a1.img',
|
||||
'format=raw, vdev=xvdc, access=r, devtype=cdrom, target=/home/root/alpine-virt-3.19.1-x86_64.iso'
|
||||
]
|
||||
|
||||
# Network configuration
|
||||
vif = ['bridge=br0']
|
||||
|
||||
# DomU settings
|
||||
memory = 512
|
||||
name = "wqalpine-a1"
|
||||
vcpus = 1
|
||||
maxvcpus = 1
|
||||
|
||||
device_model_version="qemu-xen"
|
||||
device_model_override="/bin/true"
|
||||
|
||||
---------------------------
|
||||
|
||||
xl create -f /etc/xen/a1.cfg -c
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user