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:55] 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 19: | Line 19: | ||
In **Step 2**, the TAR command will probably not work as documented. Use the following command instead: | In **Step 2**, the TAR command will probably not work as documented. Use the following command instead: | ||
<code bash> | <code bash> | ||
- | # tar xzf /media/*/xo-debian.tgz | + | # tar xvf /media/*/xo-debian.tgz |
</code> | </code> | ||
- | ===== To connect to WIFI (unencrypted or WEP) ===== | + | ===== Connect to your WI-FI network ===== |
* Boot into Debian and log-in as root. | * Boot into Debian and log-in as root. | ||
+ | |||
+ | ==== Option 1: Unencrypted WI-FI network ==== | ||
+ | |||
* Run the following commands: | * Run the following commands: | ||
<code bash> | <code bash> | ||
- | $ modprobe usb8xxx | + | $ modprobe usb8xxx |
- | $ iwconfig eth0 essid "<SSID>" key "s:<PASSWORD>" | + | $ iwconfig eth0 essid "<SSID>" |
</code> | </code> | ||
Replace <SSID> and <PASSWORD> with respective values | Replace <SSID> and <PASSWORD> with respective values | ||
- | To connect to WIFI (WPA or WPA2): | + | ==== Option 2: WEP encrypted WI-FI network ==== |
- | --------------------------------- | + | |
- | - Copy to root of a FAT32 formatted USB stick: | + | |
- | 1. wpasupplicant_05.5.5-2_i386.deb | + | * Run the following commands: |
- | 2. libdbus-1-3_1.0.2-1+etch3_i386.deb | + | |
- | - Connect USB stick to OLPC and mount it: | + | <code bash> |
+ | $ modprobe usb8xxx | ||
+ | $ iwconfig eth0 essid "<SSID>" key "s:<PASSWORD>" | ||
+ | </code> | ||
- | $ mkdir /media/usb | + | Replace <SSID> and <PASSWORD> with respective values |
- | $ mount -t vfat /dev/sda1 /media/usb | + | |
- | - Install packages: | + | ==== Option 3: WPA or WPA2 encrypted WI-FI network ==== |
- | $ cd /media/usb/ | + | * 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]]. |
- | $ dpkg --install wpasupplicant_05.5.5-2_i386.deb | + | |
- | $ dpkg --install libdbus-1-3_1.0.2-1+etch3_i386.deb | + | |
- | - Create wpa_supplicant.conf: | + | 1. wpasupplicant_05.5.5-2_i386.deb |
+ | 2. libdbus-1-3_1.0.2-1+etch3_i386.deb | ||
- | $ wpa_passphrase "<SSID>" "<PASSWORD>" | tee /etc/wpa_supplicant.conf | + | * Connect USB stick to OLPC and mount it: |
- | Replace <SSID> and <PASSWORD> with respective values | + | <code bash> |
+ | $ mkdir /media/usb | ||
+ | $ mount -t vfat /dev/sda1 /media/usb | ||
+ | </code> | ||
- | - Add the following lines to /etc/network/interfaces: | + | * Replace /dev/sda1 with the location of the USB stick's filesystem |
+ | * Install packages: | ||
- | auto lo | + | <code bash> |
- | iface lo inet loopback | + | $ 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> | ||
- | - Connect to WIFI: | + | * Create wpa_supplicant.conf: |
- | $ modprobe usb8xxx | + | <code bash> |
- | $ wpa_supplicant -B -Dwext -c /etc/wpa_supplicant.conf -i eth0 | + | $ wpa_passphrase "<SSID>" "<PASSWORD>" | tee /etc/wpa_supplicant.conf |
- | $ dhclient eth0 | + | </code> |
- | - Test by pinging 8.8.8.8 and www.google.com | + | * Replace <SSID> and <PASSWORD> with respective values |
+ | * Add the following lines to /etc/network/interfaces: | ||
- | - If previous test worked, automate WIFI connection on startup: | + | auto lo |
+ | iface lo inet loopback | ||
- | Create /root/wifion.sh: | + | * Connect to WIFI: |
- | #!/bin/bash | + | <code bash> |
- | # | + | $ modprobe usb8xxx |
- | wpa_supplicant -B -Dwext -c /etc/wpa_supplicant.conf -i eth0 | + | $ wpa_supplicant -B -Dwext -c /etc/wpa_supplicant.conf -i eth0 |
- | dhclient 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> | ||
| | ||
- | Make executable: | ||
- | $ chmod 770 wifion.sh | + | * Then make it executable: |
- | Create symbolic link to wifion.sh: | ||
- | $ ln -s /root/wifion.sh /etc/rc2.d/S99wifion | + | <code bash> |
+ | $ chmod 770 wifion.sh | ||
+ | </code> | ||
- | Restore apt-get functionality for "etch": | + | * Create symbolic link to **wifion.sh** to run on bootup: |
- | ----------------------------------------- | + | |
- | - Open /etc/apt/sources.list and replace the first line with the following: | + | <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 | deb http://archive.kernel.org/debian-archive/debian etch main | ||
- | - Run the following commands: | + | * 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! | ||
- | $ aptitude install debian-archive-keyring | + | To boot up back into Sugar OS, just hold the "O" game-key button when powering on the unit. |
- | $ apt-get update | + | |
+ | {{tag>Guides Guides:Software Guides:"OLPC XO-1"}} |