Architectures/ARM/F24/Installation

Click here to set up this language box

This page is a draft only
It is still under construction and content may change. Do not rely on the information on this page.

Fedora 24 Alpha for ARM

The Fedora ARM team is pleased to announce that Fedora 24 Alpha for the ARM Architecture is now available for download from:

• Spins - http://download.fedoraproject.org/pub/fedora/linux/releases/test/24_Alpha/Spins/armhfp/images/
• Workstation - http://download.fedoraproject.org/pub/fedora/linux/releases/test/24_Alpha/Workstation/armhfp/images/
• Server - http://download.fedoraproject.org/pub/fedora/linux/releases/test/24_Alpha/Server/armhfp/images/

Fedora 24 Alpha for ARM includes a number of images providing for a variety of desktop choices (including MATE, XFCE, LXDE, SOAS), as well as a minimal and Server image that does not include the desktop. Any of these images can be used with QEMU on an x86_64 desktop to emulate a fully functional ARM environment.

The image-based installation process involves downloading an image file (depending upon the desktop/non-desktop option desired), inserting removable media into a "host" system (e.g. an ARM or x86_64 PC class desktop, laptop, etc.) and performing a few simple commands to write this image onto the media. This media is then used by the ARM "target" system to boot the Fedora 24 Alpha environment.

What is the release?

The release contains all the exciting features of Fedora 24's editions in a form that anyone can help test. This testing, guided by the Fedora QA team, helps us target and identify bugs. When these bugs are fixed, we make a release available. A release is code-complete and bears a very strong resemblance to the third and final release. The final release of Fedora 24 Alpha is expected in October.

We need your help to make Fedora 24 Alpha the best release yet, so please take some time to download and try out the and make sure the things that are important to you are working. If you find a bug, please report it – every bug you uncover is a chance to improve the experience for millions of Fedora users worldwide.

Together, we can make Fedora rock-solid. We have a culture of coordinating new features and pushing fixes upstream as much as feasible, and your feedback will help improve not only Fedora but Linux and free software on the whole.

Fedora-Wide Changes

Fedora 24 Alpha includes a number of changes that will improve all of the editions. For example, Fedora 24 Alpha is making use of compiler flags to help improve security by "hardening" the binaries against memory corruption vulnerabilities, buffer overflows, and so on. This is a "behind the scenes" change that most users won't notice through normal use of a Fedora edition, but should help provide additional system security.

Likewise, Fedora 24 Alpha has disabled SSL3 and RC4 by default due to known vulnerabilities in the protocols. This means all applications that use GNUTLS and OpenSSL libraries have had the SSL3 protocol and RC4 cipher disabled.

Fedora 24 Alpha also includes support for Unicode 8.0, which includes new emojis, and improvements in sorting Unicode text and processing non-ASCII URLs.

Overview of Hardware Support Status

• Hardware Support Status

Download the Disk Image & Copy to Media

The image-based installation process involves downloading an image file (depending upon desktop/non-desktop option desired), inserting removable media into a "host" system (e.g. an ARM or x86_64 PC class desktop, laptop, etc.) and performing a few simple commands to write this image onto the media. This media is then used by the ARM "target" system to boot the Fedora 24 Alpha environment.

After writing the image and correct U-boot file(s), insert the media into the target platform and boot.

• http://download.fedoraproject.org/pub/fedora/linux/releases/test/24_Alpha/Spins/armhfp/images/

Fedora Arm Installer

Note
The examples provided here are from a Fedora 21/22/23 host and may need to be adjusted depending on your host environment.

Execute the following script as a user with sudo privileges. It will copy the selected disk image and write the appropriate U-Boot for the target hardware platform. Optionally you can also enable and disable SE Linux and remove the root password requirement (allowing log in without completing initial setup). To add a board not listed, simply create a bash scriptlet with the commands needed to copy U-Boot to media and add to the 'boards.d' directory.

dnf install fedora-arm-installer

