Table of ContentsLibraryView in Frames

Modifying network interface settings using the storage system command line

You can modify the parameters of your network interface settings using the command line of your storage system. For example, you can configure an IP address for a specific interface or specify a subnet mask.

Step

  1. To set specific network interface parameters, enter one of the following commands:

    If you want to ... Enter this command ..
    Configure an IP address for the specified interface ifconfig interface_name IP_address
    Note: By default, your storage system creates a network mask based on the class of the address (Class A, B, C, or D). However, if you have created subnets that do not match the class boundary of the IPv4 address, you must specify a network mask.

    Example: To configure a quad-port Ethernet interface e3a to use the IPv4 address 192.168.25.10, enter: ifconfig e3a 192.168.25.10

    To configure a quad-port Ethernet interface e3a to use the IPv6 address 2001:0db8:35ab:0:8a2e:0:0370:85, enter: ifconfig e2a 2001:0db8:35ab:0:8a2e:0:0370:85

    Specify a subnet mask for the specified interface ifconfig interface_name netmask mask

    Example: To configure a 24-bit mask for the interface e3a configured in the previous example, enter: ifconfig e3a netmask 255.255.255.0

    Note: You can specify subnet mask only for interfaces with IPv4 addresses.

    Specify the prefix length (number of bits used as the subnet mask) for the specified interface

    ifconfig interface_name ip_address prefixlen length

    Example: To configure a prefix length of 64 bits, enter: ifconfig e3a 2001:0db8:35ab:0:8a2e:0:0370:85 prefixlen 64

    Note: For an IPv4 address, the prefix length must be less than or equal to 32 bits. For an IPv6 address, the prefix length must be less than or equal to 128 bits. The default value of prefix length is 64 bits.
    Specify an address to send a message to all machines on a network ifconfig interface_name broadcast address

    Example: To set a broadcast address of 192.168.25.250 for the network 192.168.25.10 with subnet mask 255.255.255.0, enter: ifconfig e3a broadcast 192.168.25.250

    Note: You can set a broadcast address only for interfaces configured with IPv4 addresses.
    Specify a media type to configure speed and duplex for an interface ifconfig interface_name mediatype value

    Example: To configure the interface e2a as a 100Base-TX full-duplex interface, enter:

    ifconfig e2 mediatype 100tx-fd

    Specify an MTU size for transmission between your storage system and its client ifconfig interface_name mtusize size

    Example: To specify an MTU size of 9000 for Gigabit Ethernet interface e8, enter:

    ifconfig e8 mtusize 9000

    Specify the flow control type ifconfig interface_name flowcontrol value

    Example: To turn off flow control on interface e8, enter:

    ifconfig e8 flowcontrol none

    Remove a primary IP (IPv4 or IPv6) address

    ifconfig interface_name 0

    To remove an IPv4 primary address, you can also use:ifconfig interface_name 0.0.0.0

    To remove an IPv6 primary address, you can use either of these commands:
    • ifconfig interface_name 0::0
    • ifconfig interface_name inet6 0

    Example: To remove the primary address of interface e3, enter: ifconfig e3 0

    Note: You can remove an IPv4 or IPv6 primary address only after removing all the manually configured alias addresses for the interface.
    Declare an interface to be trustworthy or untrustworthy ifconfig interface_name {trusted|untrusted}

    Example: To specify that the network attached to interface e8 is not trustworthy for firewall security, enter:

    ifconfig e8 untrusted

    When you specify an interface as untrusted (untrustworthy), any packets received on the interface are likely to be dropped. For example, if you run a ping command on an untrusted interface, the ICMP response packet received on the interface is dropped.

    Enable or disable an interface to register with WINS when CIFS is running

    (By default, network interfaces are registered with a WINS server when CIFS is running.)

    ifconfig interface_name {wins|-wins}

    Example: To disable interface e8 from registering with WINS servers, enter:

    ifconfig e8 -wins

    Specify the IP address of an interface on the active/active configuration partner and to specify the interface that assumes this interface during takeover ifconfig interface_name partner address

    Example: To specify the IP address on an interface on the active/active configuration partner that assumes the interface e8 if the partner fails, enter:

    ifconfig e8 partner 192.168.25.10

    Note: You can specify only a IPv4 address for takeover in an active/active configuration.

    Specify the name of an interface on the active/active configuration partner that takes over the partner interface during failure

    ifconfig interface_name partner interface_name

    Example: To specify e3 as the interface on the active/active configuration partner that takes over the interface e8 when e8 fails, enter: ifconfig e8 partner e3

    Specify the IP address on an interface on the active/active configuration partner that assumes the interface ifconfig interface_name nfo

    Example: To enable negotiated failover on an interface e8 of an active/active configuration, enter:

    ifconfig e8 nfo
    Note: Remember to enable the cf.takeover.on_network_interface_failure option after enabling negotiated failover with the preceding command.

    This works in tandem with the active/active configuration takeover option cf.takeover.on_network_interface_failure . If the nfo parameter is on for an interface and the active/active configuration option is enabled, negotiated takeover between the configuration nodes can occur if the network interface fails.

    An interface that is a part of a vif cannot use this parameter.

    You must include this option in the /etc/rc file for it to persist across reboots.