Author: pzf
Date: Mon Jan 28 12:24:17 2008
New Revision: 616022
URL: http://svn.apache.org/viewvc?rev=616022&view=rev
Log:
added building
Added:
webservices/synapse/site/building.html
Added: webservices/synapse/site/building.html
URL:
http://svn.apache.org/viewvc/webservices/synapse/site/building.html?rev=616022&view=auto
==============================================================================
--- webservices/synapse/site/building.html (added)
+++ webservices/synapse/site/building.html Mon Jan 28 12:24:17 2008
@@ -0,0 +1,334 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
+
+
+
+
+
+
+
+
+
+
+
+<html xmlns="http://www.w3.org/1999/xhtml";>
+ <head>
+ <title>Apache Synapse - How to Build Apache Synapse</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css"
media="print" />
+ <meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="synapse.apache.org/" id="bannerLeft">
+
+
+
+ </a>
+ <a href="http://www.apache.org"; id="bannerRight">
+
+ <img
src="images/apache-synapse-banner.jpg" alt="" />
+
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 28 Jan 2008
+ </div>
+ <div class="xright"> <a href="http://www.apache.org/";
class="externalLink">Apache</a>
+ |
+ <a href="http://ws.apache.org/";
class="externalLink">WebServices</a>
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+
+ <h5>Apache Synapse</h5>
+ <ul>
+
+ <li class="none">
+ <a href="index.html">About</a>
+ </li>
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="download_index.html">Downloads</a>
+ <ul>
+
+ <li class="none">
+ <a href="download.html">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="source-repository.html">Source Code</a>
+ </li>
+ </ul>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="docs_index.html">Documentation</a>
+ <ul>
+
+ <li class="none">
+ <a href="Synapse_QuickStart.html">Quick Start Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="Synapse_Samples.html">Samples</a>
+ </li>
+
+ <li class="none">
+ <a href="Synapse_Extending.html">Extending Synapse</a>
+ </li>
+
+ <li class="none">
+ <a
href="Synapse_Configuration_Language.html">Configuration Language</a>
+ </li>
+
+ <li class="none">
+ <a href="apidocs/index.html">Javadocs</a>
+ </li>
+ </ul>
+ </li>
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="history.html">Previous Version</a>
+ <ul>
+
+ <li class="none">
+ <a href="1_1/content.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="1_0/content.html">Version 1_0</a>
+ </li>
+ </ul>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="project-info.html">Project Information</a>
+ <ul>
+
+ <li class="none">
+ <a href="mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <strong>Building</strong>
+ </li>
+
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="dependencies.html">Dependencies</a>
+ </li>
+
+ <li class="none">
+ <a href="dependency-convergence.html">Dependency
Convergence</a>
+ </li>
+
+ <li class="none">
+ <a href="team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="project-summary.html">Project Summary</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/";
title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven"
src="./images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2><a name="Obtaining_the_code"></a>Obtaining
the code</h2>
+<p>
+ You can obtain the code by downloading the <a class="externalLink"
href="http://ws.apache.org/synapse/download/1.1/download.cgi";>source
distribution</a> or, more commonly, checking out the source from Subversion
(SVN).
+ To checkout the code from <a class="externalLink"
href="http://subversion.tigris.org/";>Subversion</a>, firstly get subversion
installed, then use the following commands:
+ <pre>svn co http://svn.apache.org/repos/asf/webservices/synapse/trunk/java
[path-where-you-want-the-code]</pre>
+ If you are a committer then you need to use the secure version:
+ <pre>svn co
https://svn.apache.org/repos/asf/webservices/synapse/trunk/java
[path-where-you-want-the-code]</pre></p>
+</div>
+<div class="section"><h2><a name="Building"></a>Building</h2>
+<p>
+The first thing you need to build the code is JDK1.5 and <a
class="externalLink" href="http://maven.apache.org/download/";>Maven2</a>. You
need at least version 2.0.7.
+Synapse is not yet tested on JDK1.6 or above.
+</p>
+<p>
+To build, in the top level Synapse folder do:
+<pre>
+mvn clean install
+</pre></p>
+<p>
+To build the distribution archive packages do (the distribution archives are
created in new folder named target):
+<pre>
+mvn assembly:assembly -Drelease
+</pre></p>
+</div>
+<div class="section"><h2><a name="Offline_builds"></a>Offline builds</h2>
+<p>
+The first time you build Maven downloads all the required dependency jars to
your local repository,
+after there has been a successful build you can add the "-o"
parameter to the above commands to run in offline mode
+which avoids going out to remote Maven repositories. The result - the build
runs faster.
+<hr />
+<pre>
+mvn clean install -o
+</pre>
+or
+<pre>
+mvn assembly:assembly -Drelease -o
+</pre></p>
+</div>
+<div class="section"><h2><a name="Skipping_tests"></a>Skipping tests</h2>
+<p>
+If you don't want to have all the Synapse test cases run during the build you
can add the parameter "-Dmaven.test.skip=true", eg:
+<pre>
+mvn clean install -o -Dmaven.test.skip=true
+</pre>
+or
+<pre>
+mvn assembly:assembly -Drelease -o -Dmaven.test.skip=true
+</pre></p>
+</div>
+<div class="section"><h2><a name="Updating_Snapshots"></a>Updating
Snapshots</h2>
+<p>
+Sometimes the trunk build uses snapshot versions of some dependency jars which
can go out
+of date but may not get refreshed in your local Maven repository even when the
"-o" parameter is not used.
+So if you get build failures you can try refreshing any snapshot dependencys
with the "-U" parameter, eg:
+<pre>
+mvn clean install -U
+</pre>
+By default the Maven local repository is in your home directory, you can
change this so the build
+uses use a different local repository with the parameter
"-Dmaven.repo.local=", eg:
+<pre>
+mvn clean install -Dmaven.repo.local=\Synapse\MyRepo
+</pre></p>
+</div>
+<div class="section"><h2><a name="Eclipse_Projects"></a>Eclipse Projects</h2>
+<p>
+You can create Eclipse project definitions for Synapse (that can be imported
directly into Eclipse).
+At the top level Synapse folder run:
+<pre>
+mvn eclipse:eclipse
+</pre>
+Now within eclipse you can import those Synapse projects into an Eclipse
workspace.
+From Eclipse do File -> Import, expand the "General" toggle and
choose "Existing Projects into Workspace",
+click Next, click Browse and navigate to your Synapse SVN folder, click OK and
it should find the six Synapse projects,
+click Finish. That should set up the projects and show them in the Package
Explorer.
+There will be lots of compile errors about missing classpath entries,
+to fix this select Window -> Preferences, expend the Java toggle, then
expand the Build Path toggle and
+select Classpath Variables.
+Click New and use the name "M2_REPO" and then click Folder and
navigate to you local Maven repository
+(eg C:/Documents and Settings/Administrator/.m2/repository), click OK and
again OK and it should rebuild everything with all the compile errors gone.
+</p>
+</div>
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2005-2008
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
