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 and installed options.

Table 1. ifconfig command
Function What it does Command Valid targets
Display primary management module Ethernet channel 0 configuration Displays the current configuration of Ethernet channel 0 for the primary management module. Possible return values are:
  • enabled
  • disabled
  • -i static_ip_address (dotted decimal IPv4 IP address format)
  • -g gateway_address (dotted decimal IPv4 IP address format)
  • -s subnet_mask (dotted decimal IPv4 IP address format)
  • -n hostname
  • -c config_method
  • -r data_rate
  • -d duplex_mode
  • -m mtu
  • -l locally_administered_mac_addr
  • -b burnedin_mac_address
  • -dn domain_name
  • -ipv6 ipv6_state
  • -ipv6static static_ipv6_state
  • -i6 static_ip_address (IPv6 format)
  • -p6 address_prefix_length
  • -g6 gateway-default_route
  • -dhcp6 dhcpv6_state
  • -sa6 ipv6_stateless_autoconfig_state

If IPv6 is enabled, the link-local address link_local_address (for IPv6 connection) also displays.

If IPv6 and stateless auto-configuration (-sa6) are both enabled, the Stateless auto-config IP Addresses / Prefix Length address_table (table listing auto-generated IPv6 addresses and their prefix lengths) also displays.

 ifconfig -eth0 
                           -T system:mm[x]

where x is the primary management-module bay number.
Display standby management module Ethernet channel 0 configuration Displays the current configuration of Ethernet channel 0 for the standby management module.
Note: This option does not apply to the BladeCenter S unit.
Possible return values are:
  • enabled
  • disabled
  • -i static_ip_address (dotted decimal IPv4 IP address format)
  • -g gateway_address (dotted decimal IPv4 IP address format)
  • -s subnet_mask (dotted decimal IPv4 IP address format)
  • -n hostname
  • -c config_method
  • -r data_rate
  • -d duplex_mode
  • -m mtu
  • -l locally_administered_mac_addr
  • -b burnedin_mac_address
  • -dn domain_name
  • -ipv6 ipv6_state
  • -ipv6static static_ipv6_state
  • -i6 static_ip_address (IPv6 format)
  • -p6 address_prefix_length
  • -g6 gateway-default_route
  • -dhcp6 dhcpv6_state
  • -sa6 ipv6_stateless_autoconfig_state

If IPv6 is enabled, the link-local address link_local_address (for IPv6 connection) also displays.

If IPv6 and stateless auto-configuration (-sa6) are both enabled, the Stateless auto-config IP Addresses / Prefix Length address_table (table listing auto-generated IPv6 addresses and their prefix lengths) also displays.

 ifconfig -eth0 -o 
                           -T system:mm[x]

where x is the primary management-module bay number.

Note: Even though this command displays information for the standby management module, it still must specify the primary management module as the command target.
Set management module Ethernet channel 0 static IP address (IPv4) Sets the IPv4 static IP address for Ethernet channel 0 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -i ip_address

where ip_address is the static IP address for Ethernet channel 0 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 static IP address (IPv6) Sets the IPv6 static IP address for Ethernet channel 0 for the management module. ifconfig -eth0 -i6 ip_address

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

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set standby management module Ethernet channel 0 static IP address (IPv4) Sets the IPv4 static IP address for Ethernet channel 0 for the standby management module.
Note: This option does not apply to the BladeCenter S unit.
 ifconfig -eth0 -o -i ip_address

where ip_address is the static IP address for Ethernet channel 0 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.

Note: Even though this command displays information for the standby management module, it still must specify the primary management module as the command target.
Set standby management module Ethernet channel 0 static IP address (IPv6) Sets the IPv6 static IP address for Ethernet channel 0 for the standby management module.
Note: This option does not apply to the BladeCenter S unit.
 ifconfig -eth0 -o -i6 ip_address

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

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.

Note: Even though this command displays information for the standby management module, it still must specify the primary management module as the command target.
Set management module Ethernet channel 0 gateway IP address (IPv4) Sets the IPv4 gateway IP address for Ethernet channel 0 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -g ip_address

