ifconfig command

This command configures and displays the network interface settings for the CMM Ethernet interface, I/O-module Ethernet interface, and the compute node system-management processors and installed options.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or ifconfig command errors for a list of error messages that are specific to the ifconfig command.

Table 1. ifconfig command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display primary CMM Ethernet channel 0 configuration Displays the current configuration of Ethernet channel 0 for the primary CMM. 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.

If there are two CMMs installed in the chassis and the advfailover command is set to noswap, the following items also display:

  • -f floating_ip_address (dotted decimal IPv4 IP address format)
  • -f6 floating_ip_address (IPv6 format)
 ifconfig -eth0
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display standby CMM Ethernet channel 0 configuration Displays the current configuration of Ethernet channel 0 for the standby CMM.
Note: If there are two CMMs installed in the chassis and the currently active advfailover setting is off, there will be no current configuration of eth0 for the standby CMM.

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
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Note: Even though this command displays information for the standby CMM, it still must specify the primary CMM as the command target.
Set primary CMM Ethernet channel 0 static IP address (IPv4) Sets the IPv4 static IP address for Ethernet channel 0 for the primary CMM.
Note:
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
  • Changes made to the IPv4 configuration of the primary CMM take effect after the next reset of the primary CMM.
  • Including the -apply option when setting an IPv4 configuration option makes the change take effect immediately.
  • Use the -apply option by itself after setting multiple IPv4 configuration options for an Ethernet channel to make all changes for that Ethernet channel take effect without resetting the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Apply IPv4 configuration for primary CMM Places all outstanding IPv4 configuration made to the primary CMM into effect.
Note: Using the -apply option places changes into effect without resetting the CMM.
 ifconfig -eth0 -apply
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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 static IP address (IPv6) Sets the IPv6 static IP address for Ethernet channel 0 for the primary CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 floating IP address (IPv4) Sets the IPv4 floating IP address for Ethernet channel 0 for the primary CMM.
Note:
  • An Ethernet channel 0 floating IP address for the CMM can only be set if there are two CMMs installed in the chassis and the advfailover command is set to noswap.
  • Changes made to the IPv4 configuration of the primary CMM take effect after the next reset of the primary CMM.
  • Including the -apply option when setting an IPv4 configuration option makes the change take effect immediately.
  • Use the -apply option by itself after setting multiple IPv4 configuration options for an Ethernet channel to make all changes for that Ethernet channel take effect without resetting the primary CMM.
 ifconfig -eth0 -f ip_address

where ip_address is the floating 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 floating IP address (IPv6) Sets the IPv6 floating IP address for Ethernet channel 0 for the primary CMM.
Note: An Ethernet channel 0 floating IP address for the CMM can only be set if there are two CMMs installed in the chassis and the advfailover command is set to noswap.
 ifconfig -eth0 -f6 ip_address

where ip_address is the floating 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set standby CMM Ethernet channel 0 static IP address (IPv4) Sets the IPv4 static IP address for Ethernet channel 0 for the standby CMM.
Note:
  • An Ethernet channel 0 floating IP address for the CMM can only be set if there are two CMMs installed in the chassis and the advfailover command is set to noswap.
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
  • Changing the IPv4 static IP address for the standby CMM takes effect immediately.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Note: Even though this command displays information for the standby CMM, it still must specify the primary CMM as the command target.
Set standby CMM Ethernet channel 0 static IP address (IPv6) Sets the IPv6 static IP address for Ethernet channel 0 for the standby CMM.
Note: An Ethernet channel 0 floating IP address for the CMM can only be set if there are two CMMs installed in the chassis and the advfailover command is set to noswap.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Note: Even though this command displays information for the standby CMM, it still must specify the primary CMM as the command target.
Set primary CMM Ethernet channel 0 gateway IP address (IPv4) Sets the IPv4 gateway IP address for Ethernet channel 0 for the primary CMM.
Note:
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
  • Changes made to the IPv4 configuration of the primary CMM take effect after the next reset of the primary CMM.
  • Including the -apply option when setting an IPv4 configuration option makes the change take effect immediately.
  • Use the -apply option by itself after setting multiple IPv4 configuration options for an Ethernet channel to make all changes for that Ethernet channel take effect without resetting the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 gateway/default route (IPv6) Sets the IPv6 gateway/default route for Ethernet channel 0 for the primary CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 subnet mask (IPv4) Sets the IPv4 subnet mask for Ethernet channel 0 for the primary CMM.
Note:
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
  • Changes made to the IPv4 configuration of the primary CMM take effect after the next reset of the primary CMM.
  • Including the -apply option when setting an IPv4 configuration option makes the change take effect immediately.
  • Use the -apply option by itself after setting multiple IPv4 configuration options for an Ethernet channel to make all changes for that Ethernet channel take effect without resetting the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primaryCMM Ethernet channel 0 hostname Sets the host name for Ethernet channel 0 for the primary CMM.
