Difference between revisions of "IDempiere/Download the Code"

From WikiQSS
(fix link)
(Tip: Incremental clone: add link to incrementalClone.sh)
Line 22: Line 22:
 
It is reported repeatedly that hg clone operation tends to fail because of bandwidth.
 
It is reported repeatedly that hg clone operation tends to fail because of bandwidth.
  
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:
+
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
 
  hg clone -r 1 https://bitbucket.org/idempiere/idempiere

Revision as of 11:28, 10 November 2014

Table of Contents | Install Prerequisites on Ubuntu | Download the Code | Setting up Eclipse

Cloning iDempiere

iDempiere sources are hosted at 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: Incremental clone

It is reported repeatedly that hg clone operation tends to fail because of bandwidth.

An 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

Tip: Zipped full repo

Another tip for downloading over slow lines is to download the whole repo from [1]

Unzip the file, and then do

hg -v pull -u

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).

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.