There are versions 0.3.6 and 0.3.7? What??? Where does one even find these? They are not mentioned in the README, nor wiki page, nor can they be found under http://www.swagman.org/juice/ubiboot/ubiboot-02/. I just took ubiboot-02_0.3.5_301013.tar and flashed zImage_2.6.32.54-ubiboot-02-small_060114 as it seemed to be the latest.

If I'm honest, I found the documentation (README and wiki) to be out of date and incomplete. After a lot of pain, I eventually figured it out.

Parts of the README I found confusing:

Only in the comment in the ubiboot.conf file does it say that the path should be relative to the ubiboot FS but there was nothing to explain the layout of ubiboot FS and no way of knowing the layout without telneting in (which telneting itself may not be obvious to some if they used the "small" kernel which appears to be the latest, as I did).

It's not clear that the "Harmattan" name is taken from the value of G_OS<x>_NAME. Again, I needed to telnet in to understand this properly.

It's not clear that each rootfs should be copied/unpacked to a dedicated partition unless handled by a preinit script. This really confused me. Combined with the problems mentioned above, I incorrectly thought that maybe G_OS<x>_<y>_FILE was being used to specify the rootfs location as well as the kernel.

I don't want to sound like I'm complaining, I just hope this will help others to avoid the problems I had. Although it would also be nice if you would fix the documentation juiceme.

It might also be nice to have a new ubiboot with a recent kernel and recent kexec tools.

EDIT: One more thing, my experience would have been far less painful if ubiboot had printed an error message to tell me that my kernel image was not found before running kexec. I had no idea why it was failing and thought there was a problem with the kernel I built.