1.4. Configuring networking and storage to run MicroShift in a bootc container

Procedure

1. Check if the openvswitch module is available for the current host kernel version by running the following command:

   $ find /lib/modules/$(uname -r) -name "openvswitch*"

   Example output

   /lib/modules/5.14.0-427.28.1.el9_4.x86_64/kernel/net/openvswitch
   /lib/modules/5.14.0-427.28.1.el9_4.x86_64/kernel/net/openvswitch/openvswitch.ko.xz

2. Set the IMAGE_NAME environment variable by running the following command:

   $ IMAGE_NAME=microshift-4.17-bootc

3. Check the version of the kernel-core package used in the bootc image by running the following command:

   $ sudo podman inspect "${IMAGE_NAME}" | grep kernel-core

   Example output

   "created_by": "kernel-core-5.14.0-427.26.1.el9_4.x86_64" 

   1

   1

   The kernel version does not match the output of the /lib/modules directory.

4. Preinstall the openvswitch module on the host as a workaround by running the following command:

   $ sudo modprobe openvswitch

Procedure

1. Determine if the volume group exists and it has the necessary free space by running the following command:

   $ sudo vgs

   Example output for existing volume group

     VG   #PV #LV #SN Attr   VSize   VFree 

   1

   
     rhel   1   1   0 wz--n- <91.02g <2.02g

   1

   If no free volume group is present, the output is either empty or the VFree value is 0.

   注記

   If the host has a volume group with the available needed storage, you can run your container now. You do not need to configure the MicroShift CSI further.

   重要

   If you do not have a volume group, you must set one up for the LVM CSI to allocate storage in bootc MicroShift containers. See the additional resources for more information.

Procedure

1. Create a file to be used for LVM partitioning by running the following command:

   VGFILE=/var/lib/microshift-lvm-storage.img
   
   sudo losetup -f "${VGFILE}"

2. Resize the file to your specified size by running the following command:

   VGSIZE=1G 

   1

   
   
   $ sudo truncate --size="${VGSIZE}" "${VGFILE}"

   1

   Specify the size for the file.

3. Query the loop device name by running the following command:

   $ VGLOOP=$(losetup -j ${VGFILE} | cut -d: -f1)

4. Create a free volume group on the loop device by running the following command:

   $ sudo vgcreate -f -y <my-volume-group> "${VGLOOP}" 

   1

   1

   Replace <my-volume-group> with the name of the volume group you are creating.