shorewall_code/web/download.htm

368 lines
17 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Download</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Linux)">
<META NAME="CREATED" CONTENT="20060304;10324500">
<META NAME="CHANGEDBY" CONTENT="Tom Eastep">
<META NAME="CHANGED" CONTENT="20060310;20345500">
<META HTTP-EQUIV="Content-Language" CONTENT="en-us">
</HEAD>
<BODY LANG="en-US" DIR="LTR">
<H1 ALIGN=LEFT>Shorewall Download</H1>
<P><B>Tom Eastep<BR><BR></B>Copyright &copy;&nbsp; 2001-2006 Thomas
M. Eastep</P>
<P>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 “<A HREF="GnuCopyright.htm" TARGET="_self">GNU Free
Documentation License</A>”.</P>
<P>2006-03-10
</P>
<HR>
<H2>Table of Contents</H2>
<P><B><A HREF="#Which">Package Information</A><BR><A HREF="#Updates">Finding
Updates that Correct Known Problems</A><BR><A HREF="#Sites">Download
Sites</A><BR><A HREF="#SVN">SVN</A></B></P>
<HR>
<H2><A NAME="Which"></A>Package Information</H2>
<P><B>Before trying to install, I strongly urge you to read and print
a copy of the <A HREF="shorewall_quickstart_guide.htm">Shorewall
QuickStart Guide</A> for the configuration that most closely matches
your own.</B>
</P>
<P>The entire set of Shorewall documentation is available in PDF
format at:</P>
<P>&nbsp;&nbsp;&nbsp;
<A HREF="ftp://slovakia.shorewall.net/mirror/shorewall/pdf/">ftp://slovakia.shorewall.net/mirror/shorewall/pdf/</A><BR>&nbsp;&nbsp;&nbsp;
<A HREF="http://slovakia.shorewall.net/pub/shorewall/pdf/">http://slovakia.shorewall.net/pub/shorewall/pdf/</A><BR>&nbsp;&nbsp;&nbsp;
<A HREF="rsync://slovakia.shorewall.net/shorewall/pdf/">rsync://slovakia.shorewall.net/shorewall/pdf/</A></P>
<P>The documentation in both XML and HTML formats is also available
for download from the Download Sites listed in the table below.</P>
<P><FONT COLOR="#ff0000"><B>NOTICE: There are two current Shorewall
Release Series:</B></FONT></P>
<UL>
<LI><P STYLE="margin-bottom: 0in">The STABLE release series is 3.0.
Choose this release if you value stability and good documentation.</P>
<LI><P>The DEVELOPMENT release series is 3.2 (found in the
'development' directory). Choose this release if you are <STRONG>very
experienced</STRONG> <STRONG>user</STRONG> and you are willing to
help and report bugs. <STRONG>THIS VERSION IS EXPERIMENTAL AND IS
NOT SUPPORTED.</STRONG>
</P>
</UL>
<P>For additional information, see this article about the <A HREF="ReleaseModel.html">Shorewall
Release Model</A>.
</P>
<P>Once you've printed the appropriate QuickStart Guide, download <U>one</U>
of the modules:</P>
<UL>
<LI><P STYLE="margin-bottom: 0in">Simon Matter provides RPMs
taylored for <B>Redhat</B> and <B>Fedora</B>. You can <A HREF="http://www.invoca.ch/pub/packages/shorewall/">download
them from his site</A>.</P>
<LI><P STYLE="margin-bottom: 0in">Jack Coates provides RPMs taylored
for <B>Mandriva.</B> You can <A HREF="http://www.monkeynoodle.org/comp/net/shorewall/">download
them from his site</A>.
</P>
<LI><P STYLE="margin-bottom: 0in">jmedina provides packages for
<B>Slackware.</B> You can <A HREF="http://tuxjm.net/downloads/source/testing-10.2/">download
them from his site</A>.
</P>
<LI><P STYLE="margin-bottom: 0in">Fabio Longarai provides a package
for <B>OpenWRT</B> (Open firmware for Linksys&reg; WRT54G). You can
<A HREF="http://openwrt.homelinux.net/">download it from his site</A>.
</P>
<LI><P STYLE="margin-bottom: 0in">Marc Zonzon provides an old
package for <B>OpenWRT</B> (Open firmware for Linksys&reg; WRT54G).
You can <A HREF="http://www.iut-lannion.fr/ZONZON/memos_index.php?part=Network&amp;section=WRTMemo&amp;subsec=shorewall">download
it from his site</A>.</P>
<LI><P STYLE="margin-bottom: 0in">jMCg provides a package for <B>Arch
Linux.</B> You can <A HREF="http://aur.archlinux.org/packages.php?do_Details=1&amp;ID=1563&amp;O=0&amp;L=0&amp;C=0&amp;K=shorewall&amp;SB=n&amp;PP=25&amp;do_MyPackages=0">download
it from the Arch Linux site</A>.
</P>
<LI><P STYLE="margin-bottom: 0in">If you run a <B>SUSE,</B> <B>Linux
PPC</B>, <B>Trustix</B> or <B>TurboLinux</B> distribution with a 2.4
or 2.6 kernel, you can use the standard RPM version (note: the RPM
should also work with other distributions that store init scripts in
/etc/init.d and that include chkconfig or insserv). If you find that
it works in other cases, let <A HREF="mailto:teastep@shorewall.net">me</A>
know so that I can mention them here (Note: the standard RPM is
known to work on Redhat, Fedora and Mandriva with issues ranging
from trivial (Redhat and Fedora) to moderate (Mandriva)). See the
<A HREF="Install.htm">Installation Instructions</A> if you have
problems installing the RPM.</P>
<LI><P STYLE="margin-bottom: 0in">If you run <A HREF="http://www.debian.org/"><B>Debian</B></A>
and would like a .deb package, Shorewall is included in both the
<A HREF="http://packages.debian.org/testing/net/shorewall.html">Debian
Testing Branch</A> and the <A HREF="http://packages.debian.org/unstable/net/shorewall.html">Debian
Unstable Branch</A>.
</P>
<LI><P STYLE="margin-bottom: 0in">If you run <A HREF="http://leaf.sourceforge.net/">LEAF/Bering</A>
or one if it's derivatives, you can download a .lrp file from the
Leaf site.<BR><BR>From the LEAF Bering-uClibc Team: We try to
provide the latest stable version shortly after release, but we also
want to do some internal tests before making it available. So we may
be <BR>behind sometimes. But better be sure that the new version is
running on LEAF, than being too fast...<BR><BR>I know it's not
obvious for newbies where to find the lrp on our
pages.<BR><BR>shorewall.lrp is part of the packages
page:<BR><BR><A HREF="http://leaf.sourceforge.net/bering-uclibc/index.php?module=pagemaster&amp;PAGE_user_op=view_page&amp;PAGE_id=3&amp;MMN_position=3:3">http://leaf.sourceforge.net/bering-uclibc/index.php?module=pagemaster&amp;PAGE_user_op=view_page&amp;PAGE_id=3&amp;MMN_position=3:3</A><BR><BR>which
itself links to
cvs:<BR><BR><A HREF="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/leaf/bin/bering-uclibc/packages/shorwall.lrp?rev=HEAD&amp;content-type=application/octet-stream">http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/leaf/bin/bering-uclibc/packages/shorwall.lrp?rev=HEAD&amp;content-type=application/octet-stream</A></P>
<LI><P>Otherwise, download the <I>shorewall</I> module (.tgz)
</P>
</UL>
<P>You will probably also want to download the HTML version of the
documentation for easy reference.</P>
<H2><A NAME="Updates"></A>Finding Updates that Correct Known Problems</H2>
<P>Beginning with Shorewall 2.2.0, you will find a file named
known_problems.txt in the download directory. This file lists the
known problems with that version of Shorewall. If corrections are
available, they will be listed in the known problems and you can
download them from the 'errata' subdirectory.</P>
<P>Example:</P>
<P STYLE="margin-left: 0.42in"><FONT FACE="monospace">ftp&gt; cd
pub/shorewall/2.2/shorewall-2.2.0</FONT><BR><FONT FACE="monospace">250
OK. Current directory is /pub/shorewall/2.2/shorewall-2.2.0</FONT><BR><FONT FACE="monospace">ftp&gt;
ls</FONT><BR><FONT FACE="monospace">227 Entering Passive Mode
(206,124,146,177,35,91)</FONT><BR><FONT FACE="monospace">150 Accepted
data connection</FONT><BR><FONT FACE="monospace">drwxr-sr-x&nbsp;&nbsp;&nbsp;
3 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4096 Feb&nbsp; 1 09:52 .</FONT><BR><FONT FACE="monospace">drwxr-sr-x&nbsp;&nbsp;&nbsp;
3 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4096 Jan 28 14:28 ..</FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
500 Jan 28 14:27 2.2.0.md5sums</FONT><BR><FONT FACE="monospace"><FONT COLOR="#cc0000">drwxr-sr-x&nbsp;&nbsp;&nbsp;
2 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4096 Feb&nbsp; 1 09:51 errata&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&lt;=== (1)</FONT></FONT><BR><FONT FACE="monospace"><FONT COLOR="#cc0000">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
156 Feb&nbsp; 1 09:52 known_problems.txt &lt;=== (2)</FONT></FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
16059 Jan 24 16:13 patch-2.2.0</FONT><BR><FONT FACE="monospace">-rwxr-xr-x&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
22963 Jan 24 16:10 releasenotes.txt</FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
100232 Jan 25 15:58 shorewall-2.2.0-1.noarch.rpm</FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
122161 Jan 25 15:58 shorewall-2.2.0.tgz</FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2534077 Jan 28 13:29 shorewall-docs-html-2.2.0.tgz</FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4481205 Jan 28 13:29 shorewall-docs-xml-2.2.0.tgz</FONT><BR><FONT FACE="monospace">-rw-r--r--&nbsp;&nbsp;&nbsp;
1 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
93905 Jan 25 15:58 shorewall-lrp-2.2.0.tgz</FONT><BR><FONT FACE="monospace">226-Options:
-a -l</FONT><BR><FONT FACE="monospace">226 13 matches total</FONT><BR><FONT FACE="monospace">ftp&gt;</FONT></P>
<P STYLE="margin-left: 0.42in"><FONT FACE="monospace"><FONT COLOR="#cc0000">(1)
Directory containing updates. For Shorewall versions prior to 2.4.0,
the updates/LRP directory contains those updates that apply to the
LRP package.</FONT><BR><FONT COLOR="#cc0000">(2) List of known
problems, workarounds and updates.. &nbsp;&nbsp;&nbsp;</FONT>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT></P>
<H2><A NAME="Sites"></A><B>Download Sites</B></H2>
<P STYLE="margin-left: 0.42in"><B>Redhat</B> and <B>Fedora</B> RPMS
provided by Simon Matter:
<A HREF="http://www.invoca.ch/pub/packages/shorewall/">http://www.invoca.ch/pub/packages/shorewall/</A><BR><BR><B>Mandriva</B>
RPMS provided by Jack Coates:
<A HREF="http://www.monkeynoodle.org/comp/net/shorewall/">http://www.monkeynoodle.org/comp/net/shorewall/</A><BR><BR><B>Slackware</B>
packages created by JMedina. You can <A HREF="http://tuxjm.net/downloads/source/testing-10.2/">download
them from his site</A>.<BR><BR><B>OpenWRT</B> package provided by
Marc Zonzon:
<A HREF="http://www.iut-lannion.fr/ZONZON/memos_index.php?part=Network&amp;section=WRTMemo&amp;subsec=shorewall">http://www.iut-lannion.fr/ZONZON/memos_index.php?part=Network&amp;section=WRTMemo&amp;subsec=shorewall</A><BR><BR><B>Leaf/Bering
</B>package is available at
<A HREF="http://leaf.sourceforge.net/bering-uclibc/index.php?module=pagemaster&amp;PAGE_user_op=view_page&amp;PAGE_id=3&amp;MMN_position=3:3">http://leaf.sourceforge.net/bering-uclibc/index.php?module=pagemaster&amp;PAGE_user_op=view_page&amp;PAGE_id=3&amp;MMN_position=3:3</A><BR><BR>Use
the sites below to download the<B>tarball</B>, the <B>documentation</B>
and the <B>standard RPM</B> for (<B>Suse</B>, <B>Power PPC</B>,
<B>Trustix</B> and <B>TurboLinux</B>).<BR><BR>Packages are GPG
signed, please <B>verify the integrity of the files</B> using our
public key <A HREF="https://lists.shorewall.net/shorewall.gpg.key">https://lists.shorewall.net/shorewall.gpg.key</A>
</P>
<DL>
<DD>
<TABLE BORDER=2 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD>
<P><B>SERVER LOCATION</B></P>
</TD>
<TD>
<P><B>DOMAIN</B></P>
</TD>
<TD>
<P><B>HTTP</B></P>
</TD>
<TD>
<P><B>FTP</B></P>
</TD>
</TR>
<TR>
<TD>
<P>Slovak Republic</P>
</TD>
<TD>
<P>Shorewall.net</P>
</TD>
<TD>
<P><A HREF="http://slovakia.shorewall.net/pub/shorewall/">Browse</A></P>
</TD>
<TD>
<P><A HREF="ftp://slovakia.shorewall.net/mirror/shorewall/" TARGET="_blank">Browse</A></P>
</TD>
</TR>
<TR>
<TD>
<P>Vienna, Va, USA</P>
</TD>
<TD>
<P>Shorewall.net</P>
</TD>
<TD>
<P><A HREF="http://www.shorewall.net/pub/shorewall/">Browse</A></P>
</TD>
<TD>
<P><A HREF="ftp://ftp.shorewall.net/pub/shorewall/" TARGET="_blank">Browse</A></P>
</TD>
</TR>
<TR>
<TD>
<P>Frankfurt/Main, Germany</P>
</TD>
<TD>
<P>Shorewall.de</P>
</TD>
<TD>
<P><A HREF="http://www.shorewall.de/pub/shorewall/">Browse</A></P>
</TD>
<TD>
<P>N/A</P>
</TD>
</TR>
<TR>
<TD>
<P>Shoreline, Wa, USA</P>
</TD>
<TD>
<P>Shorewall.net</P>
</TD>
<TD>
<P><A HREF="http://www1.shorewall.net/pub/shorewall/">Browse</A></P>
</TD>
<TD>
<P><A HREF="ftp://ftp1.shorewall.net/pub/shorewall" TARGET="_top">Browse</A></P>
</TD>
</TR>
<TR>
<TD>
<P>Boston, Mass., USA</P>
</TD>
<TD>
<P>viisage.com</P>
</TD>
<TD>
<P><A HREF="http://shorewall.viisage.com/pub/shorewall">Browse</A></P>
</TD>
<TD>
<P>N/A</P>
</TD>
</TR>
<TR>
<TD>
<P>Austin Texas, USA</P>
</TD>
<TD>
<P>shorewall.net</P>
</TD>
<TD>
<P><A HREF="http://slovak.ece.utexas.edu/mirrors/shorewall/" TARGET="_top">Browse</A></P>
</TD>
<TD>
<P><A HREF="ftp://slovak.ece.utexas.edu/shorewall/" TARGET="_top">Browse</A></P>
</TD>
</TR>
<TR>
<TD>
<P>Plano Texas, USA</P>
</TD>
<TD>
<P>Infohiiway.com</P>
</TD>
<TD>
<P><A HREF="http://shorewall.infohiiway.com/pub/shorewall">Browse</A></P>
</TD>
<TD>
<P><A HREF="ftp://ftp.infohiiway.com/pub/shorewall/" TARGET="_blank">Browse<!--<tr>
<td>France</td>
<td>Shorewall.net</td>
<td><a href="http://france.shorewall.net/pub/shorewall">Browse</a></td>
<td> <a target="_blank"
href="ftp://france.shorewall.net/pub/mirrors/shorewall/">Browse</a></td>
</tr>--></A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD>
<P>Argentina</P>
</TD>
<TD>
<P>Shorewall.net</P>
</TD>
<TD>
<P><A HREF="http://argentina.shorewall.net/pub/shorewall/shorewall">Browse</A></P>
</TD>
<TD>
<P><A HREF="ftp://ftp.syachile.cl/pub/shorewall" TARGET="_top">Browse</A></P>
</TD>
</TR>
<TR>
<TD>
<P>Sourceforge - California, USA (Incomplete)</P>
</TD>
<TD>
<P>Sourceforge.net</P>
</TD>
<TD>
<P><A HREF="http://sourceforge.net/projects/shorewall">Browse</A></P>
</TD>
<TD>
<P>N/A</P>
</TD>
</TR>
</TABLE>
</DL>
<H2><A NAME="SVN"></A><B>SVN</B></H2>
<BLOCKQUOTE>The <A HREF="https://sourceforge.net/svn/?group_id=22587" TARGET="_blank">SVN&nbsp;Repository
at Sourceforge</A> is used as a safe-store for Shorewall
releases.<BR><BR>You should download and use the latest SVN version
only at your own risk -- If you are looking for bug fixes for the
current release, see <A HREF="#Updates">above.</A><BR><BR>The
following SVN projects are currently active:</BLOCKQUOTE>
<OL>
<LI><BLOCKQUOTE><B>Shorewall<BR><BR></B>This project contains the
Shorewall code.<BR>&quot;trunk&quot; is the current <STRONG>development</STRONG>
version. <BR><BR>You can download it using the following commands:
<BR><BR># svn co
https://svn.sourceforge.net/svnroot/shorewall/trunk/Shorewall<BR><BR>The
current <STRONG>stable</STRONG> version is branch named x.y where
x.y is the major version. Example: 3.0. <BR>You can download it
using the following commands: <BR><BR># svn co
https://svn.sourceforge.net/svnroot/shorewall/branches/x.y/Shorewall
<BR><!--Releases have tags with names of the form Shorewall-X_Y_Z. Example: Shorewall-2_4_6 is Shorewall version 2.4.6.<br> --><BR><BR>
</BLOCKQUOTE>
<LI><BLOCKQUOTE><B>docs<BR><BR></B>This project contains the
Shorewall documenation.<BR>trunk is the current development version.
<BR><BR><BR>You can always get the current documentation in XML
Docbook format using the following command: <BR><BR>#svn co
https://svn.sourceforge.net/svnroot/shorewall/trunk/docs
</BLOCKQUOTE>
<LI><BLOCKQUOTE><B>web<BR><BR></B>The project contains the part of
this Web site not included in the &quot;docs&quot; project.
</BLOCKQUOTE>
<LI><BLOCKQUOTE><B>tools<BR><BR></B>This project includes the tools
used by the Shorewall developers to build Shorewall releases and to
publish content to the web sites.</BLOCKQUOTE>
<LI><BLOCKQUOTE><B>Samples<BR><BR></B>This project contains the
sample configurations.</BLOCKQUOTE>
</OL>
</BODY>
</HTML>