shorewall_code/docs/fallback.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<article>
  <!--$Id$-->

  <articleinfo>
    <title>Fallback and Uninstall</title>

    <authorgroup>
      <author>
        <firstname>Tom</firstname>

        <surname>Eastep</surname>
      </author>
    </authorgroup>

    <pubdate><?dbtimestamp format="Y/m/d"?></pubdate>

    <copyright>
      <year>2001-2005</year>

      <holder>Thomas M. Eastep</holder>
    </copyright>

    <legalnotice>
      <para>Permission is granted to copy, distribute and/or modify this
      document under the terms of the GNU Free Documentation License, Version
      1.2 or any later version published by the Free Software Foundation; with
      no Invariant Sections, with no Front-Cover, and with no Back-Cover
      Texts. A copy of the license is included in the section entitled
      <quote><ulink url="GnuCopyright.htm">GNU Free Documentation
      License</ulink></quote>.</para>
    </legalnotice>
  </articleinfo>

  <section id="Tarball">
    <title>Falling Back to the Previous Version of Shorewall using the
    Fallback Script</title>

    <para>If you install Shorewall and discover that it doesn't work for you,
    you can fall back to your previously installed version. To do that:</para>

    <itemizedlist>
      <listitem>
        <para>cd to the distribution directory for the version of Shoreline
        Firewall that you are currently running (NOT the version that you want
        to fall back to).</para>
      </listitem>

      <listitem>
        <para>Type <quote>./fallback.sh</quote></para>
      </listitem>
    </itemizedlist>

    <caution>
      <para>The fallback script will replace /etc/shorewall[-lite]/*,
      /var/lib/shorewall[-lite]/*, /etc/init.d/shorewall[-lilte]] (or
      equivalent), and /sbin/shorewall[-lite] with the version of these files
      from before the current version was installed. Any changes to any of
      these files made since the installation will be lost.</para>
    </caution>
  </section>

  <section id="RPM">
    <title>Falling Back to the Previous Version of Shorewall using rpm</title>

    <para>If your previous version of Shorewall was installed using RPM, you
    may fall back to that version by typing <quote>rpm -Uvh --force &lt;old
    rpm&gt;</quote> at a root shell prompt (Example: <quote>rpm -Uvh --force
    /downloads/shorewall-3.1.1-0.noarch.rpm</quote> would fall back to the
    3.1.1-0 version of Shorewall).</para>
  </section>

  <section id="Uninstall">
    <title>Uninstalling Shorewall</title>

    <para>If you no longer wish to use Shorewall, you may remove it by:</para>

    <itemizedlist>
      <listitem>
        <para>cd to the distribution directory for the version of Shorewall
        that you have installed.</para>
      </listitem>

      <listitem>
        <para>type <quote>./uninstall.sh</quote></para>
      </listitem>
    </itemizedlist>

    <para>If you installed using an rpm, at a root shell prompt type
    <quote>rpm -e shorewall</quote>.</para>
  </section>

  <section id="Shell-Perl">
    <title>Shorewall-shell and Shorewall-perl</title>

    <para>Shorewall-shell and Shoreall-perl have no configuration files and
    all of their released files are installed in a single directory. To
    fallback to a prior release of one of these products using the tarballs,
    simple re-install the older version.</para>

    <para>To uninstal these products when they have been installed using the
    tarballs:</para>

    <itemizedlist>
      <listitem>
        <para>rm -rf /usr/share/shorewall-shell</para>
      </listitem>

      <listitem>
        <para>rm -rf /usr/share/shorewall-perl</para>
      </listitem>
    </itemizedlist>
  </section>
</article>