Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
products:a38x:software:os:debian [2018/07/09 09:43]
baruch [eMMC Software Installation] Further simplification with extlinux.conf
products:a38x:software:os:debian [2018/08/11 21:18]
artox set preferred-locale
Line 21: Line 21:
  
 ==== Official SolidRun Images ==== ==== Official SolidRun Images ====
 +Images for Jessie and Stretch are available [[https://​images.solid-build.xyz/​A38X/​|here]]. However as upstream support for the Clearfog has progressed quite far, we plan to discontinue custom images with the release of Buster. Please refer to the next section for details.
  
-An image of Debian Jessie is available [[https://​images.solid-build.xyz/​A38X/​|here]]. This is plain debian jessie, with the kernel and bootloader as provided by Marvell. 
 <​code>​Default username: debian <​code>​Default username: debian
 Default password: debian</​code>​ Default password: debian</​code>​
Line 35: Line 35:
 ./​mkimage.sh sr-a38x-debian-jessie.tar 1000M ./​mkimage.sh sr-a38x-debian-jessie.tar 1000M
 </​code>​ </​code>​
-==== Other Images ==== 
  
-=== Community Debian Wheezy Server ​===+==== Upstream (Buster) ====
  
-None as of yet.+Debian Buster (Testing) can be installed using the official debian-installer by correctly deploying it to a block device such as microSD or USB drive.
  
-  ​* [[http://www.debian.org/​|Official ​Debian ​Website]]+The block device must have a valid partition table either GPT or MBR, and at least one partition formatted with a filesystem known by both U-Boot and debian-installer,​ and big enough to hold the bootable files and an installer ISO image! We suggest using either FAT or ext4. 
 + 
 +== Getting the Files == 
 +All files required are available on the [[https://​www.debian.org/​devel/​debian-installer/​|download page for buster]]: 
 +  ​hd-media (other images -> armhf -> hd-media): ​[[http://ftp.nl.debian.org/​debian/​dists/​testing/​main/​installer-armhf/​current/​images/​hd-media/​hd-media.tar.gz|hd-media.tar.gz]] 
 +  * ISO (CD -> armhf): 
 +    * [[https://​cdimage.debian.org/​cdimage/​buster_di_alpha3/​armhf/​iso-cd/​debian-buster-DI-alpha3-armhf-netinst.iso|netinstall]] 
 +    * [[https://​cdimage.debian.org/​cdimage/​buster_di_alpha3/​armhf/​iso-cd/​debian-buster-DI-alpha3-armhf-xfce-CD-1.iso|xfce]] 
 + 
 +== Preparing the block-device == 
 +  * Unpack hd-media.tar.gz to a partition on the drive 
 +  * Copy the downloaded ISO to a (/the same) partition on the drive 
 + 
 +== Add U-Boot (optional) == 
 +U-Boot for the Clearfog devices is not part of Debian! That means it needs to be installed and managed seperately. 
 + 
 +If the installation media is a microSD, then it can be wise to now install U-Boot to that card by following our instructions on the [[products:​a38x:​software:​development:​u-boot|U-Boot page]]
 + 
 +Otherwise U-Boot has to be loaded via UART or be already available on one of eMMC, microSD, SPI Flash and SSD. 
 + 
 +<note important>​If U-Boot is installed on the same disk that debian will be installed to, it may get overridden! Safe locations for U-Boot are SPI Flash and the boot partitions of eMMC.</​note>​ 
 + 
 +== Add a preseed.cfg (optional) == 
 +A preseed file can be used to fully automate the installation. The Debian project maintains a sample for its current stable release at [[https://​www.debian.org/​releases/​stable/​example-preseed.txt]]. 
 + 
 +Below is a sample for installing Buster to an M.2 SSD: 
 +<​code>​ 
 +# Localization 
 +d-i debian-installer/​locale select en_GB.UTF-8 
 +d-i debian-installer/​language string en 
 +d-i localechooser/​preferred-locale select en_GB.UTF-8 
 + 
 +# Networking 
 +d-i netcfg/​choose_interface select eth0 
 +d-i netcfg/​get_hostname string clearfog 
 +d-i netcfg/​get_domain string unassigned-domain 
 + 
 +# Debian Mirror 
 +d-i mirror/​country string manual 
 +d-i mirror/​http/​hostname string deb.debian.org 
 +d-i mirror/​http/​directory string /debian 
 +d-i mirror/​http/​proxy string 
 + 
 +# Users and Passwords 
 +d-i passwd/​root-login boolean false 
 +d-i passwd/​user-fullname string Debian User 
 +d-i passwd/​username string debian 
 +d-i passwd/​user-password password debian 
 +d-i passwd/​user-password-again password debian 
 + 
 +# Time 
 +d-i clock-setup/​utc boolean true 
 +d-i time/zone string Israel 
 +d-i clock-setup/​ntp boolean true 
 + 
 +# Partitioning 
 +d-i partman-auto/​disk string /dev/sda 
 +d-i partman-auto/​method string regular 
 +d-i partman-auto/​choose_recipe atomic 
 +d-i partman-lvm/​device_remove_lvm boolean true 
 +d-i partman-md/​device_remove_md boolean true 
 +d-i partman-partitioning/​confirm_write_new_label boolean true 
 +d-i partman/​choose_partition select finish 
 +d-i partman/​confirm boolean true 
 +d-i partman/​confirm_nooverwrite boolean true 
 + 
 +# Package Selection 
 +tasksel tasksel/​first multiselect standard, ssh-server 
 + 
 +# Package Survey 
 +popularity-contest popularity-contest/​participate boolean false 
 + 
 +# Exit Installer 
 +d-i finish-install/​reboot_in_progress note 
 +</​code>​ 
 + 
 +Another method for acquiring ​ a preseed.cfg file is to run the installer by hand, then ask debconf for the settings that the installer had been using: 
 +<​code>​ 
 +sudo debconf-get-selections --installer > preseed.cfg 
 +</​code>​ 
 + 
 +The preseed.cfg file should be placed on the installation drive next to the iso image. In addition the automatic install has to be explicitly enabled through the kernel commandline from the U-Boot console: 
 +<​code>​ 
 +setenv bootargs "auto file=/​hd-media/​preseed.cfg"​ 
 +# boot into installer, e.g. usb 
 +run bootcmd_usb0 
 +</​code>​ 
 + 
 +== Starting the Install == 
 +All that is left to do is attaching the block storage to the Clearfog board and powering it up. 
 +The text based installer will show up on the serial console if boot succeeds. 
 + 
 +The boot order is controlled by the boot_targets U-Boot environment variable. 
 +By default it says: 
 +  1. scsi0 
 +  2. mmc0 
 +  3. usb0 
 +  4. pxe 
 +  5. dhcp 
 + 
 +In case the installer isn't started automatically because an existing system is found and started first, booting from the installer drive can be forced by invoking the corresponding boot command on the U-Boot console: 
 +<​code>​ 
 +# for USB 
 +run bootcmd_usb0 
 +# for microSD 
 +run bootcmd_mmc0 
 +# for SSD 
 +run bootcmd_scsi0 
 +</​code>​
  
 ==== Known Issues ==== ==== Known Issues ====