Architectures/ARM/Anaconda

Using Anaconda to install on ARM systems

ARM systems that support PXE-boot may install Fedora using Anaconda and Kickstart. This has been tested on the Calxeda Highbank QEMU emulator and server hardware.

There is quite a bit of setup required to perform a PXE-boot, kickstart install, so this will cover the basics.

The basic steps involved in setting up for an anaconda kickstart install are the same as for other architectures, i.e.

• have a copy of the yum repo (available via http)
• have the install tree included in the same repo
• set up a server (DHCP/TFTPBoot/PXE) to PXE-boot the host
• set up a PXE-boot script to run the kickstart

Server Setup
How to set up the server (DHCP/TFTPBoot/PXE) is covered in other Fedora documentation, and is not specific to ARM, so it will not be covered in this document.

The repo and install tree are all available publicly for primary architecture (PA) formal releases. We can't use the public Fedora ARM repo because it does not include the install tree, therefore we must make a local copy and set it up ourselves.

The ARM install tree may be created using a modified version of lorax and anaconda. A lookaside repo is used to hold the modified versions of anaconda, grubby, and lorax, since they are not in Fedora 17. A public version of the lookaside repo is available (see "Setting Up the xpfa Repository"). After a lorax compose is complete, the contents of the install tree look like:

  .discinfo
  images/
      pxeboot/
          <kernel and initrd images>
  LiveOS/
      squashfs.img
  .treeinfo

All these files and directories should be included in a local copy of the ARM yum repo, i.e.,

 <LocalPathToRepo>/Fedora/fedora-secondary/development/17/armhfp/os/
   .discinfo
   drpms/
   images/
   LiveOS/
   Packages/
   repodata/
   .treeinfo

An example PXE-boot config file is:

menu title Highbank Boot Options

default Highbank-Install
prompt 1
timeout 100

label Highbank-Install
   kernel f17-highbank/vmlinuz-highbank
   initrd f17-highbank/initrd-highbank.img
   append console=ttyAMA0 ip=eth0:dhcp ks=http://<ServerPathToKickstartConfig>/highbank.ks rd.debug rd.shell cmdline

By default, this file is in the pxeboot.cfg directory and is named 01-<MAC Address>, all lower case, for example:

 MAC=00-50-43-9e-17-28 -> FileName=01-00-50-43-9e-17-28

however U-Boot will also search for alternate file names, icluding a hexidecimal representation of the system's IP address.

Since this is still a work in progress, command line options 'rd.debug' and 'rd.shell' were added to support debugging. The 'cmdline' option will prevent ncurses-type dialogs from being displayed on the serial console during the installation.

A copy the kernel and initrd image files from the install tree in the yum repo, along with the kickstart config file, should be copied to the PXE/tftpboot server, i.e.,

 /tftpboot/f17-mvebu/
    mvebu.ks
    initrd-mvebu.img
    vmlinuz-mvebu
    uImage-mvebu
    uInitrd-mvebu

The kickstart config file could reside elsewhere, but here it with the other images, just to keep things together. This implies that the tftpboot directory is also accessible via http.

Note: It appears that the current version of U-Boot on the ArmadaXP defaults to using 'bootm' for PXE-booting, therefore we are using the U-Boot wrapped images in the PXE config file, however both versions of the kernel and initrd images are provided in the image directory of the install tree in case this changes.

{{admon/note|Default Operation|The current version of U-Boot on Highbank defaults to using 'bootz' instead of 'bootm' for PXE-booting, therefore the 'raw' images need to be copied to the server. The version of U-Boot on other systems may have the opposite default (use U-Boot wrapped images). Both versions of the kernel and initrd are provided in the images/pxeboot directory of the install tree and may be copied to the server.

Please use this example kickstart file as a base for installion.

To boot to the PXE install image, interrupt the autoboot on the system and perform a PXE-boot. For convenience a script can be defined to do this, for example:

 bootcmd_pxe=setenv autoload no; dhcp; pxe get; pxe boot;

It can then be automatically performed on boot, or run manually, for example:

 run bootcmd_pxe

U-Boot should display the boot menu defined in the PXE config file for the system. Once the default is selected (or autoboots) the kickstart install should begin. This may take a long time, and since it is command line driven (kickstart via serial console) there is not much feedback. Be patient. Depending on the system and network performance the installation may take more than an hour.

IMPORTANT NOTE
This will wipe out anything on the hard drive in order to perform the new installation. It is not interactive, and no prompts or warnings will be provided. Only run this on a 'scratch' system for installation testing.