interface

interface add/edit

interface add – Add a new interface
interface add – Add a new interface

Description:

Configure an IP interface for management purpose. Interfaces can be set to to acquire their IP configuration from a DHCP server or can be manually configured with a static IP. The subnet can be defined using the Address Prefix Length along with the IP (e.g. 192.168.1.100/24) or by entering the network mask using the netmask keyword.

Notes:

IPv4 aliases: Interfaces can be configured for dual-homing by specifying an alias name instead of an interface name. Currently only an alias ID of 0 (zero) can be defined. When specifying an alias, only the address, netmask and gateway parameters can be configured. An aliased interface is always set up as a static IP address (no DHCP) and is on a distinct interface.

IPv6: Two IPv6 addresses can be configured (0 and 1). This is different from IPv4 aliases as the index is not specified in the interface name but as a parameter of the address. All IPv6 addresses are over the same interface.

Syntax:

interface    {add|edit} <interface-name>|<alias-name>
            {name <interface-name>|<alias-name>} |
            {dhcp {enable|disable}} |
            {dhcp-rt-info {enable|disable}} |
            {dhcp-static {enable|disable}} |
            {address {<ip-addr>|<ip-addr-prefix>}} |
            {netmask {<ip-addr>}} |
            {gateway {<ip-addr>}} |
            {ipv6_enable {enable|disable}} |
            {ipv6_dhcp {disabled|stateless|stateful}} |
            {ipv6_radv {enable|disable}} |
            {ipv6_static {enable|disable}} |
            {ipv6_address <0-1> {<ipv6-addr>/<ipv6-prefixLen>
             [-<ipv6-gateway>]}} |
            {vlan1-id <vlan-id>} |
            {vlan2-id <vlan-id>} |
            {vlan1-ethertype {c-vlan | s-vlan | t-vlan}} |
            {vlan2-ethertype {c-vlan | s-vlan | t-vlan}} |
            {vlan1-priority <0-7>} |
            {vlan2-priority <0-7>} |
            {type {standard|vlan|bridge|vlan-in-vlan|bridge-vlan}} |
            {name <interface-name> } |
            {port <port-name> } |
            {sub-intf <sub-intf-name-list> } |
            {ip-override {enable|disable} } |
            {force {enable|disable} } |
            {state {enable|disable} } |
            {dhcp-relay {enable|disable}} |
            {ipv4-fwd {enable|disable}} |
            {stp {enable|disable}} }+
            {icmp_redirect {enable|disable} } |
            {ipv6_ icmp_redirect {enable|disable} } |

Parameters:

Syntax:

ipv4 edit options { { forwarding <enable|disable> } |
                    { igmp-version <0,2,3> } }+

Parameters:

interface advertisement edit

interface advertisement edit - Edit an existing advertisement instance attribute

Description:

Configure an advertisement instance on the interface for management purpose. An advertisement instance may be configured to send interface information to another system for inventory purposes. The advertisement instance is coupled with the interface of the same name, so any change to the interface name or port will affect the advertisement instance.

Syntax:

