We have two OS images with support for The Click Modular Router: Ubuntu804-click and Ubuntu1004-click20.
We support click 1.8 (in Ubuntu804-click) and click 2.0 (in Ubuntu1004-click20).
Ubuntu804-click is based on Ubuntu804-STD with the following modifications
Ubuntu1004-click20 is based on Ubuntu1004-STD with the following modifications
click is installed in /usr/local. If you do not require custom modules, the images should be usable out of the box.
For a simple example, download test.click and copy it to your home directory on users.
On a node running Ubuntu804-click or Ubuntu1004-click20, 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/log/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
The source for click is in /usr/src/click-1.8.0 or /usr/src/click-2.0.
Custom modules are typically built in the local elements folder. Copy your source files into /usr/src/click-1.8.0/elements/local or /usr/src/click-2.0/elements/local and give configure the --enable-local flag.
In click 1.8, you must give configure the path to the kernel source.
$ sudo -s # cd /usr/src/click-1.8.0 # ./configure --with-linux=/usr/src/linux-2.6.24.7 --enable-local
$ sudo -s # cd /usr/src/click-2.0 # ./configure --enable-local
At this point building and installing is as simple as:
# make && make install