= Ubuntu804-click =

Ubuntu804-click is an OS image with support for [http://read.cs.ucla.edu/click The Click Modular Router].

Ubuntu804-click is based on Ubuntu804-STD with the following modifications
 * loads as a full disk image with about 15 GB free on /
 * kernel 2.6.24.7-click
 * click 1.8.0 installed in /usr/local
 * click and kernel source in /usr/src

== Using click ==

click 1.8.0 is installed in /usr/local. If you do not require custom modules, the image should be usable out of the box.

=== Running the example ===

For a simple example, download [attachment:test.click test.click] and copy it to your home directory on users.

On a node running Ubuntu804-click, run the following command:

{{{
sudo click-install test.click
}}}

This will install the example configuration into click running in the kernel. If it succeeds, you should see output similar to the following by running {{{dmesg}}} or reading {{{/var/run/kern.log}}}:

{{{
[66530.612983] chatter: ok:   40 | 45000028 00000000 401177c3 01000001 02000002 13691369
[66530.620905] chatter: ok:   40 | 45000028 00000000 401177c3 01000001 02000002 13691369
[66530.628821] chatter: ok:   40 | 45000028 00000000 401177c3 01000001 02000002 13691369
[66530.636725] chatter: ok:   40 | 45000028 00000000 401177c3 01000001 02000002 13691369
[66530.644618] chatter: ok:   40 | 45000028 00000000 401177c3 01000001 02000002 13691369
}}}

== Building custom modules ==

The source for click is in {{{/usr/src/click-1.8.0}}}.

You must always give configure the path to the kernel source (see below).

Custom modules are typically built in the local elements folder. Copy your source files into {{{/usr/src/click-1.8.0/elements/local}}} and give configure the {{{--enable-local}}} flag.

{{{
$ sudo -s
# cd /usr/src/click-1.8.0
# ./configure --with-linux=/usr/src/linux-2.6.24.7 --enable-local
}}}

At this point building and installing is as simple as:

{{{
# make && make install
}}}