From owner-freebsd-doc@FreeBSD.ORG Wed Sep 12 11:53:07 2007 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0259616A418 for ; Wed, 12 Sep 2007 11:53:07 +0000 (UTC) (envelope-from murray.stokely@gmail.com) Received: from rv-out-0910.google.com (rv-out-0910.google.com [209.85.198.189]) by mx1.freebsd.org (Postfix) with ESMTP id C50F213C459 for ; Wed, 12 Sep 2007 11:53:06 +0000 (UTC) (envelope-from murray.stokely@gmail.com) Received: by rv-out-0910.google.com with SMTP id l15so145389rvb for ; Wed, 12 Sep 2007 04:53:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; bh=FUKIRkEo6txkHUSYRrhQugGp/qq9/3EHqq+Gn0B+nsM=; b=uGRi69+XTBsgz+AUTSUy2QyxLVdDNKkd+IfHTCG9QiCBpeH3lb470vF2/m12vxlyVXBtSbS3fhGQCKSkGT93kQzZZ2laBWoYukhX37D2SYvczgDkR5JgwEaIYw91Hup99r57vOeG7Ab8rfQtZwLtNgPQQGzB6e8lz5pWANSlLM4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=qKkjNNIhmcTVWh8W16Ni2foar6txMfC8Y7sUUry20nybiV0DGiuG2oU/UON56lXYiL46LYtw2nOz2xV1dbqDVRSZiwWseNlKen0RUqNoZhDWF+dWL1MYkZlrnU5WlrCu+51n/mCXnoZOSUSxz/t2ZemmzGngo9igcTRsGELX5rU= Received: by 10.141.51.15 with SMTP id d15mr166205rvk.1189597986448; Wed, 12 Sep 2007 04:53:06 -0700 (PDT) Received: by 10.141.193.6 with HTTP; Wed, 12 Sep 2007 04:53:06 -0700 (PDT) Message-ID: <474078f80709120453k2522bc64mdef8477b3bb3ece8@mail.gmail.com> Date: Wed, 12 Sep 2007 13:53:06 +0200 From: "Murray Stokely" To: "Andrew Thompson" In-Reply-To: <20070830202437.GA4797@heff.fud.org.nz> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <20070830202437.GA4797@heff.fud.org.nz> Cc: doc@freebsd.org Subject: Re: New link aggregation chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Sep 2007 11:53:07 -0000 Hi Andrew, your DocBook looks nice. I just made a few minor changes. The individual s in the Operating Modes section (sect2) were pretty minor and in some cases with just a few words underneath a numbered section, so I thought it looked better as a with individual s for each sect3 you had defined there. Similarly, in the next for examples I used tags so we can reference these specific examples elsewhere in the text. Also I made a few minor grammar nits. My diff of your diff, which is now committed, is attached for reference. Thanks again for a very useful new section to the Handbook! - Murray --- @@ -2888,18 +2888,21 @@ Operating Modes - - failover + + + failover + Sends and receives traffic only through the master port. If the master port becomes unavailable, the next active port is used. The first interface added is the master port; any interfaces added after that are used as failover devices. - + + - - fec + fec + Supports Cisco EtherChannel. This is a static setup and does not negotiate aggregation with the peer or exchange frames to monitor the link, if the switch supports LACP then that should be used @@ -2910,11 +2913,12 @@ active port. The hash includes the Ethernet source and destination address, and, if available, the VLAN tag, and the IPv4/IPv6 source and destination address. - + + - - lacp + lacp + Supports the IEEE 802.3ad Link Aggregation Control Protocol (LACP) and the Marker Protocol. LACP will negotiate a set of aggregable links with the peer in to one or more Link Aggregated @@ -2930,28 +2934,32 @@ active port. The hash includes the Ethernet source and destination address, and, if available, the VLAN tag, and the IPv4/IPv6 source and destination address. - + + - - loadbalance + loadbalance + This is an alias of fec mode. - + + - - roundrobin + roundrobin + Distributes outgoing traffic using a round-robin scheduler through all active ports and accepts incoming traffic from any active port. This mode will violate Ethernet frame ordering and should be used with caution. - + + + Examples - + LACP aggregation with a Cisco switch This example connects two interfaces on a &os; machine to the @@ -2965,44 +2973,39 @@ On the Cisco switch add the interfaces to the channel group. - -interface FastEthernet0/1 + interface FastEthernet0/1 channel-group 1 mode active channel-protocol lacp ! interface FastEthernet0/2 channel-group 1 mode active channel-protocol lacp -! - +! On the &os; machine create the lagg interface. &prompt.root; ifconfig lagg0 create &prompt.root; ifconfig lagg0 up laggproto lacp laggport fxp0 laggport fxp1 - View the interface status from ifconfig, ports marked as + View the interface status from ifconfig; ports marked as ACTIVE are part of the active aggregation group that has been negotiated with the remote switch and traffic will be transmitted and received. Use the verbose output of &man.ifconfig.8; to view the LAG identifiers. - -lagg0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 + lagg0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 options=8<VLAN_MTU> ether 00:05:5d:71:8d:b8 media: Ethernet autoselect status: active laggproto lacp laggport: fxp1 flags=1c<ACTIVE,COLLECTING,DISTRIBUTING> - laggport: fxp0 flags=1c<ACTIVE,COLLECTING,DISTRIBUTING> - + laggport: fxp0 flags=1c<ACTIVE,COLLECTING,DISTRIBUTING> - The switch will show which ports are active, for more detail use + The switch will show which ports are active. For more detail use show lacp neighbor detail. - -switch# show lacp neighbor + switch# show lacp neighbor Flags: S - Device is requesting Slow LACPDUs F - Device is requesting Fast LACPDUs A - Device is in Active mode P - Device is in Passive mode @@ -3014,11 +3017,10 @@ LACP port Oper Port Port Port Flags Priority Dev ID Age Key Number State Fa0/1 SA 32768 0005.5d71.8db8 29s 0x146 0x3 0x3D -Fa0/2 SA 32768 0005.5d71.8db8 29s 0x146 0x4 0x3D - +Fa0/2 SA 32768 0005.5d71.8db8 29s 0x146 0x4 0x3D - - + + Failover mode Failover mode can be used to switch over to another interface if @@ -3027,23 +3029,21 @@ &prompt.root; ifconfig lagg0 create &prompt.root; ifconfig lagg0 up laggproto failover laggport fxp0 laggport fxp1 - -lagg0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 + lagg0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 options=8<VLAN_MTU> ether 00:05:5d:71:8d:b8 media: Ethernet autoselect status: active laggproto failover laggport: fxp1 flags=0<> - laggport: fxp0 flags=5<MASTER,ACTIVE> - + laggport: fxp0 flags=5<MASTER,ACTIVE> Traffic will be transmitted and received on - fxp0, if the link is lost on + fxp0. If the link is lost on fxp0 then fxp1 will become the active link. If the link is restored on the master interface then it will once again become the active link. - +