From 64bf587ff4854b85b9b1a54700f8f0a31ea52b13 Mon Sep 17 00:00:00 2001
From: teastep <teastep@fbd18981-670d-0410-9b5c-8dc0c1a9a2bb>
Date: Sun, 2 Dec 2007 15:58:02 +0000
Subject: [PATCH] Add FAQ about loss of masquerade after Debian upgrade;
 improve Debian sample FAQ answer

git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@7816 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
---
 docs/FAQ.xml | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/docs/FAQ.xml b/docs/FAQ.xml
index ca5f71104..e481c4174 100644
--- a/docs/FAQ.xml
+++ b/docs/FAQ.xml
@@ -83,8 +83,12 @@
         <title>(FAQ 37a) I just installed Shorewall on Debian and I can't find
         the sample configurations.</title>
 
-        <para><emphasis role="bold">Answer</emphasis>: The samples are
-        included in the shorewall-doc package.</para>
+        <para><emphasis role="bold">Answer</emphasis>: With Shorewall 3.x, the
+        samples are included in the shorewall-doc package and are installed in
+        <filename
+        class="directory">/usr/share/doc/shorewall/examples/</filename>.
+        Beginning with Shorewall 4.0, the samples are in <filename
+        class="directory">/usr/share/doc/shorewall-common/examples</filename>/.</para>
       </section>
     </section>
 
@@ -127,6 +131,21 @@
         url="upgrade_issues.htm">upgrade issues.</ulink></para>
       </section>
     </section>
+
+    <section id="faq76">
+      <title>(FAQ 76) I just upgraded my Debian (or Debian-derivative such as
+      Ubuntu) system and now masquerading doesn work? What happened?</title>
+
+      <para><emphasis role="bold">Answer:</emphasis> This happens to people
+      who ignore <ulink url="Install.htm#Upgrade_Deb">our advice</ulink> and
+      allow the installer to replace their working
+      <filename>/etc/shorewall/shorewall.conf</filename> with one that has
+      default settings. Failure to forward traffic (such as during
+      masquerading net access from a local network) usually means that <ulink
+      url="???">/etc/shorewall/shorewall.conf</ulink> contains the Debian
+      default setting IP_FORWARDING=Keep; it should be
+      IP_FORWARDING=On.</para>
+    </section>
   </section>
 
   <section id="PortForwarding">