Bug 159374

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"
>

Comment 2 Brad Davis 2011-09-29 20:50:26 UTC

Responsible Changed
From-To: freebsd-doc->brd

Grab.

Comment 3 dfilter service 2011-10-02 06:37:48 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"

Comment 4 Brad Davis 2012-06-17 19:48:47 UTC

State Changed
From-To: open->closed

- Fixed.