MAP Configuration

29 min

MAP Configuration

show map interface [role {CE|BR}]

[Command] show map interface [role {CE|BR}]

[Purpose]

Display the MAP binding port

[Parameter]

Parameter	Description
CE	A Customer Edge device, which acts as the user's edge router in a MAP deployment
BR	A Border Relay device, which acts as the service provider's edge router in a MAP deployment

[View]

System view

[Use Cases]

sonic# show map interface
+-----------------------------+
| MAP_BR_ZONE |
+===============+
| Ethernet16 |
+------------------------------+
+------------------------------+
| MAP_CE_ZONE |
+===============+
+------------------------------+

show map-e domain [name domain_name|role {CE|BR}]

[Command] show map-e domain [name domain_name|role {CE|BR}]

[Purpose]

Display MAP-E configuration

[View]

System view

[Use Cases]

sonic# show map-e domain role BR
BR Domain:
Name : test1
basic-mapping-rule : BMR
rule_ipv6_prefix : 2001:db8:1012::/48
rule_ipv4_prefix : 192.0.2.0/24
ea_length : 16
psid_len : 8
psid_offset : 4
forwarding-mapping-rule : None
br-ipv6-address-rule : BRaddr
ipv6_address : 2001:db8:1012:1234::10/64
sharing-ip-no-embedded-rule : None
Params :
END

show map-e statistics [name domain_name|role {CE|BR}]

[Command] show map-e statistics [name domain_name|role {CE|BR}]

[Purpose]

Display MAP-E packet hit statistics

[View]

System view

[Use Cases]

sonic# show map-e statistics role BR
MAP-E Border Relay Statistics:
+--------+--------------+---------------+---------------+----------------+
| name | Input Pkts | Input Bytes | Output Pkts | Output Bytes |
+========+==============+===============+===============+================+
| test1 | 0 | 0 | 0 | 0 |
+--------+--------------+---------------+---------------+----------------+

show map-t domain [name domain_name|role {CE|BR}]

[Command] show map-t domain [name domain_name|role {CE|BR}]

[Purpose]

Display MAP-T configuration

[View]

System view

[Use Cases]

sonic# show map-t domain role BR
BR Domain:
Name : test2
basic-mapping-rule : BMR
rule_ipv6_prefix : 2001:db8:1012::/48
rule_ipv4_prefix : 192.0.2.0/24
ea_length : 16
psid_len : 8
psid_offset : 4
forwarding-mapping-rule : None
default-mapping-rule : DMR
ipv6_prefix : 2001:db8:1012:1234::/64
sharing-ip-no-embedded-rule : None
Params :
END

show map-t statistics [name domain_name|role {CE|BR}]

[Command] show map-t statistics [name domain_name|role {CE|BR}]

[Purpose]

Display MAP-T packet hit statistics

[View]

System view

[Use Cases]

sonic# show map-t statistics role BR
MAP-T Border Relay Statistics:
+--------+--------------+---------------+---------------+----------------+
| name | Input Pkts | Input Bytes | Output Pkts | Output Bytes |
+========+==============+===============+===============+================+
| test2 | 0 | 0 | 0 | 0 |
+--------+--------------+---------------+---------------+----------------+

show map-rule [rule_type {basic-mapping-rule|default-mapping-rule|br-ipv6-address-rule|sharing-ip-no-embedded-rule|local-ipv4-prefix-rule} | rule_name rule_name]

[Command] show map-rule [rule_type {basic-mapping-rule|default-mapping-rule|br-ipv6-address-rule|sharing-ip-no-embedded-rule|local-ipv4-prefix-rule} | rule_name rule_name]

[Purpose]

Display MAP rules

[View]

System view

[Use Cases]

sonic# show map-rule rule_type basic-mapping-rule
basic-mapping-rule:
+--------+--------------------+--------------------+--------------+------------+---------------+
| name | rule_ipv6_prefix | rule_ipv4_prefix | ea_bit_len | psid_len | psid_offset |
+========+====================+====================+==============+============+===============+
| BMR | 2001:db8:1012::/48 | 192.0.2.0/24 | 16 | 8 | 4 |
+--------+--------------------+--------------------+--------------+------------+---------------+

nat64 {map-zone-br|map-zone-ce} enable

[Command] nat64 {map-zone-br|map-zone-ce} enable

[Purpose]

Enable MAP on the interface

[Parameter]

Parameter	Description
map-zone-br	Enable MAP-BR on the interface
map-zone-ce	Enable MAP-CE on the interface

[View]

Interface view

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 16
sonic(config-if-16)# nat64 map-zone-br enable

map-rule basic-mapping-rule rule_name rule-ip6-prefix ipv6_prefix rule-ip4-prefix ipv4_prefix ea-length Embedded_Address_bits psid-len psid_len psid-offset psid_offset

[Command] map-rule basic-mapping-rule rule_name rule-ip6-prefix ipv6_prefix rule-ip4-prefix ipv4_prefix ea-length Embedded_Address_bits psid-len psid_len psid-offset psid_offset

[Purpose]

Configure MVRP timer time

[Parameter]

Parameter	Description
rule_name	The name of the Basic Mapping Rule (BMR)
ipv6_prefix	The IPv6 prefix assigned by the BMR
ipv4_prefix	The IPv4 prefix assigned by the BMR
Embedded_Address_bits	The total length (in bits) of the IPv4 address and port set information embedded in the subscriber's IPv6 address. Range: 0-64 bits
psid_len	The length of the Port Set Identifier (PSID). Range: 0-15 bits
psid_offset	The starting bit position of the PSID within the port number. Range: 0-15 bits