where ip_address is the gateway IP address for Ethernet channel 0 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 gateway/default route (IPv6) Sets the IPv6 gateway/default route for Ethernet channel 0 for the management module. ifconfig -eth0 -g6 ip_address

where ip_address is the gateway/default route for Ethernet channel 0 in IPv6 format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 subnet mask (IPv4) Sets the IPv4 subnet mask for Ethernet channel 0 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -s sub_mask

where sub_mask is the subnet mask for Ethernet channel 0 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 hostname Sets the host name for Ethernet channel 0 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -n hostname

where hostname is the host name for Ethernet channel 0. The hostname can be a string up to 63 characters in length that includes alphanumeric characters, hyphens, and underscores.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set standby management module Ethernet channel 0 hostname Sets the host name for Ethernet channel 0 for the standby management module.
Note: This option does not apply to the BladeCenter S unit.
 ifconfig -eth0 -o -n hostname

where hostname is the host name for Ethernet channel 0. The hostname can be a string up to 63 characters in length that includes alphanumeric characters, hyphens, and underscores.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.

Note: Even though this command displays information for the standby management module, it still must specify the primary management module as the command target.
Set management module Ethernet channel 0 configuration method Sets the configuration method for Ethernet channel 0 for the management module.

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.
  • Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -c config_method
where config_method is
  • dhcp
  • static
  • dthens
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 data rate Sets the data rate for Ethernet channel 0 for the management module. ifconfig -eth0 -r data_rate
where data_rate is
  • auto
  • 10
  • 100
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 duplex mode Sets the duplex mode for Ethernet channel 0 for the management module. ifconfig -eth0 -d duplex_mode
where duplex_mode is
  • auto
  • half
  • full
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

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

where mtu is between 60 and 1500, inclusive.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 static MAC address (locally administered) Sets the locally administered MAC address to the specified MAC address for Ethernet channel 0 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -l address

where address is the locally administered MAC address for Ethernet channel 0. The MAC address is 6 bytes in length, hexadecimal, separated by colons. The MAC address can not be a multicast address (the first byte must be even).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the standby management-module bay number.
Set standby management module Ethernet channel 0 static MAC address (locally administered) Sets the locally administered MAC address to the specified MAC address for Ethernet channel 0 for the standby management module.
Note: This option is not available on the BladeCenter S.
 ifconfig -eth0 -o -l address

where address is the locally administered MAC address for Ethernet channel 0. The MAC address is 6 bytes in length, hexadecimal, separated by colons. The MAC address can not be a multicast address (the first byte must be even).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.

Note: Even though this command displays information for the standby management module, it still must specify the primary management module as the command target.
Set management module Ethernet channel 0 domain name Sets the domain name for Ethernet channel 0 for Ethernet channel 0 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth0 -dn domain

where domain is an alphanumeric string up to 127 characters in length. The domain name must contain at least one dot (.).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable IPv6 addressing for management module Ethernet channel 0 Enable or disable IPv6 addressing for Ethernet channel 0 for the management module. ifconfig -eth0 -ipv6 state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable static IPv6 configuration for management module Ethernet channel 0 Enable or disable static IPv6 configuration for Ethernet channel 0 for the management module. ifconfig -eth0 -ipv6static state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 0 address prefix length Sets the IPv6 address prefix length for Ethernet channel 0 for the management module. ifconfig -eth0 -p6 length

where length is between 1 and 128 (inclusive).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable DHCPv6 for management module Ethernet channel 0 Enable or disable static DHCPv6 for Ethernet channel 0 for the management module. ifconfig -eth0 -dhcp6 state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable IPv6 stateless auto-configuration for management module for Ethernet channel 0 Enable or disable IPv6 stateless auto-configuration for Ethernet channel 0 for the management module. ifconfig -eth0 -sa6 state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Display primary management module Ethernet channel 1 configuration Displays the current configuration of Ethernet channel 1 for the primary management module. Possible return values are:
  • up (enabled)
  • down (disabled)
  • -i static_ip_address (dotted decimal IPv4 IP address format)
  • -g gateway_address (dotted decimal IPv4 IP address format)
  • -s subnet_mask (dotted decimal IPv4 IP address format)
  • -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 management module Ethernet channel 1 static IP address (IPv4) Sets the static IP address (IPv4) for Ethernet channel 1 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth1 -i ip_address

where ip_address is the static IP address for Ethernet channel 1 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 1 gateway IP address (IPv4) Sets the gateway IP address (IPv4) for Ethernet channel 1 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth1 -g ip_address

where ip_address is the gateway IP address for Ethernet channel 1 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 1 subnet mask (IPv4) Sets the subnet mask (IPv4) for Ethernet channel 1 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth1 -s sub_mask

where sub_mask is the subnet mask for Ethernet channel 1 in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 1 data rate Sets the data rate for Ethernet channel 1 for the management module. ifconfig -eth1 -r data_rate
where data_rate is
  • auto
  • 10
  • 100
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 1 duplex mode Sets the duplex mode for Ethernet channel 1 for the management module. ifconfig -eth1 -d duplex_mode
where duplex_mode is
  • auto
  • half
  • full
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 1 MTU Sets the MTU (maximum transmission unit) for Ethernet channel 1 for the management module. ifconfig -eth1 -m mtu

where mtu is between 60 and 1500, inclusive.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set management module Ethernet channel 1 static MAC address (locally administered) Sets the locally administered MAC address to the specified MAC address for Ethernet channel 1 for the management module.
Note: Changes made to the IP configuration of the primary management module take effect after the next reset of the primary management module.
 ifconfig -eth1 -l address

where address is the locally administered MAC address for Ethernet channel 1. The MAC address is 6 bytes in length, hexadecimal, separated by colons. The MAC address can not be a multicast address (the first byte must be even).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the standby management-module bay number.
Enable management module Ethernet channel 1 Enables the Ethernet channel 1 interface for the management module. ifconfig -eth1 -up
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Disable management module Ethernet channel 1 Disables the Ethernet channel 1 interface for the management module. ifconfig -eth1 -down
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Display cKVM and network configuration status for blade server Displays the cKVM status and network status for the specified blade server.
  • Valid cKVM states include:
    • Enabled
    • Disabled
  • If the blade server supports network configuration, this command also displays the NIC numbers (such as -eth0 and -eth1), NIC states (up or down), and other NIC configuration information for the blade server and all network cards connected to the blade server.
 ifconfig 
                           -T system:blade[x]

where x is the blade-server bay number.
Display network configuration information for network card Displays the NIC number (such as -eth0 and -eth1), NIC state (up or down), and other NIC configuration information for the specified network card in the specified blade server. ifconfig -eth x

where x is the NIC number.

 
                           -T system:blade[x]

where x is the blade-server bay number.
Set I/O module for blade server management traffic Sets the I/O module that will be used to route management traffic for the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth1 -i IO_bay

where IO_bay is the bay number of the I/O module that should be used to route management traffic.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Enable / disable cKVM feature for blade server Enable or disable cKVM feature for the specified blade server.
Note: The cKVM feature requires special hardware and is not available for all blade servers.
 ifconfig -ckvm state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel static IP address (IPv4) Sets the IPv4 static IP address for the specified Ethernet channel of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -i ip_address
where:
  • x is the NIC number.
  • ip_address is the static IP address for Ethernet channel x in dotted decimal IP address format.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel static IP address (IPv6) Sets the IPv6 static IP address for the specified Ethernet channel of the specified blade server.
Note:
  • This command will run only if the target blade server supports manual IPv6 configuration of its management network interface.
  • A static IPv6 configuration ID is required for network interfaces that support more than one static configuation.
 ifconfig -eth x -i6 ip_address -id id
where:
  • x is the NIC number.
  • ip_address is the static IP address for Ethernet channel x in IPv6 format.
  • id is the static IPv6 configuration ID.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel gateway IP address (IPv4) Sets the IPv4 gateway IP address for the specified Ethernet channel of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -g ip_address
where:
  • x is the NIC number.
  • ip_address is the gateway IP address for Ethernet channel x in dotted decimal IP address format.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel gateway/default route (IPv6) Sets the IPv6 gateway/default route for the specified Ethernet channel of the specified blade server.
