Create Alpine Linux PV DomU: Difference between revisions

From Alpine Linux
(replace virtgrsec with just virt. we no longer support grsec)
m (→‎Install the guest: used pkg and path templates.)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Obtain a copy of Alpine Linux ==
== Obtain a copy of Alpine Linux ==


To create an Alpine Linux paravirtualized (PV) DomU you will need an Alpine Linux iso.
To create an Alpine Linux paravirtualized (PV) DomU you'll need an Alpine Linux iso.


Download the latest alpine-virt iso from https://alpinelinux.org/downloads/
Download the latest alpine-virt iso from https://alpinelinux.org/downloads/


In this example we will use {{path|/data/}} for our download and for our disk images.
In this example we'll use {{path|/data/}} for the download and disk images.


==Mount the ISO image ==
==Mount the ISO image ==


Next, mount the iso so we can read the kernel and initramfs:
Next, mount the iso so you can read the kernel and initramfs:


{{cmd | mount -t iso9660 -o loop /data/alpine-virt-{{AlpineLatest}}-x86_64.iso  /media/cdrom }}
{{cmd | mount -t iso9660 -o loop /data/alpine-virt-{{AlpineLatest}}-x86_64.iso  /media/cdrom }}


Now we have the kernel in {{path|/media/cdrom/boot/vmlinuz-virt}} and initramfs in {{path|/media/cdrom/boot/initramfs-virt}}.
Now you have the kernel in {{path|/media/cdrom/boot/vmlinuz-virt}} and initramfs in {{path|/media/cdrom/boot/initramfs-virt}}.


Alternatively you can use {{path|uniso}} or {{path|p7zip}} to extract the content to a temp area.
Alternatively you can use {{path|uniso}} or {{path|7z}} to extract the content to a temporary area.


== Create the disk image ==
== Create the disk image ==
Now we should create an empty file, that will be the hard drive of the DomU (in this example we are using a 3GB disk):
Now you need to create an empty file to be used as the hard drive of the DomU (in this example we are using a 3GB disk):


{{cmd | <nowiki>dd if=/dev/zero of=/data/a1.img bs=1M count=3000</nowiki>}}
{{cmd | <nowiki>dd if=/dev/zero of=/data/a1.img bs=1M count=3000</nowiki>}}


Alternatively, if an LVM volume group (e.g. vg1) with free space is available on dom0, create a logical volume for Alpine:
{{cmd | <nowiki>sudo lvcreate -n alpine -L 10g vg1</nowiki>}}


== Create a DomU config file that boots the ISO image ==
== Create a DomU config file that boots the ISO image ==
The next step is to create a basic DomU configuration file, so we can launch the pv guest iso (save it where you like, although the most common place is {{path|/etc/xen/}}).
Next, create a basic DomU configuration file, so you can launch the pv guest iso (save it where you like, although the most common place is {{path|/etc/xen/}}).


{{cat | /etc/xen/a1.cfg | <nowiki># Alpine Linux PV DomU
{{cat | /etc/xen/a1.cfg | <nowiki># Alpine Linux PV DomU
Line 48: Line 51:
maxvcpus = 1
maxvcpus = 1
</nowiki>}}
</nowiki>}}
If using LVM, replace {{path|/data/a1.img}} with {{path|/dev/vg1/alpine}} in the disk specification.


== Install the guest ==
== Install the guest ==
Now that we have all the necessary files, we can start the DomU to proceed with the install:
Now that you have the necessary files, you can start the DomU to proceed with the install:


{{cmd|xl create -f /etc/xen/a1.cfg  -c}}
{{cmd|xl create -f /etc/xen/a1.cfg  -c}}


Login into the system with user "root" and no password.
Log into the system with user "root" and no password.


We need disable the ext4 64bit feature since pv-grub does not support ext4. Then we proceed with the normal install:
After configuring the basic system, you will be asked where would you like to install Alpine. Choose xvda and sys.


{{cmd |<nowiki>export MKFS_OPTS_BOOT="-O ^64bit"; setup-alpine</nowiki>}}
That will create three partitions on your disk. xvda1 for {{path|/boot}}, xvda2 for swap and xvda3 for {{path|/}}
 
After configuring the basic system, you will be asked where would you like to install Alpine, choose xvda and sys.
 
This will create three partitions on your disk, xvda1 for /boot, xvda2 for swap and xvda3 for /


