2023-10-27 17:31:01 +00:00
.. _autoinstall_quick_start_s390x:
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
Autoinstall quick start for s390x
=================================
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
This guide provides instructions on how to use autoinstall with a current version of Ubuntu for the s390x architecture in a virtual machine (VM) on your computer.
2023-08-14 10:36:26 +00:00
2023-10-27 17:31:01 +00:00
For older Ubuntu releases, substitute the version in the name of the ISO image. The instructions should otherwise be the same. See :ref: `Autoinstall quick start<autoinstall_quick_start>` for instructions on installing on the amd64 architecture.
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
Download the ISO
----------------
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
Download the latest release of the Ubuntu Server image (ISO) from the `Ubuntu ISO download page`_ (currently |ubuntu-latest-version| (|ubuntu-latest-codename|)).
2023-08-14 10:36:26 +00:00
Mount the ISO
2023-10-27 14:11:56 +00:00
-------------
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
Make the content of the ISO image accessible from a local directory:
.. code :: none
2023-08-14 10:36:26 +00:00
mkdir -p ~/iso
2023-10-27 14:11:56 +00:00
sudo mount -r ~/Downloads/ubuntu-<version-number>-live-server-s390x.iso ~/iso
Change `` <version-number> `` to match the number of the release you have downloaded.
2023-08-14 10:36:26 +00:00
2023-10-22 15:50:03 +00:00
Write your autoinstall configuration
2023-10-27 14:11:56 +00:00
------------------------------------
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
Create a cloud-init configuration:
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
.. code-block :: none
2023-08-14 10:36:26 +00:00
mkdir -p ~/www
cd ~/www
cat > user-data << 'EOF'
#cloud-config
autoinstall:
version: 1
identity:
hostname: ubuntu-server
password: "$6$exDY1mhS4KUYCE/2$zmn9ToZwTKLhCw.b4/b.ZRTIZM30JZ4QrOQ2aOXJ8yk96xpcCof0kxKwuX1kqLG/ygbJ1f8wxED22bTL4F46P0"
username: ubuntu
EOF
touch meta-data
2023-10-22 15:50:03 +00:00
The encrypted password is `` ubuntu `` .
2023-08-14 10:36:26 +00:00
2023-10-22 15:50:03 +00:00
Serve the cloud-init configuration over HTTP
2023-10-27 14:11:56 +00:00
--------------------------------------------
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
Leave the HTTP server running in a terminal:
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
.. code-block :: none
2023-08-14 10:36:26 +00:00
cd ~/www
python3 -m http.server 3003
Create a target disk
2023-10-27 14:11:56 +00:00
--------------------
2023-08-14 10:36:26 +00:00
2023-10-27 14:11:56 +00:00
In a new terminal, install the `` qemu-img `` utility:
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
.. code-block :: none
2023-08-14 10:36:26 +00:00
sudo apt install qemu-utils
...
2023-10-27 14:11:56 +00:00
Create the target VM disk for the installation:
.. code-block :: none
2023-08-14 10:36:26 +00:00
qemu-img create -f qcow2 disk-image.qcow2 10G
Formatting 'disk-image.qcow2', fmt=qcow2 size=10737418240 cluster_size=65536 lazy_refcounts=off refcount_bits=16
qemu-img info disk-image.qcow2
image: disk-image.qcow2
file format: qcow2
virtual size: 10 GiB (10737418240 bytes)
disk size: 196 KiB
cluster_size: 65536
Format specific information:
compat: 1.1
lazy refcounts: false
refcount bits: 16
corrupt: false
2023-10-06 12:18:09 +00:00
Run the installation
2023-10-27 14:11:56 +00:00
--------------------
Install the `` kvm `` command:
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
.. code-block :: none
2023-08-14 10:36:26 +00:00
sudo apt install qemu-kvm
...
2023-10-06 12:18:09 +00:00
Add the default user to the `` kvm `` group:
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
.. code-block :: none
2023-08-14 10:36:26 +00:00
sudo usermod -a -G kvm ubuntu # re-login to make the changes take effect
2023-10-27 14:11:56 +00:00
Run the installation in a VM. Change `` <version-number> `` in the following command to match the release ISO you downloaded:
.. code-block :: none
2023-08-14 10:36:26 +00:00
kvm -no-reboot -name auto-inst-test -nographic -m 2048 \
-drive file=disk-image.qcow2,format=qcow2,cache=none,if=virtio \
2023-10-27 14:11:56 +00:00
-cdrom ~/Downloads/ubuntu-<version-number>-live-server-s390x.iso \
2023-08-14 10:36:26 +00:00
-kernel ~/iso/boot/kernel.ubuntu \
-initrd ~/iso/boot/initrd.ubuntu \
-append 'autoinstall ds=nocloud-net;s=http://_gateway:3003/ console=ttysclp0'
2023-10-27 14:11:56 +00:00
This command boots the VM, downloads the configuration from the server (prepared in the previous step) and runs the installation. The installer reboots at the end. The `` -no-reboot `` option to the `` kvm `` command instructs `` kvm `` to exit on reboot.
2023-08-14 10:36:26 +00:00
Boot the installed system
2023-10-27 14:11:56 +00:00
-------------------------
2023-08-14 10:36:26 +00:00
2023-10-06 12:18:09 +00:00
.. code-block :: none
2023-08-14 10:36:26 +00:00
kvm -no-reboot -name auto-inst-test -nographic -m 2048 \
-drive file=disk-image.qcow2,format=qcow2,cache=none,if=virtio
2023-10-27 14:11:56 +00:00
This command boots the installed system in the VM. Log in using `` ubuntu `` for both the user name and password.
.. LINKS
.. _Ubuntu ISO download page: https://releases.ubuntu.com/