PERFORCE change 173064 for review

Rene Ladan rene at FreeBSD.org
Wed Jan 13 12:46:42 UTC 2010


http://p4web.freebsd.org/chv.cgi?CH=173064

Change 173064 by rene at rene_self on 2010/01/13 12:46:22

	IFC

Affected files ...

.. //depot/projects/docproj_nl/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml#44 integrate
.. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml#19 integrate
.. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#31 integrate
.. //depot/projects/docproj_nl/nl_NL.ISO8859-1/share/sgml/trademarks.ent#9 integrate
.. //depot/projects/docproj_nl/nl_NL.ISO8859-1/share/sgml/trademarks.sgml#4 integrate
.. //depot/projects/docproj_nl/www/en/news/status/report-2009-10-2009-12.xml#1 branch

Differences ...

==== //depot/projects/docproj_nl/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml#44 (text+ko) ====

@@ -1,4 +1,4 @@
-<!-- $FreeBSD: doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml,v 1.891 2010/01/11 17:39:37 nemoliu Exp $ -->
+<!-- $FreeBSD: doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml,v 1.892 2010/01/13 06:37:18 nemoliu Exp $ -->
 <!--
 	NOTE TO COMMITTERS: Contributors lists are sorted in alphabetical
 	order by first name.
@@ -4227,6 +4227,11 @@
 	<email>mrcpu at cdsnet.net</email></para>
     </listitem>
 
+   <listitem>
+      <para>Jaap Akkerhuis
+        <email>jaap at NLnetLabs.nl</email></para>
+    </listitem>
+
     <listitem>
       <para>Jean-Baptiste Quenot
 	<email>jb.quenot at caraldi.com</email></para>

==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml#19 (text+ko) ====

@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml,v 1.425 2009/08/11 17:33:35 manolis Exp $
+     $FreeBSD: doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml,v 1.426 2010/01/13 08:29:29 delphij Exp $
 -->
 
 <chapter id="advanced-networking">
@@ -2078,6 +2078,25 @@
     </sect2>
 
     <sect2>
+      <title>Using both wired and wireless connection</title>
+
+      <para>Wired connection provides better performance and reliability,
+	while wireless connection provides flexibility and mobility,
+	users of laptop computers usually want to combine these together
+	and roam seamlessly between the two.</para>
+
+      <para>On &os;, it is possible to combine two or even more network
+	interfaces together in a <quote>failover</quote> fashion, that
+	is, to use the most preferred and available connection from a
+	group of network interfaces, and have the operating system to
+	switch automatically when the link state changes.</para>
+
+      <para>We will cover link aggregation and failover in <xref linkend="network-aggregation">
+	where an example for using both wired and wireless connection
+	is also provided at <xref linkend="networking-lagg-wired-and-wireless">.</para>
+    </sect2>
+
+    <sect2>
       <title>Troubleshooting</title>
 
       <para>If you are having trouble with wireless networking, there
@@ -3401,6 +3420,85 @@
 	  become the active link. If the link is restored on the master
 	  interface then it will once again become the active link.</para>
       </example>
