docs/159374: Difficulty following guide on configuring link aggregation

[Karli Sjöberg]

>Number:         159374
>Category:       docs
>Synopsis:       Difficulty following guide on configuring link aggregation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 02 06:00:22 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Karli Sjöberg
>Release:        8.2-STABLE
>Organization:
Swedish University of Agriculture
>Environment:
FreeBSD main.inparadise.dontexist.com 8.2-STABLE FreeBSD 8.2-STABLE #0: Wed Jul  6 09:15:36 CEST 2011     root at main.inparadise.dontexist.com:/usr/obj/usr/src/sys/KERNEL-20110706-1  amd64
>Description:
Hi,

last week, it was the first time for me setting up a lagg interface with a cisco switch and had this page from the handbook as a guide:

Link Aggregation and Failover
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-aggregation.html

I had troubles getting everything to work because the lagg interface always showed "no carrier" as status and couldn´t get an address. After much googling, I found the reason for this is because you have make the laggports "up" before you create the lagg interface.

The rest went off without a hitch and it was so cool to see everything "just work". You really got double the perfomance and perfect failover!

If this had been explained in the handbook, it would have saved me half a day´s worth of troubleshooting.

Correct approach:
# ifconfig em0 up
# ifconfig em1 up
# ifconfig lagg0 create
# ifconfig lagg0 up laggproto lacp laggport em0 laggport em1

/etc/rc.conf:
ifconfig_em0="up"
ifconfig_em1="up"
cloned_interfaces="lagg0"
ifconfig_lagg0="up laggproto lacp laggport em0 laggport em1 DHCP"

I think it would make things much easier for other people in that situation, if this was explained on that page. How does that sound?

/Sebulon
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: