akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 1 | ; the general section contains all the general settings for router |
akmhoque | ba09474 | 2014-02-28 11:47:21 -0600 | [diff] [blame] | 2 | |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 3 | general |
| 4 | { |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 5 | ; mandatory configuration command section network, site and router |
akmhoque | ba09474 | 2014-02-28 11:47:21 -0600 | [diff] [blame] | 6 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 7 | network /ndn/ ; name of the network the router belongs to in ndn URI format |
| 8 | site /edu/memphis ; name of the site the router belongs to in ndn URI format |
| 9 | router /%C1.Router/cs/pollux ; name of the router in ndn URI format |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 10 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 11 | ; lsa-refresh-time is the time in seconds, after which router will refresh its LSAs |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 12 | lsa-refresh-time 1800 ; default value 1800. Valid values 240-7200 |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 13 | |
Nick Gordon | d5c1a37 | 2016-10-31 13:56:23 -0500 | [diff] [blame] | 14 | ; router-dead-interval is the time in seconds after which an inactive routers |
Vince Lehman | fc7d5b6 | 2014-12-05 15:02:47 -0600 | [diff] [blame] | 15 | ; LSAs are removed |
| 16 | ;router-dead-interval 3600 ; default value: 2*lsa-refresh-time. Value must be larger |
| 17 | ; than lsa-refresh-time |
| 18 | |
Alexander Afanasyev | 411ee4b | 2014-08-16 23:17:03 -0700 | [diff] [blame] | 19 | ; InterestLifetime (in seconds) for LSA fetching |
| 20 | lsa-interest-lifetime 4 ; default value 4. Valid values 1-60 |
| 21 | |
Vince Lehman | f99b87f | 2014-08-26 15:54:27 -0500 | [diff] [blame] | 22 | ; log-level is used to set the logging level for NLSR. |
| 23 | ; All debugging levels listed above the selected value are enabled. |
| 24 | ; |
| 25 | ; Valid values: |
| 26 | ; |
| 27 | ; NONE ; no messages |
| 28 | ; ERROR ; error messages |
| 29 | ; WARN ; warning messages |
| 30 | ; INFO ; informational messages (default) |
| 31 | ; DEBUG ; debugging messages |
| 32 | ; TRACE ; trace messages (most verbose) |
| 33 | ; ALL ; all messages |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 34 | |
Vince Lehman | f99b87f | 2014-08-26 15:54:27 -0500 | [diff] [blame] | 35 | log-level INFO |
| 36 | |
Muktadir R Chowdhury | bfa2760 | 2014-10-31 10:57:41 -0500 | [diff] [blame] | 37 | log-dir /var/log/nlsr/ ; path for log directory (Absolute path) |
| 38 | seq-dir /var/lib/nlsr/ ; path for sequence directory (Absolute path) |
| 39 | ;log4cxx-conf /path/to/log4cxx-conf ; path for log4cxx configuration file (Absolute path) |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 40 | } |
| 41 | |
Nick Gordon | d5c1a37 | 2016-10-31 13:56:23 -0500 | [diff] [blame] | 42 | ; the neighbor's section contains the configuration for router's neighbors and hellos behavior |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 43 | |
| 44 | neighbors |
| 45 | { |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 46 | ; in case hello interest timed out, router will try 'hello-retries' times at 'hello-timeout' |
| 47 | ; seconds interval before giving up for any neighbors (deciding link is down) |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 48 | |
| 49 | hello-retries 3 ; interest retries number in integer. Default value 3 |
| 50 | ; valid values 1-10 |
| 51 | |
| 52 | hello-timeout 1 ; interest time out value in integer. Default value 1 |
| 53 | ; Valid values 1-15 |
| 54 | |
| 55 | hello-interval 60 ; interest sending interval in seconds. Default value 60 |
| 56 | ; valid values 30-90 |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 57 | |
Vince Lehman | 7b61658 | 2014-10-17 16:25:39 -0500 | [diff] [blame] | 58 | ; adj-lsa-build-interval is the time to wait in seconds after an Adjacency LSA build is scheduled |
| 59 | ; before actually building the Adjacency LSA |
| 60 | |
| 61 | adj-lsa-build-interval 5 ; default value 5. Valid values 0-5. It is recommended that |
| 62 | ; adj-lsa-build-interval have a lower value than routing-calc-interval |
| 63 | |
| 64 | ; first-hello-interval is the time to wait in seconds before sending the first Hello Interest |
| 65 | |
| 66 | first-hello-interval 10 ; Default value 10. Valid values 0-10 |
| 67 | |
Nick Gordon | d5c1a37 | 2016-10-31 13:56:23 -0500 | [diff] [blame] | 68 | face-dataset-fetch-tries 3 ; default is 3. Valid values 1-10. The FaceDataset is |
| 69 | ; gotten from NFD, and is needed to configure NLSR |
| 70 | ; correctly. It is recommended not to set this |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 71 | ; variable too high, because it could cause |
Nick Gordon | d5c1a37 | 2016-10-31 13:56:23 -0500 | [diff] [blame] | 72 | ; congestion for NFD. |
| 73 | |
| 74 | face-dataset-fetch-interval 3600 ; default is 3600. Valid values 1800-5400. |
| 75 | ; This controls how often (in seconds) NLSR will attempt to |
| 76 | ; fetch a FaceStatus dataset from NFD. |
| 77 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 78 | ; neighbor command is used to configure router's neighbor. Each neighbor will need |
| 79 | ; one block of neighbor command |
| 80 | |
| 81 | neighbor |
| 82 | { |
| 83 | name /ndn/edu/memphis/%C1.Router/cs/castor ; name prefix of the neighbor router consists |
| 84 | ; of network, site-name and router-name |
| 85 | |
| 86 | face-uri udp://castor.cs.memphis.edu ; face uri of the face connected to the neighbor |
| 87 | link-cost 25 ; cost of the connecting link to neighbor |
| 88 | } |
| 89 | |
| 90 | neighbor |
| 91 | { |
| 92 | name /ndn/edu/memphis/%C1.Router/cs/mira ; name prefix of the neighbor router consists |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 93 | ; of network, site-name and router-name |
| 94 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 95 | face-uri udp://mira.cs.memphis.edu ; face uri of the face connected to the neighbor |
| 96 | link-cost 30 ; cost of the connecting link to neighbor |
| 97 | } |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 98 | } |
| 99 | |
| 100 | ; the hyperbolic section contains the configuration settings of enabling a router to calculate |
| 101 | ; routing table using [hyperbolic routing table calculation](http://arxiv.org/abs/0805.1266) method |
| 102 | |
| 103 | hyperbolic |
| 104 | { |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 105 | ; commands in this section follows a strict order |
| 106 | ; the switch is used to set hyperbolic routing calculation in NLSR |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 107 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 108 | state off ; default value 'off', set value 'on' to enable hyperbolic routing table |
Junxiao Shi | f09e263 | 2015-01-02 18:15:01 -0700 | [diff] [blame] | 109 | ; calculation which turns link state routing 'off'. set value to 'dry-run' |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 110 | ; to test hyperbolic routing and compare with link state routing. |
akmhoque | ba09474 | 2014-02-28 11:47:21 -0600 | [diff] [blame] | 111 | |
| 112 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 113 | radius 123.456 ; radius of the router in hyperbolic coordinate system |
Muktadir R Chowdhury | b00dc2a | 2016-11-05 10:48:58 -0600 | [diff] [blame] | 114 | angle 1.45,2.36 ; angle of the router in hyperbolic coordinate system |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 115 | } |
| 116 | |
| 117 | |
Nick Gordon | d5c1a37 | 2016-10-31 13:56:23 -0500 | [diff] [blame] | 118 | ; the fib section is used to configure fib entrys type to ndn FIB updated by NLSR |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 119 | |
| 120 | fib |
| 121 | { |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 122 | ; the max-faces-per-prefix is used to limit the number of faces for each name prefixes |
| 123 | ; by NLSR in ndn FIB |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 124 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 125 | max-faces-per-prefix 3 ; default value 0. Valid value 0-60. By default (value 0) NLSR adds |
| 126 | ; all available faces for each reachable name prefixes in NDN FIB |
Vince Lehman | 7b61658 | 2014-10-17 16:25:39 -0500 | [diff] [blame] | 127 | |
| 128 | ; routing-calc-interval is the time to wait in seconds after a routing table calculation is |
| 129 | ; scheduled before actually performing the routing table calculation |
| 130 | |
| 131 | routing-calc-interval 15 ; default value 15. Valid values 0-15. It is recommended that |
| 132 | ; routing-calc-interval have a higher value than adj-lsa-build-interval |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 133 | } |
| 134 | |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 135 | ; the advertising section contains the configuration settings of the name prefixes |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 136 | ; hosted by this router |
| 137 | |
| 138 | advertising |
| 139 | { |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 140 | ; the ndnname is used to advertised name from the router. To advertise each name prefix |
| 141 | ; configure one block of ndnname configuration command for every name prefix. |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 142 | |
Alexander Afanasyev | 8388ec6 | 2014-08-16 18:38:57 -0700 | [diff] [blame] | 143 | prefix /ndn/edu/memphis/cs/netlab ; name in ndn URI format |
| 144 | prefix /ndn/edu/memphis/sports/basketball |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 145 | } |
| 146 | |
| 147 | security |
| 148 | { |
| 149 | validator |
| 150 | { |
| 151 | rule |
| 152 | { |
Laqin Fan | d8c9d8c | 2017-01-18 21:45:14 +0000 | [diff] [blame] | 153 | id "NLSR Hello Rule" |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 154 | for data |
| 155 | filter |
| 156 | { |
| 157 | type name |
akmhoque | 93f1a07 | 2014-06-19 16:24:28 -0500 | [diff] [blame] | 158 | regex ^[^<NLSR><INFO>]*<NLSR><INFO><><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 159 | } |
| 160 | checker |
| 161 | { |
| 162 | type customized |
| 163 | sig-type rsa-sha256 |
| 164 | key-locator |
| 165 | { |
| 166 | type name |
| 167 | hyper-relation |
| 168 | { |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 169 | k-regex ^([^<KEY><NLSR>]*)<NLSR><KEY><>$ |
Yingdi Yu | 6a3a4dd | 2014-06-20 14:10:39 -0700 | [diff] [blame] | 170 | k-expand \\1 |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 171 | h-relation equal |
akmhoque | 93f1a07 | 2014-06-19 16:24:28 -0500 | [diff] [blame] | 172 | p-regex ^([^<NLSR><INFO>]*)<NLSR><INFO><><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 173 | p-expand \\1 |
| 174 | } |
| 175 | } |
| 176 | } |
| 177 | } |
| 178 | |
| 179 | rule |
| 180 | { |
Laqin Fan | d8c9d8c | 2017-01-18 21:45:14 +0000 | [diff] [blame] | 181 | id "NLSR LSA Rule" |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 182 | for data |
| 183 | filter |
| 184 | { |
| 185 | type name |
akmhoque | a816bee | 2014-06-24 14:37:40 -0500 | [diff] [blame] | 186 | regex ^[^<NLSR><LSA>]*<NLSR><LSA> |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 187 | } |
| 188 | checker |
| 189 | { |
| 190 | type customized |
| 191 | sig-type rsa-sha256 |
| 192 | key-locator |
| 193 | { |
| 194 | type name |
| 195 | hyper-relation |
| 196 | { |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 197 | k-regex ^([^<KEY><NLSR>]*)<NLSR><KEY><>$ |
Yingdi Yu | 6a3a4dd | 2014-06-20 14:10:39 -0700 | [diff] [blame] | 198 | k-expand \\1 |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 199 | h-relation equal |
Muktadir R Chowdhury | aa3b085 | 2015-08-06 13:08:56 -0500 | [diff] [blame] | 200 | ; the last four components in the prefix should be <lsaType><seqNo><version><segmentNo> |
Ashlesh Gawande | 54e726c | 2017-01-30 12:48:06 -0600 | [diff] [blame] | 201 | p-regex ^<localhop>([^<NLSR><LSA>]*)<NLSR><LSA>(<>*)<><><><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 202 | p-expand \\1\\2 |
| 203 | } |
| 204 | } |
| 205 | } |
| 206 | } |
| 207 | |
| 208 | rule |
| 209 | { |
Laqin Fan | d8c9d8c | 2017-01-18 21:45:14 +0000 | [diff] [blame] | 210 | id "NLSR Hierarchy Exception Rule" |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 211 | for data |
| 212 | filter |
| 213 | { |
| 214 | type name |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 215 | regex ^[^<KEY><%C1.Router>]*<%C1.Router>[^<KEY><NLSR>]*<KEY><><><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 216 | } |
| 217 | checker |
| 218 | { |
| 219 | type customized |
| 220 | sig-type rsa-sha256 |
| 221 | key-locator |
| 222 | { |
| 223 | type name |
| 224 | hyper-relation |
| 225 | { |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 226 | k-regex ^([^<KEY><%C1.Operator>]*)<%C1.Operator>[^<KEY>]*<KEY><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 227 | k-expand \\1 |
| 228 | h-relation equal |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 229 | p-regex ^([^<KEY><%C1.Router>]*)<%C1.Router>[^<KEY>]*<KEY><><><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 230 | p-expand \\1 |
| 231 | } |
| 232 | } |
| 233 | } |
| 234 | } |
| 235 | |
| 236 | rule |
| 237 | { |
Laqin Fan | d8c9d8c | 2017-01-18 21:45:14 +0000 | [diff] [blame] | 238 | id "NLSR Hierarchical Rule" |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 239 | for data |
| 240 | filter |
| 241 | { |
| 242 | type name |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 243 | regex ^[^<KEY>]*<KEY><><><>$ |
Yingdi Yu | 20e3a6e | 2014-05-26 23:16:10 -0700 | [diff] [blame] | 244 | } |
| 245 | checker |
| 246 | { |
| 247 | type hierarchical |
| 248 | sig-type rsa-sha256 |
| 249 | } |
| 250 | } |
| 251 | |
| 252 | trust-anchor |
| 253 | { |
| 254 | type file |
| 255 | file-name "root.cert" |
| 256 | } |
| 257 | } |
alvy | 297f416 | 2015-03-03 17:15:33 -0600 | [diff] [blame] | 258 | |
| 259 | prefix-update-validator |
| 260 | { |
| 261 | rule |
| 262 | { |
| 263 | id "NLSR ControlCommand Rule" |
| 264 | for interest |
| 265 | filter |
| 266 | { |
| 267 | type name |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 268 | ; /<prefix>/<management-module>/<command-verb>/<control-parameters> |
| 269 | ; /<timestamp>/<random-value>/<signed-interests-components> |
| 270 | regex ^<localhost><nlsr><prefix-update>[<advertise><withdraw>]<><><>$ |
alvy | 297f416 | 2015-03-03 17:15:33 -0600 | [diff] [blame] | 271 | } |
| 272 | checker |
| 273 | { |
| 274 | type customized |
| 275 | sig-type rsa-sha256 |
| 276 | key-locator |
| 277 | { |
| 278 | type name |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 279 | regex ^([^<KEY><%C1.Operator>]*)<%C1.Operator>[^<KEY>]*<KEY><>$ |
alvy | 297f416 | 2015-03-03 17:15:33 -0600 | [diff] [blame] | 280 | } |
| 281 | } |
| 282 | } |
| 283 | |
| 284 | rule |
| 285 | { |
| 286 | id "NLSR Hierarchy Rule" |
| 287 | for data |
| 288 | filter |
| 289 | { |
| 290 | type name |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 291 | regex ^[^<KEY>]*<KEY><><><>$ |
alvy | 297f416 | 2015-03-03 17:15:33 -0600 | [diff] [blame] | 292 | } |
| 293 | checker |
| 294 | { |
| 295 | type hierarchical |
| 296 | sig-type rsa-sha256 |
| 297 | } |
| 298 | } |
| 299 | |
| 300 | trust-anchor |
| 301 | { |
| 302 | type file |
| 303 | file-name "site.cert" |
| 304 | } |
| 305 | } |
Muktadir Chowdhury | f04f989 | 2017-08-20 20:42:56 -0500 | [diff] [blame] | 306 | |
Vince Lehman | 9f51efd | 2014-09-18 14:46:01 -0500 | [diff] [blame] | 307 | ; cert-to-publish "root.cert" ; optional, a file containing the root certificate |
| 308 | ; Only the router that is designated to publish the root cert |
| 309 | ; needs to specify this |
| 310 | |
| 311 | ; cert-to-publish "site.cert" ; optional, a file containing the site certificate |
| 312 | ; Only the router that is designated to publish the site cert |
| 313 | ; needs to specify this |
| 314 | |
| 315 | ; cert-to-publish "operator.cert" ; optional, a file containing the operator certificate |
| 316 | ; Only the router that is designated to publish the operator |
| 317 | ; cert needs to specify this |
| 318 | |
akmhoque | 50125a9 | 2014-06-30 08:54:17 -0500 | [diff] [blame] | 319 | cert-to-publish "router.cert" ; required, a file containing the router certificate. |
akmhoque | 157b0a4 | 2014-05-13 00:26:37 -0500 | [diff] [blame] | 320 | } |