Server Installation Guide

This guide walks you through the process of setting up the operating system and configuration parameters on four kinds of devices:

• Vehicles (buses)
• Gateways
• Kiosks
• Proxies

For the first three types of servers, we recommend the Soekris net4801 (http://www.soekris.com) single board computer. Our instructions are equally applicable to other small servers, such as the Mini-ITX from VIA systems (http://www.via.com.tw/en/initiatives/spearhead/mini-itx/).

Collect configuration information

Before starting the installation of KioskNet components on Soekris boxes, you should have the following information ready:

1. Name of the organization responsible for the deployment (i.e. the name of your organization)
2. Name of the region
3. Unix name for each machine (i.e. its 'hostname').
   • This will be part of the unique Endpoint ID or EID of the kiosk. The EID is <Kiosk Unix Name>.<Region name>.<Organization name>.kiosknet.org .
   • Note that users at this kiosk will get Unique IDS of the form <User's Unix user name>.<Kiosk Unix Name>.<Region name>.<Organization name>.kiosknet.org .
4. DNS name for the proxy to be used with this region
5. Public IP address of the proxy that is accessible from all the gateways. At least ports 22, 25 and 4556 should be reachable
6. Channel for the wireless interfaces: we have fixed the channel to 11, but this can be changed in the field to any other channel using the iwconfig command.

Hints on the required information

Name of the Organization

This is the name of the organization such as the NGO, Social Service Agency, or University who is installing the system. It has to be a single word
with no spaces. This name is used in the naming structure of Kiosknet users. Therefore one can identify from the username of
the user to which Organization does the Kiosk belong.

Example: If the installing organization is University of Waterloo then we can give an organization name as UW so it would appear in the name.

Name of the region

This is the area / locality / region where the Kiosk is installed. A KioskNet is divided into a large number of geographical regions which
have kiosks installed at various locations.
Example: If we are installing a kiosk in the area of village1, then we may give the region name as : village1

Name for each machine

Now in each region we have numerous kiosks installed so we have different names for them
Example: kiosk2

The name of the kisoks would look like this :

kiosk2.village1.UW.kiosknet.org

The username of KioskNet user would be :

user1.kiosk2.village1.UW.kiosknet.org

user2.kiosk2.village1.UW.kiosknet.org

Public IP for the Proxy

The proxy has to be accessible from all the gateways.Proxy is the only interface of the kiosks to the external world i.e. internet.
The proxy is installed at some location in the urban area where fast internet connection is available.

Important :

1) Installation requires a authentication key from the UW, Tether less Computing Laboratory. This key is depends on the ORGANIZATION NAME
.

2)Always start with Installation of the proxy FIRST, followed by Kiosk Controller and then the Ferry and Gateway. During Proxy installation we get EID of the proxy which should be noted down for further reference.

So in this case our region name is  : reigon2
The organization name is : uw2

Based on these 2 parameters an authentication key is generated which is used during Proxy installation.

ISO download

