A tutorial to connect to open source project with WinCVS.
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:
- Download the CVS compiere-all module (details see below)
- 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:
- Compiere CVS settings
- SourceForge CVS documentation (#6)
- If you have problems with CVS setup, please directly contact SorceForge (not the Compiere project).
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
ssh -l
(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:
CVSROOT=:pserver:anonymous@cvs.sourceforge.net:/cvsroot/compiere
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
Location:
Example:
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)
CVSROOT=:ext:
The command line equivalent is:
cvs -d:ext:
e.g.
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.
Comments