interface
Required Command-Line Mode = Configure
Use the interface command to configure settings for the eth0 Mgmt port (or the eth2 Mgmt port) on the GigaVUE® HC Series node’s control card.
The interface command has the following syntax:
interface <interface>
bond <bonded interface>
comment <comment>
dhcp [renew]
duplex <full | auto>
ip address <IP address> <netmask>
ipv6
address <<IPv6 address>/<length> | autoconfigure> [default | privacy]
dhcp client <enable | renew>
enable
mtu <MTU in bytes>
shutdown speed <10 | 100 | 1000 | auto>
zeroconf
The following table describes the arguments for the interface command:
Argument |
Description |
|||||||||
interface <interface> |
Configures settings for the eth0 Mgmt port, as well as the loopback (lo) interface, and eth1 and eth2 interface. |
|||||||||
bond <bonded interface> |
Adds a peer interface to a specified bonded interface. For example: (config) # interface eth0 bond bond0 |
|||||||||
comment <comment> |
Provides a comment field for the interface, displayed whenever the interface records are listed in the CLI. |
|||||||||
dhcp [renew] |
Enables or disables DHCP on the Mgmt interface. You can also use renew to renew the address currently leased by the Mgmt interface. When DHCP is enabled, the Mgmt port gets its IP address and subnet mask from a DHCP server—a static address/netmask defined with the ip address argument is not used when DHCP is enabled. For example, the following command enables DHCP on the Mgmt port (eth0): (config) # interface eth0 dhcp Note: By default, DHCP is enabled. This means that when you run the jump-start for the first time, the default reads, "[yes]." When it is run subsequently, it will indicate yes or no based on how it was set. |
|||||||||
duplex <full | auto> |
Sets the duplex mode for the Mgmt port. You can set it to full or auto (the default). If you set it to auto, also set speed to auto. Note: Starting in software version 5.5, half-duplex support has been deprecated from the management interfaces (eth0, eth1...). If half duplex was configured in a previous software version, it will remain intact following the upgrade to 5.5 or higher release. Update to full duplex, if required. |
|||||||||
ip address <IP address> <netmask> |
Specifies a static IPv4 address and netmask for the Mgmt port. Note that defining the IP address/netmask does NOT switch the Mgmt port over from DHCP if it is currently using it. You need to explicitly disable DHCP as well with no interface eth0 dhcp before the static address specified here is used. You can specify the netmask using either the bit-count model or a dotted-quad (for example, /24 or 255.255.255.0). For example, the following command configures a static address of 192.168.1.0 with a netmask of /24: (config) # interface eth0 ip address 192.168.1.0 /24 |
|||||||||
ipv6 |
Configures IPv6 properties for the Mgmt port. You can specify a static address or accept an auto configured address. Setting the address does not enable its use—you also have to explicitly enable the IPv6 address with interface eth0 ipv6 enable. Note: If IPv6 is disabled during configuration jump-start, you have to explicitly use ipv6 enable command to enable the IPv6 system wide before you enable the interface configuration with interface eth0 ipv6 enable.
|
|||||||||
mtu <MTU in bytes> |
Specifies the MTU for the Mgmt port. Specify a value in bytes (1518 is the largest size for a standard Ethernet packet). The range is 1280–9400. The default is 1500. It is recommended that you set the MTU value to 9400 on all platforms to avoid fragmentation. Change the MTU value for the Mgmt port only after disabling IPv6 on that particular interface using the following command: (config) # no interface <interface> ipv6 enable |
|||||||||
shutdown |
Administratively shuts down the Mgmt port. If you do this, you will only be able to access the node over the serial console port. |
|||||||||
speed <10 | 100 | 1000 | auto> |
Sets the speed for the Mgmt port. You can set it to 10Mb, 100Mb, 1000Mb, or auto. Setting the speed to auto also sets duplex to auto. If you set speed to one of the manual settings, the system will read the last autoconfigured setting for duplex and set it to the manual version of the autoconfigured value. |
|||||||||
zeroconf |
Enables zeroconf for IPv4 on the specified interface. Enabling zeroconf disables DHCP and static address settings. |
Related Commands
The following table summarizes other commands related to the interface command:
Task |
Command |
Displays detailed information for all interfaces. |
show interfaces |
Displays brief information for the specified interface. |
show interfaces eth0 brief |
Displays configuration information for the specified interface. |
show interfaces eth0 configured |
Deletes this interface from a bonded interface. |
(config) # no interface eth0 bond bond0 |
Deletes the comment from the specified interface. |
(config) # no interface eth0 comment |
Disables DHCP for the specified interface. |
(config) # no interface eth0 dhcp |
Resets the duplex setting for the specified interface to the default (auto). |
(config) # no interface eth0 duplex |
Deletes the IP address and netmask for the specified interface. |
(config) # no interface eth0 ip address |
Deletes all IPv6 addresses for the specified interface. |
(config) # no interface eth0 ipv6 address |
Deletes IPv6 address autoconfiguration for the specified interface. |
(config) # no interface eth0 ipv6 address autoconfig |
Disables learning routes from address autoconfiguration. |
(config) # no interface eth0 ipv6 address autoconfig default |
Disables privacy extensions for address autoconfiguration. |
(config) # no interface eth0 ipv6 address autoconfig privacy |
Disables DHCPv6 on the specified interface. |
(config) # no interface eth2 ipv6 dhcp client enable |
Disables IPv6 on the specified interface. |
(config) # no interface eth0 ipv6 enable |
Resets the MTU for the specified interface to the default. |
(config) # no interface eth0 mtu |
Enables the specified interface. |
(config) # no interface eth0 shutdown |
Resets the speed setting for the specified interface to the default. |
(config) # no interface eth0 speed |
Disables zeroconf for the specified interface. |
(config) # no interface eth0 zeroconf |