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 
   address <<IPv6 address>/<length> |       autoconfigure> [default | privacy]
   dhcp client <enable | renew>
   enable

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.

address—Specifies the type of IPv6 address that will be assigned to the Mgmt port. You can either explicitly configure a static address with the address argument or use the autoconfigure argument to generate one automatically.
dhcp client—Enables or renews DHCPv6 on this interface.
enable—enables the use of IPv6 for the Mgmt port.

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