Go to main content

Administering TCP/IP Networks, IPMP, and IP Tunnels in Oracle® Solaris 11.3

Exit Print View

Updated: March 2019

How to Configure the Behavior of the IPMP Daemon

    Use the IPMP /etc/default/mpathd configuration file to configure the following system-wide parameters for IPMP groups:




  1. Become the root role.
  2. Edit the /etc/default/mpathd file.
    # pfedit /etc/default/mpathd

    See the pfedit(1M) man page for instructions.

      Change the default value of one or more of the following three parameters:

    • Type the new value for the FAILURE_DETECTION_TIME parameter as follows:


      n is the amount of time in seconds for ICMP probes to detect whether an interface failure has occurred. The default is 10 seconds.

    • Type the new value for the FAILBACK parameter as follows:

      FAILBACK=[yes | no]

      Is the default for the failback behavior of IPMP. When the repair of a failed interface is detected, network access fails back to the repaired interface, as described in Detecting Physical Interface Repairs.


      Indicates that data traffic does not return to a repaired interface. When a failed interfaces is detected as repaired, the INACTIVE flag is set for that interface. This flag indicates that the interface is currently not to be used for data traffic. The interface can still be used for probe traffic.

      For example, assume that the IPMP group ipmp0 consists of two interfaces, net0 and net1. In the /etc/default/mpathd file, the FAILBACK=no parameter is set. If net0 fails, then it is flagged as FAILED and becomes unusable. After repair, the interface is flagged as INACTIVE and remains unusable because of the FAILBACK=no value.

      If net1 fails and only net0 is in the INACTIVE state, then the INACTIVE flag for net0 is cleared and the interface becomes usable. If the IPMP group has other interfaces that are also in the INACTIVE state, then any one of these INACTIVE interfaces, and not necessarily net0, can be cleared and become usable when net1 fails.

    • Type the new value for the TRACK_INTERFACES_ONLY_WITH_GROUPS parameter as follows:


      Is the default for the behavior of IPMP. This value causes IPMP to ignore network interfaces that are not configured into an IPMP group.


      Sets failure and repair detection for all network interfaces, regardless of whether they are configured into an IPMP group. However, when a failure or repair is detected on an interface that is not configured into an IPMP group, no action is triggered in IPMP to maintain the networking functions of that interface. Therefore, the no value is only useful for reporting failures and does not directly improve network availability.

      For more information about this parameter and the anonymous group feature, see Failure Detection and the Anonymous Group Feature.

  3. Restart the in.mpathd daemon.
    # pkill -HUP in.mpathd

    The daemon restarts with the new parameter values in effect.