UNE dysentry method

From Joggler
Jump to navigation Jump to search

Using DYSENTRYs disk image to install ubuntu netbook remix onto a USB flash drive (Compiled by BigBloke with input / edits from others)

This is the quickest way I have found to get Ubuntu Netbook edition ready for use with the Joggler.

At the time of writing, Dysentry has upgraded his disk image to what he refers to as "version 1.3a" (*). This adds:

Sound support (should have clean sound on both outputs)

fsck disabled

SSHD installed

NTP installed

Wired Lan fixed

Cellwriter installed

GDM fixed

Small 4gb usb stick problem solved.

Prerequisites (things you do BEFORE you start!)

A) You will need a Linux machine,other than your joggler, to uncompress and extract Dysentry's image to your USB disk.

  (for the moment I will assume this is something that you have / can use a live cd  / can install a virtual machine)
  From here in I will refer to this pc as the "BUILD" machine and the Joggler as the "TARGET" machine.

B) You will need a USB stick of at least 4GB capacity, that you are not afraid to wipe out. 8GB is fine, there will be space you can recycle afterwards.

C) On your BUILD machine you will need to know the "logical location" of the USB stick when it is inserted into a USB slot

  this might be /dev/sdb or /dev/sdc or indeed /dev/{anything_else!}} use a disk tool like gparted to identify the appropriate
  disk device 
    **                                                   WARNING!                                                **
    **                                        <<TAKE CARE>> TO GET THIS RIGHT!                                   **
    **                                            YOU HAVE BEEN WARNED!                                          **
In a Terminal Window, the easiest way is to connect your USB stick, check using the dmesg command, then double check with fdisk -l command.

1) Download the disk image.http://www.stephenford.org/joggler/files/v1.3/joggler_unr_9.10_v1.3a.bin.tar.gz

  Dysentry has advised that future releases will be stored at http://www.stephenford.org/joggler/files/<<version number>>

2) Open a terminal on the BUILD machine and obtain root privileges (su - or sudo -i)

3) Navigate to the folder where the downloaded disk image was saved (for "version 1.1" the filename your looking for is "joggler_unr_9.10_v1.3a.bin.tar.gz"

4) Insert the USB stick into the BUILD machine (assuming you haven't done this already!)

5) With reference to the WARNING in prerequisite C) above, start restoring the disk image to the usb stick.

  The command is: 
               tar xzvOf joggler_unr_9.10_v1.3a.bin.tar.gz joggler_unr_9.10_v1.3a.bin | dd of=<your_own_device> bs=10M

  For avoidance of doubt you specify a whole DEVice here (like /dev/sdb) without the "<>"'s. you do not 
  specify a single partition like /dev/sdb1 or /dev/sdc2
  As a worked EXAMPLE ONLY, if your USB stick in the BUILD machine was recognised as /dev/sdd you would type:
               tar xzvOf joggler_unr_9.10_v1.3a.bin.tar.gz joggler_unr_9.10_v1.3a.bin | dd of=/dev/sdd bs=10M

6) Wait until you get your command prompt back - this may take quite a while.

  if your USB stick has an LED which flashes whilst acessing data, take heart! whilst its flashing its doing something.
  If you want to get a progress indicator open up another terminal with root privileges (or terminal tab) and type:
              watch pkill -SIGUSR1 dd
  This will send the USR1 signal and cause DD to output it's current speed and progress.
  Once dd is finished do ctrl-c in the new terminal to send SIGINT to the pkill process to stop it.

7) If you are using a 4GB drive skip this step. For those using larger drives the 4GB partition can now be made larger to fill your drive using fdisk (or use gparted if you like).

             fdisk /dev/sd*
   Make sure to replace * with the letter associated with your usb drive. Also make sure the drive is unmounted using umount     
             press 'd' to delete a partition
             press '2' to choose the second partition (the one you just wrote with dd)
             press 'n' to create a new partition
             press 'p' to make a primary partition
             press '2' to make it the new second partition, keep selecting the default choices for the first cyclinder, last cyclinder questions
             press 'w' to write the changes
   After this type:
             resize2fs /dev/sd*2
   Once this is complete type
             fsck -f /dev/sd*2
   to check the disk. Now your drive is ready to go.

8) Remove the USB stick from the BUILD machine (politely if possible, or at worst, shut down the BUILD machine then remove it)

9) Insert the USB stick into the TARGET machine (Joggler) and power it up.

   It should boot straight into a Ubuntu desktop. It may make a few odd noises during this phase - don't be too surprised ;)

Post installation configuring of cell-writer

Cell-writer now starts on boot-up in keyboard-only mode. No additional configuration needed.

Using Cell-Writer

Hopefully you are now looking at your Ubuntu netbook desktop (sweet isnt it ?) with a white CW icon on the task bar

Tap the CW icon (The small one on the Ubuntu task bar) and a drop down menu appears with 3 options:

SHOW - displays the on screen keyboard (or character input screen)

SETUP - takes you back to the setup menu (that you just configured)

QUIT - exits Cell writer

