- 1 The installer
- 2 Pre-installation
- 3 Installation
- 4 Notes
- 5 Known Issues
The Alpine s390x installer includes a kernel, an initramfs (initrd image), and a parameter file.
Installation on KVM and z/VM are supported.
Installation on LPAR is not supported at the moment.
Kernel parameters (and parmfile)
The Alpine s390x installer requires following kernel parameters to work:
ip= : the networking information, each field is separated by a colon
- 1st field: ip address of the guest VM where we are going to run the installer
- 2nd field: not used, leave blank or fill with
- 3rd field: the gateway ip address
- 4th field: the netmask
- 5th field: not used, leave blank or fill with
- 6th field: the network interface of the guest VM, default is
eth0if left blank.
- 7th field: fill with
noneto use static IP configuration. Fill with
dhcpif DHCP is used.
- 8th field: address of the DNS server
- 9th field: address of the 2nd DNS server
alpine_repo= : the location of the Alpine repository from which packages are downloaded.
- For stable release, use
- For rolling release, use
modloop= : the remote location of the image containing kernel's modules, required for LVM and raid setup.
ssh_key= : the remote location of your SSH public key which is used to allow SSH connection into the installer. HTTPS, FTPS, HTTP, FTP are supported.
ssh_pass= : the password to login the installer via SSH.
- You can use either
ssh_key=is recommended method.
- If neither of these fields are specified, the default password of blank is used (see below).
dasd= : the addresses of the DASD devices, either ECKD or FBA DASDs. Each device is separated with a comma.
s390x_net= : the network interface type and its subchannels. At the moment, only QETH layer 2 is supported, thus the name
qeth_l2 is used (see below).
Create a virtual disk:
$ qemu-img create alpine_disk.qcow2 5G
Start qemu: (modify
ssh_pass= for your needs)
$ qemu-system-s390x -M s390-ccw-virtio \ -m 2048 -smp 2 -nographic -enable-kvm \ -hda alpine_disk.qcow2 \ -net nic -net tap,ifname=tap0,script=no' -kernel vmlinuz-vanilla \ -initrd initramfs-vanilla \ -append "ip=192.168.1.2::192.168.1.1:255.255.255.0:none:eth0:none:126.96.36.199 alpine_repo=http://dl-cdn.alpinelinux.org/alpine/edge/main modloop=http://dl-cdn.alpinelinux.org/alpine/latest-stable/releases/s390x/modloop-vanilla ssh_key=https://your-website.com/your-ssh-key.pub"
To ease out the process of downloading the images, punch the readers, ipl, etc., ZNETBOOT  is used.
Create the parm file
On your workstation/laptop, create a file named
alpine.znetboot in your home directory with contents below (modify
ssh_pass= for your needs)
(The first line is the line holder for a wide file since z/VM's default file width is 80 chars.)
# ############################################################################ HOLDER FOR WIDE FILE # ZNETBOOT_KERNEL=http://dl-cdn.alpinelinux.org/alpine/latest-stable/releases/s390x/vmlinuz-vanilla ZNETBOOT_INITRD=http://dl-cdn.alpinelinux.org/alpine/latest-stable/releases/s390x/initramfs-vanilla ZNETBOOT_PROGRESS=1M dasd=0.0.04c0,0.0.05d1 s390x_net=qeth_l2,0.0.0560,0.0.0561,0.0.0562 ip=192.168.1.2::192.168.1.1:255.255.255.0:none:eth0:none:188.8.131.52 alpine_repo=http://dl-cdn.alpinelinux.org/alpine/edge/main modloop=http://dl-cdn.alpinelinux.org/alpine/latest-stable/releases/s390x/modloop-vanilla ssh_key=https://your-website.com/your-ssh-key.pub
Upload to z/VM system via 3270 client
Open 3270 client and log in the z/VM system with your z/VM username and password.
Upload 3 files
curl.rexx to the z/VM environment using the 3270 client (this tutorial uses x3270). On the top left corner, click "File", then "File Transfer". (Figure 1.)
Do following steps : (Figure 2.)
- On "Local File Name" box, enter alpine.znetboot
- On "Host File Name" box, enter alpine znetboot
- Choose Send to host
- Choose Host is VM/CMS
- Click Transfer File box
Repeat the same steps with
Beware the difference between the dot
. and the space
Check the configuration files
On 3270 client, enter following commands to check if the configuration files are correctly transferred:
xedit alpine znetboot
xedit znetboot exec
xedit curl rex
On 3270 client, type below command and wait till Figure 3.:
Steps in this part does not involve the interaction with the 3270 client anymore. Everything is done in your terminal with SSH client.
Either installing in KVM or z/VM environments, from your workstation/laptop, you will be able to run:
$ ssh email@example.com (change ip address to what you specified earlier)
Remaining steps are similar to installing Alpine on other architectures (x86, arm, ppc, etc.), either on KVM (using virtio/SCSI disks) or on z/VM with FBA DASDs. Installing on ECKD DASDs requires an additional step, as described below.
Below is the detailed walkthrough of installing Alpine on a single ECKD DASD using LVM and extend that LVM to the second ECKD DASD.
On SSH client/console, run:
Select keyboard layout [none]:
- press Enter for none
Enter system hostname (short form, e.g. 'foo') [localhost]:
- enter your hostname
Available interfaces are: eth0. Enter '?' for help on bridges, bonding and vlans. Which one do you want to initialize? (or '?' or 'done') [eth0]:
- type 'eth0' or press Enter
Ip address for eth0? (or 'dhcp', 'none', '?') [192.168.1.2]
- enter ip address or 'dhcp'
- enter netmask
Gateway? (or 'none') [192.168.1.1]
- enter gateway's ip address
Do you want to do any manual network configuration? [no]
- enter 'no' or press Enter
DNS domain name? (e.g 'bar.com') 
- enter domain name or press Enter for none
DNS nameserver(s)? [184.108.40.206 ]
- enter DNS nameserver
Changing password for root
- enter root password
Which timezone are you in? ('?' for list) [UTC]
- enter timezone or '?' for list of timezones
HTTP/FTP proxy URL? (e.g. 'http://proxy:8080', or 'none') [none]
- enter proxy or press Enter for none
Enter mirror number (1-27) or URL to add (or r/f/e/done) [f]:
- enter a number or 'r' or 'f' or 'e' or 'done' as described
Which SSH server? ('openssh', 'dropbear' or 'none') [openssh]
- enter SSH server or press Enter for openssh
Which NTP client to run? ('busybox', 'openntpd', 'chrony' or 'none') [chrony]
- enter 'busybox' or press Enter for chrony
(next step is the additional step for ECKD DASDs on z/VM)
Available ECKD DASD(s) are: 0.0.04c0 (3390/0c 3990/e9 IBM) 0.0.05d1 (3390/0c 3990/e9 IBM) Which ECKD DASD(s) would you like to be formatted using dasdfmt? (enter '?' for help) [all]
- enter 'all' or '0.0.04c0 0.0.05d1' (separated by a space) to format all/both DASDs
- enter '0.0.04c0' or '0.0.05d1' to format respective DASD
- enter '?' for help
WARNING: Erase ECKD DASD 0.0.04c0? [y/N]:
- enter 'y' to format
Available disks are: dasda (2.5 GB IBM 0.0.04c0) Which disk(s) would you like to use? (or '?' for help or 'none') [dasda]
- enter 'dasda' or press Enter
The following disk is selected: dasda (2.5 GB IBM 0.0.04c0) How would you like to use it? ('sys', 'data', 'lvm' or '?' for help) [?]
- enter 'lvm'
The following disk is selected (with LVM): dasda (2.5 GB IBM 0.0.04c0) How would you like to use it? ('sys', 'data' or '?' for help) [?]
- enter 'sys' to install Alpine on disk
WARNING: The following disk(s) will be erased: dasda (2.5 GB IBM 0.0.04c0) WARNING: Erase the above disk(s) and continue? [y/N]:
- enter 'y'
Installation is complete. Please reboot.
- the installation is finished
At this point, don't poweroff the installer right away. Follow below part for directions to have access to your new Alpine system.
Copying SSH keys into new Alpine system
After the installer's done running, there are 2 ways to copy your SSH key into the new Alpine system:
- Option 1: mount the installed disk and copy the SSH keys
- Option 2: poweroff the installer, use the 3270 client to ipl the new Alpine system and copy the SSH keys
If you use 'lvm' + 'sys' installation scheme above, do:
# mount /dev/vg0/lv_root /mnt/
- If you use
- If you use
# cp -ar /root/.ssh/ /mnt/root/
- If you use
# mkdir /mnt/root/.ssh
# wget https://your-website.com/your-ssh-key.pub -O /mnt/root/.ssh/authorized_keys
# chmod 700 /mnt/root/.ssh
# chmod 600 /mnt/root/.ssh/authorized_keys
- If you use
If you use 'sys' (without LVM) installation scheme above, do
# mount /dev/dasda3 /mnt/ (change dasda to dasdb or dasdc , etc. for which DASD you chose but 3rd partition should be the same)
- Then do accordingly for
ssh_passas described above block.
- Then do accordingly for
Login to new Alpine system
Open the 3270 client, login with your z/VM username and password.
You may need to run
ipl 04c0 (or whichever device you chose as root disk in earlier steps).
If you chose Option 2 above, wait for new Alpine system to ipl/boot, then login as root user while in 3270 client. Then run:
# mkdir /root/.ssh
# wget https://your-website.com/your-ssh-key.pub -O /root/.ssh/authorized_keys
# chmod 700 /root/.ssh
# chmod 600 /root/.ssh/authorized_keys
Then either Option 1 or Option 2, on your workstation/laptop, use SSH client to login new Alpine system:
# ssh firstname.lastname@example.org(or whichever ip address you used)