kobol-wiki/docs/archlinuxarm.md
2019-03-04 21:36:45 +01:00

4.7 KiB

This document is a guide for installing Arch Linux ARM on the Helios4.

What you need before you start

Look at the "What you need before you start" section of the Helios4 install guide.

Using an Arch Linux ARM image file for Helios4

Arch Linux ARM can be installed on Helios4 using an image file containing both the Arch Linux ARM system and the U-Boot boot loader.

This image can be created using the build-archlinux-img-for-helios4.sh script provided by the alarm-helios4-image-builder project, or you can use a pre-built image from the same project. Each method is described below.

Once you get an image file, follow the instructions from the Installing Arch Linux ARM on Helios4 section below.

The Arch Linux ARM image builder for Helios4

The build-archlinux-img-for-helios4.sh script provided by the alarm-helios4-image-builder project allows to create a bootable Arch Linux ARM image file for Helios4 automatically.

Requirements

The build-archlinux-img-for-helios4.sh script expects to be used on a x86 system running Arch Linux. It needs qemu-arm-static to work. You can install it using the qemu-user-static or qemu-user-static-bin packages from the AUR.

Usage

!!! note This script needs to execute commands as the superuser. If not run as root, it will re-run itself using sudo.

$ git clone https://github.com/gbcreation/alarm-helios4-image-builder.git
$ cd alarm-helios4-image-builder
$ sh ./build-archlinux-img-for-helios4.sh

Once the Arch Linux ARM image created, follow the instructions from the Installing Arch Linux ARM on Helios4 section below.

Pre-built images

You can download a pre-built Arch Linux ARM image for Helios4 from the alarm-helios4-img-builder project.

$ wget https://github.com/gbcreation/alarm-helios4-image-builder/releases/download/2019-02-27/ArchLinuxARM-helios4-2019-02-27.img.gz{,.md5}
$ md5sum -c ArchLinuxARM-helios4-2019-02-27.img.gz.md5
$ gunzip ArchLinuxARM-helios4-2019-02-27.img.gz

Installing Arch Linux ARM on Helios4

Once you get an Arch Linux ARM image, follows these instructions to use it on Helios4:

Writing image / power-up Helios4 / connecting to serial console

Follows these steps from the Helios4 install guide:

  • step 2 to write the Arch Linux ARM image to a microSD card
  • step 3 to power-up Helios4
  • step 4 to connect to the Helios4 serial console.

!!! note Arch Linux ARM is configured by default to get its IP address from a DHCP server. As an alternative to step 4, you can connect to your router to find the IP address given to Helios4, then connect to this latter using SSH.

Log in

Use the serial console or SSH to the IP address given to Helios4 by your router.

You can login as:

  • the default user alarm with the password alarm
  • the user root with password root

!!! important For security reasons, it is highly recommended to change the default password of the alarm and root users.

Network settings

Arch Linux ARM is configured by default to get its IP address from a DHCP server. To change the network settings, look at the Network Configuration page from the Arch Linux wiki.

Pacman

The Pacman keyring is already initialized in the images created by the build-archlinux-img-for-helios4.sh script and the pre-built images. It is also already populated with the Arch Linux ARM package signing keys.

What to do next?

You can now configure Arch Linux ARM according to you needs and use pacman to install third party applications.

Here are some useful links from the Arch Linux wiki to get started:

!!! note Read the Accelerate Disk Encryption section of the Helios4 wiki before proceeding to learn how to offload disk encryption on the CESA unit.