ifconfig command

This command configures and displays the network interface settings for the management-module Ethernet interface, I/O-module Ethernet interface, and the blade server integrated system management processors.

Table 1. ifconfig command
Function What it does Command Valid targets
Display Ethernet channel 0 configuration Displays the current configuration of Ethernet channel 0. Possible return values are:
  • enabled
  • disabled
  • -i static_ip_address
  • -g gateway_address
  • -s subnet_mask
  • -n hostname
  • -c config_method
  • -r data_rate
  • -d duplex_mode
  • -m mtu
  • -l locally_administered_mac_addr
  • -b burnedin_mac_address
ifconfig -eth0 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 static IP address Checks syntax and sets the static IP address for Ethernet channel 0. ifconfig -eth0 -i ip_address

where ip_address is the static IP address for Ethernet channel 0.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 gateway IP address Checks syntax and sets the gateway IP address for Ethernet channel 0. ifconfig -eth0 -g ip_address

where ip_address is the gateway IP address for Ethernet channel 0.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 subnet mask Checks syntax and sets the subnet mask for Ethernet channel 0. ifconfig -eth0 -s sub_mask

where sub_mask is the subnet mask for Ethernet channel 0.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 hostname Checks syntax and sets the host name for Ethernet channel 0. ifconfig -eth0 -n hostname

where hostname is the host name for Ethernet channel 0.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 configuration method Checks syntax and sets the configuration method for Ethernet channel 0.

A value of dthens will try the DHCP configuration and default to the static IP configuration if DHCP is unsuccessful.

A value of dthens will try the DHCP configuration and default to the static IP configuration if DHCP is unsuccessful after 2 minutes.

Note: If the management module DHCP setting is set to try the DHCP server and then use the static IP address, the management module will use the static IP address when the DHCP server is not available during management module start up. When this occurs, the IP address might not be reachable if multiple management modules were started with the same static IP address.
 ifconfig -eth0 -c config_method
where config_method is
  • dhcp
  • static
  • dthens

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 data rate Checks syntax and sets the data rate for Ethernet channel 0. ifconfig -eth0 -r data_rate
where data_rate is
  • auto
  • 10
  • 100

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 duplex mode Checks syntax and sets the duplex mode for Ethernet channel 0. ifconfig -eth0 -d duplex_mode
where duplex_mode is
  • auto
  • half
  • full

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 MTU Checks syntax and sets the MTU (maximum transmission unit) for Ethernet channel 0. ifconfig -eth0 -m mtu

where mtu is between 60 and 1500, inclusive.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 0 static MAC address (locally administered) Checks syntax and sets the locally administered MAC address to the specified MAC address for Ethernet channel 0. ifconfig -eth0 -l address

where address is the locally administered MAC address for Ethernet channel 0.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Display Ethernet channel 1 configuration Displays the current configuration of Ethernet channel 1. Possible return values are:
  • enabled
  • disabled
  • -i static_ip_address
  • -g gateway_address
  • -s subnet_mask
  • -r data_rate
  • -d duplex_mode
  • -m mtu
  • -l locally_administered_mac_addr
  • -b burnedin_mac_address
ifconfig -eth1 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 1 static IP address Checks syntax and sets the static IP address for Ethernet channel 1. ifconfig -eth1 -i ip_address

where ip_address is the static IP address for Ethernet channel 1.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 1 gateway IP address Checks syntax and sets the gateway IP address for Ethernet channel 1. ifconfig -eth1 -g ip_address

where ip_address is the gateway IP address for Ethernet channel 1.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 1 subnet mask Checks syntax and sets the subnet mask for Ethernet channel 1. ifconfig -eth1 -s sub_mask

where sub_mask is the subnet mask for Ethernet channel 1.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set Ethernet channel 1 static MAC address (locally administered) Checks syntax and sets the locally administered MAC address to the specified MAC address for Ethernet channel 1. ifconfig -eth1 -l address

where address is the locally administered MAC address for Ethernet channel 1.

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable Ethernet channel 1 Enables Ethernet channel 1. ifconfig -eth1 -up

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Disable Ethernet channel 1 Disables Ethernet channel 1. ifconfig -eth1 -down

Command use restricted (see Commands and user authority).

 
                           -T system:mm[x]

where x is the primary management-module bay number.
Display starting IP address for blade server integrated system management processor Displays the starting point of the integrated system management processor IP addresses for blade servers that are installed in the BladeCenter® unit. ifconfig 
                           -T system:blade[1]:sp
Set starting IP address for blade server integrated system management processor Sets the starting point of the integrated system management processor IP addresses for blade servers that are installed in the BladeCenter unit. ifconfig -i ip_address

where ip_address is the starting IP address for all blade servers that are installed in the BladeCenter unit.

Command use restricted (see Commands and user authority).

 
                           -T system:blade[1]:sp
Display network settings for I/O module Displays network settings for the specified I/O module. Depending on the type of I/O module targeted, valid return values might include one or more of the following:
  • I/O-module type
  • Config. Method config_method
  • -i ip_address
  • -s subnet_mask
  • -g gateway_address
  • -em ext_mgt_status
  • -ep ext_port_status
ifconfig 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set starting IP address for I/O module Sets the IP addresses for a specified I/O module that supports IP address configuration. ifconfig -i ip_address

where ip_address is the IP address of the specified I/O module.

Command use restricted (see Commands and user authority).

 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable external management for I/O module Enables or disables external management on all ports for a specified I/O module that supports this feature. ifconfig -em state

where state is enabled or disabled.

Command use restricted (see Commands and user authority).

 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable external ports for I/O module Enables or disables external ports for the specified I/O module that supports this feature. ifconfig -ep state

where state is enabled or disabled.

Command use restricted (see Commands and user authority).

 
                           -T system:switch[x]

where x is the I/O-module bay number.

Example:

To display the configuration for Ethernet channel 0, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  ifconfig -eth0
To set the static IP address for Ethernet channel 0 to 192.168.70.133, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  ifconfig -eth0 -i 192.168.70.133 -c static

The following example shows the information that is returned from these two commands:

               system:mm[1]> ifconfig -eth0
Enabled
-i 10.10.10.10
-g 0.0.0.0
-s 255.255.255.0
-n MM00096BCA0C80
-c Try DHCP server.  If it fails, use static IP config.
-r Auto
-d Auto
-m 1500
-l 00:00:00:00:00:00
-b 00:09:6B:CA:0C:80
system:mm[1]> ifconfig -eth0 -i 192.168.70.133 -c static
Changes to the network settings will take effect after the next reset of the MM.
system:mm[1]>
Parent topic: Command syntax