[View]

System configuration view

[Use Cases]

sonic# configure terminal
sonic(config)# map-rule basic-mapping-rule BMR rule-ip6-prefix 2001:db8:1012::/48 rule-ip4-prefix 192.0.2.0/24 ea-length 16 psid-len 8 psid-offset 4

map-rule br-ipv6-address rule_name ipv6-address br_ipv6_address

[Command] map-rule br-ipv6-address rule_name ipv6-address br_ipv6_address

[Purpose]

Configure the Border Relay IPv6 address rule

[Parameter]

Parameter	Description
rule_name	The name of the rule
br_ipv6_address	The IPv6 address of the Border Relay (BR) device

[View]

System configuration view

[Notes]

This command specifies the physical address of the BR device to act as the next hop for traffic, typically used in MAP-E mode

[Use Cases]

sonic# configure terminal
sonic(config)# map-rule br-ipv6-address BRaddr ipv6-address 2001:db8:1012:1234::10/64

map-rule default-mapping-rule rule_name ipv6-prefix ipv6_prefix

[Command] map-rule default-mapping-rule rule_name ipv6-prefix ipv6_prefix

[Purpose]

Configure the Default Mapping Rule (DMR)

[Parameter]

Parameter	Description
rule_name	The name of the rule
ipv6_prefix	The IPv6 prefix for the Default Mapping Rule

[View]

System configuration view

[Notes]

This rule is typically used in MAP-T mode

[Use Cases]

sonic# configure terminal
sonic(config)# map-rule default-mapping-rule DMR ipv6-prefix 2001:db8:1012:1234::/64

[Command] map-rule sharing-ip-no-embedded rule_name

[Purpose]

Configure the Non-embedded Shared IPv4 Address rule

[Parameter]

Parameter	Description
rule_name	The name of the rule

[View]

System configuration view

[Notes]

This rule is applied when the subscriber does not use the embedded address format

[Use Cases]

sonic# configure terminal
sonic(config)# map-rule sharing-ip-no-embedded test

map-e domain domain_name {CE|BR}

[Command] map-e domain domain_name {CE|BR}

[Purpose]

Create a MAP-E domain

[Parameter]

Parameter	Description
domain_name	The name of the MAP-E domain

[View]

System configuration view

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR

basic-mapping-rule rule_name

[Command] basic-mapping-rule rule_name

[Purpose]

Bind a Basic Mapping Rule within the MAP domain

[Parameter]

Parameter	Description
rule_name	The name of the rule

[View]

Map-domain view

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR
sonic(config-map-e-domain-test1)# basic-mapping-rule BMR

br-ipv6-address rule_name

[Command] br-ipv6-address rule_name

[Purpose]

Bind a br-ipv6-address Rule within the MAP-E domain

[Parameter]

Parameter	Description
rule_name	The name of the rule

[View]

MAP-E-domain view

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR
sonic(config-map-e-domain-test1)# br-ipv6-address BRaddr

frag-ignore-df enable

[Command] frag-ignore-df enable

[Purpose]

Configure to ignore the Don't Fragment (DF) flag within the MAP domain

[View]

Map-domain view

[Notes]

This is used when a packet with the DF bit set to 1 needs to be fragmented normally after passing through the device

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR
sonic(config-map-e-domain-test1)# frag-ignore-df enable

frag-inner enable

[Command] frag-inner enable

[Purpose]

Configure inner-layer fragmentation within the MAP-E domain

[View]

MAP-E-domain view

[Notes]

When a packet exceeds the MTU after encapsulation and requires fragmentation, this setting enables fragmentation at the inner IPv4 layer. This configuration is applicable only in MAP-E mode

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR
sonic(config-map-e-domain-test1)# frag-inner enable

security-check enable

[Command] security-check enable

[Purpose]

Configure packet security check within the MAP domain

[View]

Map-domain view

[Notes]

Enables security check for packets in the MAP domain. Packets that do not comply with the rules defined in the MAP domain will be discarded. Enabled by default

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR
sonic(config-map-e-domain-test1)# security-check enable

tcp-mss value

[Command] tcp-mss value

[Purpose]

Configure the TCP maximum segment size (MSS) for packets

[Parameter]

Parameter	Description
value	Range: 160~9540

[View]

Map-domain view

[Use Cases]

sonic# configure terminal
sonic(config)# map-e domain test1 BR
sonic(config-map-e-domain-test1)# tcp-mss 1460

map-t domain domain_name {CE|BR}

[Command] map-t domain domain_name {CE|BR}

[Purpose]

Create a MAP-T domain

[Parameter]

Parameter	Description
domain_name	The name of the MAP-E domain

[View]

System configuration view

[Use Cases]

sonic# configure terminal
sonic(config)# map-t domain test2 BR

default-mapping-rule rule_name

[Command] default-mapping-rule rule_name

[Purpose]

Bind a Default Mapping Rule within the MAP-T domain

[Parameter]

Parameter	Description
rule_name	The name of the rule

[View]

MAP-T-domain view

[Use Cases]

sonic# configure terminal
sonic(config)# map-t domain test2 BR
sonic(config-map-t-domain-test2)# default-mapping-rule DMR

MAP Configuration