Usage: fedora-arm-image-installer <options>

   --image=IMAGE    - xz compressed image file name
   --target=TARGET  - target board
		      [A10-OLinuXino-Lime|A20-OLinuXino-Lime|A20-OLinuXino-Lime2|A20-OLinuXino_MICRO|am335x_boneblack|arndale|Bananapi|Bananapro|cm_fx6|Cubieboard|Cubieboard2|Cubietruck|jetson-tk1|Linksprite_pcDuino|Linksprite_pcDuino3|Linksprite_pcDuino3_Nano|Mele_A1000|Mele_A1000G_quad|Mini-X|mx6cuboxi|none|novena|omap4_panda|omap5_uevm|riotboard|trimslice|wandboard]
   --media=DEVICE   - media device file (/dev/[sdX|mmcblkX])
   --selinux=ON/OFF - Turn SELinux off/on as needed
   --norootpass     - Remove the root password
    -y		    - Assumes yes, will not wait for confirmation
   --version	    - Display version and exit
   --resizefs	    - Resize root filesystem to fill media device
   --addconsole     - Add system console to extlinux.conf

Example: fedora-arm-image-installer --image=Fedora-Rawhide.xz --target=Bananapi --media=/dev/mmcblk0 --selinux=OFF

For Versatile Express Emulation with QEMU

No ARM hardware? No problem! Even without hardware, it is possible to run the Fedora for ARM images using the QEMU emulator program. Any image can be used, and you can choose a scr ipt method or manual depending on your preference.

Using an Existing Disk Image

Choose a disk image.

http://download.fedoraproject.org/pub/fedora/linux/releases/test/24_Alpha/Spins/armhfp/images/

Extract the image:

TYPE= # Type of image used. (eg Minimal, KDE, Xfce, SoaS, MATE)
unxz Fedora-$TYPE-armhfp-24_Alpha-7-sda.raw.xz

Install 'libguestfs-tools' to use virt-builder:

sudo dnf install -y libguestfs-tools

Extract the kernel and initramfs for use with booting.

virt-builder --get-kernel Fedora-$TYPE-armhfp-24_Alpha-7-sda.raw

Move the files to the default libvirt image location:

sudo mv Fedora-$TYPE-armhfp-24_Alpha-7-sda.raw vmlinuz-4.5.0-0.rc7.git0.20.fc24.armv7hl initramfs-4.5.0-0.rc7.git0.20.fc24.armv7hl.img /var/lib/libvirt/images/

Using Virt-Manager (Graphical )

• Start virt-manager, connect to 'QEMU', click the 'New VM' icon
• On the first page, under 'Architecture Options' select 'arm'. The 'virt' machine type should be selected automatically
• Select the 'Import install' option, go to the next page
• Browse to the disk image, kernel, and initrd we moved in the previous step.
• Set kernel args as: console=ttyAMA0 rw root=LABEL=_/ rootwait
• Set the OS as Fedora 22.
• Continue with the OS defaults, complete the install.

The guest should shortly start booting, and you should see text console output. After a bit of a wait, it should hit a text mode 'initial setup' where you can set a root password. To boot (you will need to determine the kernel version used in the disk image):

Using 'virt-install' (command line)

sudo virt-install \
    --name Fedora-$TYPE-armhfp-24_Alpha-7 --ram 1024 --arch armv7l --import --os-variant fedora22 \
    --disk /var/lib/libvirt/images/Fedora-$TYPE-armhfp-24_Alpha-7-sda.raw \
    --boot kernel=/var/lib/libvirt/images/vmlinuz-4.5.0-0.rc7.git0.20.fc24.armv7hl,initrd=/var/lib/libvirt/images/initramfs-4.5.0-0.rc7.git0.20.fc24.armv7hl.img,kernel_args="console=ttyAMA0 rw root=LABEL=_/ rootwait"

Expanding the Disk Image

You can easily expand the root partition of the disk image using qemu-img.

