User:Holt/XS Community Edition/Install Recipe

NOTE: The contents of this page are not set in stone, and are subject to change! This page is a draft in active flux ... Please leave suggestions on the talk page.

This recipe installs XS Community Edition on XO-1.5 (i386) or XO-1.75 (ARM). Other Fedora platforms will be supported later, such as XO-4 and larger servers. XO-1 is NOT supported as memory/disk are insufficient. Later, prefab USB images for offline install should be provided for a few common cases.

To begin, your XO/XS must connect to the Internet using its built-in Wifi adapter/ears, or using a 3G/cellular adapter (untested). WARNING: Your XO/XS may NOT connect to the Internet thru a USB Ethernet adapter during the current installation process, as described below.

You will however need a USB Ethernet adapter (most will work, verify it's compatible with Fedora 17) and Wifi access point so kids' XOs can later connect the XS.

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-1.5 or XO-1.75 software at http://wiki.laptop.org/go/Release_notes/12.1.0
2. Turn off automatic power management within My Settings | Power.
3. Connect your XO-1.5 or XO-1.75 to high-speed Internet (built-in Wifi or 3G/cellular adapter). Installing via wireline USB Ethernet adapter is NOT currently supported.
4. Ensure USB Ethernet Adapters are NOT connected to your XO!
5. Make the Terminal Activity a favorite (hidden down in List view of activities, where you highlight this activity's "star").
   Launch Terminal Activity, change to user root by typing "su".
6. Getting from yum repos will require setting the GMT date -- type "date mmddhhmmyyyy" where mm=month, dd=day, hh=hour, mm=minute, yyyy=year.
7. Type "cd /etc/yum.repos.d"
8. Repeat any of the download steps below if they fail due to Internet/DNS glitches.
9. Type "wget http://georgejhunt.com/olpc/files/xsce.repo" (downloads 200+ bytes)
10. Type "yum -y install xs-config-xo" (downloads 17+ MB)
11. Type "bootstrap-xo" (downloads 34+ MB)
12. Press [Enter] to reboot.
13. 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)
14. "INSERT USB ETHERNET ADAPTER NOW" warning will appear. While optional, this configuration step is critical for those using an USB Ethernet adapter to connect to their LAN/Intranet.
    Type "y" to continue.
15. 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 !)
    Remove any USB Ethernet adapter (XO-1.5s require this prior to booting!)
    Reboot for good measure (ejabberd will take a long time to boot, let it run).
    Re-insert any USB Ethernet adapter.
16. 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 adapter above (serving the LAN/Intranet) also take note of the school server's eth1-ip-address = LAN-ip = 172.18.96.1
17. 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)
18. Test the XS/XO web server by pointing its own Browse activity to http://<WAN-ip>/top or http://172.18.96.1/top or http://localhost/top.
    Verify the (typically green) web control panel appears with all 3 URLs ideally.
19. Also try another web browser on the WAN with http://<WAN-ip>/top or on the LAN with http://172.18.96.1/top
20. 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 adapter).
21. 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)

Further Quick Testing

1. Register the XO/XS to itself. From the Home view, right-click on the XO Icon and left-click on "Register". Make sure it responds "Registration Successful".
2. Open Browse activity, and try Moodle by clicking on "Local schoolserver" which tests the URL http://schoolserver (which should redirect to a longer URL) showing "Welcome to Moodle" logged in as your own XO username, with "Course Creator" privileges.
3. Test Squid: open Browse on a client XO and visit a web page. Check the traffic is being recorded in XS file: /var/log/squid/access.log
4. Test VNC's enabling and disabling of services. EG. from the XS browse to http://localhost/top then click on "Setup" in the top-left and try clicking on "Internet" near the top of the left frame.
   Click "Desktop" in the upper-right to bring up VNC.
   Unlock the screensaver using username "vnc" and password "*vnc4u*"
   Click "Use default config"
   Turn off screensaver under Applications Menu -> Settings -> Screensaver.
5. Try other classic XS features: http://wiki.laptop.org/go/XS_Troubleshooting