XS Community Edition/5.0/Installing: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
m (moved XS Community Edition/0.5/Installing to XS Community Edition/5.0/Installing: irc & voice meeting consensus over the past week)
 
(4 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{draft}}
{{draft}}


This is a draft pending release of XSCE 0.5 which is renamed 5.0.
''''' EVOLVING FROM ANNA'S: https://github.com/XSCE/xsce/blob/master/docs/INSTALL.rst [Tim Moody says Anish working on this Early December 2013] '''''


= Installation Overview =
Thank you for [[../Testing|testing]] as progress moves quickly [[../Testing/Results|reinforcing support across x86, XO-1.5, XO-1.75, XO-4, x86, Trim-Slice and Raspberry Pi]] towards our [[../Road Map|imminent release]].


XSCE 5.0 is the first release to use github (https://github.com/XSCE/xsce) for source control and ansible as a means of installation.
If you are installing on an XO, you may choose to install from an [[#Offline_Install_on_XO.27s_-_download_an_image|(1) Offline Image (preferred)]] or the more traditional [[#Online_Install_on_XO.27s|(2) Online Install method]].


Thank you for [[../Testing|testing]] and providing feedback.
If you are installing on a non-XO, please read our growing community-contributed collection of [[#Install_Recipes_for_Non-XO_Hardware|(3) Install Recipes]].


= Installing on XO-4, XO-1.75, or XO-1.5 =
(might also clone XSCE from one XO to another, see [[Firmware/Storage]] for the fs-save and fs-load commands, and [[Tiny Core Linux]] for tools to use Linux for the task, and [[Backup]]. --[[User:Quozl|Quozl]] 08:31, 22 August 2013 (UTC))
= Offline Install on XO's - download an image =
{{TOCright}}


The documentation in the github repository is the best and most detailed guide to installing on an XO. Please read the section on automatic network detection as it will determine whether the XSCE server is configured as a gateway or as a standalone appliance.
== Prerequisites ==


The documentation may be found at https://github.com/XSCE/xsce/blob/master/docs/INSTALL.rst.
* a [[USB drive]] of 2GB or greater
* an [[XO-1.5]], [[XO-1.75]] or [[XO-4]]


= Install Recipes for Non-XO Hardware =
(On [[XO-1]] laptops, XSCE remains highly experimental due to fundamental hardware limitations.)


Professional volunteers are strongly encouraged to reinforce support for other hardware platforms running Fedora 18. Each of these other platforms installs in an almost identical fashion except that there is no need for a reboot and there is usually no power management to deal with. As in the case of an XO make sure your Ethernet adapters are connected before starting the install. Simply follow each step listed for an XO.
== Install Steps ==


For now we have:
#Download a .zd file from http://build.laptop.org.au/xsce/RC1/ and copy it to a USB stick with at least 2GB of free space.
#Download an additional zip file and unzip it onto a USB key from http://build.laptop.org.au/xsce/RC1/xs-repo.zip. This will enable completely offline installs
#Install with {{Code|"fs-update u:\<file>.zd"}}, (at the firmware "ok" prompt, you can list the contents of USB with {{Code|dir u:\|}}). see also [[Firmware/Storage#How_to_install_to_SD_card|How to install to SD card]] for instructions on how to install to an external SDcard.)
#Reboot with {{Code|bye|}}
#login (just press the {{Code|enter|}} key)
'''If you need to configure wifi access to the internet:'''
#{{Code|telinit 5}}
#configure WiFi in the neighbourhood view
#open the terminal activity
#type {{Code|su|}}
#{{Code|ping google.com|}}
#reboot
#login (just press the {{Code|enter|}} key)
'''If you have internet access via an ethernet dongle:'''
#{{Code|ping google.com|}}
'''Then:'''
#Ensure your usb flashdrive that you unzipped xs-repo.zip to is inserted in the XO
#{{Code|xs-setup}} or {{Code|xs-setup <domain> | tee -a screen-log.txt}}
#Reboot and inspect

== NOTES about Offline Installs ==
* Stripped out content and a limited set of activities
* {{Code|ds-backup-client}} and {{Code|olpc-update-query}} are disabled
* TinyCore's xo-custom files
* All of stats' dependencies pre-installed
* Pathagar
* Internet-in-a-Box (IIAB) e.g. partial dataset for testing: http://downloads.internet-in-a-box.org/IIAB_QuickStart_Sampler_20130809.tgz
* IIAB, xs-extras, and release-0.4-fixes repo files are pre-installed nothing to add to get newer rpms.
* For a complete list of rpms installed see the *packages.txt in the same directory. Now only 2 rpms (dhcpd and ejabberd) get installed later either online or from the optional usbkey. Warning the installed size is now ~2.4Gb up from ~1.9Gb.

= Online Install on XO's =

This is the traditional install method, variations of which supporting most all hardware running Fedora 18. It had been the only available install method for [[../../0.3|version 0.3]], earlier in 2013.

== Prereqs ==

This recipe installs XS Community Edition on an XO-1.5, XO-1.75 or XO-4 running OLPC OS [[Release_notes/13.2.0|13.2.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.

== Install Steps ==

#If connecting to the Internet via WiFi, go to 'Neighborhood View' and select a wireless network to connect to the Internet.
#From the XO Home screen, go to Settings, select "Power," then uncheck "Automatic power management."
#Ensure one or two USB Ethernet Adapters are connected, see above.
#Launch Terminal Activity (unhide Terminal if necessary, clicking List View in the top right of Home View).
#Change to user root by typing {{Code|su}}.
#Make sure the date and time are set correctly by typing {{Code|date}} at the command prompt. If it is not, set it manually using {{Code|date mmddhhmmyyyy}} where mm=month, dd=day, hh=hour, mm=minute, yyyy=year. This is required for yum to work correctly.
#Confirm your connectivity to the Internet by typing {{Code|ping google.com|}}
#Change directory by typing {{Code|cd /etc/yum.repos.d}}.
#Download the needed yum repo by typing {{Code|wget http://xsce.activitycentral.com/repos/xsce-rel4.repo}}.
#Ensure you can access all the repos with {{Code|yum repolist}} (can be repeated if an error occurs.)
#Install xs-config-xo by typing {{Code|yum -y install xs-config-xo}}. (If you are installing on an XO-1, type {{Code|yum -y install xs-config-xo1}}). See [[Installing_XSCE_on_an XO1|Installing XSCE on an XO1]].
#Type {{Code|bootstrap-xo}} to configure the XO with software necessary to install the school server.
#When you are prompted, Press [Enter] to reboot.
#When you are prompted, Press [Enter] to log in as root.
#Type the command {{Code|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.
#At the end the install script will declare, "XS configured; Ready to reboot and use."
#Type {{Code|reboot}}.
#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 {{Code|xs-setup-network}}.

= Install Recipes for Non-XO Hardware =

Professional volunteers are strongly encouraged to reinforce support for other hardware platform running Fedora 18. For now we have:


== Intel i386, i686, X86_64 ==
== Intel i386, i686, X86_64 ==
#Install FC18 onto your machine or vm. The minimal install is sufficient.
#Ensure one or two Ethernet Adapters are connected, (2 required for internet gateway functions).
#Ensure your Ethernet adapter(s) are connected.
#Ensure you are root
#Ensure you are root
#Follow the instructions for an XO mentioned above.
#Change directory by typing {{Code|cd /etc/yum.repos.d}}.
#Download the needed yum repo by typing {{Code|wget http://xsce.activitycentral.com/repos/xsce-rel4.repo}}.
#Install xs-config by typing {{Code|yum -y install xs-config}}.
#type {{Code|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.

#At the end the install script will declare, "XS configured; Ready to reboot and use."
#Type {{Code|reboot}}.


== Trim-Slice ==
== Trim-Slice ==
Line 110: Line 35:
# I found it necessary, during installs, to use a serial to usb adapter, and an XO running minicom (for me this uses /dev/ttyUSB0 115200).
# I found it necessary, during installs, to use a serial to usb adapter, and an XO running minicom (for me this uses /dev/ttyUSB0 115200).
# edit the {{Code|/boot/boot.scr}} as per instructions for USB/SATA, put the hard drive in the Trim-Slice, and boot
# edit the {{Code|/boot/boot.scr}} as per instructions for USB/SATA, put the hard drive in the Trim-Slice, and boot
# Now follow the instructions for an XO mentioned above.
# Change directory by typing {{Code|cd /etc/yum.repos.d}}.
# Download the needed yum repo by typing {{Code|wget http://xsce.activitycentral.com/repos/xsce-rel4.repo}}.
#Change back to the root directory -- {{Code|cd}}.
#Type the command {{Code|yum -y install xs-config-ts}}.
#Then type {{Code|bootstrap-ts 2>&1 | tee -a boot.log}} 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. In case there are problems, the file {{Code|/root/boot.log}} will help with diagnosis.
#At the end the install script will declare, "XS configured; Ready to reboot and use."
#Type {{Code|reboot}}.


== Raspberry Pi ==
== Raspberry Pi ==


Installation on the Raspberry Pi is experimental.
# Download the image from http://xsce.activitycentral.com/downloads/rpi-xsce-0.4-1.img.gz, and the rpi-xsce-0.4-1.img.md5sum (-1,-2,-3, etc will include more recent fixes).
# Gunzip the <xxxx.img.gz> file.
# Run md5sum on the expanded .img file and compare with {{Code|cat < rpi-xsce...img.md5sum}}.
# Determine the /dev/<name> of the SD card you want to use with the Raspberry Pi.
# Use {{Code|dd}} to write the image to the SD card: <code>dd if=<file name> of=</dev/name></code> (probably /dev/sdb or mmcblk0). Don't include the "p1,p2" because the partition table gets written by the image.
# The image was created with an unprivileged user "admin" and a password of "12admin". If you don't have USB keyboard, mouse, and digital monitor, you can ssh in with these credentials. Sometimes you can view the IP addresses passed out by your router with a web browser to get the the Raspberry Pi's IP address.
# Root password is "fedora". Change this if you have pranksters in your vicinity by becoming root, and using command line "passwd".
# Change to user root by typing {{Code|su}}. enter the password for root
# It's recommended to resize the SD card partition to it's maximum available size. GParted or a similar tool would do the trick.
# type {{Code|xs-setup-network}}


# Install FC18 on the raspi following instructions for Pidora at http://zenit.senecac.on.ca/wiki/index.php/Pidora_Installation.
'''To test the latest code:'''
#Ensure your Ethernet adapter(s) are connected.
# Change directory by typing {{Code|cd /etc/yum.repos.d}}.
#Ensure you are root
# type {{Code|rm xs-devel.repo}} when prompted type {{Code|y}}
#Follow the instructions for an XO mentioned above.
# Download the needed yum repo file by typing {{Code|wget http://xsce.activitycentral.com/repos/xsce-rel4.repo}}.
# Ensure you can access all the repos with {{Code|yum repolist}} (can be repeated if an error occurs.)
# type {{Code|yum update xs-config}}
# type {{Code|xs-setup}}


CAVEATS: Raspberry Pi is armv6 architecture, and XO is armv7hl. Some rpm packages are not available in the required form and some functions will have incomplete support. i.e:
CAVEATS: Raspberry Pi is armv6 architecture, and XO is armv7hl. Some rpm packages are not available in the required form and some functions will have incomplete support. i.e:

Latest revision as of 15:34, 16 January 2014

This IIAB XSCE content does not reflect the opinion of OLPC. These pages were created by members of a volunteer community supporting OLPC and deployments.


Pencil.png 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.

Pencil.png

This is a draft pending release of XSCE 0.5 which is renamed 5.0.

Installation Overview

XSCE 5.0 is the first release to use github (https://github.com/XSCE/xsce) for source control and ansible as a means of installation.

Thank you for testing and providing feedback.

Installing on XO-4, XO-1.75, or XO-1.5

The documentation in the github repository is the best and most detailed guide to installing on an XO. Please read the section on automatic network detection as it will determine whether the XSCE server is configured as a gateway or as a standalone appliance.

The documentation may be found at https://github.com/XSCE/xsce/blob/master/docs/INSTALL.rst.

Install Recipes for Non-XO Hardware

Professional volunteers are strongly encouraged to reinforce support for other hardware platforms running Fedora 18. Each of these other platforms installs in an almost identical fashion except that there is no need for a reboot and there is usually no power management to deal with. As in the case of an XO make sure your Ethernet adapters are connected before starting the install. Simply follow each step listed for an XO.

For now we have:

Intel i386, i686, X86_64

  1. Install FC18 onto your machine or vm. The minimal install is sufficient.
  2. Ensure your Ethernet adapter(s) are connected.
  3. Ensure you are root
  4. Follow the instructions for an XO mentioned above.

Trim-Slice

  1. The internal ethernet is configured as external internet connection and wifi is enabled as lan connection, (a second USB adapter required for connection to additional wifi access points).
  2. Grab the Fedora 18 Trim-Slice image at http://fedoraproject.org/wiki/Architectures/ARM/F18/Trimslice -- use the armhfp version. (I needed to yum -y install xz to follow the xzcat <image> > <device> instructions).
  3. For a while I used a SATA hard drive adapter to initialize the hard drive. Later I have started to use the Trim-Slice kernel made for flashing the internal uboot loader, which installs on an SD card, and can write the SATA drive in place.
  4. I found it necessary, during installs, to use a serial to usb adapter, and an XO running minicom (for me this uses /dev/ttyUSB0 115200).
  5. edit the /boot/boot.scr as per instructions for USB/SATA, put the hard drive in the Trim-Slice, and boot
  6. Now follow the instructions for an XO mentioned above.

Raspberry Pi

Installation on the Raspberry Pi is experimental.

  1. Install FC18 on the raspi following instructions for Pidora at http://zenit.senecac.on.ca/wiki/index.php/Pidora_Installation.
  2. Ensure your Ethernet adapter(s) are connected.
  3. Ensure you are root
  4. Follow the instructions for an XO mentioned above.

CAVEATS: Raspberry Pi is armv6 architecture, and XO is armv7hl. Some rpm packages are not available in the required form and some functions will have incomplete support. i.e:

  1. Stats
  2. Internet-In-A-Box
  3. ejabberd