summaryrefslogtreecommitdiffhomepage
path: root/docs/sources/evpn.md
diff options
context:
space:
mode:
authorIWASE Yusuke <iwase.yusuke0@gmail.com>2017-12-25 23:25:41 +0900
committerFUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>2017-12-30 20:33:37 +0900
commit4aa2c438bfcf8b79bdc8c2047dfaa3a06471ef29 (patch)
tree312c4d51b48dd2fcf750666f1763844ae3aebae6 /docs/sources/evpn.md
parent06be3c5c2637aebca8a887d9f8d87cc1e9a7692a (diff)
evpn.md: Add description and examples for ESI
Also this patch updates table of contents. Signed-off-by: IWASE Yusuke <iwase.yusuke0@gmail.com>
Diffstat (limited to 'docs/sources/evpn.md')
-rw-r--r--docs/sources/evpn.md68
1 files changed, 68 insertions, 0 deletions
diff --git a/docs/sources/evpn.md b/docs/sources/evpn.md
index e457242c..176dca3c 100644
--- a/docs/sources/evpn.md
+++ b/docs/sources/evpn.md
@@ -6,6 +6,12 @@ still very experimental.
## Contents
- [CLI Syntax](#cli-syntax)
+ - [Ethernet Segment Identifier](#ethernet-segment-identifier)
+ - [Ethernet Auto-discovery Route](#ethernet-auto-discovery-route)
+ - [MAC/IP Advertisement Route](#macip-advertisement-route)
+ - [Inclusive Multicast Ethernet Tag Route](#inclusive-multicast-ethernet-tag-route)
+ - [Ethernet Segment Route](#ethernet-segment-route)
+ - [IP Prefix Route](#ip-prefix-route)
- [BaGPipe](#bagpipe)
- [Configuration](#configuration)
- [Advertising EVPN route](#advertising-evpn-route)
@@ -15,6 +21,68 @@ still very experimental.
## CLI Syntax
+### Ethernet Segment Identifier
+
+Some route types requires to specify Ethernet Segment Identifier (ESI) for its
+argument. The supported ESI types and their formats are the following.
+
+| Type | Format | Description |
+| ---- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| 0 | single-homed | Reserved keyword for arbitrary ESI type to denote a single-homed site. |
+| 0 | 0 | The same with "single-homed". |
+| 0 | ARBITRARY \<Value> | Arbitrary ESI type with arbitrary value. Value should be colon separated hex values (similar to MAC address). |
+| 1 | LACP \<MAC> \<Port Key> | Type for LACP configured segment. |
+| 2 | MSTP \<MAC> \<Priority> | Type for L2 bridge protocol (e.g., Multiple Spanning Tree Protocol) configured segment. |
+| 3 | MAC \<MAC> \<Discriminator> | Type for ESI based on MAC address. |
+| 4 | ROUTERID \<Router ID> \<Discriminator> | Type for ESI based on Router ID. |
+| 5 | AS \<AS> \<Discriminator> | Type for ESI based on AS number. |
+
+### Example - Ethernet Segment Identifier
+
+```bash
+# single-homed
+$ gobgp global rib -a evpn add a-d esi single-homed etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:single-homed][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+
+# ARBITRARY <Value>
+$ gobgp global rib -a evpn add a-d esi ARBITRARY 11:22:33:44:55:66:77:88:99 etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:ESI_ARBITRARY | 11:22:33:44:55:66:77:88:99][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+
+# LACP <MAC> <Port Key>
+$ gobgp global rib -a evpn add a-d esi LACP aa:bb:cc:dd:ee:ff 10 etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:ESI_LACP | system mac aa:bb:cc:dd:ee:ff, port key 10][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+
+# MSTP <MAC> <Priority>
+$ gobgp global rib -a evpn add a-d esi MSTP aa:bb:cc:dd:ee:ff 10 etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:ESI_MSTP | bridge mac aa:bb:cc:dd:ee:ff, priority 10][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+
+# MAC <MAC> <Discriminator>
+$ gobgp global rib -a evpn add a-d esi MAC aa:bb:cc:dd:ee:ff 10 etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:ESI_MAC | system mac aa:bb:cc:dd:ee:ff, local discriminator 10][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+
+# ROUTERID <Router ID> <Discriminator>
+$ gobgp global rib -a evpn add a-d esi ROUTERID 1.1.1.1 10 etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:ESI_ROUTERID | router id 1.1.1.1, local discriminator 10][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+
+# AS <AS> <Discriminator>
+$ gobgp global rib -a evpn add a-d esi AS 65000 10 etag 100 label 200 rd 1.1.1.1:100
+$ gobgp global rib -a evpn
+ Network Labels Next Hop AS_PATH Age Attrs
+*> [type:A-D][rd:1.1.1.1:100][esi:ESI_AS | as 65000, local discriminator 10][etag:100] [200] 0.0.0.0 00:00:00 [{Origin: ?}]
+```
+
### Ethernet Auto-discovery Route
```bash