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.
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:
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:
| ifconfig -eth0 | Primary CMM:
|
Display standby CMM Ethernet channel 0 configuration | Displays the current configuration of Ethernet channel 0 for the standby CMM. Note If there are two Possible return values are:
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:
Note Even though this command displays information for the standby |
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
| 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:
| Primary CMM:
|
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 | ifconfig -eth0 -apply This command can only be run by users who have one or more of the following command authorities:
| Primary CMM:
|
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:
| Primary CMM:
|
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
| 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:
| Primary CMM:
|
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 | 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:
| Primary CMM:
|
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
| 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:
| Primary CMM:
Note Even though this command displays information for the standby |
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 | 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:
| Primary CMM:
Note Even though this command displays information for the standby |
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
| 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:
| Primary CMM:
|
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:
| Primary CMM:
|
Set primary CMM Ethernet channel 0 subnet mask (IPv4) | Sets the IPv4 subnet mask for Ethernet channel 0 for the primary CMM. Note
| 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:
| Primary CMM:
|
Set primaryCMM Ethernet channel 0 hostname | Sets the host name for Ethernet channel 0 for the primary CMM. Note
| 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:
| Primary CMM:
|
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 | 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:
| Primary CMM:
Note Even though this command displays information for the standby |
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
| ifconfig -eth0 -c config_method where config_method is
This command can only be run by users who have one or more of the following command authorities:
| Primary CMM:
|
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 | ifconfig -eth0 -r data_rate where data_rate is
This command can only be run by users who have one or more of the following command authorities:
| Primary CMM:
|
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 | ifconfig -eth0 -d duplex_mode where duplex_mode is
This command can only be run by users who have one or more of the following command authorities:
| Primary CMM:
|
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:
| Primary CMM:
|
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 | 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:
| Primary CMM:
|
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 | 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:
| Primary CMM:
Note Even though this command displays information for the standby |
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 | 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:
| Primary CMM:
|
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:
| Primary CMM:
|
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:
| Primary CMM:
|
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:
| Primary CMM:
|
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:
| Primary CMM:
|
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:
| Primary CMM:
|
Display network configuration status for compute node | Displays the network interfaces and network status for the specified compute node. | ifconfig | Compute node:
|
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:
Valid interface types for a specific compute node can be seen by running the ifconfig command with no interface argument. | Compute node:
|
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
| ifconfig -interface_label -i ip_address where:
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:
| Compute node:
|
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
| ifconfig -interface_label -i6 ip_address -id id where:
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:
| Compute node:
|
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
| ifconfig -interface_label -g ip_address where:
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:
| Compute node:
|
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
| ifconfig -interface_label -g6 ip_address -id id where:
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:
| Compute node:
|
Set compute node network interface subnet mask (IPv4) | Sets the IPv4 subnet mask for the specified network interface of the specified compute node. Note
| ifconfig -interface_label -s sub_mask where:
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:
| Compute node:
|
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
| ifconfig -interface_label -c config_method where:
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:
| Compute node:
|
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:
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:
| Compute node:
|
Set compute node address prefix length | Sets the IPv6 address prefix length for the specified network interface of the specified compute node. Note
| ifconfig -interface_label -p6 length -id id where:
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:
| Compute node:
|
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 | ifconfig -interface_label -dhcp6 state where:
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:
| Compute node:
|
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 | ifconfig -interface_label -sa6 state where:
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:
| Compute node:
|
Display network settings for I/O module | Displays network settings for the specified I/O module. Valid return values are:
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:
|
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
| ifconfig -c config_method where config_method is
This command can only be run by users who have one or more of the following command authorities:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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 | ifconfig -pip enabled This command can only be run by users who have one or more of the following command authorities:
| I/O module:
|
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 | ifconfig -pip disabled This command can only be run by users who have one or more of the following command authorities:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
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:
| I/O module:
|
Example:
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]
<span className="ph">Changes to -c, -i, -s, -g, and -f will become active after the next reset of the
CMM, or by using the -apply flag.</span>
system>
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>