PL-VINI FAQ
When starting the virtual network, I get an error. What's wrong?
The most common problem is a TCP/UDP port collision with another PL-VINI experiment running in a different slice on the same nodes. Click opens two ports: a TCP control port (CLICK_PORT in the Makefile) and a UDP tunnel port (OVERLAY_PORT in the Makefile). The error message for a collision on the tunnel port looks like this:
*** ERROR starting click on planetlab1.wash.internet2.planet-lab.org *** demo/planetlab1.wash.internet2.planet-lab.org.click:4: While configuring 'Message@1 :: Message': Click started on: planetlab1.wash.internet2.planet-lab.org @ config time: Mon Oct 23 15:34:26 EDT 2006 demo/planetlab1.wash.internet2.planet-lab.org.click:143: While initializing 'in :: Socket': bind: Address already in use Router could not be initialized! make: *** [click] Error 1
The important feature is that the error occured while initializing element 'in :: Socket'. In this case, change $udp_port in your PL-VINI configuration file to a different value. A collision on the Click control port looks like:
*** ERROR starting click on planetlab1.wash.internet2.planet-lab.org *** demo/planetlab1.wash.internet2.planet-lab.org.click:4: While configuring 'Message@1 :: Message': Click started on: planetlab1.wash.internet2.planet-lab.org @ config time: Mon Oct 23 15:34:26 EDT 2006 click: While initializing 'click_driver@@ControlSocket@0 :: ControlSocket': bind: Address already in use Router could not be initialized! make: *** [click] Error 1
Here, the error occurs while initializing element 'click_driver@@ControlSocket@0 :: ControlSocket'. Change the $click_port in your configuration file if you see this.
An error also occurs if another process has already opened the tap0 interface in your slice (e.g., an old Click process from a previous run of PL-VINI). This error looks like:
*** ERROR starting click on planetlab2.sttl.internet2.planet-lab.org *** demo/planetlab2.sttl.internet2.planet-lab.org.click:4: While configuring 'Message@1 :: Message': Click started on: planetlab2.sttl.internet2.planet-lab.org @ config time: Mon Oct 23 15:34:26 EDT 2006 demo/planetlab2.sttl.internet2.planet-lab.org.click:123: While initializing 'FromHost@17 :: FromHost': warning: Linux universal tun failed for tap0: Device or resource busy unspecified error Router could not be initialized! make: *** [click] Error 1
Try make stop to kill off any other running Click processes.
How can I compile my own Click/XORP/UML to use with PL-VINI?
Instructions here.
How can I get into configuration mode in xorpsh?
Within UML, first su xorp before running xorpsh.

