Click Modular Router

1
Click Modular Router

• Installation tools
• Bart Braem Michael Voorhaen
• firstname.lastname_at_ua.ac.be

2
Requirements

• Software
• Unix system
• Linux works in userlevel and kernelspace
• FreeBSD has a port, only userlevel works
• A recent GNU C compiler gt 3.0
• GNU Make
• For user-level Click x86 or x86_64
• Not sure of the requirements?
• The ./configure script will tell you

3
Download configure it

• Version 1.5.0 should be used
• http//www.read.cs.ucla.edu/click/click-1.5.0.tar.
  gz
• For bleeding-edge development CVS
• Untar Click in some directory
• tar xzf click-1.5.0.tar.gz
• Configure it (disabling the kernel module)
• cd click-1.5.0
• ./configure --disable-linuxmodule --enable-local

4
Making installing

• Make Click (fast)
• (inside the click-1.5.0 directory)
• make -j2
• Click will now run
• userlevel/click conf/test.click
• Output should be five times ok 40 45000028
  00000000 401177c3 01000001 02000002 13691369
• Optional install Click systemwide (as root)
• Become root su
• make install
• click ltclickdirectorygt/conf/test.click should
  work
• Every time you change elements you must do a make
  install

5
Installing own elements

• All elements are stored in /elements/ directory
• Yours should be put in elements/local
• Put the .hh and .cc files there
• To make those elements available
• make elemlist
• make (notice new elements being compiled)
• Solve any compilation problems
• Use your elements

6
Tools

• Click graphs can get large
• Sometimes you need visual checks
• Helps you verify the situation
• Tools available
• click-flatten
• click-viz

7
Tools click-flatten

• Flattens out compound elements
• The resulting router will do exactly the same
• In tools/click-flatten
• Reorders for click-viz

• tools/click-flatten/click-flatten ping-3.click
• 33 "ping-3.click"
• AddressInfo_at_1 AddressInfo(senderaddr 10.0.0.1
  1A7C3E907841)
• 34 "ping-3.click"
• AddressInfo_at_2 AddressInfo(receiveraddr
  10.0.0.2 1A7C3E907842)
• 40 "ping-3.click"
• Null_at_5 Null
• 43 "ping-3.click"
• Null_at_6 Null
• 4 "ping-3.click"
• sender/ICMPPingSource_at_1 ICMPPingSource(senderad
  dr, receiveraddr)
• 5 "ping-3.click"
• .
• sender/ICMPPingSource_at_1 -gt sender/IPPrint_at_2
• -gt sender/EtherEncap_at_3
• -gt sender/ToDump_at_4
• -gt Null_at_5
• -gt receiver/Strip_at_1
• -gt receiver/MarkIPHeader_at_2

8
Tools click-viz

• Basic visualization of Click scripts
• Python script
• Renders dotty output (Graphviz software)
• Usage
• tools/click-flatten/click-flatten ping-1.click
  tools/click-viz dot -Tpng gt ping-1.png

9
References

• Click website
• http//www.read.cs.ucla.edu/click/
• Tool documentation (click-viz, click-flatten)
• Element documentation
• Click package
• INSTALL
• README
• Graphviz http//www.graphviz.org/