If you are in recognition mode you should see some blank white squares and some black touch buttons. beneath the black buttons are three words CLEAR KEYS ENTER

Tap the KEYS word

The character input screen should be replaced by the on screen keyboard

Click the [X] icon in the top right of the keyboard to remove it from the screen , use the white CW icon on the upper task bar and SHOW to get it back

NOW you can tap the wifi icon and enter your WEP/WPA/WPA2 key without having to resort to a USB keyboard and hub

Potential problems

Fixing random/invalid Ethernet MAC address problem

Some users have encountered a problem with wired Ethernet caused by the shared MAC address. This issue is related to the way udev initialises and the r8168/r8169 driver. More discussion can be found Here

Edit the file /etc/udev/rules.d/70-persistent-net.rules; Remove all lines beginning with SUBSYSTEM and enter the following:

SUBSYSTEM=="net", DRIVERS=="r8168", NAME="eth0"

The file should read something like this:

# This file maintains persistent names for network interfaces.
# See udev(7) for syntax.
# Entries are automatically added by the 75-persistent-net-generator.rules
# file; however you are also free to add your own entries.
SUBSYSTEM=="net", DRIVERS=="r8168", NAME="eth0"

When you reboot your wifi card should automatically be re-added.

To allow Net-manager to manage your ethernet connection, edit /etc/NetworkManager/nm-system-settings.conf






Further information may be found on the Joggler.info forum

Replacing R8169 Ethernet driver with R8168

Some jogglers (AO2JOGON) contain the Realtek r8169 Ethernet chip, while others (AO2JOGXN) contain r8168. By default Dysentrys image uses the r8169 driver, the following instructions describe how to install the r8168 driver. All commands need to be run as root

Download the r8168 driver from: File:R8168-8.018.00.tar.bz2
Extract the driver source: tar xvfj R8168-8.018.00.tar.bz2
Change into the source tree: cd r8168-8.018.00
Compile it: ./autorun.sh
Tell Ubuntu to ignore the r8169 driver: echo "blacklist r8169" >> /etc/modprobe.d/blacklist.conf
Rebuild the module dependencies: depmod -a
Create backup of initrd: cp /media/BOOTV13/initrd /media/BOOTV13/initrd.bak
Create initrd image on FAT16 boot partition (for dysentrys UNR): mkinitramfs -o /media/BOOTV13/initrd
Reboot the joggler
Check r8168 is loaded and NOT r8169: lsmod | grep 816

Sources: http://www.jamesonwilliams.com/hardy-r8168



Outstanding issues

I was unable to load new software as Gnome prompted me to enter a password. The fix is below . Thanks are extended to the contrbutor

Allowing GNOME gksu to use onscreen keyboards

I still have clicks and pops on the sound, and around 1 boot in 5 I have no sound. I think I need to check the files to ensure I have correct configs. Meanwhile I've told the family not to worry as its "probably just hard disk access !!" ;-)))))

Upon returning home from work, some 18 hours later, I tapped the Joggler Screen (centre) The screen had locked itself and I could not enter a password. This was (temporarilly) resolved by a power cycle (which restored desktop access).

The fix has been kindly supplied below:

Onscreen keyboard in GNOME screen unlock

Occasionally the "matrix" screen saver will not exit forcing a reboot to restore desktop access

The touch screen (on my joggler) is about 4mm out of calibration. I have yet to find a way to resolve this.

Cellwriter will not input the default keyring passwords into the dialgoue box after entering the WPA key. the only option is to press the "X" icon to force the keyring window closed. This does however, permit wifi access but you will need to repeat the process upon reboot

After 3-4 days of flawless operation , cellwriter will not now input text into the WEP / WPA key field ??

Feedback / observations supplied by third parties

I managed to install the build Florence keyboard after installing tonnes of libraries, but didn't find it useful. It need further development before its any use as i comes up full screen and doesn't seem to have a option to minimize. Firefox has a virtual keyboard and grab drag (touch scrolling) addon, but I preferred Chrome, Chrome Touch and cell writer.

Another good onscreen keyboard to try is kvkbd, this can by installed using synaptic or apt-get.

An alternative browser optimised for touch screens and smaller resolutions is Mozilla's Fennec, also available from apt/Synaptic.

Also for linux users, gparted worked well in extending the ext2 partition to greater than 4gb (8gb in my case), with no errors in the next boot.

Good guide on Post installation stuff: http://theindexer.wordpress.com/2009/10/25/to-do-list-after-installing-ubuntu-9-10-aka-karmic-koala/. Not all necessary but some very useful.

General Tweaks for Ubuntu Netbook Remix Edition 9.10 on the Joggler


helpful comments from the #mer crowd on Freenode IRC

Joggler.info forum topic thread http://www.joggler.info/forum/viewtopic.php?f=33&t=235

Enabling XDMCP under Ubuntu Netbook Edition


Are extended to Dysentry for sharing his disk image (keep up the great work!)

Bigbloke's "Anonymous" assistants for their inclusion of fixes / edits to this Wiki