Go to main content

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

Exit Print View

Updated: November 2020
 
 

Maintaining IP Connectivity and Routing While Deploying IPMP

You can add an IP interface to an IPMP group by using the ipadm command or the ifconfig command. Due to backward compatibility with previous versions of Oracle Solaris IPMP, when you use the ifconfig command, any data addresses that are not marked with IFF_NOFAILOVER are migrated to the IPMP interface that is associated with the IPMP group. However, when you add an IP interface to an IPMP group by using the ipadm command, any address that is currently configured on the IP interface becomes a test address for that IP interface, meaning the address is not migrated to the IPMP interface as a data address.

If you want the IP address to be an IPMP data address, you must first remove the address from the IP interface and then reconfigure the address directly on the IPMP interface, as shown in the following example:

$ ipadm
NAME    CLASS/TYPE  STATE    UNDER    ADDR
...
ipmp0   ipmp        down      --      --
net0    ip          ok        ipmp0   --
net0/v4 static      ok        --      192.0.2.10/27
$ ipadm delete-addr net0/v4       
$ ipadm create-addr -T static -a local=192.0.2.10/27 ipmp0/v4
    
$ ipadm
NAME      CLASS/TYPE  STATE    UNDER     ADDR
...
ipmp0     ipmp        ok       --        --   
ipmp0/v4  static      ok       --        192.0.2.10/27
net0      ip          ok       ipmp0     --

Also, be mindful that any routes that you have defined by using specific IP interfaces will no longer work if these interfaces are subsequently added to an IPMP group. To ensure that a default route is preserved while using IPMP, you can define the route without specifying an interface. Using this method ensures that any interface, including an IPMP interface, can be used for routing, thereby enabling the system to continue to route traffic.

Loss of routing when configuring IPMP can also occur in association with an Oracle Solaris installation. During the installation, you are required to define a default route, for which you can use an interface on the system, such as the primary interface. Subsequently, if you configure an IPMP group by using the same interface on which you defined the default route, the system can no longer route network packets because the interface's address has been transferred to the IPMP interface. The following procedure describes a method for preserving the default route when using IPMP.

How to Preserve the Default Route While Using IPMP

The following task assumes the primary interface on the system is the interface on which the default route is defined. This type of routing loss applies to any interface that is used for routing, which later becomes part of an IPMP group.

Before You Begin

Ensure that your role has the appropriate rights profile to perform this procedure. See Using Rights Profiles to Perform Network Configuration.

  1. Log in to the system by using a console.

    You must use the console to perform this procedure. If you use the ssh or telnet command to log in, the connection is lost when you perform the subsequent steps.

  2. (Optional) Display the routes that are currently defined in the routing table.
    $ netstat -nr
  3. Delete the route that is bound to the specific interface.
    $ route -p delete default gateway-address -ifp interface
  4. Add the route without specifying an interface.
    $ route -p add default gateway-address
  5. (Optional) Display the redefined routes in the routing table.
    $ netstat -nr
  6. (Optional) If the information has not changed, restart the routing service, then recheck the information in the routing table to make sure the routes have been correctly redefined.
    $ svcadm restart routing-setup
Example 16  Defining Routes for IPMP

This example assumes that the default route was defined for net0 during the installation.

$ netstat -nr
Routing Table: IPv4
Destination     Gateway       Flags    Ref     Use       Interface
-------------  ------------  --------  -----  -----------  --------
default        192.0.2.1/27     UG      107    176682262   net0
192.0.2.0/27   192.0.2.30/27    U        22    137738792   net0

$ route -p delete default 192.0.2.1/27 -ifp net0
$ route -p add default 192.0.2.1/27

$ netstat -nr
Routing Table: IPv4
Destination     Gateway       Flags    Ref     Use       Interface
-------------  ------------  --------  -----  -----------  --------
default        192.0.2.1/27     UG      107    176682262
192.0.2.0/27   192.0.2.30/27    U        22    137738792   net0