Note:
  • This command will run only if the target blade server supports manual IPv6 configuration of its management network interface..
  • A static IPv6 configuration ID is required for network interfaces that support more than one static configuation.
 ifconfig -eth x -g6 ip_address -id id
where:
  • x is the NIC number.
  • ip_address is the gateway/default route for Ethernet channel x in IPv6 format.
  • id is the static IPv6 configuration ID.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel subnet mask (IPv4) Sets the IPv4 subnet mask for the specified Ethernet channel of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -s sub_mask
where:
  • x is the NIC number.
  • sub_mask is the subnet mask for Ethernet channel x in dotted decimal IP address format.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel configuration method Sets the configuration method for the specified Ethernet channel of the specified blade server.

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

Note:
  • This command will run only if the target blade server supports manual configuration of its management network interface.
  • If the DHCP setting is set to try the DHCP server and then use the static IP address, the NIC will use the static IP address when the DHCP server is not available during start up. When this occurs, the IP address might not be reachable if multiple devices were started with the same static IP address.
  • Blade servers based on the Power PC chip, including the JS12 and JS22, only support the static and DHCP options.
 ifconfig -eth x -c config_method
where:
  • x is the NIC number.
  • config_method is
    • dhcp
    • static
    • dthens
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set management module Ethernet channel VLAN ID Sets the VLAN ID for the specified Ethernet channel of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -v vlan_id
where:
  • x is the NIC number.
  • vlan_id is from 1 to 4095, inclusive. If you enter a value outside this range, an error will be displayed.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set state for blade server Ethernet channel VLAN ID Enables or disables the VLAN ID for the specified Ethernet channel of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -ve state
where:
  • x is the NIC number.
  • state is enable or disable.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server Ethernet channel hostname Sets the host name for the specified Ethernet channel of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -n hostname
where:
  • x is the NIC number.
  • hostname is the host name. The hostname can be a string up to 63 characters in length that includes alphanumeric characters, hyphens, and underscores.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Enable blade server Ethernet channel Enables the specified Ethernet channel interface of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -up

where x is the NIC number.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Disable blade server Ethernet channel Disables the specified Ethernet channel interface of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -eth x -down

where x is the NIC number.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Enable / disable IPv6 addressing for blade server Enable or disable IPv6 addressing for the specified Ethernet channel interface of the specified blade server.
Note: This command will run only if the target blade server supports manual IPv6 configuration of its management network interface.
 ifconfig -eth x -ipv6 state
where:
  • x is the NIC number.
  • state is enabled or disabled.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server address prefix length Sets the IPv6 address prefix length for the specified Ethernet channel interface of the specified blade server.
Note:
  • This command will run only if the target blade server supports manual IPv6 configuration of its management network interface.
  • A static IPv6 configuration ID is required for network interfaces that support more than one static configuation.
 ifconfig -eth x -p6 length -id id
where:
  • x is the NIC number.
  • length is between 1 and 128 (inclusive).
  • id is the static IPv6 configuration ID.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Enable / disable DHCPv6 for blade server Enable or disable static DHCPv6 for the specified Ethernet channel interface of the specified blade server.
Note: This command will run only if the target blade server supports manual IPv6 configuration of its management network interface.
 ifconfig -eth x -dhcp6 state
where:
  • x is the NIC number.
  • state is enabled or disabled.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Enable / disable IPv6 stateless auto-configuration for blade server Enable or disable IPv6 stateless auto-configuration for the specified Ethernet channel interface of the specified blade server.
Note: This command will run only if the target blade server supports manual IPv6 configuration of its management network interface.
 ifconfig -eth x -sa6 state
where:
  • x is the NIC number.
  • state is enabled or disabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]

where x is the blade-server bay number.
Set blade server ISMP static IP address (IPv4) Sets the IPv4 static IP address for the integrated system management processor (ISMP) of the specified blade server.
Note: This command will run only if the target blade server supports manual configuration of its management network interface.
 ifconfig -i ip_address

where ip_address is the static IP address for the blade server ISMP in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:blade[x]:sp

