XS Installing Software 0.6: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Split off USB boot instructions)
No edit summary
Line 7: Line 7:
This page describes how to obtain a copy of the [[XS_Server_Software|XS school server software]], load it onto media, and install it onto a system. A more [[XS Software Repositories|complete description of the software repositories]], [[XS_Configuration_Management|configuration information]], and [[Schoolserver_Testing|testing instructions]] are also available.
This page describes how to obtain a copy of the [[XS_Server_Software|XS school server software]], load it onto media, and install it onto a system. A more [[XS Software Repositories|complete description of the software repositories]], [[XS_Configuration_Management|configuration information]], and [[Schoolserver_Testing|testing instructions]] are also available.


This page covers XS 0.5 and newer. For older releases, see [[XS_Installing_Software_0.4]].
=Downloading the System Image=


=Downloading the System Image=
You can obtain the latest image from [http://xs-dev.laptop.org/xs/ http://xs-dev.laptop.org/xs/]:
You can obtain the latest image from [http://xs-dev.laptop.org/xs/ http://xs-dev.laptop.org/xs/]:


Line 15: Line 17:
This can be copied onto a '''CD''' or '''DVD''' using your favorite software.
This can be copied onto a '''CD''' or '''DVD''' using your favorite software.


== Using a USB key/disk for installation ==
It may also be copied onto a '''USB''' key, using the <tt>livecd-tools</tt> provided by Fedora 7:


Using a USB key to install this version of the XS involves several additional steps.
livecd-iso-to-disk OLPC_XS_LATEST.iso /dev/sdb1


* First, copy the installation using the 'mkusbinstall' script you can download [http://dev.laptop.org/git?p=projects/xs-livecd;a=blob;f=util/mkusbinstall;hb=HEAD here] (click on the 'raw' link). Assuming your usb key is /dev/sdb, you can invoke it like this:
where <tt>/dev/sdb1</tt> represents the USB key being copied onto.
mkusbinstall OLPC_XS_LATEST.iso /dev/sdb1

* You may need to configure your machine to boot from USB - see [[XS_Boot_from_USB]] for details.
There is [http://git.fedoraproject.org/git/?p=hosted/livecd a git repository for <tt>livecd-tools</tt>] if you need a different version of the script, or are on a different linux distro.
* Early in the installation , anaconda will say that it cannot find its kickstart file. Change the path from 'cdrom:/anaconda.ks' to 'hd:sdb1:/anaconda.ks'. You will get prompted again for the path to the ISO - set it to device: '/dev/sdb1' and directory: 'iso'. If the machine has more than one hard drive, then the device might be sdc1 instead of sdb1.

==Using an XO to create an installer USB key==

You can use an XO laptop to create an installer key. First, you will need to install some necessary tools on the XO, then download the image, then transfer it to a USB key inserted in the laptop:

sudo yum install livecd-tools
wget http://xs-dev.laptop.org/xs/OLPC_XS_LATEST.iso
sudo livecd-iso-to-disk OLPC_XS_LATEST.iso /dev/sda1


=Installing the Software=
=Installing the Software=
Line 37: Line 32:
The install from a '''CD''' or '''USB''' key will eventually be automatic upon booting. While the install is currently mostly automated (not interactive), it is not performed automatically upon boot.
The install from a '''CD''' or '''USB''' key will eventually be automatic upon booting. While the install is currently mostly automated (not interactive), it is not performed automatically upon boot.


# Boot from the USB Key or CD-ROM -- Getting an older system to boot from a USB key can be difficult, but most will do it.
# Boot from the USB Key or CD-ROM
# Select "Run from Image" at the initial boot screen.
# Select "Install using kickstart" at the initial boot screen.
# '''Note: for most images, the installer will start automatically and proceed to reformat your disk after a few questions. There is currently no option to partition the drive. We're tracking progress on this at https://dev.laptop.org/ticket/7814 '''
# '''Note: the default graphical installer can be instable at times. You can press tab and add 'text' at the end of the line to request the text-based installer.'''
# You will be prompted for the keyboard type, the time zone, and a root password
# Anaconda (the Fedora installer) takes over and you will be prompted for the standard questions - these are preset to the correct defaults for the Scgool Server configuration. You will want to set keyboard type, the time zone, and a root password for your specific system.
# If the disk in the system is new, you may be prompted to OK its formatting.
# When it has finished installing, you will be prompted to reboot. Remove the CD-ROM or USB key after power-down, but before the boot process begins.
# When it has finished installing, you will be prompted to reboot. Remove the CD-ROM or USB key after power-down, but before the boot process begins.


You should now have a school server!
You should now have a school server! It needs initial configuration before it starts providing services to the laptops.


== Initial Configuration ==
[[XS_Boot_from_USB|More info on how to configure your hardware to boot from USB]].


Right after installation, you '''must'''
== Configuration ==
* Set the server domain name using:
[http://dev.laptop.org/git?p=projects/xs-config;a=blob;f=fsroot.olpc.img/etc/sysconfig/olpc-scripts/domain_config;hb=HEAD /etc/sysconfig/olpc-scripts/domain_config] '''example.org'''
* Enable ejabberd on startup, and start it using:
chkconfig --level 345 ejabberd on
service ejabberd start
* Create an account on ejabber for the administrator:
ejabberdctl ejabberd register admin schoolserver.'''example.org''' admin
* Go to the web-based administration interface for ejabberd at <tt>http://schoolserver.example.org:5280/admin/</tt>, or <tt>http://172.18.0.1:5280/admin/</tt> if using an XO or other laptop connected through the LAN interface.
* Login as "admin@schoolserver.example.org" with the password you set when registering (admin).
* Click on "Virtual Hosts", then your hostname, then "Shared Roster". Type "Online" and click Add New.
* Click on "Online" and enter "Online" for Name, "@online@" for Members, and "Online" for Displayed Groups. Click Submit.


===Optional===
The default server setup is to connect to the Internet on the first wired ethernet network interface, using IPv4 DHCP. Laptops connect to the server over the wireless mesh using one or more [[Active Antenna]], connected through USB interfaces. Optional second (and additional) ethernet interfaces are configured by default to provide an internal LAN within the school. Traditional WiFi access points, if used, should be located on this internal LAN. See [[XS Configuration Management]] for details.
* Setup and start [[XS_Configuration_Management#Web_Caching|web caching]] by typing:
[http://dev.laptop.org/git?p=projects/xs-config;a=blob;f=fsroot.olpc.img/etc/sysconfig/olpc-scripts/TURN_SQUID_ON;hb=HEAD /etc/sysconfig/olpc-scripts/TURN_SQUID_ON]


===Network===
To enable external IPv6 you will have to [[XS_Configuration_Management#IPv6|configure the global address of the machine and setup an IPv6 tunnel]].

The default server setup is to connect to the Internet on the '''first wired ethernet network interface''', using IPv4 DHCP. Laptops connect to the server over Acceess Points (APs) connected to the '''second wired ethernet network interface''' or via the wireless mesh using one or more [[Active Antenna]], connected through USB interfaces.

If your XS has 2 network interfaces and you would like to reverse their (WAN, LAN) roles you can use the xs-swapnics utility.

IPv6 is not enabled by default and not needed -- to enable external IPv6 you will have to [[XS_Configuration_Management#IPv6|configure the global address of the machine and setup an IPv6 tunnel]].


== Installing additional software ==
== Installing additional software ==
Line 58: Line 72:
If you wish to install packages that aren't part of the default school server distribution, you should first try using <tt>yum</tt>. The ''stable'' and ''testing'' school server repositories include all packages included in Fedora, even if they aren't installed by default. For third party software you should follow their installation procedure for Fedora 7 or for the XS Server specifically. For example, to install Moodle, follow these instructions: http://docs.moodle.org/en/OLPC_XS_installation#Install_Moodle_from_the_OLPC_XS_Image
If you wish to install packages that aren't part of the default school server distribution, you should first try using <tt>yum</tt>. The ''stable'' and ''testing'' school server repositories include all packages included in Fedora, even if they aren't installed by default. For third party software you should follow their installation procedure for Fedora 7 or for the XS Server specifically. For example, to install Moodle, follow these instructions: http://docs.moodle.org/en/OLPC_XS_installation#Install_Moodle_from_the_OLPC_XS_Image


=Keeping your XS software up to date=
=Upgrading=


Upgrading a server is done using the [http://linux.duke.edu/yum/ <tt>yum</tt>] package interface provided by Fedora.
Upgrading a server is done using the [http://linux.duke.edu/yum/ <tt>yum</tt>] package interface provided by Fedora.

==Over the Internet==


If you have an Internet connection, you can upgrade from the default servers at OLPC, or your own mirrors of them. This is done using yum:
If you have an Internet connection, you can upgrade from the default servers at OLPC, or your own mirrors of them. This is done using yum:


sudo yum -y upgrade
yum -y upgrade

=Upgrading from earlier version of XS=

If you are upgrading from XS 0.4, the process is similar to a new installation, with some minor changes. In the menu shown right after booting, you should choose the (preselected) 'Install with kickstart' option, press the Tab key, and add 'upgradeany' to the boot configuration line. After adding that line, press enter twice.


With this extra option, Anaconda will recognise the old installation and will offer to upgrade.
==From a CD or USB key==


Notes:
If you do not have an Internet connection (or wish to minimize its use), you can obtain a '''CD''' or '''USB''' key for upgrading an existing system.


* Right after the upgrade, you '''must''' re-run the /etc/sysconfig/olpc-scripts/domain_config script with the appropriate domain name for the machine.
''More instructions coming soon. Feel free to contribute''
* The new OS may detect your network cards differently -- the roles of WAN and LAN cards may end up swapped from what they were under 0.4. If that happens, use the xs-swapnics script.


== See also ==
== See also ==

Revision as of 19:50, 13 November 2008

  english | españolCopy "{{subst:requesttranslation}}" to 한국어 HowTo [ID# 180025]  +/-  


  This page is monitored by the OLPC team.

This page describes how to obtain a copy of the XS school server software, load it onto media, and install it onto a system. A more complete description of the software repositories, configuration information, and testing instructions are also available.

This page covers XS 0.5 and newer. For older releases, see XS_Installing_Software_0.4.

Downloading the System Image

You can obtain the latest image from http://xs-dev.laptop.org/xs/:

wget http://xs-dev.laptop.org/xs/OLPC_XS_LATEST.iso

This can be copied onto a CD or DVD using your favorite software.

Using a USB key/disk for installation

Using a USB key to install this version of the XS involves several additional steps.

  • First, copy the installation using the 'mkusbinstall' script you can download here (click on the 'raw' link). Assuming your usb key is /dev/sdb, you can invoke it like this:
mkusbinstall OLPC_XS_LATEST.iso /dev/sdb1
  • You may need to configure your machine to boot from USB - see XS_Boot_from_USB for details.
  • Early in the installation , anaconda will say that it cannot find its kickstart file. Change the path from 'cdrom:/anaconda.ks' to 'hd:sdb1:/anaconda.ks'. You will get prompted again for the path to the ISO - set it to device: '/dev/sdb1' and directory: 'iso'. If the machine has more than one hard drive, then the device might be sdc1 instead of sdb1.

Installing the Software

Please read the release notes for the version you are installing.

The install from a CD or USB key will eventually be automatic upon booting. While the install is currently mostly automated (not interactive), it is not performed automatically upon boot.

  1. Boot from the USB Key or CD-ROM
  2. Select "Install using kickstart" at the initial boot screen.
  3. Note: the default graphical installer can be instable at times. You can press tab and add 'text' at the end of the line to request the text-based installer.
  4. Anaconda (the Fedora installer) takes over and you will be prompted for the standard questions - these are preset to the correct defaults for the Scgool Server configuration. You will want to set keyboard type, the time zone, and a root password for your specific system.
  5. When it has finished installing, you will be prompted to reboot. Remove the CD-ROM or USB key after power-down, but before the boot process begins.

You should now have a school server! It needs initial configuration before it starts providing services to the laptops.

Initial Configuration

Right after installation, you must

  • Set the server domain name using:
/etc/sysconfig/olpc-scripts/domain_config example.org
  • Enable ejabberd on startup, and start it using:
chkconfig --level 345 ejabberd on
service ejabberd start
  • Create an account on ejabber for the administrator:
ejabberdctl ejabberd register admin schoolserver.example.org admin
  • Go to the web-based administration interface for ejabberd at http://schoolserver.example.org:5280/admin/, or http://172.18.0.1:5280/admin/ if using an XO or other laptop connected through the LAN interface.
  • Login as "admin@schoolserver.example.org" with the password you set when registering (admin).
  • Click on "Virtual Hosts", then your hostname, then "Shared Roster". Type "Online" and click Add New.
  • Click on "Online" and enter "Online" for Name, "@online@" for Members, and "Online" for Displayed Groups. Click Submit.

Optional

/etc/sysconfig/olpc-scripts/TURN_SQUID_ON

Network

The default server setup is to connect to the Internet on the first wired ethernet network interface, using IPv4 DHCP. Laptops connect to the server over Acceess Points (APs) connected to the second wired ethernet network interface or via the wireless mesh using one or more Active Antenna, connected through USB interfaces.

If your XS has 2 network interfaces and you would like to reverse their (WAN, LAN) roles you can use the xs-swapnics utility.

IPv6 is not enabled by default and not needed -- to enable external IPv6 you will have to configure the global address of the machine and setup an IPv6 tunnel.

Installing additional software

If you wish to install packages that aren't part of the default school server distribution, you should first try using yum. The stable and testing school server repositories include all packages included in Fedora, even if they aren't installed by default. For third party software you should follow their installation procedure for Fedora 7 or for the XS Server specifically. For example, to install Moodle, follow these instructions: http://docs.moodle.org/en/OLPC_XS_installation#Install_Moodle_from_the_OLPC_XS_Image

Keeping your XS software up to date

Upgrading a server is done using the yum package interface provided by Fedora.

If you have an Internet connection, you can upgrade from the default servers at OLPC, or your own mirrors of them. This is done using yum:

 yum -y upgrade

Upgrading from earlier version of XS

If you are upgrading from XS 0.4, the process is similar to a new installation, with some minor changes. In the menu shown right after booting, you should choose the (preselected) 'Install with kickstart' option, press the Tab key, and add 'upgradeany' to the boot configuration line. After adding that line, press enter twice.

With this extra option, Anaconda will recognise the old installation and will offer to upgrade.

Notes:

  • Right after the upgrade, you must re-run the /etc/sysconfig/olpc-scripts/domain_config script with the appropriate domain name for the machine.
  • The new OS may detect your network cards differently -- the roles of WAN and LAN cards may end up swapped from what they were under 0.4. If that happens, use the xs-swapnics script.

See also