Download the KioskNet Installation DVD from here (http://blizzard.cs.uwaterloo.ca/tetherless/livecd.iso) (right click and choose 'save as'). This is a 2GB image, so may take a while to download. Once it is downloaded, burn it to a DVD using any standard DVD burning software, such as:

• k3b for Linux
• neuro for Windows (don't use the built-in windows DVD burner, which will not burn ISOs)
• Apple's built-in Disk Utility for Macs

Install the OS image on a hard drive

1. Insert drive into a USB enclosure

We recommend that you install the operating system directly to the Soekris's hard drive using an external USB 2.0 hard drive enclosure such as the one shown below. Do not connect this to your PC yet!

2. Set PC BIOS to boot from the DVD ROM drive

Set the PC BIOS to boot from the DVDROM - you can do this by pressing F8 or DEL on the keyboard during startup, and entering BIOS, then changing the boot order options (http://www.whitecanyon.com/esupport/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=7).

3. Reboot the PC

Then, reboot the machine with the DVD. This will bring up your PC as an Ubuntu machine.

• Select the default option from the initial menu. Please note that this may take up ten minutes, so please be patient!
• Log in as 'kiosknet' and password 'KioskNet'

4. Attach and unmount the hard drive

Now attach the hard drive inside the USB enclosure to your PC.

Note: If this is not a fresh hard drive, Ubuntu will automatically mount the file system on the drive. If so, the easiest way to eject the volume is to right click on the icon on the desktop that corresponds to the USB drive and select 'Eject'. If this does not work:

• become root using su - (you will not need a password for this)
• If this doesnt work try this

      $sudo su - admin
       Password: KioskNet

• type "fdisk -l" to list the mounted volumes
  • sometimes you will find that the volume is not listed. In this case, you may need to unpulug and replug the USB cable a few times, until fdisk works.
• compare the sizes of the listed volumes to find the volume corresponding to the drive you mounted. You should be looking for a disk called /dev/sdXXX with a size corresponding to the capacity of the hard drive (e.g. 40 GB)
• use 'umount /dev/<volume>' to unmount the disk

5. Start a terminal session

After the live Ubuntu starts, run a terminal (Applications>Accessories>Terminal). It may help to run two terminal sessions in parallel, one to run the installer program, and the other for other tasks.

6. Create a public and private key pair (needs to be fixed)

During the installation of the KioskNet deployment you will be asked to provide a common public/private key pair used for that installation. Generate these keys using the OpenSSL (http://openssl.org) command:

ssh-keygen -t dsa

Accept the default filename. Just press enter when you are asked for the pass phrase (i.e use a null pass phrase). The newly generated keys will be stored in two files called id_dsa and id_dsa.pub in the .ssh directory. Save them in another directory using

 scp -r .ssh /tmp/pubkeys

which will copy the two files to the /tmp/pubkeys directory. You will need to remember where you copied these files to for later. Also, note that these public and private keys should be used with all other installations, so make sure that you save a copy of these files elsewhere.

7. Start the installation program

In one of the terminal sessions, type:

 KioskNetInstall

• If it returns an error 'can't cd to /usr/bin/Tetherless', keep trying the command until it succeeds!

This will start a script that will ask you some questions. Note that you if you enter any information incorrectly while running the installation program, you can always restart the installation program and try again. Please note that it will take 10-15 minutes before the script asks you any questions.

Read the questions carefully before answering them.

When the installation program asks you for the device node of the USB hard drive, run another virtual terminal, then type "fdisk -l" to list the storage disks. Compare the sizes of the listed volumes to find the volume corresponding to The USB hard drive. It will be of the form /dev/<volume> (e.g. /dev/sdc). Be careful not to confuse a partition node (such as /dev/sdc1) with the device node (/dev/sdc). The installation program needs the device node and not a partition node.

This will start the copying of the image from the DVDROM to the hard drive. Please be patient - it can take up to 20 minutes for this operation to complete.

When the copying completes you must remove the USB connector from the PC and insert it again, and wait for the OS to detect the drive. When this happens, the OS will pop up two windows. Close these windows.

Run

sudo fdisk -l again

and find the device node.

Re-enter this in the installation script and press enter.

The script will create some file systems on the hard drive. This will take about a minute.

It will now ask some configuration questions. Answer them using the information you gathered in the first step. From this point on, if you enter any information incorrectly, don't worry, the startup script will ask for confirmation at the end and give you the opportunity to re-enter your answers to the configuration question.

Notes

1. When asked for the public/private key pair, enter the name of the directory where you saved the id_dsa and id_dsa.pub files.
2. You can safely ignore all 'umount' errors generated by the script
3. There is a default user on the Kiosk for the kiosk operator with user name 'franchisee' and password 'KioskNet'
4. The default root password after the installation of each soekris image is "KioskNet". Make sure you change this!
5. Use the command date -s to set the date and time (use 'man date' for details)

Making changes to your deployment

Return to main deployment guide.