Note:
  • Changes made to the IPv4 configuration of the primary CMM take effect after the next reset of the primary CMM.
  • Including the -apply option when setting an IPv4 configuration option makes the change take effect immediately.
  • Use the -apply option by itself after setting multiple IPv4 configuration options for an Ethernet channel to make all changes for that Ethernet channel take effect without resetting the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set standby CMM Ethernet channel 0 hostname Sets the host name for Ethernet channel 0 for the standby CMM.
Note: Changes made to the host name of the standby CMM take effect immediately.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Note: Even though this command displays information for the standby CMM, it still must specify the primary CMM as the command target.
Set primary CMM Ethernet channel 0 IPv4 configuration method Sets the IPv4 configuration method for Ethernet channel 0 for the primary CMM.

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 CMM DHCP setting is set to try the DHCP server and then use the static IP address, the CMM will use the static IP address when the DHCP server is not available during CMM start up. When this occurs, the IP address might not be reachable if multiple CMMs were started with the same static IP address.
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
  • Changes made to the IPv4 configuration of the primary CMM take effect after the next reset of the primary CMM.
  • Including the -apply option when setting an IPv4 configuration option makes the change take effect immediately.
  • Use the -apply option by itself after setting multiple IPv4 configuration options for an Ethernet channel to make all changes for that Ethernet channel take effect without resetting the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 data rate Sets the data rate for Ethernet channel 0 for the primary CMM.
Note: Changes made to the data rate of the primary CMM take effect after the next reset of the primary CMM.
 ifconfig -eth0 -r data_rate
where data_rate is
  • 10
  • 100
  • auto
  • 1000auto
    Note: When set to 1000auto, the duplex mode is automatically changed to 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM Ethernet channel 0 duplex mode Sets the duplex mode for Ethernet channel 0 for the primary CMM.
Note: Changes made to the duplex mode of the primary CMM take effect after the next reset of the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set CMM Ethernet channel 0 MTU Sets the MTU (maximum transmission unit) for Ethernet channel 0 for the CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set primary CMM 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 primary CMM.
Note: Changes made to the IP configuration of the primary CMM take effect after the next reset of the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set standby CMM 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 CMM.
Note: Changes made to the locally administered MAC address of the standby CMM take effect immediately.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Note: Even though this command displays information for the standby CMM, it still must specify the primary CMM as the command target.
Set primary CMM Ethernet channel 0 domain name Sets the domain name for Ethernet channel 0 for the primary CMM.
Note: Changes made to the IP configuration of the primary CMM take effect after the next reset of the primary CMM.
 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set standby CMM Ethernet channel 0 domain name Sets the domain name for Ethernet channel 0 for the standby CMM. ifconfig -o -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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable static IPv6 configuration for CMM Ethernet channel 0 Enable or disable static IPv6 configuration for Ethernet channel 0 for the CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set CMM Ethernet channel 0 address prefix length Sets the IPv6 address prefix length for Ethernet channel 0 for the CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable DHCPv6 for CMM Ethernet channel 0 Enable or disable static DHCPv6 for Ethernet channel 0 for the CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable IPv6 stateless auto-configuration for CMM for Ethernet channel 0 Enable or disable IPv6 stateless auto-configuration for Ethernet channel 0 for the CMM. 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display network configuration status for compute node Displays the network interfaces and network status for the specified compute node. ifconfig
Compute node:
  • blade[x]
  • where x is the node bay number.
Display configuration information for network interface Displays the network interface type and number (such as -eth0), network interface state (up or down), and other network interface configuration information for the specified network interface in the specified compute node. ifconfig -interface_label
where interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
  • usb for USB
  • eth for Ethernet

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node network interface static IP address (IPv4) Sets the IPv4 static IP address for the specified network interface of the specified compute node.
Note:
  • This command will run only if the target compute node supports manual configuration of its management network interface.
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 ifconfig -interface_label -i ip_address
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • ip_address is the static IP address for network interface in dotted decimal IP address format.

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node network interface static IP address (IPv6) Sets the IPv6 static IP address for the specified network interface of the specified compute node.
Note:
  • This command will run only if the target compute node 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 -interface_label -i6 ip_address -id id
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • ip_address is the static IP address for Ethernet channel x in IPv6 format.
  • id is the static IPv6 configuration ID.

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node network interface gateway IP address (IPv4) Sets the IPv4 gateway IP address for the specified network interface of the specified compute node.
Note:
  • This command will run only if the target compute node supports manual configuration of its management network interface.
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 ifconfig -interface_label -g ip_address
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • ip_address is the gateway IP address for Ethernet channel x in dotted decimal IP address format.

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node network interface gateway/default route (IPv6) Sets the IPv6 gateway/default route for the specified network interface of the specified compute node.
Note:
  • This command will run only if the target compute node 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 -interface_label -g6 ip_address -id id
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • ip_address is the gateway/default route for Ethernet channel x in IPv6 format.
  • id is the static IPv6 configuration ID.

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node network interface subnet mask (IPv4) Sets the IPv4 subnet mask for the specified network interface of the specified compute node.
Note:
  • This command will run only if the target compute node supports manual configuration of its management network interface.
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 ifconfig -interface_label -s sub_mask
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • sub_mask is the subnet mask for Ethernet channel x in dotted decimal IP address format.

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node network interface IPv4 configuration method Sets the IPv4 configuration method for the specified network interface of the specified compute node.

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 compute node 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.
  • If the CMM and compute nodes are set up to use DHCP and the CMM loses network connectivity, the CMM will attempt to acquire a new IP address when network connectivity is restored. The compute nodes will not attempt to acquire an IP address again; they will continue using their existing IP addresses. If you experience compute node network problems after connectivity between the CMM and network is restored, you might need to reset the system-management processor on each compute node in the chassis (including optional Lenovo XClarity Administrator or Flex System Manager hardware, if it is installed).
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 ifconfig -interface_label -c config_method
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • config_method is
    • dhcp
    • static
    • dthens

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable IPv4 addressing for compute node Enable or disable IPv4 addressing for the specified network interface of the specified compute node. ifconfig -interface_label -ipv4 state
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • state is enabled or disabled .

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set compute node address prefix length Sets the IPv6 address prefix length for the specified network interface of the specified compute node.
Note:
  • This command will run only if the target compute node 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 -interface_label -p6 length -id id
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • length is between 1 and 128 (inclusive).
  • id is the static IPv6 configuration ID.

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable DHCPv6 for compute node Enable or disable static DHCPv6 for the specified network interface of the specified compute node.
Note: This command will run only if the target compute node supports manual IPv6 configuration of its management network interface.
 ifconfig -interface_label -dhcp6 state
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • state is enabled or disabled .

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable IPv6 stateless auto-configuration for compute node Enable or disable IPv6 stateless auto-configuration for the specified network interface of the specified compute node.
Note: This command will run only if the target compute node supports manual IPv6 configuration of its management network interface.
 ifconfig -interface_label -sa6 state
