This release consists of a single source archive (engroup_src.zip) that contains all the Engroup components.

Prerequisites

• Java 6 (http://java.sun.com/javase/downloads/index.jsp): only build Engroup sources with Java 6, because Engroup runs only on Java 6 platform.
• Maven (http://maven.apache.org/)
• Flex 3 SDK (http://www.adobe.com/products/flex/flexdownloads/)
• AIR 1.5 SDK (http://www.adobe.com/products/air/tools/sdk/)
• You must connect to internet at the first time of building Engroup source codes: maven will download many Engroup-Osgi libraries from Engroup Maven repository http://engroup.sourceforge.net/maven2 at the first time of building source and this process can take long time depends on your internet bandwidth and computer processor.

Build the contents

Follow the following steps:

• Unzip the Engroup source file to folder: we call the unzip folder is %ENG_SRC_DIR% (for example C:\engroupsrc)

• Set FLEX_HOME and AIR_HOME environment variables:

   

  FLEX_HOME: points to the folder installs Flex 3 SDK. For example: command > set FLEX_HOME = C:\Flex3SDK

   

  AIR_HOME: points to the folder installs AIR 1.5 SDK. For example: command > set AIR_HOME = C:\AIRSDK

   

  Note: FLEX_HOME, AIR_HOME environment variables are the must for building Engroup client components, if you only build Engroup server artifacts you can ignore them.

   

• Configure maven options:

     

  Engroup consists multiple maven projects, many of them take much memory and long time to build - especially Engroup client components. According to eSoftHead test, a large enough java heap size and Permgen space are required to build Engroup sources successfully, otherwise maven will throw OutOfMemoryException and the build is failed. You must set the MAVEN_OPTS with the following value -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m. The value of heap size and permgen may change in your environment, if you have any OutOfMemoryException while building Engroup sources, please adjust these values.

   

  For example, the following command sets maven options in Windows OS: set MAVEN_OPTS=-Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m

   

• Run the command:

   

  The final task is so simple, go to Engroup  source folder and call mvn install. Please be patient for the first time of building Engroup sources (from the second times, it may take 5-15 minutes to build the whole Engroup components). After maven complete installing, it will create Engroup installers (for both client and server components) at %ENG_SRC_DIR%/installation/dist. They are the same with our pre-binary distributions.