1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
|
Example Scripts
===============
print\_all.py
-------------
Description
~~~~~~~~~~~
This script displays the contents of a MRT format data.
Usage
~~~~~
::
print_all.py path_to_file
Result
~~~~~~
::
---------------------------------------------------------------
MRT Header
Timestamp: 1392828028(2014-02-20 01:40:28)
Type: 16(BGP4MP)
Subtype: 5(BGP4MP_STATE_CHANGE_AS4)
Length: 24
BGP4MP_STATE_CHANGE_AS4
Peer AS Number: 100
Local AS Number: 64512
Interface Index: 0
Address Family: 1(AFI_IPv4)
Peer IP Address: 192.168.1.21
Local IP Address: 192.168.1.100
Old State: 5(OpenConfirm)
New State: 6(Established)
---------------------------------------------------------------
MRT Header
Timestamp: 1392828028(2014-02-20 01:40:28)
Type: 16(BGP4MP)
Subtype: 4(BGP4MP_MESSAGE_AS4)
...
If error occurred, it displays data in byte as below.
::
---------------------------------------------------------------
MRT Header
Timestamp: 1442843462(2015-09-21 22:51:02)
Type: 16(BGP4MP)
Subtype: 5(BGP4MP_STATE_CHANGE_AS4)
Length: 12
MRT Data Error: Unsupported AFI 8(Unknown)
00 00 00 00 00 00 00 00 00 01 00 08
...
---------------------------------------------------------------
MRT Header
Timestamp: 1443251615(2015-09-26 16:13:35)
Type: 16(BGP4MP)
Subtype: 2(BGP4MP_ENTRY)
Length: 80
MRT Data Error: Unsupported BGP4MP subtype 2(BGP4MP_ENTRY)
fd e8 fd e8 00 00 00 01 c0 a8 01 66 c0 a8 01 0a
00 00 00 01 56 06 43 5f 00 01 01 04 c0 a8 00 0b
10 c0 a8 00 2b 40 01 01 00 40 02 04 02 01 fd f3
40 05 04 00 00 00 64 c0 07 08 00 00 fd e8 c0 a8
00 0b 80 09 04 c0 a8 00 0b 80 0a 04 c0 a8 00 0a
mrt2exabgp.py (formerly exabgp\_conf.py)
----------------------------------------
Description
~~~~~~~~~~~
| This script converts MRT format to ExaBGP_ config/API format and displays it.
| If you want to know how to use ExaBGP API, please read `the wiki`_.
.. _ExaBGP: https://github.com/Exa-Networks/exabgp
.. _`the wiki`: https://github.com/YoshiyukiYamauchi/mrtparse/wiki
Usage
~~~~~
::
usage: mrt2exabgp.py [-h] [-r ROUTER_ID] [-l LOCAL_AS] [-p PEER_AS]
[-L LOCAL_ADDR] [-n NEIGHBOR] [-4 [NEXT_HOP]]
[-6 [NEXT_HOP]] [-a] [-s] [-A] [-G [NUM]] [-g [NUM]] [-P]
path_to_file
This script converts to ExaBGP format.
positional arguments:
path_to_file specify path to MRT format file
optional arguments:
-h, --help show this help message and exit
-r ROUTER_ID specify router-id (default: 192.168.0.1)
-l LOCAL_AS specify local AS number (default: 64512)
-p PEER_AS specify peer AS number (default: 65000)
-L LOCAL_ADDR specify local address (default: 192.168.1.1)
-n NEIGHBOR specify neighbor address (default: 192.168.1.100)
-4 [NEXT_HOP] convert IPv4 entries and change IPv4 next-hop if specified
-6 [NEXT_HOP] convert IPv6 entries and change IPv6 next-hop if specified
-a convert all entries (default: convert only first entry per
one prefix)
-s convert only entries from a single asn (the peer asn, specify
as -p PEER_ASN)
-A convert to ExaBGP API format
-G [NUM] convert to ExaBGP API format and group updates with the same
attributes for each spceified the number of prefixes using
"announce attributes ..." syntax (default: 1000000)
-g [NUM] convert to ExaBGP API format and group updates with the same
attributes for each spceified the number of prefixes using
"announce attribute ..." old syntax (default: 1000000)
-P convert to ExaBGP API program
Result (Config format)
~~~~~~~~~~~~~~~~~~~~~~
Without "-A"/"-G"/"-g"/"-P" options, it outputs a ExaBGP config.
::
neighbor 192.168.1.1 {
router-id 192.168.0.2;
local-address 192.168.1.2;
local-as 64512;
peer-as 65000;
graceful-restart;
aigp enable;
static {
route 1.0.0.0/24 origin IGP as-path [57821 12586 13101 15169 ] community [12586:147 12586:13000 64587:13101] next-hop 192.168.1.254;
route 1.0.4.0/24 origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254;
route 1.0.5.0/24 origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254;
route 1.0.6.0/24 origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254;
route 1.0.7.0/24 origin IGP as-path [57821 6939 4826 56203 56203 56203 ] next-hop 192.168.1.254;
route 1.0.64.0/18 origin IGP as-path [57821 6939 4725 4725 7670 7670 7670 18144 ] atomic-aggregate aggregator (18144:219.118.225.189) next-hop 192.168.1.254;
route 1.0.128.0/17 origin IGP as-path [57821 12586 3257 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254;
route 1.0.128.0/18 origin IGP as-path [57821 12586 3257 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254;
...
}
}
Result in "-A" option (API format)
~~~~~~~~~~~~~~~~~~~
This option is possible to improve the performance in most cases.
::
announce route 1.0.0.0/24 origin IGP as-path [57821 12586 13101 15169 ] community [12586:147 12586:13000 64587:13101] next-hop 192.168.1.254
announce route 1.0.4.0/24 origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254
announce route 1.0.5.0/24 origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254
announce route 1.0.6.0/24 origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254
announce route 1.0.7.0/24 origin IGP as-path [57821 6939 4826 56203 56203 56203 ] next-hop 192.168.1.254
announce route 1.0.64.0/18 origin IGP as-path [57821 6939 4725 4725 7670 7670 7670 18144 ] atomic-aggregate aggregator (18144:219.118.225.189) next-hop 192.168.1.254
announce route 1.0.128.0/17 origin IGP as-path [57821 12586 3257 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254
announce route 1.0.128.0/18 origin IGP as-path [57821 12586 3257 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254
...
Result in "-G" option (API grouping format)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| This option is possible to improve the performance, especially when advertising huge prefixes like full internet routes.
| It outputs with "announce attributes ..." syntax.
| If you use MRT format data included "BGP4MP" or "BGP4MP_ET", you must use this or "-g" option.
| In that case "NUM" argument is ignored even if specified it.
::
announce attributes origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254 nlri 1.0.4.0/24 1.0.5.0/24 1.0.6.0/24 103.2.176.0/24 103.2.177.0/24 103.2.178.0/24 103.2.179.0/24
announce attributes origin IGP as-path [57821 6939 4826 56203 56203 56203 ] next-hop 192.168.1.254 nlri 1.0.7.0/24
announce attributes origin IGP as-path [57821 6939 4725 4725 7670 7670 7670 18144 ] atomic-aggregate aggregator (18144:219.118.225.189) next-hop 192.168.1.254 nlri 1.0.64.0/18 58.183.0.0/16 222.231.64.0/18
announce attributes origin IGP as-path [57821 12586 3257 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254 nlri 1.0.128.0/17 1.0.128.0/18 1.0.192.0/18 1.2.128.0/17 1.4.128.0/17 1.4.128.0/18 1.179.128.0/17 101.51.0.0/16 101.51.64.0/18 113.53.0.0/16 113.53.0.0/18 118.172.0.0/16 118.173.0.0/16 118.173.192.0/18 118.174.0.0/16 118.175.0.0/16 118.175.0.0/18 125.25.0.0/16 125.25.128.0/18 180.180.0.0/16 182.52.0.0/16 182.52.0.0/17 182.52.128.0/18 182.53.0.0/16 182.53.0.0/18 182.53.192.0/18
announce attributes origin IGP as-path [4608 1221 4637 4651 9737 23969 ] next-hop 192.168.1.254 nlri 1.0.128.0/24
announce attributes origin IGP as-path [57821 12586 3257 1299 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254 nlri 1.0.160.0/19 1.0.224.0/19 118.173.64.0/19 118.173.192.0/19 118.174.128.0/19 118.174.192.0/19 118.175.160.0/19 125.25.0.0/19 125.25.128.0/19 182.53.0.0/19 203.113.0.0/19 203.113.96.0/19
announce attributes origin IGP as-path [57821 12586 3257 4134 ] community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254 nlri 1.1.8.0/24 36.106.0.0/16 36.108.0.0/16 36.109.0.0/16 101.248.0.0/16 106.0.4.0/22 106.7.0.0/16 118.85.204.0/24 118.85.215.0/24 120.88.8.0/21 122.198.64.0/18 171.44.0.0/16 183.91.56.0/24 183.91.57.0/24 202.80.192.0/22 221.231.151.0/24
announce attributes origin IGP as-path [57821 12586 13101 15412 17408 58730 ] community [12586:147 12586:13000 64587:13101] next-hop 192.168.1.254 nlri 1.1.32.0/24 1.2.1.0/24 1.10.8.0/24 14.0.7.0/24 27.34.239.0/24 27.109.63.0/24 36.37.0.0/24 42.0.8.0/24 49.128.2.0/24 49.246.249.0/24 101.102.104.0/24 106.3.174.0/24 118.91.255.0/24 123.108.143.0/24 180.200.252.0/24 183.182.9.0/24 202.6.6.0/24 202.12.98.0/24 202.85.202.0/24 202.131.63.0/24 211.155.79.0/24 211.156.109.0/24 218.98.224.0/24 218.246.137.0/24
...
Result in "-g" option (API grouping format)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| This option is possible to improve the performance, especially when advertising huge prefixes like full internet routes.
| It outputs with "announce attribute ..." old syntax.
| If you use MRT format data included "BGP4MP" or "BGP4MP_ET", you must use this or "-G" option.
| In that case "NUM" argument is ignored even if specified it.
::
announce attribute origin IGP as-path [57821 6939 4826 56203 ] next-hop 192.168.1.254 nlri 1.0.4.0/24 1.0.5.0/24 1.0.6.0/24 103.2.176.0/24 103.2.177.0/24 103.2.178.0/24 103.2.179.0/24
announce attribute origin IGP as-path [57821 6939 4826 56203 56203 56203 ] next-hop 192.168.1.254 nlri 1.0.7.0/24
announce attribute origin IGP as-path [57821 6939 4725 4725 7670 7670 7670 18144 ] atomic-aggregate aggregator (18144:219.118.225.189) next-hop 192.168.1.254 nlri 1.0.64.0/18 58.183.0.0/16 222.231.64.0/18
announce attribute origin IGP as-path [57821 12586 3257 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254 nlri 1.0.128.0/17 1.0.128.0/18 1.0.192.0/18 1.2.128.0/17 1.4.128.0/17 1.4.128.0/18 1.179.128.0/17 101.51.0.0/16 101.51.64.0/18 113.53.0.0/16 113.53.0.0/18 118.172.0.0/16 118.173.0.0/16 118.173.192.0/18 118.174.0.0/16 118.175.0.0/16 118.175.0.0/18 125.25.0.0/16 125.25.128.0/18 180.180.0.0/16 182.52.0.0/16 182.52.0.0/17 182.52.128.0/18 182.53.0.0/16 182.53.0.0/18 182.53.192.0/18
announce attribute origin IGP as-path [4608 1221 4637 4651 9737 23969 ] next-hop 192.168.1.254 nlri 1.0.128.0/24
announce attribute origin IGP as-path [57821 12586 3257 1299 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254 nlri 1.0.160.0/19 1.0.224.0/19 118.173.64.0/19 118.173.192.0/19 118.174.128.0/19 118.174.192.0/19 118.175.160.0/19 125.25.0.0/19 125.25.128.0/19 182.53.0.0/19 203.113.0.0/19 203.113.96.0/19
announce attribute origin IGP as-path [57821 12586 3257 4134 ] community [12586:145 12586:12000 64587:3257] next-hop 192.168.1.254 nlri 1.1.8.0/24 36.106.0.0/16 36.108.0.0/16 36.109.0.0/16 101.248.0.0/16 106.0.4.0/22 106.7.0.0/16 118.85.204.0/24 118.85.215.0/24 120.88.8.0/21 122.198.64.0/18 171.44.0.0/16 183.91.56.0/24 183.91.57.0/24 202.80.192.0/22 221.231.151.0/24
announce attribute origin IGP as-path [57821 12586 13101 15412 17408 58730 ] community [12586:147 12586:13000 64587:13101] next-hop 192.168.1.254 nlri 1.1.32.0/24 1.2.1.0/24 1.10.8.0/24 14.0.7.0/24 27.34.239.0/24 27.109.63.0/24 36.37.0.0/24 42.0.8.0/24 49.128.2.0/24 49.246.249.0/24 101.102.104.0/24 106.3.174.0/24 118.91.255.0/24 123.108.143.0/24 180.200.252.0/24 183.182.9.0/24 202.6.6.0/24 202.12.98.0/24 202.85.202.0/24 202.131.63.0/24 211.155.79.0/24 211.156.109.0/24 218.98.224.0/24 218.246.137.0/24
...
Result in "-P" option (API program format)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| This option is useful when using the same MRT data repeatedly.
| It can be used together with "-G" or "-g" option.
::
#!/usr/bin/env python
import sys
import time
msgs = [
'announce route 0.0.0.0/0 origin IGP as-path [8758 6830 ] community [8758:110 8758:300] next-hop 192.168.1.254',
'announce route 1.0.4.0/24 origin IGP as-path [50304 174 4637 1221 38803 56203 ] next-hop 192.168.1.254',
'announce route 1.0.5.0/24 origin IGP as-path [50304 174 4637 1221 38803 56203 ] next-hop 192.168.1.254',
'announce route 1.0.6.0/24 origin IGP as-path [50304 174 4637 1221 38803 56203 56203 56203 ] next-hop 192.168.1.254',
'announce route 1.0.38.0/24 origin IGP as-path [50304 10026 24155 ] next-hop 192.168.1.254',
'announce route 1.0.64.0/18 origin IGP as-path [50304 174 209 2516 7670 18144 ] atomic-aggregate aggregator (18144:219.118.225.188) next-hop 192.168.1.254',
'announce route 1.0.128.0/17 origin IGP as-path [50304 24482 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) next-hop 192.168.1.254',
'announce route 1.0.128.0/18 origin IGP as-path [50304 24482 38040 9737 ] atomic-aggregate aggregator (9737:203.113.12.254) next-hop 192.168.1.254',
...
]
while msgs:
msg = msgs.pop(0)
if isinstance(msg, str):
sys.stdout.write(msg + '\n')
sys.stdout.flush()
else:
time.sleep(msg)
while True:
time.sleep(1)
slice.py
--------
Description
~~~~~~~~~~~
| This script outputs the following data of a MRT format file.
|
| 1. The data for the interval of the specified seconds from the
specified start time to the specified end time.
| 2. The data from the specified start time to the specified end time.
| 3. The data for the interval of the specified seconds.
Usage
~~~~~
::
usage: slice.py [-h] [-s START\_TIME] [-e END\_TIME] [-i INTERVAL] [-c {gz,bz2}] path_to_file
This script slices MRT format data.
positional arguments:
path_to_file specify path to MRT format file
optional arguments:
-h, --help show this help message and exit
-s START_TIME specify start time in format YYYY-MM-DD HH:MM:SS
-e END_TIME specify end time in format YYYY-MM-DD HH:MM:SS
-i INTERVAL specify interval in seconds
-c {gz,bz2} specify compress type (gz, bz2)
Result
~~~~~~
::
# slice.py -s '2015-04-26 03:26:00' -e '2014-04-26 03:27:00' -i 10 -c bz2 -f latest-update.gz
# ls
latest-update-20150426-032600.bz2
latest-update-20150426-032610.bz2
latest-update-20150426-032620.bz2
latest-update-20150426-032630.bz2
latest-update-20150426-032640.bz2
latest-update-20150426-032650.bz2
summary.py
----------
Description
~~~~~~~~~~~
This script displays the summary of a MRT format file.
Usage
~~~~~
::
summary.py path_to_file
Result
~~~~~~
::
[2014-08-11 03:45:00 - 2014-08-11 03:49:59]
BGP4MP: 5973
BGP4MP_MESSAGE: 34
UPDATE: 24
KEEPALIVE: 10
BGP4MP_MESSAGE_AS4: 5896
UPDATE: 5825
KEEPALIVE: 71
BGP4MP_STATE_CHANGE_AS4: 43
Idle: 1
Connect: 20
Active: 18
OpenSent: 4
mrt2bgpdump.py
--------------
Description
~~~~~~~~~~~
This script converts to bgpdump_ format.
.. _bgpdump: https://bitbucket.org/ripencc/bgpdump/wiki/Home
Usage
~~~~~
::
usage: mrt2bgpdump.py [-h] [-m] [-M] [-O [file]] [-s] [-v] [-t {dump,change}][-p] path_to_file
This script converts to bgpdump format.
positional arguments:
path_to_file specify path to MRT format file
optional arguments:
-h, --help show this help message and exit
-m one-line per entry with unix timestamps
-M one-line per entry with human readable timestamps(default
format)
-O [file] output to a specified file
-s output to STDOUT(default output)
-v output to STDERR
-t {dump,change} timestamps for RIB dumps reflect the time of the dump or
the last route modification(default: dump)
-p show packet index at second position
Result
~~~~~~
::
BGP4MP|0|1438386900|A|193.0.0.56|3333|204.80.242.0/24|3333 1273 7922 33667 54169 54169 54169 54169 54169 54169 54169 54169|IGP|193.0.0.56|0|0|1273:21000|NAG||
BGP4MP|1|1438386900|A|2405:fc00::6|37989|2001:4c0:2001::/48|37989 4844 2914 174 855|IGP|2405:fc00::6|0|0||NAG||
BGP4MP|1|1438386900|A|2405:fc00::6|37989|2001:4c0:6002::/48|37989 4844 2914 174 855|IGP|2405:fc00::6|0|0||NAG||
BGP4MP|2|1438386900|A|146.228.1.3|1836|189.127.0.0/21|1836 174 12956 262589 27693|IGP|146.228.1.3|0|0|1836:110 1836:6000 1836:6031|NAG|27693 189.127.15.253|
BGP4MP|4|1438386900|A|2405:fc00::6|37989|2406:e400:1a::/48|37989 4844 7642|INCOMPLETE|2405:fc00::6|0|0||NAG||
BGP4MP|5|1438386900|A|2001:8e0:0:ffff::9|8758|2c0f:fe90::/32|8758 174 2914 30844 37105 37105 37105 36943|IGP|2001:8e0:0:ffff::9|0|0|174:21100 174:22005 8758:110 8758:301|NAG||
BGP4MP|6|1438386900|A|213.200.87.254|3257|187.110.144.0/20|3257 174 16735 27693 53117|IGP|213.200.87.254|0|10|3257:8093 3257:30235 3257:50002 3257:51100 3257:51102|NAG||
BGP4MP|7|1438386900|A|213.200.87.254|3257|187.95.16.0/20|3257 174 16735 27693 53081|IGP|213.200.87.254|0|10|3257:8063 3257:30252 3257:50002 3257:51300 3257:51302|NAG||
BGP4MP|8|1438386900|A|213.200.87.254|3257|189.127.208.0/21|3257 174 16735 27693 28235|IGP|213.200.87.254|0|10|3257:8093 3257:30235 3257:50002 3257:51100 3257:51102|NAG||
BGP4MP|8|1438386900|A|213.200.87.254|3257|189.127.216.0/21|3257 174 16735 27693 28235|IGP|213.200.87.254|0|10|3257:8093 3257:30235 3257:50002 3257:51100 3257:51102|NAG||
...
Authors
-------
| Tetsumune KISO t2mune@gmail.com
| Yoshiyuki YAMAUCHI info@greenhippo.co.jp
| Nobuhiro ITOU js333123@gmail.com
License
-------
| Licensed under the `Apache License, Version 2.0`_
| Copyright © 2017 Tetsumune KISO
.. _`Apache License, Version 2.0`: http://www.apache.org/licenses/LICENSE-2.0
|
