Differences

This shows you the differences between two versions of the page.

--- 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 ======
-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.
@@ Line 10: / Line 10: @@
 ===== 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:
-[[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]].
+. wpasupplicant_05.5.5-2_i386.deb
+. 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"}}

steptail.com

User Tools

Site Tools

Differences

Page Tools