From nobody@FreeBSD.org  Tue Aug  2 05:51:58 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 8A89E106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  2 Aug 2011 05:51:58 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 7A4F18FC13
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  2 Aug 2011 05:51:58 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p725pwZM051604
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 2 Aug 2011 05:51:58 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p725pwKM051602;
	Tue, 2 Aug 2011 05:51:58 GMT
	(envelope-from nobody)
Message-Id: <201108020551.p725pwKM051602@red.freebsd.org>
Date: Tue, 2 Aug 2011 05:51:58 GMT
From: Karli Sjberg <karli.sjoberg@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Difficulty following guide on configuring link aggregation
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         159374
>Category:       docs
>Synopsis:       [handbook] Difficulty following guide on configuring link aggregation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brd
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 02 06:00:22 UTC 2011
>Closed-Date:    Sun Jun 17 18:48:57 UTC 2012
>Last-Modified:  Sun Jun 17 18:48:57 UTC 2012
>Originator:     Karli Sjberg
>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@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 couldnt 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 days 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:

From: Benjamin Kaduk <kaduk@MIT.EDU>
To: Karli SjXberg <karli.sjoberg@gmail.com>
Cc: freebsd-gnats-submit@freebsd.org, freebsd-doc@freebsd.org
Subject: Re: docs/159374: Difficulty following guide on configuring link
 aggregation
Date: Thu, 4 Aug 2011 16:28:50 -0400 (EDT)

 Dear Karli,
 
 On Tue, 2 Aug 2011, Karli SjXberg wrote:
 
 >
 >
 > 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
 >
 
 This is standard behavior for manually configuring network interfaces -- 
 the explicit setting of the interface as 'up' is needed when no other 
 information about the interface is given (e.g. in rc.conf or 
 wpa_supplicant.conf).  So I do not think it is really appropriate to give 
 particular emphasis to the need to "up" the interface, in this particular 
 location in the text.
 It should be fine to include an explicit example of doing so for the LACP 
 case, though.  (Note that a later, non-LACP, example on that page does 
 include the 'up' stage.)
 It may also be needed to mention the general need for setting interfaces 
 as "up" elsewhere in the handbook, but I do not have time to check that 
 right now.
 
 > /etc/rc.conf:
 > ifconfig_em0="up"
 > ifconfig_em1="up"
 > cloned_interfaces="lagg0"
 > ifconfig_lagg0="up laggproto lacp laggport em0 laggport em1 DHCP"
 
 Is the "up" really necessary for ifconfig_lagg0, here?  I could mostly 
 believe that it is needed for em[01], but my understanding is that it 
 would not be needed for lagg0; the very last example on the page you link 
 does not have it for the failover case, as well.  If you could check and 
 report back, that would be helpful.
 
 Thanks,
 
 Ben Kaduk
 
 >
 > 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:
 > _______________________________________________
 > freebsd-doc@freebsd.org mailing list
 > http://lists.freebsd.org/mailman/listinfo/freebsd-doc
 > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
 >
Responsible-Changed-From-To: freebsd-doc->brd 
Responsible-Changed-By: brd 
Responsible-Changed-When: Thu Sep 29 19:50:26 UTC 2011 
Responsible-Changed-Why:  
Grab. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=159374 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/159374: commit references a PR
Date: Sun,  2 Oct 2011 05:37:48 +0000 (UTC)

 brd         2011-10-02 05:37:39 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/advanced-networking 
                                                        chapter.sgml 
   Log:
   - Link Aggregation and Failover section improvements
           - Explicitly show you have to bring the interfaces up in the examples
           - Improve wording around bringing the interfaces up
   
   PR:     docs/159374
   
   Revision  Changes    Path
   1.439     +17 -12    doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: brd 
State-Changed-When: Sun Jun 17 18:48:47 UTC 2012 
State-Changed-Why:  
- Fixed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=159374 
>Unformatted:
