# HG changeset patch # User Paul Boddie # Date 1368135612 -7200 # Node ID 42074dd7c46108fc440f583af0f5e2ba15ffe664 # Parent 5aa8a0c6ac03e9ca4334fb4036a98490e7160c52 Updated the documentation for Wheezy, adding an example configuration file. diff -r 5aa8a0c6ac03 -r 42074dd7c461 README.txt --- a/README.txt Sun Apr 07 20:59:13 2013 +0200 +++ b/README.txt Thu May 09 23:40:12 2013 +0200 @@ -27,7 +27,24 @@ apt-get update -...and then try to install such a newer version. If no readily available newer version exists in a usable repository, you may need to backport the package from a later Debian release. Such an activity is currently outside the scope of this document. +...and then try to install such a newer version. If no readily available newer version exists in a usable repository, you may need to backport the package from a later Debian release. Such an activity is currently outside the scope of this document, but the following package versions have been used for certain distributions: + +{| border="1" cellspacing="0" cellpadding="5" +! Host Distribution +! Target Distribution +! Multistrap Version +! Notes +|- +| Debian Squeeze +| Emdebian Squeeze/Debian Squeeze +| 2.1.20 +| Source package obtained from Debian Sid (unstable) and built for Squeeze +|- +| Debian Squeeze +| Emdebian Wheezy-Grip/Debian Wheezy +| 2.1.22 +| Source package obtained from Debian Sid (unstable) and built for Squeeze +|} ==== Downloads ==== @@ -70,9 +87,11 @@ This minimal configuration installs a base system from Emdebian Grip packages, which should be smaller than conventional Debian packages, using such conventional packages for those which are not present in the Grip repository. In addition, the udev and busybox-static packages are added; this latter package is essential for the initial configuration of the system. +For Debian Wheezy, various details must be changed in the configuration and an example file is provided in the [http://hgweb.boddie.org.uk/qi-emdebian/file qi-emdebian distribution] for guidance. + === Preparing a Root Filesystem === -With a suitable configuration file called, for example, multistrap-squeeze-mipsel.conf a root filesystem can be constructed in a location such as rootfs as follows. Note that you should really be root or use sudo for this to work properly: +With a suitable configuration file called, for example, multistrap-squeeze-mipsel.conf a root filesystem can be constructed in a location such as rootfs as follows. Note that you must be root or use sudo for this to work properly: multistrap -f multistrap-squeeze-mipsel.conf -d rootfs @@ -87,21 +106,23 @@ A number of configuration files, missing from the root filesystem, must be defined for the installation: * /etc/fstab +* /etc/hostname * /etc/network/interfaces - -Such files can be placed in a directory called, for example, configfiles while retaining the necessary filesystem structure, so that fstab would reside at configfiles/etc/fstab, and so on. This reflects their typical locations in a real system. +* /etc/resolv.conf -==== Pre-initialisation Files ==== +Such files can be placed in a directory called, for example, files while retaining the necessary filesystem structure, so that fstab would reside at files/etc/fstab, and so on. This reflects their typical locations in a real system. -Two additional files called preinit and preinit-config are required that "glue" the kernel to the Debian system on the first boot of the system. These files must reside in the current directory when running the script below. +==== Pre-Initialisation Files ==== + +Two additional files called preinit and preinit-config are required that "glue" the kernel to the Debian system on the first boot of the system. These files must reside in the current directory when running the script below. The preinit file is a convention apparently employed by the OpenWrt distribution used on the NanoNote, and where kernels from other origins are to be used, it is important that the appropriate conventions for invoking the system init program are followed. Thus, if you switch to a different kernel from another project, you may need to change the qi-emdebian-postsetup script to install these files into other locations, potentially giving them different names. ==== Running the Script ==== With the missing files now defined, a script written to automate the remaining configuration activity can be run as follows. Again, it may help to be root or to use sudo to be able to copy the necessary files into the root filesystem: - qi-emdebian-postsetup rootfs openwrt-xburst-qi_lb60-uImage.bin configfiles + qi-emdebian-postsetup rootfs openwrt-xburst-qi_lb60-uImage.bin files -Here, rootfs is the root filesystem created above, openwrt-xburst-qi_lb60-uImage.bin is the kernel image obtained above, and configfiles is the directory containing the missing configuration files. +Here, rootfs is the root filesystem created above, openwrt-xburst-qi_lb60-uImage.bin is the kernel image obtained above, and files is the directory containing the missing configuration files. === Formatting the Boot Medium === @@ -118,7 +139,21 @@ fdisk -l /dev/sdb -To add a new partition, run fdisk, use the n command to make a primary partition, and then the w command to write the partition table. +If the microSD card already has partitions, you should check to see if they have been mounted by the system: + + mount + +If so, you must first unmount the corresponding devices as follows (as root or using sudo): + + umount /dev/sdb1 + +To preserve existing partitions, you can copy them from the card to your system as follows (as root or using sudo): + + dd if=/dev/sdb1 of=sdb1.backup + +To add a new partition, run fdisk, use the n command to make a primary partition, and then the w command to write the partition table. Since fdisk will probably suggest a reasonable start of a partition, perhaps the biggest concern is the size of the partition. Choosing +1024M to indicate a partition of 1024MB or 1GB is not unreasonable for modern microSD cards and current Emdebian installations. + +It is also possible to accept the partition size suggested by fdisk and assign all the space on the card to a partition as well. This may not be sensible, however, since it may make some operations slower and hinder alternative uses for the space (like the creation of other partitions for purposes like backups). === Completing the Installation === diff -r 5aa8a0c6ac03 -r 42074dd7c461 multistrap-wheezy-mipsel.conf --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/multistrap-wheezy-mipsel.conf Thu May 09 23:40:12 2013 +0200 @@ -0,0 +1,33 @@ +[General] +arch=mipsel + +# same as --tidy-up option if set to true +cleanup=true + +# same as --no-auth option if set to true +# keyring packages listed in each debootstrap will +# still be installed. +noauth=false + +# the order of sections is not important. +# the debootstrap option determines which repository +# is used to calculate the list of Priority: required packages. +bootstrap=Grip Debian +aptsources=Grip Debian + +[Grip] +packages=udev busybox-static +packages=openssh-server openssh-client +packages=plymouth dialog module-init-tools +packages=inetutils-ping net-tools ifupdown +packages=python vim +#packages=python-pygame +source=http://ftp.uk.debian.org/emdebian/grip +keyring=emdebian-archive-keyring +suite=wheezy-grip + +[Debian] +packages=python-pygame +source=http://ftp.debian.org/debian +keyring=debian-archive-keyring +suite=wheezy