You can obtain the code by downloading the source distribution or, more commonly, checking out the source from Subversion
(SVN). To checkout the code from Subversion, firstly get subversion installed, then use the following commands:
svn co https://hr-crm.svn.sourceforge.net/svnroot/hr-crm/trunk hrcrm
If you are a committer then you need to use the secure version:
svn co https://hr-crm.svn.sourceforge.net/svnroot/hr-crm/trunk hrcrm
The first thing you need to build the code is JDK1.6 and Maven2. You need at least version 2.0.7.
To build, in the top level HR-CRM folder do:
mvn clean install -Dmaven.test.skip=true -P ear
There is additional end2end testing module, which can be activated with the
all
profile. First you must set two environments variables: JBOSS_HOME and JBOSS_PORT and initialize the database using
this script
mvn clean install -P all
The first time you build Maven downloads all the required dependency jars to your local repository, after there has been a
successful build you can add the "-o" parameter to the above commands to run in offline mode which avoids going out to remote
Maven repositories. The result - the build runs faster.
mvn clean install -o
If you don't want to have all the HR-CRM test cases run during the build you can add the parameter "-Dmaven.test.skip=true",
eg:
mvn clean install -Dmaven.test.skip=true
Sometimes the trunk build uses snapshot versions of some dependency jars which can go out of date but may not get refreshed in
your local Maven repository even when the "-o" parameter is not used. So if you get build failures you can try refreshing any
snapshot dependencys with the "-U" parameter, eg:
mvn clean install -U
By default the Maven local repository is in your home directory, you can change this so the build uses use a different local
repository with the parameter "-Dmaven.repo.local=", eg:
mvn clean install -Dmaven.repo.local=\HR-CRM\MyRepo
You can create Eclipse project definitions for HR-CRM (that can be imported directly into Eclipse). At the top level HR-CRM
folder run:
mvn eclipse:eclipse -P all
Now within eclipse you can import those HR-CRM projects into an Eclipse workspace. From Eclipse do File -> Import, expand the
"General" toggle and choose "Existing Projects into Workspace", click Next, click Browse and navigate to your HR-CRM SVN
folder, click OK and it should find the six HR-CRM projects, click Finish. That should set up the projects and show them in
the Package Explorer. There will be lots of compile errors about missing classpath entries, to fix this select Window ->
Preferences, expend the Java toggle, then expand the Build Path toggle and select Classpath Variables. Click New and use the
name "M2_REPO" and then click Folder and navigate to you local Maven repository (eg USER_HOME/.m2/repository), click OK and
again OK and it should rebuild everything with all the compile errors gone.