Difference between revisions of "IDempiere/Download the Code"

From WikiQSS
(hg update)
(moved)
 
Line 1: Line 1:
<!-- breadcrumb -->
+
Moved to [http://wiki.idempiere.org/en/Download_the_Code http://wiki.idempiere.org/en/Download_the_Code]
<font size=-2>
 
&lArr;
 
[[IDempiere|Table of Contents]] |
 
[[IDempiere/Install_Prerequisites_on_Ubuntu|Install Prerequisites on Ubuntu]] |
 
Download the Code |
 
[[IDempiere/Setting_up_Eclipse|Setting up Eclipse]]
 
&rArr;
 
</font>
 
 
 
== Cloning iDempiere ==
 
 
 
iDempiere sources are hosted at [http://bitbucket.org/idempiere/idempiere Atlassian Bitbucket], you can download the complete project with:
 
 
 
cd $HOME/sources
 
hg clone https://bitbucket.org/idempiere/idempiere
 
 
 
Please replace $HOME/sources with the folder where you wish to download the whole sources, at least 2 GB are required.
 
 
 
=== Tip: Zipped full repo ===
 
 
 
It is reported repeatedly that hg clone operation tends to fail because of bandwidth.
 
 
 
For your convenience iDempiere project provides a full zipped repo that you can download over slow lines, you can find it at sourceforge on this [http://sourceforge.net/projects/idempiere/files/v2.1/source-repo/idempiere_hgrepo_v2.1.zip/download link]
 
 
 
You just need to download, unzip the file, and then execute within the downloaded folder:
 
hg -v pull -u
 
 
 
=== Tip: Incremental clone ===
 
 
 
Alternatively, an [https://bitbucket.org/CarlosRuiz_globalqss/idempiere-stuff/raw/tip/incrementalClone.sh incrementalClone.sh] script can be used to download on slow lines, you just need to download the script and execute on the folder you want to download:
 
incrementalClone.sh https://bitbucket.org/idempiere/idempiere
 
 
 
Or, you can do it manually, note that mercurial doesn't support directly to do incremental clone, so the trick is to clone the first revision and then incrementally pull sets of revisions, for example:
 
 
 
hg clone -r 1 https://bitbucket.org/idempiere/idempiere
 
cd idempiere
 
hg pull -r 100 -u
 
hg pull -r 200 -u
 
hg pull -r 300 -u
 
hg pull -r 400 -u
 
hg pull -r 500 -u
 
... and so on until the actual revision of the repository
 
 
 
== Local experimentation clone ==
 
 
 
Once you have downloaded the sources from bitbucket you can easily clone locally your downloaded repository (for example for experimentation purposes) with an instruction like this:
 
 
 
cd $HOME/sources
 
hg clone idempiere myexperiment
 
 
 
This way you could experiment with a local clone instead of the downloaded from bitbucket (in order to keep it pristine).
 
 
 
== Set the working version ==
 
 
 
If you are going to work with iDempiere development version (actually 3.0) please execute:
 
cd $HOME/sources/myexperiment
 
hg update development
 
 
 
If you are going to work with iDempiere version 2.1:
 
cd $HOME/sources/myexperiment
 
hg update release-2.1
 
 
 
== Keeping up to date ==
 
 
 
When you want to synchronize your local clone with bitbucket again you can do it with:
 
 
 
cd $HOME/sources/idempiere
 
hg pull -u
 
 
 
and/or, similarly for your local clone
 
 
 
cd $HOME/sources/myexperiment
 
hg pull -u
 
 
 
Note that first one will pull from bitbucket, and second will pull from your local clone.
 

Latest revision as of 13:32, 7 June 2015