Details Print

BuildEmForge

Build instruction for EmForge Project

Tools Required to Work with EmForge

1. Java 1.5 of course :)
2. Eclipse to develop the project
3. Maven 2 to build the project.
4. Subversion Client to get Sources from Repository omitting Eclipse.
5. By Default build-in HSQL database is used, so, you do not need any additional database server installed;
6. Tomcat 5.5 or 6.0 - used as Servlet-Container

Get sources from Repository

Sources available by URL: https://emforge.svn.sourceforge.net/svnroot/emforge/EmForge/trunk Just Get it into some folder (for example c:/work/EmForge/trunk)

svn checkout https://emforge.svn.sourceforge.net/svnroot/emforge/EmForge/trunk trunk

As result you will receive several projects:

• emforge-util - some itility classes used in other projects;
• emforge-api - api (interfaces and trasfer-objects) implemented by emforge-core (and emforge-scm);
• emforge-core - implementation of EmForge services;
• emforge-scm - part of servicesresopsible for working with Source Controls - implemenyed as separate jar, since used separatelly from core in portlets;
• emforge-web - WebApplication - it is war finally included all other projects and deployed into server;
• some other projects not used in normal development;

Build with Maven

To build project with Maven you need from project's root folder call

mvn install

If build will be success you can find EmForge.war package in target folder.

Prepeare Eclipse Workspace

To work with EmForge from Eclipse you need:

• Setup JDK (not JRE) - it is required for Tomcat: Window -> Preferences... -> Java - Installed JREs
• Add Tomcat Server Runtime: Windows -> Preferences... -> Server -> Installed Runtimes
• Add Tomcat Server instance: J2EE Perspective -> Servers Tab -> New -> Server
• Add Required Database JDBC driver {TomcatHome}/common/lib
• Prepeare Workspace to work with Maven by command (exit from Eclipse before, see Maven Site for details):

mvn -Declipse.workspace={path-to-eclipse-workspace} eclipse:add-maven-repo

• Import downloaded EmForge projects into workspace

Prepare Database Server

Development environment is using HSQL build-in database, so, to start use EmForge you will not need to install and setup any additional database. During build required hsql jar will be downloaded by maven and database with required scheme will be created during first run.

Install EmForge

Actually, EmForge from Repository, after build is ready to be installed, it is configured to use:

• HSQL Build-In Database
• EmForge Subversion to browse sources
• Database based wiki and attachment provider

In Eclipse just add EmForge project into your Tomcat Server Instance, for standalone Tomcat deploy WAR-file you got from maven build