User:Holt/XS Community Edition/Install Recipe
Jump to navigation
Jump to search
Here is a recipe for getting a copy of the XS-arm on a XO-1.75. For now, this XO/XS install method requires DHCP/Internet via the XO's built-in wifi adapter/ears, or from a 3G/cellular dongle. For some of the services to function, you will need an Ethernet dongle.
Please be warned this is an early version--the product of an early focused effort by Jerry Vonau and George Hunt. Still lots of rough edges!
- Start with the released version of XO software at http://wiki.laptop.org/go/Release_notes/12.1.0#XO-1.75</a>
- Turn off automatic power management within My Settings | Power.
- Connect your XO-1.75 to high-speed Internet (built-in Wifi or 3G/cellular dongle). Installing via wireline USB-to-Ethernet dongle is *NOT* currently supported.
- Make the Terminal Activity a favorite (hidden down in List view of activities, where you highlight its "star"). Launch Terminal Activity, change to user "root" by typing "su".
- Getting from yum repos will require setting the GMT date -- type "date mmddhhmmyyyy" where mm=month, dd=day, hh=hour, mm=minute, yyyy=year.
- Type "cd /etc/yum.repos.d"
- Repeat any of the download steps below if they fail due to Internet/DNS glitches.
- Type "wget http://georgejhunt.com/olpc/files/myrepo/xs-arm.repo" (downloads 200+ bytes)
- Type "yum -y install xs-config-xo" (downloads 17+ MB)
- Type "bootstrap-xo" (downloads 33+ MB)
- Press [Enter] to reboot.
- Then, again as root (type "su"), issue the command "xs-setup" . This xs-setup command generates a long list of "yum" install requests, similar to the normal adding of function that you would do if you loaded a minimal "network" install cd from Fedora, and then added additional functions one at a time. (downloads 400+ KB)
- "INSERT DONGLE NOW" warning will appear. While optional, this configuration step is critical for those using an USB Ethernet dongle to connect to their LAN/Intranet. Type "Y" to continue.
- Perhaps 40+ minutes later, your XS should return to a root prompt with the message "XS configured; services are ready to use" indicating success (downloads about 200 MB !) Reboot for good measure.
- Use "ifconfig" to determine the ip address of the XS. Take note of its eth0-ip-address = WAN-ip. If you've inserted the USB Ethernet dongle above (serving the LAN/Intranet) also take note of the school server's eth1-ip-address = LAN-ip = 172.18.96.1
- If you inserted the Ethernet USB dongle above, configure its own Wifi Access Point to properly serve other LAN/Intranet client XOs.
- Test the XS/XO web server by pointing its own Browse activity to http://<WAN-ip>/top/en or http://172.18.96.1/top/en or http://localhost/top/en. Verify the (typically green) web control panel appears with all 3 URLs ideally.
- Also try another web browser on the WAN with http://<WAN-ip>/top/en or LAN with http://172.18.96.1/top/en
- Ping the XS from another computer on the WAN or LAN/Intranet. Then try ssh using unprivileged user "ssh admin@<WAN-ip>" (password=12admin). Early on, I usually come in via the WAN adapter (however sshd is attached to all interfaces-- feel free to ssh to the second interface at 172.18.96.1 if you have attached a USB ethernet dongle).
- The acid test of the XS gateway function is "ping yahoo.com" from other client XOs, making sure they're connected to the XS alone.
(all above evolving; copied from http://schoolserver.wordpress.com/xs-installation/community-edition-xs-on-xo-1-75/ on Nov 13, 2012)