User:Holt/XS Community Edition/Install Recipe

From OLPC
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 a USB Ethernet dongle (eg. for LAN/Intranet Wifi).

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!

  1. Start with the released version of XO software at http://wiki.laptop.org/go/Release_notes/12.1.0#XO-1.75</a>
  2. Turn off automatic power management within My Settings | Power.
  3. 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.
  4. 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".
  5. Getting from yum repos will require setting the GMT date -- type "date mmddhhmmyyyy" where mm=month, dd=day, hh=hour, mm=minute, yyyy=year.
  6. Type "cd /etc/yum.repos.d"
  7. Repeat any of the download steps below if they fail due to Internet/DNS glitches.
  8. Type "wget http://georgejhunt.com/olpc/files/myrepo/xs-arm.repo" (downloads 200+ bytes)
  9. Type "yum -y install xs-config-xo" (downloads 17+ MB)
  10. Type "bootstrap-xo" (downloads 33+ MB)
  11. Press [Enter] to reboot.
  12. Then, again in Terminal 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)
  13. "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.
  14. 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. (ejabberd takes a long time. Let it run)
  15. 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
  16. If you inserted the Ethernet USB dongle above, configure its own Wifi Access Point (AP) to properly serve other LAN/Intranet client XOs. (If the Wifi AP is a router, DO NOT plug into its "WAN" port -- instead use any of its LAN/normal ports. And be sure to enable the AP's "bridge mode" or similar, to disable the AP's own DHCP)
  17. 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.
  18. Also try another web browser on the WAN with http://<WAN-ip>/top/en or LAN with http://172.18.96.1/top/en
  19. 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).
  20. 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. [PENDING FIX OF MASQUERADING BY NOV 15 HOPEFULLY!]


(all above evolving; copied from http://schoolserver.wordpress.com/xs-installation/community-edition-xs-on-xo-1-75/ on Nov 13, 2012)