Sample Proxy Configuration Files

We recommend that you use the graphical proxy configuration utility included in the package. However, if you wish to directly tweak the configuration files by hand, the examples given below may serve as a reference.

proxy-config.xml

This is the main proxy configuration file. The list of active overlays and parameters of the packet capturing device are specified here. A sample proxy-config.xml with one active i3 overlay network is shown below.

<?xml version="1.0"?>

<ProxyConfigFile 
	stdDNSRequestPort="53"
	legacyDNSRequestPort="55667"
	fakeAddrRangeStart="1.0.0.2"
	fakeAddrRangeMask="255.255.255.0"
	myNamesConfigFile="config_files/myNames.xml"
	outboundConnectionConfigFile="config_files/outbound.xml"
 >


    <OC-D-List>
	    <OC-D
                type="I3"
                id="pli3"
                description="I3 Overlay Network running on PlanetLab"
                configFile="config_files/i3-cfg.xml"
                active="yes"

    		I3_EnableShortcut="no"
	    	I3_AddressBook="config_files/i3_addr_book.txt"
	    	I3_EnableFastConnectionStartup="no"
	    	defaultUrlSuffix=".pli3"
	    	otherUrlSuffixes=".i3"
	    	I3_LocalPortNum="58749"
	    />
    
    </OC-D-List>


    <Tunnel>
    
        <DevicePath>/dev/net/tun</DevicePath>
        <DeviceName>tun0</DeviceName>
        <MTU>1200</MTU>
        <IPAddress>10.0.0.1</IPAddress>
        <RoutingTable>tuntab</RoutingTable>

        <ifconfigCmd>/sbin/ifconfig</ifconfigCmd>
        <iptablesCmd>/sbin/iptables</iptablesCmd>
        <ipCmd>/sbin/ip</ipCmd>
        <modprobeCmd>/sbin/modprobe</modprobeCmd>

    </Tunnel>
</ProxyConfigFile>

i3-cfg.xml

This file contains i3 specific configuration details of the PlanetLab instance of i3 listed in proxy-config.xml shown above.

<?xml version="1.0"?>
<I3ConfigFile version="0.1">
	<I3ServerDetails
		UsePing="no"
        	UseTCP="no"
		ServerListURL="rose.cs.berkeley.edu:8080/i3_status2.txt"
	>

        
    		<!-- Planetlab 8  -->
   	 	<I3Server
			IPAddress="169.229.50.10"
			PortNum="5612"
			I3Id="7b97e83bd6d7c5aeb60169237476742fa49aa248"
		/>

	</I3ServerDetails>
</I3ConfigFile>

myNames.xml

This configuration file specifies the names to be associated with the machine on which the proxy is run. In the example myNames.xml shown below, a single name associated with the Planetlab instance of i3 is specified.

<?xml version="1.0"?>

<MyNameList>
	<MyName
        	name="YourName.pli3"
        	ocdId="pli3"
        	active="true"

        	i3TriggerType="public"
    	/>
</MyNameList&rt;

outbound.xml

This configuration file specifies the overlays to be used for outbound connections to different URLs. In the sample outbound.xml configuration file, all connections to URLs ending in .pli3 are sent over the i3 instance running on PlanetLab.

<?xml version="1.0"?>

<OutboundPathConfig>

    <PathInfo >
        <Match urlPattern = "*.pli3" />
        <Security protocol  = "none" mode = "endhostonly" />
        <Compression algo   = "none" level = "5" />
        <FakeAddressNegotiation preference  =   "not necessary" />
        <Hop overlayId = "pli3" />
    </PathInfo>

</OutboundPathConfig>