[esb-java-dev] svn commit r40966 - branches/esb/java/2.1/product/docs/xdoc
ruwan at wso2.com
ruwan at wso2.com
Tue Jul 7 07:56:12 PDT 2009
Author: ruwan
Date: Tue Jul 7 07:56:11 2009
New Revision: 40966
URL: http://wso2.org/svn/browse/wso2?view=rev&revision=40966
Log:
Fixing the source-repository
Modified:
branches/esb/java/2.1/product/docs/xdoc/source-repository.xml
Modified: branches/esb/java/2.1/product/docs/xdoc/source-repository.xml
URL: http://wso2.org/svn/browse/wso2/branches/esb/java/2.1/product/docs/xdoc/source-repository.xml?rev=40966&r1=40965&r2=40966&view=diff
==============================================================================
--- branches/esb/java/2.1/product/docs/xdoc/source-repository.xml (original)
+++ branches/esb/java/2.1/product/docs/xdoc/source-repository.xml Tue Jul 7 07:56:11 2009
@@ -28,54 +28,97 @@
</title>
</head>
<body>
- <h2>Overview</h2><p>This project uses <a href="http://subversion.tigris.org/">Subversion</a>
- to manage its source code. Instructions on Subversion use can be found at<a href="http://svnbook.red-bean.com/">
- http://svnbook.red-bean.com/</a>.</p>
- <h2>Web Access</h2>
- <p>The following is a link to the online source repository.</p>
+ <h1>WSO2 Enterprise Service Bus (ESB) Source Repository</h1>
+ WSO2 ESB is developed on top of the revolutionary WSO2 Carbon platform. You might need the
+ source of the Carbon platform as well apart from the ESB source code. Please note that both
+ ESB and the Carbon platform is open source and the code is available under the Apache
+ Software License v2.0.
+
+ <h2>Overview</h2>
+ <p>This project uses <a href="http://subversion.tigris.org/">Subversion</a>
+ to manage its source code. Instructions on Subversion use can be found at
+ <a href="http://svnbook.red-bean.com/">http://svnbook.red-bean.com/</a>.</p>
+
+ <h2>Source code of the ESB 2.1.0 release</h2>
+ <p>The following is a link to the online source tag of the WSO2 ESB 2.1.0 release.</p>
+ <div class="source">
+ <pre><a href="http://svn.wso2.org/repos/wso2/tags/esb/java/2.1.0/">http://svn.wso2.org/repos/wso2/tags/esb/java/2.1.0/</a></pre>
+ </div>
+ <p>The complete source including the carbon platform can be checked out anonymously from
+ SVN with this command:</p>
+ <div class="source">
+ <pre>$ svn checkout http://svn.wso2.org/repos/wso2/tags/esb/java/2.1.0 wso2esb</pre>
+ </div>
+
+ <p>This code base contains the ESB product source code inside the directory "product" and
+ it also contains the source for the platform under the directory "carbon-pltform". Further
+ there will be a "build.sh" script to build the ESB with the platform.</p>
+
+ <p>This script accepts any of the maven related system properties, but the property to skip
+ the tests has been shortned to "-ts", for example to build the ESB with the platform on
+ skipping tests the command is;</p>
+
+ <div class="source">
+ <pre>$ ./build.sh -ts</pre>
+ </div>
+
+ <p>To build off-line with this build script you can pass in the "-o" option. If you just
+ need to build either the product or a specific part of the platform (for example Synapse)
+ you just need to traverse to that directory and use maven to build any of the projects.</p>
+
+ <h2>Source code of the WSO2 ESB trunk</h2>
+ <p>Everyone can access the Subversion repository via HTTPS, but Committers must checkout
+ the Subversion repository via HTTPS.
+ </p>
+ <div class="source">
+ <pre>$ svn checkout https://svn.wso2.org/repos/wso2/trunk/esb/java wso2esb</pre>
+ </div>
+
+ <p>The Carbon framework related source code can be checked out from the
+ following commands.</p>
+
<div class="source">
- <pre><a href="https://wso2.org/repos/wso2/trunk/esb/java/wso2esb">https://wso2.org/repos/wso2/trunk/esb/java/wso2esb</a></pre>
+ <pre>$ svn checkout https://svn.wso2.org/repos/wso2/trunk/carbon carbon</pre>
</div>
- <h2>Anonymous access</h2>
- <p>The source can be checked out anonymously from SVN with this command:</p>
+
<div class="source">
- <pre>$ svn checkout http://wso2.org/repos/wso2/trunk/esb/java wso2esb</pre>
+ <pre>$ svn checkout https://svn.wso2.org/repos/wso2/trunk/carbon-components carbon-components</pre>
</div>
- <h2>Developer access</h2>
- <p>Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion
- repository via
- HTTPS.
+
+ <p>The Carbon project is the root project of the OSGi platform on whcih all the Java
+ product stack is built on top of, and the carbon-components contains all the components
+ not just ESB specific components. So you obviously need to build just the set of
+ components required by the ESB, which can be achieved through;
</p>
+
<div class="source">
- <pre>$ svn checkout https://wso2.org/repos/wso2/trunk/esb/java wso2esb</pre>
+ <pre>$ mvn clean install -Dproduct=esb</pre>
</div>
- <p>To commit changes to the repository, execute the following command to commit your changes (svn will prompt
- you for
- your password)
+
+ <p>To commit changes to the repository, execute the following command (svn will prompt
+ you for your password)
</p>
<div class="source">
<pre>$ svn commit --username your-username -m "A message"</pre>
</div>
+
<h2>Access from behind a firewall</h2>
- <p>For those users who are stuck behind a corporate firewall which is blocking http access to the Subversion
- repository,
- you can try to access it via the developer connection:
+ <p>For those users who are stuck behind a corporate firewall which is blocking http access
+ to the Subversion repository, you can try to access it via the developer connection:
</p>
<div class="source">
- <pre>$ svn checkout https://wso2.org/repos/wso2/trunk/esb/java wso2esb</pre>
+ <pre>$ svn checkout https://svn.wso2.org/repos/wso2/trunk/esb/java wso2esb</pre>
</div>
<h2>Access through a proxy</h2>
- <p>The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers"
- configuration
- file to indicate which proxy to use. The files location depends on your operating system. On Linux or Unix
- it is
- located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%",
- note
- this is a hidden directory.)
- </p>
- <p>There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion
- client
- and run any command; this will cause the configuration directory and template files to be created.
+ <p>The Subversion client can go through a proxy, if you configure it to do so.
+ First, edit your "servers" configuration file to indicate which proxy to use. The
+ files location depends on your operating system. On Linux or Unix it is
+ located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion".
+ (Try "echo %APPDATA%", note this is a hidden directory.)
+ </p>
+ <p>There are comments in the file explaining what to do. If you don't have that file, get
+ the latest Subversion client and run any command; this will cause the configuration
+ directory and template files to be created.
</p>
<p>Example : Edit the 'servers' file and add something like :</p>
<div class="source">
More information about the Esb-java-dev
mailing list