A tutorial to connect to open source project with WinCVS.

(quoted from http://www.compiere.org/technology/build.html)

Reason I copy all over to my blog is that overtime I notice many web sites will be either dissapeared, content changed or URL broken after some times. Just do not want to search here and there again for the same stuff. Therefore I just place the whole thing here for my sake of future references. The credit should still be all dued to the real authors.

These are the steps to build Compiere from Source:

  1. Download the CVS compiere-all module (details see below)
  2. In the utils-dev sub-directory
    • customize the myDevEnv.bat file
    • execute RUN_build.bat

We internally use Eclipse, but you are able to use any IDE or Java development environment to build Compiere form Source.

Please note that there is a delay between the CVS commit and it's availability in anomynous (general) CVS access - up to 24 hours according to SourceForge. Usually it does NOT create a problem, but it has resulted in compile errors. In that case, please re-download.

Related links:

See also Jaume's guide

CVS Download

If you are on the developer list (i.e. have CVS write privileges), you need to install ssh (see below). Here is are some helpful CVS links:

General CVS (anonymous) Download

There is the general procedure to download the source:

  • Get any CVS client
  • Execute
    cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/compiere login
    cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/compiere checkout compiere-all

Alternatively, you can

  • follow the install steps below with the "pserver" connection option
    (you can skip the ssh installation)
  • also download the nightly CVS Tree Tarball.
  • download individual files via the CVS web interface

Developer & Anonymous CVS Download under Windows

If you are developing under Linux/Unix, things are a bit easier with CVS. Here one way to get CVS working on Windows 2000

Enabling SSH

You can skip this step, if you are not on the developer list and just want to download the source. One way is to install Cygwin which gives you Unix utilities under Windows. Make sure, that you install OpenSSH (in the Net category).

Start Cygwin and connect to SourceForge:

ssh -l compiere.sorceforge.net
ssh -l cvs.sorceforge.net

(example: ssh -l jjanke compiere.sourceforge.net)

This adds the SourceForge hosts to the list of known hosts and shows that you have a valid user ID. The connection to cvs.compiere.sorceforge.net is immediate closed, but this step is required to add it to the list of known hosts.

Install CVS Client

There are many CVS clients available. We use WinCvs (if you have trouble connecting, download directly).

Note: You can use any CVS client (e.g. the command line option 'cvs' in Cygwin), when you set the environment variables CVSROOT (and CVS_RSH for SSH access).

Check also the Compiere settings and the SourceForge CVS documentation (F). The WinCSV project has very good general CVS documentation.

General (anonymous) CVS Access:


In WinCVS enter

Authentication: pserver
Path: /cvsroot/compiere
Host address: cvs.sourceforge.net
User name: anonymous

Then checkout "compiere-all" via the menu Create > Checkout module ... and enter

Module name: compiere-all


CVS Checkout

CVS Connection Settings

CVS PServer Settings

The command line equivalent is:

cvs -d:pserver:anonymous@cvs.compiere.sourceforge.net:/cvsroot/compiere login
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/compiere co compiere-all

For Developer CVS Access via SSH:

For this, you need to be on the Compiere Developer List. Follow the steps above, but note the following changes:

Authentication: ssh
Path: /cvsroot/compiere
Host address: cvs.sourceforge.net
User name:
Select: Show CVS console
In ssh Settings enable Additional ssh options: -v

Set the following System Environment Variables:

CVS_RSH=C:\cygwin\bin\ssh.exe (or the location of the ssh executable)

The command line equivalent is:

cvs -d:ext:@cvs.sourceforge.net:/cvsroot/compiere co compiere-all

cvs -d:ext:jjanke@cvs.sourceforge.net:/cvsroot/compiere co compiere-all

Compiling / Building Compiere

The CVS tree has all required libraries - you just need a Java 1.4.2 SDK

Customize myDevEnv.bat / myDevEnv.sh

The files are located in the utils_dev directory. Define the path of Java executable, source, and build area. Executing the script creates the keystore required for signing jar files for the use with WebStart. If you are distributing the build, you may want to get a Java code signing certificate.

Execute RUN_build.bat / RUN_build.sh

The files are located in the utils_dev directory. It compiles the sources and builds the distribution files.

If you are using an IDE like Eclipse, you need to define projects.
CVS contains the Eclipse .project files.


Popular posts from this blog

Clearcase check in/uncheck out all the checked out files script

Duplicating a local copy of project from TFS and making web software client factory to work