howto/Quagga.md
... ...
@@ -18,47 +18,49 @@ To connect to bgpd use:
18 18
$ vtysh
19 19
20 20
Which provides an interactive interface.
21
-In this interface the following commands can be used:
21
+In this interface '?' can be used to list the available commands or subcommands.
22 22
23
-The following text use this placeholders:
23
+## Configure Quagga
24
+a minimal config would look like this:
24 25
25
-- `<AS>` your Autonomous System Number (only the digits)
26
-- `<GATEWAY_IP>` your gateway ip (the internal dn42 ip address you use on the host, where dn42 is running)
27
-- `<SUBNET>` your registered dn42 subnet, which you allocated on [nixnodes](https://io.nixnodes.net/)
28
-- `<PEER_IP>` dn42 ip of your peer who is connected with you using your favorite vpn/tunnel protocol (openvpn, ipsec, tinc, ...)
29
-- `<INTERFACE>` Interface which is used to connect to the peer, in case of openvpn it is the tun device
30
-- `<PEER_AS>` Autonomous System Number of your peer (only the digits)
26
+ vtysh> configure terminal
27
+ vtysh(config)> router bgp <your-asn>
28
+ vtysh(config-router)> neighbor <neighbor-ip> remote-as <neighbor-asn>
29
+ vtysh(config-router)> neighbor <neighbor-ip> interface <interface>
30
+ vtysh(config-router)> exit
31
+ vtysh(config)> exit
31 32
32
-## Configure a new ipv6 peering
33
+### IPv6
34
+for IPv6 do something like
33 35
34
-In your interactive vtysh session type the following:
36
+ vtysh> configure terminal
37
+ vtysh(config)> router bgp <your-asn>
38
+ vtysh(config-router)> neighbor <neighbor-ip> remote-as <neighbor-asn>
39
+ vtysh(config-router)> neighbor <neighbor-ip> interface <interface>
40
+ vtysh(config-router)> no neighbor <neighbor-ip> activate
41
+ vtysh(config-router)> address-family ipv6
42
+ vtysh(config-router-af)> neighbor <neighbor-ip> activate
43
+ vtysh(config-router-af)> exit
44
+ vtysh(config-router)> exit
45
+ vtysh(config)> exit
46
+
47
+### peer groups, prefix lists and such
48
+If you want to use 'prefix-list' to filter some of the prefixes quagga is receiving, you can use a 'peer-group' instead of apply the prefix list to every neighbor.
35 49
36
-```
37
-vtysh> configure terminal
38
-vtysh> router bgp <AS>
39
-vtysh> neighbor <PEER_IP> remote-as <PEER_AS>
40
-vtysh> neighbor <PEER_IP> peer-group dn
41
-vtysh> neighbor <PEER_IP> interface <INTERFACE>
42
-vtysh> no neighbor <PEER_IP> activate
43
-vtysh> exit
44
-vtysh> address-family ipv6
45
-vtysh> neighbor <PEER_IP> activate
46
-vtysh> neighbor <PEER_IP> soft-reconfiguration inbound
47
-vtysh> exit
48
-```
50
+Define a peer group:
49 51
50
-## Configure a new ipv4 peering
52
+ vtysh(config-router)> neighbor <peer-group-name> peer-group
53
+
54
+Apply to a neighbor:
55
+
56
+ vtysh(config-router)> neighbor <neighbor-ip> peer-group <name>
57
+
58
+Apply a prefix list for incoming prefixes to your peer group:
59
+
60
+ vtysh(config-router)> neighbor <peer-group-name> prefix-list <prefix-list-name> in
51 61
52
-```
53
-vtysh> configure terminal
54
-vtysh> router bgp <AS>
55
-vtysh> neighbor <PEER_IP> remote-as <PEER_AS>
56
-vtysh> neighbor <PEER_IP> peer-group dn
57
-vtysh> neighbor <PEER_IP> interface <INTERFACE>
58
-vtysh> exit
59
-```
60 62
61
-# show bpg session status
63
+## show bpg session status
62 64
63 65
in this example:
64 66
* an active bgp session exists with peer 64713.