XS Server Installation: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Replacing page with '{{OLPC}}Category:SchoolServer Content in this page has been merged into XS_Installing_Software.')
 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{OLPC}}[[Category:SchoolServer]]
This is a rough guide for installing an XS school server for a small school. This is by no means a complete guide to installing all things server-related so please feel free to add to this document.


Content in this page has been merged into [[XS_Installing_Software]].
== Recommended School Server Specifications ==
A number of computers may act as a school server, but it must be a Fedora-capable computer. Recommended minimum specifications for a school server are as follows:

<table border='1'>

<tr>
<th>Server</th>
<th>Laptops Supported</th>
<th>Processor</th>
<th>RAM</th>
<th>Storage</th>
</tr>
<tr>
<td>Small</td>
<td><20-25</td>
<td>466 MHz</td>
<td>256 MB</td>
<td>40-60 GB</td>
</tr>
<tr>
<td>Large</td>
<td><150</td>
<td>1 GHz</td>
<td>1 GB</td>
<td>320-400 GB</td>
</tr>
</table>

== Set Access Point ==

The steps for setting up a wireless router access point vary based on the wireless router being using, but this serves as a rough guide for installation. These steps were run using a Zoom Wireless-G model 4400 router.

*Press the reset button on the wireless router to reset it and connect it to any computer. It's possible to do this setup with an XO or any other machine with linux installed.
*Open terminal and type
ifconfig eth0 IPaddress

Where IPaddress is default IP for the access point
*Connect to the access point by typing in the IP address in a web browser.
*Login to the access point using the default password (or skip entering a password if none is provided)
*Set the wireless channel to 1, 6 or 11 to minimize interference
*Set a unique name for the network
*Make sure that the access point is NOT running as a DHCP server

== Obtaining Server Software ==
=== Downloading the System Image [http://wiki.laptop.org/go/XS_Installing_Software#Downloading_the_System_Image] ===

You can obtain the latest image from [http://xs-dev.laptop.org/xs/ 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.

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

livecd-iso-to-disk OLPC_XS_LATEST.iso /dev/sdb1

where <tt>/dev/sdb1</tt> represents the USB key being copied onto.

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.

===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

== Software Installation [http://wiki.laptop.org/go/XS_Configuration_Management#Example_Configurations]==

This is the step-by-step process used to install the '''XS''' software onto a server for schools with a single server.

The school domain name used in this example is <tt>example.org</tt>.

# Boot up the server from the USB key or CD. Select "Run from Image", indicate your keyboard type, time zone, and enter a root password. When the install has finished, click "Reboot".
# Now log in as root and reboot ([http://dev.laptop.org/ticket/6678 trac #6678], removing the installation media (key or CD) so the system now boots from the disk drive.
# Log in as root, and [[XS_Configuration_Management#Changing_the_Root_Password|set a root passwd]] (until [http://dev.laptop.org/ticket/6677 trac #6677] is fixed).
# 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 random.xs.laptop.org

If you've changed the domain name already, you can drop the second argument or use the newer domain name (which you are changing).

* If outside access is to be supported, change the schoolserver public IP address supplied by <tt>/var/named/school.external.zone.db</tt> to be the public IP of the principal school server. ''At present time, we don't support public access to school servers using DHCP to obtain their WAN IP address --- but this should be correctable with a script or so ([http://dev.laptop.org/ticket/6138 Trac ticket 6138])...''
* 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 connected through the mesh.
* Login as "admin@schoolserver.example.org" with the password you set when registering (admin).
* Click on "Virtual Hosts", then your hostname, then "Shared Roster Groups". 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====
* 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]
* Create an account for yourself (this is a test of basic network connectivity as well):
[http://dev.laptop.org/git?p=projects/xs-config;a=blob;f=fsroot.olpc.img/etc/sysconfig/olpc-scripts/mkaccount /etc/sysconfig/olpc-scripts/mkaccount] wad http://dev.laptop.org/~wad/dsa_public_key
passwd wad
* Add yourself to the wheel group, so that you have ''sudo'' priviledges

== Server Registration ==

Latest revision as of 00:07, 14 November 2008

  This page is monitored by the OLPC team.

Content in this page has been merged into XS_Installing_Software.