Ubuntu804-click

Ubuntu804-click is an OS image with support for ​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 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

Further Reading

• ​Click Module Router
• ​click examples
• general Ubuntu image info