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
• A recent GNU C compiler gt 3.0
• GNU Make (not Solaris Make!)
• pcap library to communicate with the network
• For user-level Click x86
• Not sure of the requirements?
• The ./configure script will tell you

3
Download configure it

• Version 1.4.3 should be used
• http//pdos.csail.mit.edu/click/click-1.4.3.tar.gz
  
• For bleeding-edge development CVS
• Untar Click in some directory
• tar xzf click-1.4.3.tar.gz
• Configure it
• cd click-1.4.3
• ./configure --disable-linuxmodule --enable-local

4
Making installing

• Make Click (fast)
• (go to click-1.4.3)
• 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
• Become root su
• make install
• click ltclickdirectorygt/conf/test.click should
  work
• Every time you change elements you should 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-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

7
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

8
References

• Click website http//pdos.csail.mit.edu/click/
• Tool documentation (click-viz, click-flatten)
• Click package
• INSTALL
• README
• Graphviz http//www.graphviz.org/