ifconfig command

Use this command to configure the Ethernet interface.

Type ifconfig eth0 to display the current Ethernet interface configuration. To change the Ethernet interface configuration, type the options, followed by the values. To change the interface configuration, you must have at least Adapter Networking and Security Configuration authority.

Note

In a Flex System, the VLAN settings are managed by a Flex System CMM and cannot be modified on the IMM.

The following table shows the arguments for the options.

Table 1. ifconfig command.
The following table is a multi-row three column table consisting of the options, option descriptions, and associated values for the options.
Option	Description	Values
-b	Burned-in MAC Address (read-only and not configurable)
-state	Interface state	disabled, enabled
-c	Configuration method	dhcp, static, dthens (dthens corresponds to the try dhcp server, if it fails use static config option on the web interface)
-i	Static IP address	Address in valid format.
-g	Gateway address	Address in valid format.
-s	Subnet mask	Address in valid format.
-n	Host name	String of up to 63 characters. The string can include letters, digits, periods, underscores, and hyphens.
-r	Data rate	10, 100, auto
-d	Duplex mode	full, half, auto
-m	MTU	Numeric between 60 and 1500.
-l	LAA	MAC address format. Multicast addresses are not allowed (the first byte must be even).
-dn	Domain name	Domain name in valid format.
-auto	Autonegotiation setting, which determines whether the Data rate and Duplex network settings are configurable	true, false
-ghn	Obtain hostname from DHCP	disabled, enabled
-nic	switch NIC mode¹	shared, dedicated, shared:nixX²
-failover²	Failover mode	none, shared, shared:nicX
-nssync³	Network setting synchronization	enabled, disabled
-address_table	Table of automatically-generated IPv6 addresses and their prefix lengths Note The option is visible only if IPv6 and stateless auto-configuration are enabled.	This value is read-only and is not configurable.
-ipv6	IPv6 state	disabled, enabled
-lla	Link-local address Note The link-local address only appears if IPv6 is enabled.	The link-local address is determined by the IMM. This value is read-only and is not configurable.
-ipv6static	Static IPv6 state	disabled, enabled
-i6	Static IP address	Static IP address for Ethernet channel 0 in IPv6 format.
-p6	Address prefix length	Numeric value between 1 and 128.
-g6	Gateway or default route	IP address for the gateway or default route for Ethernet channel 0 in IPv6.
-dhcp6	DHCPv6 state	enabled, disabled
-sa6	IPv6 stateless autoconfig state	enabled, disabled
-vlan	Enable or disable the VLAN tagging	enabled, disabled
-vlanid	Network packet identification tag for the IMM	Numeric value between 1 and 4094.
Note -nic will also show the status of nic. [active] indicates which nic XCC is currently using For example: `-nic: shared:nic3 nic1: dedicate nic2: ext card slot #3 nic3: ext card slot 5 [active]` Indicates that nic3 is in shared mode, on slot 5, nic2 is on slot3, nic1 is XCC dedicated port and XCC is using nic3. The shared:nicX value is available on servers that have an optional mezzanine network card installed. This mezzanine network card can be used by the IMM. If the IMM is configured to use the dedicated management network port, the -failover option will direct the IMM to switch to the shared network port if the dedicated port is disconnected. If the failover mode is enabled, the -nssync option directs the IMM to use the same network settings that are used on the dedicated management network port for the shared network port.

Syntax:

ifconfig eth0 [<em className="ph i">options</em>]
options:

  -state <em className="ph i">interface_state</em>
  -c <em className="ph i">config_method</em>
  -i <em className="ph i">static_ipv4_ip_address</em>
  -g <em className="ph i">ipv4_gateway_address</em>
  -s <em className="ph i">subnet_mask</em>
  -n <em className="ph i">hostname</em>
  -r <em className="ph i">data_rate</em>
  -d <em className="ph i">duplex_mode</em>
  -m <em className="ph i">max_transmission_unit</em>
  -l <em className="ph i">locally_administered_MAC</em>
  -b <em className="ph i">burned_in_MAC_address</em>
  -dn <em className="ph i">domain_name</em>
  -auto <em className="ph i">state</em>
  -nic <em className="ph i">state</em>
  -failover mode
  -nssync <em className="ph i">state</em>
  -address_table
  -lla ipv6_link_local_addr
  -dhcp6 <em className="ph i">state</em>
  -ipv6 <em className="ph i">state</em>
  -ipv6static <em className="ph i">state</em>
  -sa6 <em className="ph i">state</em>
  -i6 <em className="ph i">static_ipv6_ip_address</em>
  -g6 <em className="ph i">ipv6_gateway_address</em>
  -p6 <em className="ph i">length</em>
  -vlan <em className="ph i">state</em>
  -vlanid <em className="ph i">VLAN ID</em>

Example:

system> ifconfig eth0
-state    :   enabled 
-c        :   dthens
-ghn      :   disabled 
-i        :   192.168.70.125 
-g        :   0.0.0.0 
-s        :   255.255.255.0 
-n        :   IMM00096B9E003A 
-auto     :   true 
-r        :   auto
-d        :   auto
-vlan     :   disabled
-vlanid  :   1 
-m        :   1500 
-b        :   00:09:6B:9E:00:3A 
-l        :   00:00:00:00:00:00 
-dn       :
-ipv6     :  enabled
-ipv6static :  disabled
-i6       :  ::
-p6       :  64
-g6       :  ::
-dhcp6   :  enabled
-sa6      :  enabled
-lla      :  fe80::6eae:8bff:fe23:91ae
-nic :  shared:nic3
      nic1: dedicate
      nic2: ext card slot #3  
      nic3: ext card slot #5  [active]
-address_table    :

system> ifconfig eth0 -c static -i 192.168.70.133
These configuration changes will become active after the next reset of the IMM.

Give documentation feedback