where x is the blade-server bay number.
Display network settings for BladeCenter unit Displays network settings for the BladeCenter unit. Valid return values are:
  • -v VLAN-id
  • -maxv enabled/disabled
ifconfig 
                           -T system
Enable / disable multiple video sessions for blade servers Set state to allow only a single remote video session or allow up to four remote video sessions for each blade server. ifconfig -maxv state

where state is enabled (allow multiple video sessions) or disabled (allow only one video session).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system
VLAN ID for BladeCenter unit Sets the VLAN ID for the BladeCenter unit. ifconfig -v VLAN-id

where VLAN-id is from 1 to 4095, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system
Set state for BladeCenter unit VLAN ID Enables or disables the VLAN ID for the BladeCenter unit. ifconfig -ve state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system
Enable / disable global cKVM feature for BladeCenter unit Enable or disable cKVM feature globally for the BladeCenter unit. (This is the same as running the ifconfig -ckvm enable command directed to each blade server.)
Note: The cKVM feature requires special hardware and is not available for all blade servers.
 ifconfig -ckvm state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system
Display network settings for I/O module Displays network settings for the specified I/O module. Valid return values are:
  • I/O-module type
  • -i ip_address (dotted decimal IPv4 IP address format)
  • -s subnet_mask (dotted decimal IPv4 IP address format)
  • -g gateway_address (dotted decimal IPv4 IP address format)
  • -em ext_mgt_status
  • -ep ext_port_status
  • -pm enabled/disabled (protected mode)
  • -pip enabled/disabled
  • -c config_method
  • -ipv6 ipv6_state
  • -ipv6static static_ipv6_state
  • -i6 static_ip_address (IPv6 format)
  • -p6 address_prefix_length (IPv6 format)
  • -g6 gateway-default_route (IPv6 format)
  • -dhcp6 dhcpv6_state
  • -sa6 ipv6_stateless_autoconfig_state

If IPv6 is enabled, the link-local address link_local_address (for IPv6 connection) also displays.

If IPv6 and stateless auto-configuration (-sa6) are both enabled, the Stateless auto-config IP Addresses / Prefix Length address_table (table listing auto-generated IPv6 addresses and their prefix lengths) also displays.

 ifconfig 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set starting IP address for I/O module (IPv4) Sets the IPv4 IP addresses for the specified I/O module. ifconfig -i ip_address

where ip_address is the IP address of the specified I/O module in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set starting IP address for I/O module (IPv6) Sets the IPv6 static IP address for the specified I/O module. ifconfig -i6 ip_address

where ip_address is the static IP address for the specified I/O module in IPv6 format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set I/O-module gateway IP address (IPv4) Sets the gateway IPv4 IP address for the specified I/O module. ifconfig -g ip_address

where ip_address is the gateway IP address for the I/O module in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set I/O-module gateway IP address (IPv6) Sets the IPv6 gateway/default route for the specified I/O module. ifconfig -g6 ip_address

where ip_address is the gateway IP address for the I/O module in IPv6 format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Keep new IP address configuration for I/O-module after reset Retains a new IP address configuration after the specified I/O module is reset.
Note: Make sure a valid New Static IP Configuration is entered for this I/O module so that when the module's factory defaults are restored, or when a reset is initiated by a source other than the management module, the New Static IP Configuration will be configured. In these cases management module communication with the I/O module will be preserved.
 ifconfig -pip enabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Revert to old IP address configuration for I/O-module after reset Reverts IP address to old configuration after the specified I/O module is reset.
Note: The factory default IP configuration will become active when the I/O module is reset to factory defaults by either the management module or the I/O module. If an I/O module reset is initiated by a source other than the management module, then the previous IP configuration will be in affect. In both of these cases the management module will lose IP communications with the I/O module.
 ifconfig -pip disabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set I/O-module subnet mask (IPv4) Sets the IPv4 subnet mask for the specified I/O module. ifconfig -s sub_mask