interface {edit} <advertisement-name> { {state {enable|disable}} |
            {ip-state {enable|disable}} |
            {ip-address {<ip-addr> [, <ip-addr>]+}} |
            {rate <transmission rate>} |
            {format {ACP} |
            {use-beacon-rate {enable|disable} }}+

Parameters:

interface advertisement show

interface advertisement show - show advertisement configuration

Description:

Specifying an interface or alias name provides detailed configuration about this advertisement, otherwise the command provides summary configuration for all advertisements in a table format.

Syntax:

interface advertisement show [<interface-name>|<alias-name>]

Parameters:

interface auxiliary-mac show

interface auxiliary-mac show - Show the auxiliary-mac interface configuration

Description:

This command displays a summary of the configuration of the interface where the auxiliary MAC is enabled.

Syntax:

interface auxiliary-mac show

interface beacon edit

interface beacon edit - Edit an existing beacon attributes

Description:

Configure a beacon instance on the interface for management purpose. A beacon may be configured to discover remote devices by sending a special frame on the network, through the interface it is tied to. The beacon is coupled with the interface of the same name, so any change to the interface name or port will affect the beacon instance.

Syntax:

interface beacon {edit} <interface-name> { {state {enable|disable}} |
            {rate <transmission rate>} |
            {domain-id <domain>} |
            {subnet  {<ip-addr>}} |
            {netmask {<ip-addr>}} | 
            {gateway {<ip-addr>}} |
            {dhcp-hostname-option <none,custom,serial-number,current>} |
            {dhcp-client-id-option <none,custom,serial-number>} |
            {dhcp-hostname <hostname>} |
            {dhcp-client-id <client-id>} |
            {ip-config-mode {local|auto|dhcp|auto-static}} |
            {id-mismatch {enable|disable} }}+

Parameters:

interface beacon show

interface beacon show - Show beacon configuration

Description:

Specifying an interface or alias name provides detailed configuration about this beacon, otherwise the command provides summary configuration for all beacons in a table format.

Syntax:

interface beacon show [<interface-name>|<alias-name>]

Parameters:

interface delete

interface delete - Delete an existing interface

Description:

Delete an existing interface or alias. When deleting the interface, if an alias had been previously configured, it will also be deleted.

Syntax:

interface delete <interface-name>|<alias-name>

Parameters:

interface discovery edit

interface discovery edit - Edit the discovery instance attributes

Description:

Configure the attributes related to beacon discovery on the auto interface. The discovery instance may be configured to listen for beacons on selected ports and automatically configure an interface upon reception of a valid beacon.

Syntax:

interface discovery {edit} { {state {enable|disable}} |
            {id-matching {enable|disable}} |
            {domain-id <domain_id>} |
            {forward-on-bridge {enable|disable}} |
            {discovery-ports <port_list>} |
            {level [All,<0-7>]} |
            {forward-match-ports {port_list|null}} |
            {forward-mismatch-ports {port_list|null}}}+

Parameters:

interface discovery show

interface discovery show - Show the discovery instance attributes

Description:

Show the attributes related to beacon discovery on the auto interface.

Syntax:

interface discovery {show}

Parameters:

interface primary clear

interface primary clear - Clear the system primary interface selection

Description:

This command is used to clear the system primary interface selection.

Syntax:

interface primary clear

interface primary set

interface primary set - Select the system primary interface

Description:

This command is used to select the system primary interface generally used for management.

Syntax:

interface primary set <interface-name>

Parameters:

interface primary show

interface primary show - Display the system primary interface name

Description:

This command is used to display the name of the system primary interface.

Syntax:

interface primary show

interface refresh

interface refresh - Send gratuitous ARP on all interfaces

Description:

Convert IP address into physical address for all interfaces.

Syntax:

interface refresh

interface show / ipv6_show

interface show - Show IPv4 interface configuration
interface ipv6_show - Show IPv6 interface configuration

Description:

This command displays a summary of the configuration for all interfaces in a table format. Specifying an interface or alias name will display the detailed configuration for this interface.

Syntax:

interface {show|ipv6_show} [<interface-name>|<alias-name>]

Parameters:

Notes:

Alias name interface should not be used in this case.
The summary output will display the string "AuxMAC interface" in the Info column to identify the interface which has the Auxiliary MAC enabled.

Display of the new field 'Auxiliary MAC' will always be present on those platforms the Dual MAC feature is enabled.

Output:

IPv4 interface
	interface show Management
	Interface name: Management	
	Interface type : Standard
	Interface state : Enabled
	IPv4 forwarding : Disabled
	DHCP relay : Disabled
	On port : Management
	DHCP : Yes
	Static+DHCP : Yes
	Static IP : 192.168.1.254
	IP address : 10.231.60.51
	Netmask : 255.255.0.0
	Default gateway : 10.231.0.1
	ICMP redirect : Enabled
IPv6 interface
	interface ipv6_show Management
	Interface name : Management
	IPv6 enabled : Yes
	Interface type : Standard
	Interface state : Enabled
	On port : Management
	DHCPv6 : Disabled
	Use Static Address : No
	Use RADV address : Yes
	Link address : 	fe80::215:adff:fe67:ed/64
	ICMP redirect : Enabled