<pre>
<pre>
Line 84: Line 85:
</pre>
</pre>


Before you reboot, mount the boot partition and create a {{path|grub/menu.lst}} file for pv-grub.
When you reboot, the pv bootloader pvgrub, will look to {{path|/boot/grub/grub.cfg}} for its menu, so create that file first.
 
Mount the boot partition and create a {{path|grub/grub.cfg}} file for pvgrub. (Note that grub.cfg is for pvgrub2 which replaced pvgrub1 and its menu.lst beginning in 2013.)


{{cmd |<nowiki>mount /dev/xvda1 /mnt
{{cmd |<nowiki>mount /dev/xvda1 /mnt
mkdir /mnt/grub</nowiki>}}
mkdir /mnt/grub</nowiki>}}


{{cat | /mnt/grub/menu.lst |<nowiki>default 0
Install a basic text editor like {{pkg|nano}} or {{pkg|vim}}:<br/>
timeout 5
{{cmd | apk add nano}}
 
title alpine-xen-pv
If using nano, enter:<br/>
root (hd0,0)
{{cmd | nano /mnt/grub/grub.cfg}}
kernel /boot/vmlinuz-virt modules=ext4 console=hvc0 root=/dev/xvda3
 
initrd /boot/initramfs-virt</nowiki>}}
Then add the following to create a basic grub2 configuration file:
{{cat | /mnt/grub/grub.cfg |<nowiki>menuentry 'alpine-xen' {
    set root=(xen/xvda,msdos1)
    linux /boot/vmlinuz-virt root=/dev/xvda3 modules=ext4 console=hvc0
    initrd /boot/initramfs  
}</nowiki>}}
 
Finally, Ctrl-S to save, Ctrl-X to exit nano.


Unmount and power off.
Unmount and power off.
Line 103: Line 113:
== Adjust the domU config file to boot from fresh install ==
== Adjust the domU config file to boot from fresh install ==


In your Dom0, edit your DomU config file to boot with pv-grub.
In your Dom0, edit your DomU config file to boot with pvgrub.


{{cat | /etc/xen/a1.cfg |<nowiki># Alpine Linux PV DomU
{{cat | /etc/xen/a1.cfg |<nowiki># Alpine Linux PV DomU


kernel = "/usr/lib/xen/boot/pv-grub-x86_64.gz"
kernel = "/usr/lib/grub-xen/grub-x86_64-xen.bin"


# Path to HDD and iso file
# Path to HDD and iso file
Line 123: Line 133:
maxvcpus = 1
maxvcpus = 1
</nowiki>}}
</nowiki>}}
Make sure that grub-xenhost is installed.
{{cmd | apk add grub-xenhost}}


Remember to unmount the loopback iso image.
Remember to unmount the loopback iso image.
{{cmd | umount /media/cdrom}}
{{cmd | umount /media/cdrom}}


When you next boot, you will be presented with the grub boot menu, and your VM will boot.
The next time you boot, you'll be presented with the grub boot menu, and your VM will boot.
 
== Using Legacy pvgrub ==
 
To use Legacy pvgrub you need to use a {{path|/boot/grub/menu.lst}} instead of {{path|/boot/grub/grub.cfg}}.
 
{{cat | /etc/xen/a1.cfg |<nowiki>default 0
timeout 2
title alpine-xen-pv
root (hd0,0)
kernel /boot/vmlinuz-virt root=/dev/xvda3 modules=ext4 console=hvc0
initrd /boot/initramfs-virt
</nowiki>}}
 
And in {{path|/etc/xen/a1.cfg}} you need to change the 'kernel' loader to
{{cat | /etc/xen/a1.cfg |<nowiki>...
kernel = "/usr/lib/xen/boot/pv-grub-x86_64.gz"
...
</nowiki>}}


== See also ==
== See also ==

Latest revision as of 20:02, 18 August 2023

Obtain a copy of Alpine Linux

To create an Alpine Linux paravirtualized (PV) DomU you'll need an Alpine Linux iso.

Download the latest alpine-virt iso from https://alpinelinux.org/downloads/

In this example we'll use /data/ for the download and disk images.

Mount the ISO image

Next, mount the iso so you can read the kernel and initramfs:

mount -t iso9660 -o loop /data/alpine-virt-3.20.3-x86_64.iso /media/cdrom

