System Administration Guide: Network Interfaces and Network Virtualization

ProcedureHow to Create a Link Aggregation

Before You Begin

Note –

Link aggregation only works on full-duplex, point-to-point links that operate at identical speeds. Make sure that the interfaces in your aggregation conform to this requirement.

If you are using a switch in your aggregation topology, make sure that you have done the following on the switch:

  1. Assume the Primary Administrator role, or become superuser.

    The Primary Administrator role includes the Primary Administrator profile. To create the role and assign the role to a user, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

  2. Display the network data-link information.

    # dladm show-link
  3. Make sure that the link over which you are creating the aggregation is not opened by any application.

    For example, if the IP interface over the link is plumbed, then unplumb the interface.

    # ifconfig interface unplumb

    where interface refers to the IP interface that is plumbed and using the link.

  4. Create a link aggregation.

    # dladm create-aggr [-f] -l link1 -l link2 [...] aggr

    Forces the creation of the aggregation. Use this option when you are attempting to aggregate devices that do not support link state notification.


    Specifies the data links that you want to aggregate.


    Specifies the name that you want to assign to the aggregation.

  5. Plumb and configure an IP interface over the newly created aggregation.

    # ifconfig interface plumb IP-address up

    where interface takes the name of the aggregation.

  6. Check the status of the aggregation you just created.

    The aggregation's state should be UP.

    # dladm show-aggr
  7. (Optional) Make the IP configuration of the link aggregation persist across reboots.

    1. Create the /etc/hostname file for the aggregation's interface.

      If the aggregation contains IPv4 addresses, the corresponding hostname file is /etc/hostname.aggr. For IPv6–based link aggregations, the corresponding hostname file is /etc/hostname6.aggr.

    2. Type the IPv4 or IPv6 address of the link aggregation into the file.

    3. Perform a reconfiguration boot.

      # reboot -- -r

Example 6–1 Creating a Link Aggregation

This example shows the commands that are used to create a link aggregation with two data links, subvideo0 and subvideo1. The configuration is persistent across system reboots.

# dladm show-link
LINK          CLASS     MTU     STATE     OVER
subvideo0     phys      1500    up        ----
subvideo1     phys      1500    up        ----

# dladm create-aggr -l subvideo0 -l subvideo1 video0
# ifconfig video0 plumb up
# dladm show-aggr
video0    L4      auto            off            short      -----

# echo > /etc/hostname.video0

# reboot -- -r

When you display link information, the link aggregation is included in the list.

# dladm show-link
LINK          CLASS     MTU     STATE     OVER
subvideo0     phys      1500    up        ----
subvideo1     phys      1500    up        ----
video0        aggr      1500    up        subvideo0, subvideo1