CT-PC89E Debian Installer - Revision history

Peter Huewe: Added to category CT-PC89E

2011-04-13T21:49:33Z

Added to category CT-PC89E

Lkcl: /* Installation HOWTO */

2010-03-25T12:06:38Z

‎Installation HOWTO

Lkcl at 12:05, 25 March 2010

2010-03-25T12:05:00Z

Lkcl: add CT-PC89E Debian-Installer page

2010-03-25T12:04:14Z

add CT-PC89E Debian-Installer page

New page

installing Debian Squeeze using
Debian Installer is, with a few limitations, as easy as installing Debian
on any other system.

Before attempting this yourself, please read the information below
carefully. The installation procedure has been successfully tested, but
keep in mind that this is not rock solid code yet.

== Known issues and limitations ==

The only real issues are because our kernel is not yet perfect.

== kernel issues ==

The installer uses and will install the 2.6.24.7 kernel Luke and I have
been working on. This kernel is still very much work in progress. Help
fixing the issues below would be very much appreciated!

Current known kernel issues are (roughly in order of importance):
* Internal flash (mmcblk0) gets disabled (or reset) when external SD card is inserted/removed. Do *NOT* change the SD card while the installer or Debian is running.
* System does not power off after shoutdown; use the "reset" button on the bottom to power off the system after shutdown.
* No driver for wireless networking available.
* The dm9000 eth0 network device has some issues and is slow to come up. Once up it has been reliable for me.
* The dm9000 is assigned a random MAC address on each boot, pending work on a device driver to read the DS2431 EEPROM where there is a MAC address stored.
* Various other (less important) devices are not yet enabled or tested.

== installer limitations ==

* Do *not* change mmcblk0p1; this is where u-boot and the kernel live...
* The root file system *must* be formatted for ext2. Reason is that we don't have a initrd, so the driver for the root file system must be compiled into the kernel. Only ext2 and ext4dev are compiled in at the moment.
* ext4 is *not* usable. Cause is probably an incompatibility between the version of ext4 available in 2.6.24 and Squeeze userland libraries and utilities. A newly created ext4 partition fails to mount. However, the existing MidFun ext4 partitions mount correctly.
* The installer will install a "full" Debian base system, not a reduced emdebbian "grip" system. Maybe installing emdebbian Squeeze grip is possible, but that's untested. "Upgrading" to grip should be possible.
* Repository Release files are *not* authenticated. Reason is that the installation uses a repository on alioth for custom packages which does not (yet) have a signed Release file.

== Debian Installer functionality ==

The installation is similar to "netboot" installs: only the initial
installer image is read from SD card; all additional installer components
and all packages are downloaded from the Internet.
I have opted for this in order to keep the external SD card completely free
for use for partitioning and the installed system.

All installer components that are specific to the CT-PC89E are included in
the initial installer image.

The installer has a number of customizations for the CT-PC89E:
* a micro ramdisk piggybacked onto the installation kernel that loads the real installer image from SD card
* the installer itself is *not* flashed, but runs entirely in RAM
* extended timeout for DHCP because of the eth0 kernel issues
* automatically adds package repository on alioth for:
* custom kernel package
* custom udev package: this package is identical to the Lenny version of udev, but with a version number bumped so it's higher than the current version of udev in Squeeze (I've used: 160-really0.125-1)
* installs hook scripts to run depmod and to flash the kernel to nand
* guided partitioning is skipped by default as using it is completely unsuitable for use on mmcblk0p1

The custom package repository can be found at:
http://arm-netbook.alioth.debian.org/dists/

The custom udev package is needed because the current version in Squeeze
requires a 2.6.26 or later kernel.

NOTE: the kernel will automatically be flashed to Nand (mmcblk0p1) during
the installation, and also later when upgraded using a suitable kernel
package.

== Installation tips ==

* Do not create a swap partition; by all accounts using swap with flash is not a good idea.
* It is possible, using partman, to delete mmcblk0p2 and mmcblk0p3 and, create a new mmcblk0p2 partition of ~1.9GB. Or choose your own scheme, but *do not* touch mmcblk0p1.