where:
  • interface_label is any interface label reported by the compute node that specifies both the interface type and channel number. For example, eth0 for Ethernet channel 0. Valid interface types include:
    • usb for USB
    • eth for Ethernet
  • state is enabled or disabled

Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument.

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.
Compute node:
  • blade[x]
  • where x is the node bay number.
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 non_mgmt_data_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
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Set I/O module IPv4 network configuration method Sets the IPv4 network configuration method for the specified I/O 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:
  • This command will run only if the target I/O module 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 I/O module 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.
  • Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 ifconfig -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
  • I/O module configuration
See Commands and user authority for additional information.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Set starting IP address for I/O module (IPv4) Sets the IPv4 IP addresses for the specified I/O module.
Note: Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Set I/O-module gateway IP address (IPv4) Sets the gateway IPv4 IP address for the specified I/O module.
Note: Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-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 manufacturing defaults are restored, or when a reset is initiated by a source other than the CMM, the New Static IP Configuration will be configured. In these cases CMM 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.
I/O module:
  • switch[x]
  • where x is the I/O-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 manufacturing default IP configuration will become active when the I/O module is reset to manufacturing defaults by either the CMM or the I/O module. If an I/O module reset is initiated by a source other than the CMM, then the previous IP configuration will be in affect. In both of these cases the CMM 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.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Set I/O-module subnet mask (IPv4) Sets the IPv4 subnet mask for the specified I/O module.
Note: Static IPv4 parameters can not be set when the IPv4 configuration method is set to DHCP.
 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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Enable Ethernet interface for I/O module Enables the Ethernet interface for the specified I/O module. ifconfig -up
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.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Disable Ethernet interface for I/O module Disables the Ethernet interface for the specified I/O module. ifconfig -down
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.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Enable / disable non-management data ports for I/O module Enables or disables non-management data 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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-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.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.

Example:

To set the CMM IPv4 static IP address for Ethernet channel 0 to 192.168.70.133, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
ifconfig -eth0 -i 192.168.70.133 -c static -T mm[p]

The following example shows the information that is returned from this command:

system> ifconfig -eth0 -i 192.168.70.133 -c static -T mm[p]
Changes to -c, -i, -s, -g, and -f will become active after the next reset of the 
CMM, or by using the -apply flag.
system>
To display the configuration for CMM Ethernet channel 0, after the above change has been applied, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
ifconfig -eth0 -T mm[p]

The following example shows the information that is returned from this command:

system> ifconfig -eth0 -T mm[p]
Enabled
-i 192.168.70.133
-g 9.72.216.1
-s 255.255.248.0
-n MM5CF3FC25DC49
-c static
-r auto
-d auto
-m 1500
-l 00:00:00:00:00:00
-b 5C:F3:FC:25:DC:49
-dn cmm.com
-ipv6 enabled
-ipv6static disabled
-i6 ::
-p6 0
-g6 ::
-dhcp6 enabled
-sa6 enabled
Link-local address: fe80::5ef3:fcff:fe25:dc49
Stateless auto-config IP Addresses       Prefix Length
---------------------------------------  -------------
3001:1013::5ef3:fcff:fe25:dc49           64
2000:1013::5ef3:fcff:fe25:dc49           64
3000:1013::5ef3:fcff:fe25:dc49           64
3002:1013::5ef3:fcff:fe25:dc49           64
2002:1013::5ef3:fcff:fe25:dc49           64
2001:1013::5ef3:fcff:fe25:dc49           64
system>
Parent topic: Command reference