where sub_mask is the subnet mask for the I/O module in dotted decimal IP address format.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -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 the specified I/O module. ifconfig -em state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -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. ifconfig -ep state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable protected mode for I/O module Enables or disables protected mode for the specified I/O module. ifconfig -pm state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable IPv6 addressing for I/O module Enable or disable IPv6 addressing for the specified I/O module. ifconfig -ipv6 state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable static IPv6 configuration for I/O module Enable or disable static IPv6 configuration for the specified I/O module. ifconfig -ipv6static state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set I/O module address prefix length Sets the IPv6 address prefix length for the specified I/O module. ifconfig -p6 length

where length is between 1 and 128 (inclusive).

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable DHCPv6 for I/O module Enable or disable static DHCPv6 for the specified I/O module. ifconfig -dhcp6 state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Enable / disable IPv6 stateless auto-configuration for I/O module Enable or disable IPv6 stateless auto-configuration for the specified I/O module. ifconfig -sa6 state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the I/O-module bay number.
Set IP addresses for RAID controller and SAS system (IPv4)

(BladeCenter S units only)

 Sets IPv4 IP addresses for RAID controller and SAS system. ifconfig -i ip_address_a -ir ip_address_b
where
  • ip_address_a is the IP address of the specified SAS system in dotted decimal IP address format.
  • ip_address_b is the IP address of the associated RAID controller in dotted decimal IP address format.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the RAID controller bay number.
Set gateway IP addresses for RAID controller and SAS system (IPv4)

(BladeCenter S units only)

 Sets the IPv4 gateway IP addresses for RAID controller and SAS system. ifconfig -g ip_address_a -gr ip_address_b
where
  • ip_address_a is the gateway IP address of the specified SAS system in dotted decimal IP address format.
  • ip_address_b is the gateway IP address of the associated RAID controller in dotted decimal IP address format.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the RAID controller bay number.
Set subnet masks for RAID controller and SAS system (IPv4)

(BladeCenter S units only)

 Sets the IPv4 subnet masks for the RAID controller and SAS system. ifconfig -s sub_mask_a -sr sub_mask_b
where
  • sub_mask_a is the subnet mask of the specified SAS system in dotted decimal IP address format.
  • sub_mask_b is the subnet mask of the associated RAID controller in dotted decimal IP address format.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
 
                           -T system:switch[x]

where x is the RAID controller bay number.

Example:

To display the configuration for Ethernet channel 0, that does not support IPv6, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  ifconfig -eth0
To set the IPv4 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
To set the IPv4 IP addresses for the BladeCenter S SAS subsystem to 9.186.10.16 and the IPv4 IP address for the RAID controller to 9.186.10.17, while switch module 3 is set as the persistent command environment, at the system:switch[3]> prompt, type
                  ifconfig -i 9.186.10.16 -ir 9.186.10.17
To set the IPv4 gateway address for the BladeCenter S SAS subsystem to 9.186.10.1 and the IPv4 gateway address for the RAID controller to 9.186.11.1, while switch module 3 is set as the persistent command environment, at the system:switch[3]> prompt, type
                  ifconfig -g 9.186.10.1 -gr 9.186.11.1

The following example shows the information that is returned from these 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]>
            
               system:switch[3]>ifconfig -i 9.186.10.16 -ir 9.186.10.17
OK
system:switch[3]>ifconfig -g 9.186.10.1 -gr 9.186.11.1
OK
system:mm[1]>
To display the configuration for Ethernet channel 0, that supports IPv6, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  ifconfig -eth0

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

               system:mm[1]> ifconfig -eth0
Enabled
-i 10.13.3.230
-g 10.13.1.1
-s 255.255.0.0
-n primaryAMM
-c static
-r auto
-d auto
-m 1500
-l 00:00:00:00:00:00
-b 00:14:5E:DF:0F:CE
-dn primaryAMM.com
-ipv6 enabled
-ipv6static disabled
-i6 6::6
-p6 1
-g6 ::
-dhcp6 enabled
-sa6 enabled
Link-local address: fe80::214:5eff:fedf:fce
Stateless auto-config IP Addresses       Prefix Length
---------------------------------------  -------------
2000:1013::214:5eff:fedf:fce             64
2001:1013::214:5eff:fedf:fce             64
2002:1013::214:5eff:fedf:fce             64
system:mm[1]>
Parent topic: Command syntax