Project

General

Profile

Configuration File Format » History » Revision 11

Revision 10 (A K M Mahmudul Hoque, 05/05/2014 12:01 PM) → Revision 11/27 (A K M Mahmudul Hoque, 05/05/2014 12:49 PM)

## Configuration File Format 

 NLSR is configured using an [INFO file](http://www.boost.org/doc/libs/1_42_0/doc/html/boost_propertytree/parsers.html#boost_propertytree.parsers.info_parser). 

 ## Example configuration 

     ; the router section contains the setting of network, site name  
     ; and router name which all together makes router-prefix 
    
     router 
     { 
     ; mandatory configuration command section 
    
         network /ndn           ; name of the network the router belongs to in ndn URI format 
         site /memphis.edu      ; name of the site the router belongs to in ndn URI format 
         router /cs/pollux      ; name of the network the router belongs to in ndn URI format 
     } 

     ; the hello section describes the configuration settings for NLSR hello protocol 
    
     hello 
     { 
     ; in case hello interest timed out, router will try 'retrials' times at 'interval' seconds 
     ; interval before giving up for any neighbors (deciding link is down)      

        retrials 3                            ; interest retry number in integer. Default value 3 
                                            ; valid values 1-10 

        interval                              ; interest sending interval in seconds. Default value 1 
                                            ; valid values 1-15 

     ; neighbor command is used to configure router's neighbor. Each neighbor will need 
     ; one block of neighbor command 
    
        neighbor 
        { 
            name /ndn/memphis.edu/cs/castor ; name prefix of the neighbor router consists 
                                            ; of network, site-name and router-name 
           
            face-id    10                       host cs.castor.memphis.edu        ; face id hostname or ip address of the face connected to the neighbor router 
            link-cost 20.6                    ; cost of the connecting link to neighbor 
        } 
     } 

     ; the synchronization section contains all the configuration settings for router's update 
     ; synchronization with neighbors in the network 

     synchronization 
     { 
     ; all routers in the network must have same sync-prefix. Routers synchronizes routing updates 
     ; in this prefix across the network. This prefix is routable to each neighbor from every router 

         sync-prefix /ndn/nlsr/sync ; name in URI format. Default value /ndn/nlsr/sync 

     ; lsa-refresh-time is the time in seconds, after which router will refresh its LSAs 
    
         lsa-refresh-time 1800        ; default value 1800. Valid values 240-7200 
     } 

     ; the hyperbolic section contains the configuration settings of enabling a router to calculate 
     ; routing table using [hyperbolic routing table calculation](http://arxiv.org/abs/0805.1266) method 

     hyperbolic 
     { 
     ; commands in this section follows a strict order 
     ; the switch is used to set hyperbolic routing calculation in NLSR 

         state off                ; default value 'off', set value 'on' to enable hyperbolic routing table  
                                ; calculation which turns link state routing 'off'. set value to 'dry-run" 
                                ; to test hyperbolic routing and compare with link state routing. 
     

         radius     123.456         ; radius of the router in hyperbolic coordinate system 
         angle      1.45            ; angle of the router in hyperbolic coordinate system 
     } 


     ; the fib section is used to configure fib entry's type to ndn FIB updated by NLSR 

     fib 
     { 
     ; the tunnel configuration is used to set the tunnel type of the FIB entries by NLSR 
    
         tunnel-type udp            ; default tunnel type is 'udp', set value to 'tcp' for TCP tunnel 
     

     ; the max-faces-per-prefix is used to limit the number of faces for each name prefixes 
     ; by NLSR in ndn FIB 
    
         max-faces-per-prefix 3     ; default value 0. Valid value 0-60. By default (value 0) NLSR adds 
                                  ; all available faces for each reachable name prefixes in NDN FIB 
     
     } 

     ; the advertising section contains the configuration settings of the name prefixes  
     ; hosted by this router 

     advertising 
     { 
     ; the ndnname is used to advertised name from the router. To advertise each name prefix 
     ; configure one block of ndnname configuration command for every name prefix. 
    
         prefix /ndn/edu/memphis/cs/netlab             ; name in ndn URI format 
         prefix /ndn/edu/memphis/sports/basketball  
     }