summaryrefslogtreecommitdiff
path: root/README
blob: fd37f06d931e294779543900e21a617f676a51fb (plain)
  1. # Homebase Boxer install routines
  2. This document documents the routines to setup boxes at [Homebase][].
  3. The install routines themselves are avaiable in a [git repository][].
  4. [Homebase]: <https://support.homebase.dk/homebase/>
  5.   "Homebase web page"
  6. [git repository]: <git://source.homebase.dk/box.git/>
  7.   "Homebase Boxer git repository"
  8. ## Preparations
  9. ### Hardware
  10. These install routines cover the following devices:
  11.   * [OLinuXino A20 LIME2][]
  12.   * [OLinuXino A20 LIME1][]
  13. Documentation describes use of the routines for A20 LIME2
  14. - adjust as needed for A20 LIME.
  15. Use power jack (USB-OTG is too weak as power source).
  16. [OLinuXino A20 LIME2]: <https://www.olimex.com/wiki/A20-OLinuXino-LIME2>
  17.   "Olimex OLinuXino A20 LIME2"
  18. [OLinuXino A20 LIME1]: <https://www.olimex.com/wiki/A20-OLinuXino-LIME>
  19.   "Olimex OLinuXino A20 LIME"
  20. ### Environment
  21. Build environment should be Debian Sid or Buster,
  22. with these packages installed:
  23.     apt install make curl boxer cpio u-boot-tools fusefat pigz eatmydata fakeroot multistrap parted udev proot qemu-user-static fuse2fs rsync sudo
  24. Other environments may work too,
  25. just please mention loudly any deviation when reporting bugs.
  26. Root access is *not* required to generate images,
  27. only for above package installation,
  28. and for writing final image to microSD card.
  29. ## Install
  30. Target system can be Debian Stretch, Buster or Sid,
  31. using either of the following desktop environments:
  32.   * hamlet
  33.   * jawa
  34. Documentation describes routines for hamlet on Debian Stretch
  35. - adjust as needed for other desktop and/or suite.
  36. Currently workarounds are needed,
  37. e.g. to avoid need for serial access during install.
  38. Make sure to read eventual warnings spewed during image build.
  39. ### Manual
  40. Debian installation is by default interactive.
  41.   * Fetch and merge installer image:
  42.         make clean
  43.         make images/stretch/d-i/plain/A20-OLinuXino-Lime2.img.gz
  44.   * Install (as root) installer onto microSD card
  45.     (replace SDCARD with actual device):
  46.         zcat images/stretch/d-i/plain/A20-OLinuXino-Lime2.img.gz > /dev/SDCARD
  47.   * Boot box with SDCARD plugged in,
  48.     and follow instructions,
  49.     especially this:
  50.     * Pick one of the options to overwrite the whole disk
  51.       (installer will be replaced by actual system on SDCARD)
  52.   * Create install script:
  53.         make clean
  54.         make content/hamlet-stretch/script.sh
  55.   * Transfer content/hamlet-stretch/script.sh to box,
  56.     and execute it as root.
  57. ### Automated
  58. Official Debian,
  59. pre-seeded with our package selection and configuration,
  60. installed onto target box,
  61. asking only most essential questions.
  62.   * Fetch and merge installer parts
  63.     with locally created preseeding file embedded:
  64.         make clean
  65.         bootargs=preseed/interactive=true make images/stretch/d-i/hamlet/A20-OLinuXino-Lime2.img.gz
  66.   * Install (as root) installer onto microSD card
  67.     (replace SDCARD with actual device):
  68.         zcat images/stretch/d-i/hamlet/A20-OLinuXino-Lime2.img.gz > /dev/SDCARD
  69.   * Boot box with SDCARD plugged in
  70.     (installer will be replaced by actual system on SDCARD)
  71. ### Non-interactive
  72. Official Debian,
  73. pre-seeded with our package selection and configuration,
  74. installed fully automated onto target box.
  75.   * Fetch and merge installer parts
  76.     with locally created preseeding file embedded:
  77.         make clean
  78.         make images/stretch/d-i/hamlet/A20-OLinuXino-Lime2.img.gz
  79.   * Install (as root) installer onto microSD card
  80.     (replace SDCARD with actual device):
  81.         zcat images/stretch/d-i/hamlet/A20-OLinuXino-Lime2.img.gz > /dev/SDCARD
  82.   * Boot box with SDCARD plugged in
  83.     (installer will be replaced by actual system on SDCARD)
  84. ### Preinstalled
  85. FIXME: Requires root (i.e. add line "fakeroot=" to file local.mk)
  86. Official Debian,
  87. preinstalled as intermediary, locally deployable image.
  88.   * Create image:
  89.         make clean
  90.         make images/stretch/local/hamlet/A20-OLinuXino-Lime2.img.gz
  91.   * Install (as root) installer onto microSD card
  92.     (replace SDCARD with actual device):
  93.         zcat images/stretch/local/hamlet/A20-OLinuXino-Lime2.img.gz > /dev/SDCARD
  94.   * Boot box with SDCARD plugged in
  95. ### Mass-deployable
  96. FIXME: Not yet implemented!
  97. Official Debian,
  98. preinstalled as intermediary generic image.
  99.   * Create image:
  100.         make clean
  101.         make images/stretch/full/hamlet/A20-OLinuXino-Lime2.img.gz
  102.   * Install (as root) installer onto microSD card
  103.     (replace SDCARD with actual device):
  104.         zcat images/stretch/full/hamlet/A20-OLinuXino-Lime2.img.gz > /dev/SDCARD
  105.   * Boot box with SDCARD plugged in
  106.     (will resize and personalize at first boot)
  107. ## Source
  108. When this README file is accompagnied by binary installer images, the
  109. following applies to satisfy license requirements:
  110. I hereby offer to provide the source code for the relevant Debian binary
  111. packages, included in the installer, on request.  However, you will
  112. probably find it easier to acquire these packages from the official
  113. Debian resources, ftp.debian.org and/or snapshot.debian.org.
  114. Jonas Smedegaard <dr@jones.dk>  Mon, 30 Nov 2015 12:04:49 +0100