Image:Kiosknet-title.png

Table of contents

Downloading KioskNet

KioskNet is available as Free Open-Source Software under the Apache license. Most deployments will only need the ISO LiveDVD image that you can download from this link (http://blizzard.cs.uwaterloo.ca/tetherless/frag/). You can also get source code access to KioskNet (updated hourly) from CVS.

Kiosknet Deployment Guide

Getting familiar with KioskNet

Before following these instructions, please make sure you familiarize yourself with an overview of our architecture.

Deploying KioskNet requires:

  1. Planning: deciding how many kiosks and vehicles you need.
  2. Ordering equipment.
  3. Server installation: loading hard drives with software images from our distribution.
  4. Rollout into the field: installing the hard drives in single-board computers, and placing these computers in vehicles and kiosks.
  5. Adding recycled PCs: this gets a kiosk up and running.
  6. Adding users: this makes the solution available to kiosk users.

These steps described in more detail below.

Planning

As with any complex software system, deployment requires planning. In this phase, you will collect information to determine the number of gateways, buses, and kiosks in your system. We have prepared some planning guidelines to help you with this process.

Ordering equipment

We have put together some details on the equipment that you need to buy to deploy our solution. Please follow this link to the equipment guide. You may also be able to get free hardware from us if you qualify for the Quick Start Program.

Server installation

You are now ready to install the operating system on the hard drives for the single board computers (servers). You will also be installing configuration parameters on these servers. Photographs and an overview of how to load the operating system into the hard drives can be found in the server installation guide.

Detailed instructions on configuring the servers is below:

Once you have installed the servers you should test your system:

Field rollout

At this point, you have the servers ready, but you still need to configure the kiosks, and install the servers in the vehicles. Details of these steps are in the field rollout guide.

Adding recycled PCs

Once the kiosk controllers have been set up, you are ready to add recycled PCs to the system. These will be booted up from the kiosk controllers. Here is a guide to adding recycled PCs.

Adding users

By default, the kiosk already has one user, who is called 'admin'. The admin's password is chosen when you install the kiosk. The admin user can now add more users. To do so, follow these instructions.

Start using KioskNet: Omail - Disconnection-tolerant email

Most likely, the first application you will run on KioskNet will be disconnection-tolerant email. You can find detailed instructions on setting up thunderbird to use Omail here (http://blizzard.cs.uwaterloo.ca/tetherless/index.php/Setting_up_thunderbird).

Troubleshooting

Log files

The first step in trouble shooting KioskNet is looking into the log files. All logs can be found in separate files in ‘/var/log.’ Note that the log files can be slightly out of date due to delaying in flushing the files to disk. The latest information can always be found in the the database tables as discussed here.

  • On the kiosk controller, gateway, and ferry, the OCMP log file is /var/log/ocmpclient.log
  • On the proxy, the OCMP log file is /var/log/ocmpproxy.log
  • The secure directory watcher on kiosk controllers, terminals, and proxies logs its activity on /var/log/secure-dir-api.log
  • The email log is in /var/log/omaild.log

The log files of all the nodes in a KioskNet deployment are collected by ‘logflood’ in the proxy for central monitoring as described here

Wireless problems

Having trouble getting your wireless ethernet to work?

Debugging OCMP

Mounting files from a kiosk controller

To mount a directory from the kiosk controller, two changes are needed to the Kiosk Controller's file system:

  1. /etc/exports on the kiosk controller should export the directory
  2. /var/terminal.img/etc/rc2.d/S99nfsmount should have a line to mount the directory

Note that /opt/ltsp/i386/etc/fstab is NOT being used to mount the files on the terminal!!

Misc. tips

Misc. troubleshooting tips

Installing Proxy on Ubuntu

Howto Install Proxy on Ubuntu


Installing Kiosk on Ubuntu

Howto Install Kiosk on Ubuntu


Installing Proxy on Windows XP

Howto Install Proxy on Windows XP


Installing Kiosk on Windows XP

Howto Install Kiosk on Windows XP

Copying sample Images to your Hard Drives

Howto Copy sample Images to your hard drives

Other deployment information

Retrieved from "http://blizzard.cs.uwaterloo.ca/tetherless/index.php/Deployment_guide"

This page has been accessed 3928 times. This page was last modified 15:34, 7 Apr 2009.


Main Page

About

Current Projects

Downloads

Documents

Internal

Old Projects

Meta