View source for User:Holt/XS Community Edition/0.2/Installing

XS-CE 0.2 will run on XO 1.75.

===XO 1.75 Install===

====Prereqs====
This recipe installs XS Community Edition on XO-1.75 (ARM) running OLPC OS 12.1.0 (http://wiki.laptop.org/go/Release_notes/12.1.0) with power management turned off within My Settings | Power.

During the install process, your XS server must be connected to the Internet, via its built-in Wifi adapter/ears (it may NOT connect to the Internet thru a USB Ethernet Adapter during your install).  After the install process, your XS server may connect to the Internet using others mean.

Also required is a [[USB ethernet adaptors|USB Ethernet Adapter]] 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====
<ol>
  <li>Ensure that the USB Ethernet Adapter is connected (or at least available, for the "INSERT USB ETHERNET ADAPTER" step below).
  <li>Launch Terminal Activity (unhide Terminal if necessary, clicking List View in the top right of Home View).
  <Li>Change to user root by typing "su".
  <li>Change directory by typing "cd /etc/yum.repos.d" 
  <li>Download the needed yum repo definition by typing "wget http://build.activitycentral.com/xsce.repo".
  <li>Install xs-config-xo by typing "yum -y install xs-config-xo" (downloads 17+ MB).
  <li>Type "bootstrap-xo" (downloads 34+ MB).
  <li>Press [Enter] to reboot.
   
  <li>Launch Terminal Activity.
  <li>Change to user root by typing "su".
  <li>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)
  <li>"INSERT USB ETHERNET ADAPTER NOW" warning will appear (if it was not inserted earlier). Insert it as instructed.<br>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 !)
  <li>Reboot.
</ol>

====setup====
<ol>
  <li>Use "ifconfig" to determine the ip address of the XS.<br>Take note of its eth0-ip-address = WAN-ip.<br>If you've inserted the USB Ethernet Adapter above (serving the LAN/Intranet) also take note of the school server's eth1-ip-address = LAN-ip = 172.18.96.1

  <li>If you inserted the USB Ethernet Adapter 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)