Skip to main content

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.

OptionDescriptionValues
-bBurned-in MAC Address (read-only and not configurable) 
-stateInterface statedisabled, enabled
-cConfiguration methoddhcp, static, dthens (dthens corresponds to the try dhcp server, if it fails use static config option on the web interface)
-iStatic IP addressAddress in valid format.
-gGateway addressAddress in valid format.
-sSubnet maskAddress in valid format.
-nHost nameString of up to 63 characters. The string can include letters, digits, periods, underscores, and hyphens.
-rData rate10, 100, auto
-dDuplex modefull, half, auto
-mMTUNumeric between 60 and 1500.
-lLAAMAC address format. Multicast addresses are not allowed (the first byte must be even).
-dnDomain nameDomain name in valid format.
-autoAutonegotiation setting, which determines whether the Data rate and Duplex network settings are configurabletrue, false
-ghnObtain hostname from DHCPdisabled, enabled
-nicswitch NIC mode1shared, dedicated, shared:nixX2
-failover2Failover modenone, shared, shared:nicX
-nssync3Network setting synchronizationenabled, disabled
-address_tableTable 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.
-ipv6IPv6 statedisabled, enabled
-llaLink-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.
-ipv6staticStatic IPv6 statedisabled, enabled
-i6Static IP addressStatic IP address for Ethernet channel 0 in IPv6 format.
-p6Address prefix lengthNumeric value between 1 and 128.
-g6Gateway or default routeIP address for the gateway or default route for Ethernet channel 0 in IPv6.
-dhcp6DHCPv6 stateenabled, disabled
-sa6IPv6 stateless autoconfig stateenabled, disabled
-vlanEnable or disable the VLAN taggingenabled, disabled
-vlanidNetwork packet identification tag for the IMMNumeric value between 1 and 4094.
Note
  1. -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.
  2. 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.
  3. 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.
  4. 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 [options]
options:

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