XS Community Edition/0.3/Installing

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.

You will need almost an 8gb hard disk in order to proceed with the installation. If the internal hard disk is less than that, you can use a sdcard to install the system, check the following instructions: http://activitycentral.com/community/news/installing-os-sd-card

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. PLEASE NOTE: It is entirely possible to use an old router as an access point for the AP-LAN. BUT in order to do this, place a piece of tape over the WAN port of the router, and use the configuration mechanism of the router to turn of the internal DHCP server inside the router (The DHCP service must come from the XSCE for the system to work correctly).

If you want an SD card for schoolserver storage, put the empty, vfat formatted SD card into the machine before starting the install process (may work if installed later -- but not tested, nor guaranteed). SD cards come from the factory vfat formatted.

If you have difficulty, please enter a bug report.

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. If connecting to the Internet via WiFi, go to 'my neighborhood' and select a wireless network to connect to the Internet.
3. Ensure one or two USB Ethernet Adapters are connected, see above.
4. Make sure that the USB stick you use to flash the XO is removed (this release will fail if USB is present).
5. Launch Terminal Activity (unhide Terminal if necessary, clicking List View in the top right of Home View).
6. Change to user root by typing "su".
7. Make sure the date and time are set correctly by typing "date" at the command prompt. If it is 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.
8. Confirm your connectivity to the Internet by typing "yum repolist" (can be repeated if an error occurs.)
9. Change directory by typing "cd /etc/yum.repos.d"
10. Download the needed yum repo by typing "wget http://xsce.activitycentral.com/repos/xsce-release.repo".
11. Install xs-config-xo by typing "yum -y install xs-config-xo".
12. (SD CARD?) if you want your XSCE server to use the storage on an SD card for content, swap file, Activity-server, put the device into the XO and run "prep-storage.sh" NOW! (Note: upgrading to 13.2.0 will break this feature -- firmware related, so reinstalling 13.1.0 will still be broken, unless firmware is also reverted)
13. Type "bootstrap-xo" to configure the XO with software necessary to install the Schoolserver.
14. When you are prompted, Press [Enter] to reboot. (after the reboot, expect to continue in "text mode" rather than windows)

    ---

15. When you are prompted, Press [Enter] to log in as root.
16. 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.
17. At the end the install script will declare, "XS configured; services should be active."
18. When you are prompted, Press [Enter] to log in as root.
19. Type "reboot".
20. Note that if during testing the networking seems not to be working (and you are sure that access points are set up correctly) it is possible to reconfigure the network by typing the command "xs-setup-network".
21. During the install, the graphical user interface (GUI) is turned off, in order to use valuable memory for server functions. If you need the GUI for setting up another access point, or other reasons, you can get the GUI back (until the next reboot) using the terminal command "init 5".
22. Good server practice is to use "passwd" to apply a root password at the time of first install.