Skip to main content

ifconfig command

Use this command to configure the Ethernet interface.

Use the ifconfig command 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.

Syntax:
ifconfig [ethernet_number] [-options]
Example:
dhcpinfo eth1 -b
Table 1. ifconfig options
OptionDescriptionValues
-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)
-ghnObtain hostname from DHCPdisabled, enabled
-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.
-autoAutonegotiation setting, which determines whether the Data rate and Duplex network settings are configurabletrue, false
-vlanEnable or disable the VLAN taggingenabled, disabled
-vlanidVLAN IDNumeric value between 1 and 4094.
-rData rate10, 100, 1000
-dDuplex modefull, half
-mMTUNumeric between 60 and 1500.
-lLAAMAC address format. Multicast addresses are not allowed (the first byte must be even).
-bBurned-in MAC Address (read only) 
-dnDomain name (read only) 
-ipv6IPv6 statedisabled, enabled
-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.
-dhcp6IPv6 DHCP modeenabled, disabled
-sa6IPv6 Stateless modeenabled, disabled
-llaLink-local address (read only) 
-ncsiNCSI NIC port selectionnic[x]:port[y]
Note
Use comma as the delimiter if there are two or more settings.
-nicSwitch NIC mode1shared, dedicated, shared:nic[x]2
-failover2Failover modenone, shared, shared:nic[x]
-nssync3Network setting synchronizationenabled, disabled
-address_tableTable of automatically-generated IPv6 addresses and their prefix lengths (read only)
Note
The option is visible only if IPv6 and stateless auto-configuration are enabled.
 
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:nic[x] 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.
Example:
system> ifconfig eth0 -c static -i 192.168.70.133
These configuration changes will become active after the next reset of the IMM.
system>