Hakipu'u Network Project
DNS Server:
Subnet Mask
Installation Notes
This instalation attempts to use GUI (Graphical User Interface) as much as possible. On a project of this nature there can be many different ways to accomplish a task. We acknowledge that and hope to provide a path that is easy for an average user to follow. If this can be acomplished it will allow greater descimination of this great technology. This install is for a 32 bit system (i386).
Install Ubuntu. Ubuntu 8.04 Alternate CD (When installing Edubuntu Server the F4 key must be depressed to bring up modes menu, then select LTSP option)
When the installer asks for a proxy server, leave it blank and click continue .
Since you should have two network interface cards pay attention when the installations ask you to identify them (eth0 & eth1). Note that the "primary" network interface will be the one going to your backbone (where the internet is accessible) and will later be given a fixed (static) IP.
Disk Partition: When choosing the disk partition you want to use the entire disk and allow the installer to create the size partition it wants to. Ubuntu uses ext3 file system.
Add-ons. : Ubuntu 8.04 educational add-on CD Select “start add-on installer, then select “Edubuntu Desktop” for installation. It now becomes Edubuntu.
Here are the detailed installation instructions for the above two steps
Updates (Run the update manager a couple of times & restart as directed.)
Note: Ubuntu/Edubuntu ships without "proprietary" software (Adobe Flash, certain graphics adapter drivers, certain sound and video codecs, Microsoft Fonts, etc). In the past there have been several "easy" ways to add this essential functionality including: Easyubuntu, Automatix and more recently, the Medibuntu repository. All of these have some serious drawbacks and disadvantages, mostly of the sort: "I have no idea what they did and whether a future Ubuntu update will be compatible. I am reasonably certain that the ubuntu-restricted-extras and two libflash packages mentioned below are now all that is needed.
Run Synaptic Package Manager. Click on Reload and then select for installation:
Become familar with the Terminal and the chroot enviorment it is a mini version of the Linux Kernal. It lives at /opt/ltsp/name_of_computer (i386, ppc, ect.) In terminal you will notice a change from $ to # by the prompt. (have comand guide handy) Decide what text editor you will use (gedit, pico, vim).
Add Admistrators (as needed)

