XS Community Edition/0.3/Installing

From OLPC
< XS Community Edition‎ | 0.3
Revision as of 21:44, 10 May 2013 by Timmoody (talk | contribs) (Prereqs)
Jump to: navigation, search

Prereqs

This recipe installs XS Community Edition on an XO running OLPC OS 13.1.0 (http://wiki.laptop.org/go/Release_notes/13.1.0). It assumes that the XO will have two network connections, one for the Internet and one for client XOs.

During the install process, your XS server must be connected to the Internet either via its built-in Wifi adapter/ears or through a USB Ethernet Adapter. This will be the way that the server talks to the Internet.

In order for the server to be able to talk to XOs it will need a USB ethernet adaptor connected to a separate Wifi access point (call it AP-LAN) so kids' XOs can later connect their XOs to the server.

Repeat any of the download steps below if they fail due to Internet/DNS glitches.

Installing

  1. Turn power management off within My Settings | Power. (This is not required but will make life easier as the machine will not turn off.)
  2. Ensure USB Ethernet Adapters are connected.
  3. Launch Terminal Activity (unhide Terminal if necessary, clicking List View in the top right of Home View).
  4. Go to 'my neighborhood' and connect to internet.
  5. Change to user root by typing "su".
  6. Make sure the date and time are set correctly. If not set it manually using "date mmddhhmmyyyy" where mm=month, dd=day, hh=hour, mm=minute, yyyy=year. This is required for yum to work correctly.
  7. Change directory by typing "cd /etc/yum.repos.d"
  8. Download the needed yum repo by typing "wget http://xsce.activitycentral.com/repos/xsce-release.repo".
  9. Install xs-config-xo by typing "yum -y install xs-config-xo" (downloads 17+ MB).
  10. Type "bootstrap-xo" (downloads 34+ MB).
  11. Press [Enter] to reboot.
  12. Launch Terminal Activity.
  13. Change to user root by typing "su".
  14. Type the command "xs-setup" . This generates a long list of "yum" install requests, similar to the normal adding of functions that you would do if you loaded a minimal "network" install CD from Fedora, and then added additional functions one at a time. (downloads 200+ MB)
  15. "INSERT USB ETHERNET ADAPTER NOW" warning will appear. Insert it as instructed.
    Type "y" to continue. 40+ minutes later, your XS should return to a root prompt with the message "XS configured; services are ready to use." (downloads about 200 MB !)
  16. Remove any USB Ethernet Adapter
  17. Reboot.
  18. Re-insert USB Ethernet Adapter.