Management and front port IPv4/IPv6 Address

Example 1: Configure IP address on management port "eth0"

Reference model:

• Switch model name: AS5812-54X
• Edgecore SONiC version: SONiC.Edgecore-SONiC_20200116_051623_ec201904_128
• Switch model name: AS7326-56X
• Edgecore SONiC version: SONiC.Edgecore-SONiC_20200507_052107_ec201911_74

Default setting:

1. DHCP address on management port"eth0"

Procedure :

Caution:  SONiC command is not available for management IP address.  Therefore, edit config_db.json instead.

Steps 1. edit /etc/sonic/config_db.json as shown below,

admin@sonic:/etc/sonic$ sudo vi config_db.json
{
    ...omitted
    "MGMT_INTERFACE": {
        "eth0|192.168.1.2/24": {
            "gwaddr": "192.168.1.1"
        },
        "eth0|2001::8/64": {
            "gwaddr": "2001::1/64"
        }    
    },
    "MGMT_PORT": {
        "eth0": {
            "admin_status": "up",
            "alias": "eth0"
        }
    },
    ...omitted
}

Caution: If the "MGMT_PORT" doesn't configure only sets ip address in "MGMT_INTERFACE", syslog shows warning message even though the management ip address can work.

Additional attributes:  Refer to https://github.com/Azure/SONiC/wiki/Configuration#management-interface

Management interfaces are defined in MGMT_INTERFACE table. Object key is composed of management interface name and IP prefix. Attribute gwaddr specify the gateway address of the prefix. forced_mgmt_routes attribute can be used to specify addresses / prefixes traffic to which are forced to go through management network instead of data network.

Steps 2.  Apply the setting

admin@sonic:~$ sudo config reload -y

Step 3. Check IP address

admin@sonic:~$ show ip interfaces 
Interface    IPv4 address/mask    Admin/Oper   BGP Neighbor   Neighbor IP
-----------  -------------------  ------------ -------------- -------------
docker0      240.127.1.1/24       up/down      N/A            N/A
eth0         192.168.1.2/24       up/up        N/A            N/A
lo           127.0.0.1/8          up/up        N/A            N/A
             10.1.0.1/32

admin@sonic:~$ show ipv6 interfaces
Interface   Master   IPv6 address/mask                       Admin/Oper   BGP Neighbor   Neighbor IP
----------- -------- --------------------------------------- ------------ -------------- -------------
Bridge               fe80::8412:8dff:fe89:ed59%Bridge/64     up/down      N/A            N/A
Ethernet48           fe80::82a2:35ff:fe4f:4f40%Ethernet48/64 up/up        N/A            N/A
Loopback0            fe80::b403:ffff:fe7e:23e6%Loopback0/64  up/up        N/A            N/A
eth0                 2001::8/64                              up/up        N/A            N/A
                     fe80::82a2:35ff:fe4f:4f40%eth0/64
lo                   ::1/128                                 up/up        N/A            N/A

admin@sonic:~$ show management_interface address
Management IP address = 192.168.1.2/24
Management Network Default Gateway = 192.168.1.1
Management IP address = 2001::8/64
Management Network Default Gateway = 2001::1/64

Note: The "show management_interface address" command and "BGP Neighbor information" do not support in ecSONiC-201904 version.

Quick solution with restriction: Configure IP address on management port "eth0"

Caution: This is Linux command, not SONiC command.   This setting will be restored to default after rebooting. And couldn't use "show management_interface address" command to check status.

Add IPv4/IPv6 address to eth0

admin@sonic:~$ sudo ip address add 188.188.98.21/16 dev eth0 
admin@sonic:~$ sudo ip -6 address add 2001::1/64 dev eth0

 Add default gateway

admin@sonic:~$ ip route add 0.0.0.0/0 via 188.188.0.1 

Known issue: Warning messages in default configuration

Nov 8 18:51:57.788087 sonic WARNING snmp#snmp-subagent [sonic_ax_impl] WARNING: No managment ports found in b'MGMT_PORT|'
Nov 8 18:52:55.922997 sonic WARNING snmp#snmp-subagent message repeated 2 times: [ [sonic_ax_impl] WARNING: No managment ports found in b'MGMT_PORT|']

Solution: Add MGMT_PORT setting on /etc/sonic/config_db.json and reload config.

admin@sonic:/etc/sonic$ sudo vi config_db.json
{
    ...omitted
    "MGMT_PORT": {
        "eth0": {
            "admin_status": "up",
            "alias": "eth0"
        }
    },
    ...omitted
}

Example 2: Configure IP address on front port (aka physical interface).

Procedure :

Caution: Please make sure the port name is correct. Otherwise it does not work.

Since there's no warming messages for wrong command.

Steps 1. Configure IP address on front port. i.e Ethernet0

admin@sonic:~$ sudo config interface ip add Ethernet0 192.168.1.1/24        
admin@sonic:~$ sudo config interface ip add Ethernet0 2002::1/64 

Steps 2. Check IP address 

admin@sonic:~$ show ip interfaces 
Interface    IPv4 address/mask    Admin/Oper
-----------  -------------------  ------------
Ethernet0    192.168.1.1/24       up/down
docker0      240.127.1.1/24       up/down
eth0         188.188.97.32/16     up/up
lo           127.0.0.1/8          up/up
             10.1.0.1/32
             
admin@sonic:~$  show ipv6 interfaces 
Interface    IPv6 address/mask                       Admin/Oper
-----------  --------------------------------------  ------------
Bridge       fe80::f4f6:a4ff:fe97:3c88%Bridge/64     up/up
Ethernet0    2002::1/64                              up/down
dummy        fe80::90cd:eff:fe7b:359f%dummy/64       up/up
eth0         fe80::aa2b:b5ff:fe9d:d7db%eth0/64       up/up
lo           ::1/128                                 up/up

Steps 3. Save the setting to config_db.json

admin@sonic:~$ sudo config save -y

Steps 4. Check IP address setting on config_db.json

admin@sonic:/etc/sonic$ sudo vi config_db.json
{
    ...omitted
    "INTERFACE": {
        "Ethernet0|192.168.1.1/24": {},
        "Ethernet0|2002::1/64": {},
    ...omitted
    },
    ...omitted
}