== Installation HOWTO ==

Yes, I've put this at the bottom on purpose :-)

* Create a VFAT partition on an SD card; the maximum *total* capacity of the SD card is 4GB; larger cards are not recognized by u-boot. Suggested size for the VFAT partition is 100MB; the partition *must* be partition 1.
* Copy the Debian Installer files from [1] to the SD card. The files are:
* zImage_dt_update: kernel image + micro initial ram disk
* datang-epc.tar.gz: dummy tarball required by u-boot
* root.img: the actual Debian Installer image
* Boot the netbook for a "firmware update" by holding the two touchpad buttons and then press and hold the power button. Keep all three buttons pressed until you see a blue Chinese text (which presumably says the "firmware" image is being loaded).
* Install as usual, but please observe all the warnings listed above.

== Final remarks ==

With this milestone reached I'm going to reduce the time spent on the
netbook a bit. However, I will update the package repository and installer
images on alioth as improvements (in the kernel) become available.

Please share your experiences and let me (and others) know of any problems, on arm-netbooks@lists.phcomp.co.uk, or by editing the "discussion" page on this wiki.

@@ Line 74: / Line 74: @@
 * Create a VFAT partition on an SD card; the maximum *total* capacity of the SD card is 4GB; larger cards are not recognized by u-boot. Suggested size for the VFAT partition is 100MB; the partition *must* be partition 1.
-* Copy the Debian Installer files from [1] to the SD card. The files are:
+* Copy the Debian Installer files from http://arm-netbook.alioth.debian.org/pub/CT-PC89E/debian-installer/ to the SD card. The files are:
 ** zImage_dt_update: kernel image + micro initial ram disk
 ** datang-epc.tar.gz: dummy tarball required by u-boot

@@ Line 19: / Line 19: @@
 Current known kernel issues are (roughly in order of importance):
 * Internal flash (mmcblk0) gets disabled (or reset) when external SD card is inserted/removed. Do *NOT* change the SD card while the installer or Debian is running.
-* System does not power off after shoutdown; use the "reset" button on the bottom to power off the system after shutdown.
+* System does not power off after shutdown; use the "reset" button on the bottom to power off the system after shutdown.
 * No driver for wireless networking available.
 * The dm9000 eth0 network device has some issues and is slow to come up. Once up it has been reliable for me.
@@ Line 88: / Line 88: @@
 Please share your experiences and let me (and others) know of any problems, on arm-netbooks@lists.phcomp.co.uk, or by editing the "discussion" page on this wiki.

@@ Line 49: / Line 49: @@
 * extended timeout for DHCP because of the eth0 kernel issues
 * automatically adds package repository on alioth for:
- * custom kernel package
+** custom kernel package
- * custom udev package: this package is identical to the Lenny version of udev, but with a version number bumped so it's higher than the current version of udev in Squeeze (I've used: 160-really0.125-1)
+** custom udev package: this package is identical to the Lenny version of udev, but with a version number bumped so it's higher than the current version of udev in Squeeze (I've used: 160-really0.125-1)
 * installs hook scripts to run depmod and to flash the kernel to nand
 * guided partitioning is skipped by default as using it is completely unsuitable for use on mmcblk0p1
@@ Line 75: / Line 75: @@
 * Create a VFAT partition on an SD card; the maximum *total* capacity of the SD card is 4GB; larger cards are not recognized by u-boot. Suggested size for the VFAT partition is 100MB; the partition *must* be partition 1.
 * Copy the Debian Installer files from [1] to the SD card. The files are:
- * zImage_dt_update: kernel image + micro initial ram disk
+** zImage_dt_update: kernel image + micro initial ram disk
- * datang-epc.tar.gz: dummy tarball required by u-boot
+** datang-epc.tar.gz: dummy tarball required by u-boot
- * root.img: the actual Debian Installer image
+** root.img: the actual Debian Installer image
 * Boot the netbook for a "firmware update" by holding the two touchpad buttons and then press and hold the power button. Keep all three buttons pressed until you see a blue Chinese text (which presumably says the "firmware" image is being loaded).
 * Install as usual, but please observe all the warnings listed above.