Set fixed IP:
System/administration/network – wired connection (eth0 or eth1 whichever is the connection to the network backbone.
Set fixed IP: (within your range), subnet mask, gateway
From terminal run: sudo ltsp-update-sshkeys (required whenever fixed IP is changed)

Sudo Passwd Note: Is this in correct order? https://lists.ubuntu.com/archives/edubuntu-users/2008-June/004157.html

Samba Server: Install and configure Samba server
Workgroup= edubuntu
Check “this computer is a WINS server”

You will notice when your thin-client starts up it is using PXE boot, Pre-boot Execution Environment. You will need to configure the BIOS on your client to enable "network boot" and disable the hard drive. Some clients require an additional step after the BIOS loads to configure the "Managed Boot Agent" to PXE boot mode.
Install X11 VNC: we followed these instructions (Note: the reason X11VNC is NOT being installed by Synaptic Package Manager is because it needs root persmissions, granted by chroot)

Before installing in the ltsp environment, make sure that apt-get sources in ltsp are consistent with the base install:
sudo cp /etc/apt/sources.list /opt/ltsp/i386/etc/apt/sources.list
Now, chroot into the ltsp client environment on the server.
sudo chroot /opt/ltsp/i386
Update the repositories that the ltsp environment uses for apt-get:
apt-get update
Install the x11vnc package (it's in the universe repository, possibly you must add it in /etc/apt/sources.list; in this case don't forget to apt-get update):
apt-get install x11vnc
Setting x11vnc to run on the thin clients
Note: Now edit the rc.local file to add x11vnc to the system startup
(note: make sure this is all being done in the chroot environment and not the root of the server) (note: You may want to choose another editor besides vi)
vi /etc/rc.local
You can use also nano for that, but first you have to install it on the chroot environment.
apt-get install nano
nano /etc/rc.local
Add the following line before the exit 0 statement in this file and save it:
x11vnc -display :6 -forever -loop -shared &
Now lets make sure rc.local gets actually executed:
cd /etc/rc2.d
mv K99rc.local S99rc.local
Having installed the x11vnc package and set x11vnc up to run when the thin client starts up you are ready to exit the chroot environment:

Update the LTSP image: Ubuntu/Edubuntu 7.10 and onwards - Make sure that the ltsp image gets updated:
sudo ltsp-update-image
If you are using an i386 image on an AMD64 build the command is:
sudo ltsp-update-image --arch i386
Reboot your thin clients and you should be able to connect to them via vnc now. For example, if you had a thin client at IP address you could connect to it with:
xvnc4viewer -FullColour
(omit -FullColour for faster but uglier access to the remote screen).
Add Webmin This provides a GUI (Graphical User Interface) for Network Administration.
When configuring printers we chose CUPS (
Clonezilla—GPL software for creating Disk Images
Disk Utility—Part of every OSX installation.
Misc. Notes
Gnash is a GNU Flash movie player. http://www.gnu.org/software/gnash/#TOC http://wiki.debian.org/DebianEdu/FlashInDebianEdu
RED 5 is a GNU Flash Server http://www.osflash.org/red5
How to create Fat - Thin Clients https://help.ubuntu.com/community/UbuntuLTSP/LTSPFatClients
When the sound was not working on the thin clients you can reset it with: sudo /etc/init.d/alsa-utils reset
To turn off encryption you can use LDM-DIRECTX=True
To prevent a same user from opening multiple Linux sessions without closing previous ones edit /etc/sysconfig/k12ltsp and set PURGE_PROCESSES=YES If a user tries to login a second time then the first gsession is closed and all his processes are killed.
Sometimes in order to Kill a Process we needed to use: kill -kill (name of process)
Math Program
User Name skhlc
Password hakipuu
Hawaii Smart Kids
On Site Resources
Other Resources
Medi Ubuntu (multimedia)
API Application programming interface provides to support requests made by computer programs.
APT Advanced Packaging Tool—APT simplifies the process of managing software on Unix.
BIOS BIOS refers to the firmware code run by an PC when first powered on.
Boot is a bootstrapping process that starts operating systems.
CUPS Common Unix Printing System A modular printing system for Unix-like computers.
DHCP Dynamic Host Configuration Protocol—Process of dynamically assigning IP addresses.
DLBR Diskless Remote Boot in Linux
Fat or Thick Client Fat client typically refers to the large size of applications residing on the client machine.
fstab fstab file lists available disks and disk partitions, and indicates how they are to be initialized or integrated into the overall system's file system.
Gentoo A file manager used with Linux or the name of a Linux Distribution.
GET the most common type of HTTP request.
Gnome Graphical user interface which sits on top of a computer operating system, composed entirely of free software.
GNU and/or GPL A widely used free software license.
GUI GUI (Unix) Graphical User Interface Unix-Globally Unique Identifier
KDC Key Distribution Center—(usually Kerberos drawbacks: single point of failure).
LDAP Lightweight Directory Access Protocol. LDAP Authentication
LDIF Standard plain text data interchange format for representing LDAP directory content and update requests.
Recomended standards
Common Name cn=
Domain Component dc=
Distinguished Name dn=
Organizational Unit ou=
LTSP Linux Terminal Server Project.
MDAdm Multiple Disk Adminstration—RAID0 Striped; RAID1 Mirror; RAID5 Striped Disks with Parity (also RAID 2, 3, 4, 6)
NFS Network File Server—Supports sharing of files, printers and other resources.
NIS (insecure) Client-server directory service protocol, former king of centralized authentication systems AKA- YP (Yellow Pages)
NSS Name Service Switch—allows replacement of many Unix configuration files.
NTP Network Time Protocol.
PAM Pluggable Authentication Modules—Dynamic authorization for applications and services in a Linux system.
PDC Primary Domain Controller.
PXE Pre-Execution Environment, (or pixie) is an environment to boot computers using a network interface.
RAID Redundant Array of Inexpensive Drives see: MDAdm
SAMBA Samba is a free software re-implementation of SMB/CIFS.
SSH Secure Shell Handler—Network protocol that allows data to be exchanged securely through encryption.
SUDO SuperUser—Allows users to run programs with the security privileges after giving password.
Synaptic Package Manager Advanced Packaging Tool for the Debian package management system.
SRC Source Code (commonly just source or code).
TAR File format derived from tape archive.
Thin Client A client computer which depends primarily on the central server.
TFTP Trivial File Transfer Protocol—Simple file transfer protocol, with functionality of very basic FTP.
TGT Ticket Granting Ticket—encrypted identification file with a limited validity period (usually Kerberos).
TOP Produces a frequently-updated list of processes performed by the CPU.
Ubuntu (Zulu) Ubuntu is a derivative of Debian, another free operating system.
UID(Unix) UID User Identifier (Unix sudo is 0 nobody is 32,767) and/or Unique Identifier (other OS's) (setuid-set users ID).
UMTP File on Unix-like systems that keeps track of all logins and logouts to the system.
VNC Virtual Network Computing—Graphical desktop sharing system.