For example to increase the image size by 10GB you can issue:

 qemu-img resize Fedora-$TYPE-armhfp-24_Alpha-7-sda.raw +10G

Interactive Network Installation

This example will create an 8Gb disk image in the libvirt images directory.

sudo virt-install \
    --name f24-armhfp --ram 2048 --arch armv7l --os-variant fedora22\
    --disk /var/lib/libvirt/images/f24-armhfp.raw,bus=virtio,format=raw,size=8 \
    --location=http://dl.fedoraproject.org/pub/fedora/linux/releases/24/Server/armhfp/os/ \
    --extra-args="console=ttyAMA0 rw"

Complete a Text or VNC Installation choosing a software packge and partitioning scheme. The system will attempt to reboot but fail until the next step is completed.

Virt-Manager

• Open Virt-Manager and select the image created above. Click on "Edit-> Virtual Machine Details -> View -> Details"
• Under "Boot Options", add the kernel, initramfs
• Use virt-cat to get the appropriate kernel args.

sudo virt-cat -a /var/lib/libvirt/images/f24-armhfp.raw /boot/extlinux/extlinux.conf

Booting for the First Time

Initial-setup

• During the first boot the system will launch the 'initial-setup' utility. For graphical images this will occur on the display, for minimal images this will occur on the serial console. Failure to complete the initial-setup will prevent logging into the system. To log in to the root account without completing the initial-setup you will need to minimally edit '/etc/passwd' file and remove the 'x' from the line beginning with 'root' (this will allow you to log into the root account without entering a password).
  • NOTE - currently there is a timing issue with initial-setup, even though a display is connected, it may be run as text on the serial console. This is often resolved by rebooting the system.

Resize the Root Filesystem

To resize the root partition use 'gparted' on a Fedora host.

Upgrade using Fedup

It is also possible to upgrade to Fedora 24 Alpha from an existing Fedora 23 installation (NOTE: This is not well tested prior to Beta, and may not work for all hardware. Tested on Calxeda Highbank. Previous releases may also work but have not been tested).

# fully update the system
dnf update -y
# install the upgrade plugin
dnf install dnf-plugin-system-upgrade
#upgrade
dnf system-upgrade download --releasever=24

Known Issues & Usage Tips

• Display is not currently working in vexpress emulation.
• On some hardware, initial setup runs on serial console (initial-setup-text) rather than graphical on Desktop enabled images. If no serial console is available, restarting the system may start the graphical version. Removing the symlink for initial-setup-text will ensure the correct version is run.
• Initial-setup-graphical does not use the full screen on Desktop images. It is still possible to complete, once an option is selected the window should resize and be easier to use. (BZ#1160891)
• The Fedora Server and Cloud repositories are not installable due to a compose issue and truncated 'product.img' files. Cloud and Server can both be installed using the Everything repository.

For a list of all common bugs please visit - http://fedoraproject.org/wiki/Common_F24_bugs .

FAQ

• QUESTION : How do I use Fedora ARM when I have no serial cable or display?
  • ANSWER: Though not recommended it is possible to use Fedora ARM without a serial cable or display. When doing so you may want to limit updates to reduce the possibility of not being able to boot. (This example is from a Fedora 22 system, you may need to adjust the mounts used).

USER= # your user account
rm /run/media/$USER/__/etc/systemd/system/graphical.target.wants/initial-setup-graphical.service
rm /run/media/$USER/__/etc/systemd/system/multi-user.target.wants/initial-setup-text.service
mkdir /run/media/$USER/__/root/.ssh/
cat /home/$USER/.ssh/id_rsa.pub >> /run/media/$USER/__/root/.ssh/authorized_keys
chmod -R u=rwX,o=,g= /run/media/$USER/__/root/.ssh/

Give the system a few minutes to boot, when it obtains an IP you should be able to ssh to the root account.

• QUESTION : Why does 'yum update' fail?
  • ANSWER: The system time might be incorrect, please ensure it is correct.