This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
guides:how_to_install_debian_on_olpc_xo-1 [2024-09-18 20:46] 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|archive mirror]]) | + | 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. |
+ | ==== 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]] 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"}} |