kobol-wiki/docs/helios4/arch.md
Gauthier Provost 79b964612d Fix page link. Add '/' when needed.
Add .gitignore file
2020-05-02 19:40:24 +08:00

4.9 KiB

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

Arch Linux ARM is a port of Arch Linux for ARM processors. Its design philosophy is simplicity and full control to the end user, and like its parent operating system Arch Linux, aims to be very Unix-like. More info here.

Prerequisite

Refer to the following section of the Helios4 install guide.

Arch Linux ARM image 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 pre-built images provided by 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.

Arch Linux ARM image builder

The build-archlinux-img-for-helios4.sh script provides an easy way to automatically create a bootable Arch Linux ARM image file for Helios4.

Requirements

The build-archlinux-img-for-helios4.sh script expects to be run 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 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 is created, go to Installing Arch Linux ARM on Helios4 section.

Pre-built images

You can download here pre-built Arch Linux ARM images for Helios4.

$ 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 your needs and use pacman to install 3rd party applications.

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

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

Page contributed by gbcreation