steptail.com

How many light bulbs does it take to change a penguin?

User Tools

Site Tools


guides:how_to_install_debian_on_olpc_xo-1

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
guides:how_to_install_debian_on_olpc_xo-1 [2024-09-18 20:50]
omolini
guides:how_to_install_debian_on_olpc_xo-1 [2024-09-25 04:45] (current)
omolini [Restore apt-get functionality for "etch"]
Line 1: Line 1:
 ====== How to install Debian GNU/Linux on OLPC XO-1 ====== ====== How to install Debian GNU/Linux on OLPC XO-1 ======
-This guide will guide you through the steps of installing Debian GNU/Linux "​etch"​ on an OLPC XO-1, and get it online with functioning apt package system. ​+This guide (updated 2024) will guide you through the steps of installing Debian GNU/Linux "​etch"​ on an OLPC XO-1 in a dual-boot configuration, and get it online with functioning apt package system. ​
  
 From there you can install a windowing system, or upgrade your edition of Debian. From there you can install a windowing system, or upgrade your edition of Debian.
Line 10: Line 10:
 ===== Install Debian as a dual-boot OS ===== ===== Install Debian as a dual-boot OS =====
  
-Follow the steps outlined here: [[https://​wiki.laptop.org/​go/​Installing_Debian_as_an_upgrade|Installing Debian as an upgrade]] [[https://​web.archive.org/​web/​20231013052312/​https://​wiki.laptop.org/​go/​Installing_Debian_as_an_upgrade|mirror of aforementioned document]]+Follow the steps outlined here: [[https://​wiki.laptop.org/​go/​Installing_Debian_as_an_upgrade|Installing Debian as an upgrade]] [[https://​web.archive.org/​web/​20231013052312/​https://​wiki.laptop.org/​go/​Installing_Debian_as_an_upgrade|mirror of aforementioned document]]. Please note the changes for some steps you may need to follow outlined below.
  
-Note!+==== Changes to documentation ====
  
 In **Step 1**, if you do not have a pre-existing Debian system, you may want to download a prebuilt bootstrap package: In **Step 1**, if you do not have a pre-existing Debian system, you may want to download a prebuilt bootstrap package:
-[[http://​omolini.steptail.com/​olpc/​xo-debian.tgz|xo-debian.tgz]] ​Shift-click and select ​Save As if the file doesn'​t download automatically.+[[http://​omolini.steptail.com/​olpc/​xo-debian.tgz|xo-debian.tgz]] ​Right-click ​the link and shift-click "Save As" ​if the file doesn'​t download automatically.
  
 +In **Step 2**, the TAR command will probably not work as documented. Use the following command instead:
 +<code bash>
 +# tar xvf /​media/​*/​xo-debian.tgz
 +</​code>​
  
 +===== Connect to your WI-FI network =====
  
 +  * Boot into Debian and log-in as root. 
 +
 +==== Option 1: Unencrypted WI-FI network ====
 +
 +  * Run the following commands:
 +
 +<code bash>
 +$ modprobe usb8xxx
 +$ iwconfig eth0 essid "<​SSID>"​
 +</​code>​
 +
 +Replace <​SSID>​ and <​PASSWORD>​ with respective values
 +
 +==== Option 2: WEP encrypted WI-FI network ====
 +
 +  * Run the following commands:
 +
 +<code bash>
 +$ modprobe usb8xxx
 +$ iwconfig eth0 essid "<​SSID>"​ key "​s:<​PASSWORD>"​
 +</​code>​
 +
 +Replace <​SSID>​ and <​PASSWORD>​ with respective values
 +
 +==== Option 3: WPA or WPA2 encrypted WI-FI network ==== 
 +
 +  * Copy to root of a FAT32 formatted USB stick the following files. You can download them [[http://​omolini.steptail.com/​olpc/​|from here]] or [[https://​archive.debian.org/​debian/​pool/​main/​|here]].
 +
 +  1. wpasupplicant_05.5.5-2_i386.deb ​
 +  2. libdbus-1-3_1.0.2-1+etch3_i386.deb
 +
 +  * Connect USB stick to OLPC and mount it:
 +
 +<code bash>
 +$ mkdir /media/usb
 +$ mount -t vfat /dev/sda1 /media/usb
 +</​code>​
 +
 +  * Replace /dev/sda1 with the location of the USB stick'​s filesystem
 +  * Install packages:
 +
 +<code bash>
 +$ cd /media/usb/
 +$ dpkg --install wpasupplicant_05.5.5-2_i386.deb ​
 +$ dpkg --install libdbus-1-3_1.0.2-1+etch3_i386.deb
 +</​code>​
 +
 +  * Create wpa_supplicant.conf:​
 +
 +<code bash>
 +$ wpa_passphrase "<​SSID>"​ "<​PASSWORD>"​ | tee /​etc/​wpa_supplicant.conf
 +</​code>​
 +
 +  * Replace <​SSID>​ and <​PASSWORD>​ with respective values
 +  * Add the following lines to /​etc/​network/​interfaces:​
 +
 +  auto lo
 +  iface lo inet loopback
 +
 +  * Connect to WIFI:
 +
 +<code bash>
 +$ modprobe usb8xxx
 +$ wpa_supplicant -B -Dwext -c /​etc/​wpa_supplicant.conf -i eth0
 +$ dhclient eth0
 +</​code>​
 +
 +  * Test by pinging **8.8.8.8** and **www.google.com**
 +  * If previous test worked, automate WIFI connection on startup by first creating **/​root/​wifion.sh**:​
 +
 +<code bash>
 +#!/bin/bash
 +#
 +wpa_supplicant -B -Dwext -c /​etc/​wpa_supplicant.conf -i eth0
 +dhclient eth0
 +</​code>​
 +  ​
 +
 +  * Then make it executable:
 +
 +
 +<code bash>
 +$ chmod 770 wifion.sh
 +</​code>​
 +
 +  * Create symbolic link to **wifion.sh** to run on bootup:
 +
 +<code bash>
 +$ ln -s /​root/​wifion.sh /​etc/​rc2.d/​S99wifion
 +</​code>​
 +
 +==== Restore apt-get functionality for "​etch"​ ====
 +
 +  * Open /​etc/​apt/​sources.list and replace the first line with the following:
 +
 +  deb http://​archive.kernel.org/​debian-archive/​debian etch main
 +
 +  * Run the following commands:
 +
 +<code bash>
 +$ aptitude install debian-archive-keyring
 +$ apt-get update
 +</​code>​
 +
 +From here you can install the rest of the system, windowing manager etc. Don't forget to set your root password!
 +
 +To boot up back into Sugar OS, just hold the "​O"​ game-key button when powering on the unit.
 +
 +{{tag>​Guides Guides:​Software Guides:"​OLPC XO-1"​}}
guides/how_to_install_debian_on_olpc_xo-1.1726692658.txt.gz · Last modified: 2024-09-18 20:50 by omolini