Now you have the kernel in /media/cdrom/boot/vmlinuz-virt and initramfs in /media/cdrom/boot/initramfs-virt.

Alternatively you can use uniso or 7z to extract the content to a temporary area.

Create the disk image

Now you need to create an empty file to be used as the hard drive of the DomU (in this example we are using a 3GB disk):

dd if=/dev/zero of=/data/a1.img bs=1M count=3000

Alternatively, if an LVM volume group (e.g. vg1) with free space is available on dom0, create a logical volume for Alpine:

sudo lvcreate -n alpine -L 10g vg1

Create a DomU config file that boots the ISO image

Next, create a basic DomU configuration file, so you can launch the pv guest iso (save it where you like, although the most common place is /etc/xen/).

Contents of /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=/data/alpine-virt-3.20.3-x86_64.iso' ] # Network configuration vif = ['bridge=br0'] # DomU settings memory = 512 name = "alpine-a1" vcpus = 1 maxvcpus = 1

If using LVM, replace /data/a1.img with /dev/vg1/alpine in the disk specification.

Install the guest

Now that you have the necessary files, you can start the DomU to proceed with the install:

xl create -f /etc/xen/a1.cfg -c

Log into the system with user "root" and no password.

After configuring the basic system, you will be asked where would you like to install Alpine. Choose xvda and sys.

That will create three partitions on your disk. xvda1 for /boot, xvda2 for swap and xvda3 for / 

Available disks are:
  xvda	(3.1 GB  )
Which disk(s) would you like to use? (or '?' for help or 'none') [none] xvda
The following disk is selected:
  xvda	(3.1 GB  )
How would you like to use it? ('sys', 'data' or '?' for help) [?] sys
WARNING: The following disk(s) will be erased:
  xvda	(3.1 GB  )
WARNING: Erase the above disk(s) and continue? [y/N]: y
Initializing partitions on /dev/xvda...
Creating file systems...
Installing system on /dev/xvda3:


Installation is complete. Please reboot.

#

When you reboot, the pv bootloader pvgrub, will look to /boot/grub/grub.cfg for its menu, so create that file first.

Mount the boot partition and create a grub/grub.cfg file for pvgrub. (Note that grub.cfg is for pvgrub2 which replaced pvgrub1 and its menu.lst beginning in 2013.)

mount /dev/xvda1 /mnt mkdir /mnt/grub

Install a basic text editor like nano or vim:

apk add nano

If using nano, enter:

nano /mnt/grub/grub.cfg

Then add the following to create a basic grub2 configuration file:

Contents of /mnt/grub/grub.cfg

menuentry 'alpine-xen' { set root=(xen/xvda,msdos1) linux /boot/vmlinuz-virt root=/dev/xvda3 modules=ext4 console=hvc0 initrd /boot/initramfs }

Finally, Ctrl-S to save, Ctrl-X to exit nano.

Unmount and power off.

umount /mnt poweroff

Adjust the domU config file to boot from fresh install

In your Dom0, edit your DomU config file to boot with pvgrub.

Contents of /etc/xen/a1.cfg

# Alpine Linux PV DomU kernel = "/usr/lib/grub-xen/grub-x86_64-xen.bin" # Path to HDD and iso file disk = [ 'format=raw, vdev=xvda, access=w, target=/data/a1.img' ] # Network configuration vif = ['bridge=br0'] # DomU settings memory = 512 name = "alpine-a1" vcpus = 1 maxvcpus = 1

Make sure that grub-xenhost is installed.

apk add grub-xenhost

Remember to unmount the loopback iso image.

umount /media/cdrom

The next time you boot, you'll be presented with the grub boot menu, and your VM will boot.

Using Legacy pvgrub

To use Legacy pvgrub you need to use a /boot/grub/menu.lst instead of /boot/grub/grub.cfg.

Contents of /etc/xen/a1.cfg

default 0 timeout 2 title alpine-xen-pv root (hd0,0) kernel /boot/vmlinuz-virt root=/dev/xvda3 modules=ext4 console=hvc0 initrd /boot/initramfs-virt

And in /etc/xen/a1.cfg you need to change the 'kernel' loader to

Contents of /etc/xen/a1.cfg

... kernel = "/usr/lib/xen/boot/pv-grub-x86_64.gz" ...

See also

Retrieved from "https://wiki.alpinelinux.org/w/index.php?title=Create_Alpine_Linux_PV_DomU&oldid=24370"