+      <example id="networking-lagg-wired-and-wireless">
+	<title>Failover mode between wired and wireless interfaces</title>
+
+	<para>For laptop users, it is usually desirable to make wireless as a
+	  secondary interface, which is to be used when the wired connection
+	  is not available.  With &man.lagg.4;, it is possible to use one
+	  IP address, prefer the wired connection for both performance and
+	  security reasons, while maintaining the ability to transfer data
+	  over the wireless connection.</para>
+
+	<para>In this setup, we will need to override the underlying
+	  wireless interface's <acronym>MAC</acronym> address to match the &man.lagg.4;'s,
+	  which is inherited from the master interface being used, the
+	  wired interface.</para>
+
+	<para>In this setup, we will treat the wired interface,
+	  <replaceable>bge0</replaceable>, as the master, and the wireless
+	  interface,
+	  <replaceable>wlan0</replaceable>, as the failover interface.  The
+	  <replaceable>wlan0</replaceable> was created from
+	  <replaceable>iwn0</replaceable> which we will set up with
+	  the wired connection's <acronym>MAC</acronym> address.  The first step would be
+	  to obtain the <acronym>MAC</acronym> address from the wired interface:</para>
+
+        <screen>&prompt.root; <userinput>ifconfig <replaceable>bge0</replaceable></userinput>
+bge0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
+	options=19b&lt;RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,TSO4&gt;
+	ether 00:21:70:da:ae:37
+	inet6 fe80::221:70ff:feda:ae37%bge0 prefixlen 64 scopeid 0x2 
+	nd6 options=29&lt;PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL&gt;
+	media: Ethernet autoselect (1000baseT &lt;full-duplex&gt;)
+	status: active</screen>
+
+	<para>You can replace the <replaceable>bge0</replaceable> to match
+	  your reality, and will get a different <literal>ether</literal>
+	  line which is the <acronym>MAC</acronym> address of your wired interface.  Now,
+	  we change the underlying wireless interface,
+	  <replaceable>iwn0</replaceable>:</para>
+
+        <screen>&prompt.root; <userinput>ifconfig <replaceable>iwn0</replaceable> ether <replaceable>00:21:70:da:ae:37</replaceable></userinput></screen>
+
+	<para>Bring up the wireless interface but don't set up any IP
+	  address on it:</para>
+
+        <screen>&prompt.root; <userinput>ifconfig create <replaceable>wlan0</replaceable> wlandev <replaceable>iwn0</replaceable> ssid <replaceable>my_router</replaceable> up</userinput></screen>
+
+	<para>Create the &man.lagg.4; interface with <replaceable>bge0</replaceable>
+	  as master, and failover to <replaceable>wlan0</replaceable> if
+	  necessary:</para>
+
+        <screen>&prompt.root; <userinput>ifconfig <replaceable>lagg0</replaceable> create</userinput>
+&prompt.root; <userinput>ifconfig <replaceable>lagg0</replaceable> up laggproto failover laggport <replaceable>bge0</replaceable> laggport <replaceable>wlan0</replaceable></userinput></screen>
+
+	<para>The interface will look something like this, the major
+	  differences will be the <acronym>MAC</acronym> address and the
+	  device names:</para>
+
+        <screen>&prompt.root; <userinput>ifconfig <replaceable>lagg0</replaceable></userinput>
+lagg0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
+        options=8&lt;VLAN_MTU&gt;
+        ether 00:21:70:da:ae:37
+        media: Ethernet autoselect
+        status: active
+        laggproto failover
+        laggport: wlan0 flags=0&lt;&gt;
+        laggport: bge0 flags=5&lt;MASTER,ACTIVE&gt;</screen>
+
+	<para>To avoid having to do this after every reboot, one can add
+	  something like the following lines to the
+	  <filename>/etc/rc.conf</filename> file:</para>
+
+	<programlisting>ifconfig_bge0="up"
+ifconfig_iwn0="ether 00:21:70:da:ae:37"
+wlans_iwn0="wlan0"
+ifconfig_wlan0="WPA"
+cloned_interfaces="lagg0"
+ifconfig_lagg0="laggproto failover laggport bge0 laggport wlan0 DHCP"
+</programlisting>
+      </example>
     </sect2>
   </sect1>
 

==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#31 (text+ko) ====

@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Dutch Documentation Project
 
-     $FreeBSD: doc/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v 1.19 2009/10/04 14:06:59 rene Exp $
+     $FreeBSD: doc/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v 1.20 2010/01/12 20:22:04 rene Exp $
 
      %SOURCE%	en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
      %SRCID%	1.246

==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/share/sgml/trademarks.ent#9 (text+ko) ====

@@ -9,7 +9,7 @@
 
      Houd dit bestand alstublieft gesorteerd.
 
-     $FreeBSD: doc/nl_NL.ISO8859-1/share/sgml/trademarks.ent,v 1.4 2009/07/24 19:13:28 rene Exp $
+     $FreeBSD: doc/nl_NL.ISO8859-1/share/sgml/trademarks.ent,v 1.5 2010/01/12 20:20:43 rene Exp $
      %SOURCE%	share/sgml/trademarks.ent
      %SRCID%	1.47
 -->

==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/share/sgml/trademarks.sgml#4 (text+ko) ====

@@ -1,7 +1,7 @@
 <!-- 
      Trademark Legend, as required by The Open Group, Sun, etc..
 
-     $FreeBSD$
+     $FreeBSD: doc/nl_NL.ISO8859-1/share/sgml/trademarks.sgml,v 1.2 2010/01/12 20:20:43 rene Exp $
      %SOURCE%	en_US.ISO8859-1/share/sgml/trademarks.sgml
      %SRCID%	1.7
 -->


More information about the p4-projects mailing list