blob: 42e2923a603069ff8fdb8407dc487cbaf108806e [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
<meta name="Forrest-version" content="0.8-dev">
<meta name="Forrest-skin-name" content="pelt">
<meta name="generator" content="">
<title>Obtain the Apache Forrest distribution</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
<link type="text/css" href="skin/profile.css" rel="stylesheet">
<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
<link rel="shortcut icon" href="favicon.ico">
</head>
<body onload="init()">
<script type="text/javascript">ndeSetTextSize();</script>
<div id="top">
<!--+
|breadtrail
+-->
<div class="breadtrail">
<a href="http://www.apache.org/">apache</a> &gt; <a href="http://forrest.apache.org/">forrest</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
</div>
<!--+
|header
+-->
<div class="header">
<!--+
|start group logo
+-->
<div class="grouplogo">
<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="images/apache-forrest.png" title="The Apache Software Foundation"></a>
</div>
<!--+
|end group logo
+-->
<!--+
|start Project Logo
+-->
<div class="projectlogo">
<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="images/project-logo.gif" title="Apache Forrest"></a>
</div>
<!--+
|end Project Logo
+-->
<!--+
|start Search
+-->
<div class="searchbox">
<form action="http://www.google.com/search" method="get" class="roundtopsmall">
<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
<input name="Search" value="Search" type="submit">
</form>
</div>
<!--+
|end search
+-->
<!--+
|start Tabs
+-->
<ul id="tabs">
<li class="current">
<a class="selected" href="index.html">Welcome</a>
</li>
<li>
<a class="unselected" href="contrib.html">Developers</a>
</li>
<li>
<a class="unselected" href="versions/index.html">Versioned Docs</a>
</li>
<li>
<a class="unselected" href="pluginDocs/index.html">Plugins</a>
</li>
<li>
<a class="unselected" href="tools/index.html">Tools</a>
</li>
</ul>
<!--+
|end Tabs
+-->
</div>
</div>
<div id="main">
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
<div id="level2tabs"></div>
<!--+
|end Endtabs
+-->
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<!--+
|breadtrail
+-->
<div class="breadtrail">
&nbsp;
</div>
<!--+
|start Menu, mainarea
+-->
<!--+
|start Menu
+-->
<div id="menu">
<div onclick="SwitchMenu('menu_1.1', 'skin/')" id="menu_1.1Title" class="menutitle">About</div>
<div id="menu_1.1" class="menuitemgroup">
<div class="menuitem">
<a href="index.html" title="Welcome and introduction">About Forrest</a>
</div>
<div class="menuitem">
<a href="linkmap.html" title="Table of Contents for all Forrest documentation">Documentation ToC</a>
</div>
<div class="menuitem">
<a href="http://forrest.apache.org/mirrors.cgi" title="Download a release from your nearest mirror or get the latest from SVN">Download</a>
</div>
<div class="menuitem">
<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists and discussion</a>
</div>
<div class="menuitem">
<a href="license.html" title="Notes and FAQs about the licensing">License</a>
</div>
<div class="menuitem">
<a href="forrest-contract.html" title="What each party can expect">Our contract</a>
</div>
<div class="menuitem">
<a href="compliance.html" title="Declare the status of HTML, WAI, CSS compliance">Standards compliance</a>
</div>
<div class="menuitem">
<a href="forrest-issues.html" title="List of currently open issues">Open issues</a>
</div>
<div class="menuitem">
<a href="who.html" title="Explain who is involved">Who we are</a>
</div>
<div class="menuitem">
<a href="flyer.html" title="One-page description">Flyer</a>
</div>
<div class="menuitem">
<a href="live-sites.html" title="Some sites created using Apache Forrest technology">Example sites</a>
</div>
<div class="menuitem">
<a href="thanks.html" title="Acknowledgment to those who have become involved">Thanks</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Related projects</div>
<div id="menu_1.2" class="menuitemgroup">
<div class="menuitem">
<a href="http://gump.apache.org/">Apache Gump</a>
</div>
<div class="menuitem">
<a href="http://cocoon.apache.org/">Apache Cocoon</a>
</div>
<div class="menuitem">
<a href="http://lenya.apache.org/">Apache Lenya</a>
</div>
<div class="menuitem">
<a href="http://xml.apache.org/">Apache XML</a>
</div>
<div class="menuitem">
<a href="http://projects.apache.org/">projects.apache.org</a>
</div>
</div>
<div id="credit"></div>
<div id="roundbottom">
<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
<!--+
|alternative credits
+-->
<div id="credit2">
<a href="http://apachecon.com/2007/EU/"><img border="0" title="ApacheCon Europe 2007" alt="ApacheCon Europe 2007 - logo" src="http://apache.org/ads/ApacheCon/2007-europe-125x125.png" style="width: 125px;height: 125px;"></a><a href="http://people.apache.org/calendar.html#200711"><img border="0" title="ApacheCon US 2007" alt="ApacheCon US 2007 - logo" src="http://apache.org/ads/ApacheCon/2007-usa-125x125.png" style="width: 125px;height: 125px;"></a>
</div>
</div>
<!--+
|end Menu
+-->
<!--+
|start content
+-->
<div id="content">
<div title="Portable Document Format" class="pdflink">
<a class="dida" href="mirrors.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
</div>
<div class="trail">Font size:
&nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
&nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
&nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>Obtain the Apache Forrest distribution</h1>
<div id="minitoc-area">
<ul class="minitoc">
<li>
<a href="#how">How to download</a>
</li>
<li>
<a href="#closest">Current official release (closest mirror site selected automatically)</a>
</li>
<li>
<a href="#svn">Current development and head SVN repository</a>
</li>
<li>
<a href="#archive">Archive of old releases</a>
</li>
<li>
<a href="#verify">Verify releases</a>
</li>
</ul>
</div>
<a name="N10010"></a><a name="how"></a>
<h2 class="underlined_10">How to download</h2>
<div class="section">
<p class="note">Please realise that Forrest is still pre-1.0 release version. It is certainly usable for those who are prepared to move with it. See more notes about <a href="index.html#status">status</a>.</p>
<p>Use the links below to download a distribution of Apache Forrest from one of our mirrors. It is good practice to <a href="[location]#verify">verify the integrity</a> of the distribution files.</p>
<p>Apache Forrest is distributed as a <span class="codefrag">zip</span> archive (for Windows) and as a <span class="codefrag">tar.gz</span> archive (for UNIX). The contents are the same, the only difference is the line-endings of all text files.</p>
<p>The distribution contains all of the source code, documentation, and resources, together with the pre-built ready-to-run forrest binary. It also includes pre-packaged copies of relevant portions of Apache Cocoon and Apache Ant, and supporting products.</p>
<p>After unpacking the distribution, follow the README.txt to see the Requirements (just Java 1.4+), Installation Instructions and Documentation, Licensing and legal issues and credits.</p>
</div>
<a name="N1002F"></a><a name="closest"></a>
<h2 class="underlined_10">Current official release (closest mirror site selected automatically)</h2>
<div class="section">
<p>You are currently using <strong>[preferred]</strong> . If you encounter a problem with this mirror, then please select another. If all mirrors are failing, there are backup mirrors at the end of the list. See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.</p>
<a name="SelectMirror"></a>
<form action="[location]" method="get" id="SelectMirror">Other mirrors: <select name="Preferred">
<!--[if-any http] [for http]--><option value="[http]">[http]</option>
<!--[end] [end]-->
<!--[if-any ftp] [for ftp]--><option value="[ftp]">[ftp]</option>
<!--[end] [end]-->
<!--[if-any backup] [for backup]--><option value="[backup]">[backup] (backup)</option>
<!--[end] [end]--></select> <input type="submit" value="Change">
</form>
<p>The current release is Apache Forrest 0.7 (see the <a href="[preferred]/forrest/RELEASE-NOTES-0.7.txt">release notes</a>).</p>
<ul>
<li>For UNIX operating systems: <a href="[preferred]/forrest/apache-forrest-0.7.tar.gz">apache-forrest-0.7.tar.gz</a> [<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.tar.gz.asc">PGP</a>] [<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.tar.gz.md5">MD5</a>]</li>
<li>For Windows operating systems: <a href="[preferred]/forrest/apache-forrest-0.7.zip">apache-forrest-0.7.zip</a> [<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.zip.asc">PGP</a>] [<a href="http://www.apache.org/dist/forrest/apache-forrest-0.7.zip.md5">MD5</a>]</li>
</ul>
</div>
<a name="N1007B"></a><a name="svn"></a>
<h2 class="underlined_10">Current development and head SVN repository</h2>
<div class="section">
<p>Developers can use the latest Apache Forrest features, the source code is under version control with Subversion (read how to <a href="docs_0_70/build.html">obtain</a> your working copy).</p>
</div>
<a name="N10087"></a><a name="archive"></a>
<h2 class="underlined_10">Archive of old releases</h2>
<div class="section">
<p>Older releases are available in the <a href="http://archive.apache.org/dist/forrest/">archive</a>. Those releases are only provided as historical artefacts. We strongly recommend to not use those releases, but upgrade to the most recent release.</p>
</div>
<a name="N10093"></a><a name="verify"></a>
<h2 class="underlined_10">Verify releases</h2>
<div class="section">
<p>It is essential that you verify the integrity of the downloaded files using the PGP and MD5 signatures. MD5 verification ensures the file was not corrupted or tampered with. PGP verification ensures that the file came from a certain person.</p>
<p>The PGP signatures can be verified using <a href="http://www.pgpi.org/">PGP</a> or <a href="http://www.gnupg.org/">GPG</a>. First download the Apache Forrest <a href="http://www.apache.org/dist/forrest/KEYS">KEYS</a> as well as the <span class="codefrag">*.asc</span> signature file for the particular distribution. It is important that you get these files from the ultimate trusted source - the main ASF distribution site, rather than from a mirror. Then verify the signatures using ...</p>
<pre>% pgpk -a KEYS
% pgpv apache-forrest-X.Y.tar.gz.asc
<em>or</em>
% pgp -ka KEYS
% pgp apache-forrest-X.Y.tar.gz.asc
<em>or</em>
% gpg --import KEYS
% gpg --verify apache-forrest-X.Y.tar.gz.asc
</pre>
<p>To verify the MD5 signature on the files, you need to use a program called <span class="codefrag">md5</span> or <span class="codefrag">md5sum</span>, which is included in many unix distributions. It is also available as part of <a href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</a>. Windows users can get binary md5 programs from <a href="http://www.fourmilab.ch/md5/">here</a>, <a href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or <a href="http://www.slavasoft.com/fsum/">here</a> or an openssl client from <a href="http://www.slproweb.com/products/Win32OpenSSL.html">here</a>.</p>
<pre>% md5sum apache-forrest-X.Y.tar.gz
... output should match the string in apache-forrest-X.Y.tar.gz.md5
</pre>
<p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
</div>
</div>
<!--+
|end content
+-->
<div class="clearboth">&nbsp;</div>
</div>
<div id="footer">
<!--+
|start bottomstrip
+-->
<div class="lastmodified">
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<div class="copyright">
Copyright &copy;
2002-2007 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
+-->
</div>
</body>
</html>