Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
tutorial:dev:build_backend [2017/09/13 14:38]
michalp
tutorial:dev:build_backend [2017/09/13 15:32]
michalp
Line 1: Line 1:
 +===== Build CzechIdM Backend =====
 +
 +===== Requirements =====
 +
 +Install JDK 8.
 +
 +Install Maven. - ''Required version is 3.1 or higher'' 
 +
 +Install Tomcat 8.0.*. ''Tested versions: 8.0.24, 8.0.35, 8.0.36''
 +
 +===== Modules =====
 +
 +==== Project modules [mandatory] ====
 +
 +  * ''parent'' Maven parent of all following submodules with common dependencies
 +  * ''core'' Contains base IdM functionality (entities, repositories, services etc.)
 +    * ''core-api'' Core interfaces
 +    * ''core-test-api'' Test interfaces
 +    * ''core-impl'' Core services, entities and rest implementation
 +  * ''app'' Contains example .war application - all modules (core + business modules) and their configuration
 +
 +==== Application modules [optional] ====
 +
 +* ''acc'' Account management module
 +* ''module-example'' Example application module / skeleton
 +
 +==== Maven modules [optional] ====
 +
 +* ''gui'' Frontend as .war package
 +* ''module-aggregator'' Complex builder for all modules
 +
 +===== Build =====
 +
 +The quickest way to build whole backend application, is to use module-aggreagator. Go to module-aggreagator folder, where pom.xml is located and run command:
 +
 +<code>mvn clean install</code>
 +or you can build it with separeate gui (requires gulp installation from [[tutorial:dev:build_frontend|frontend installation guide]])
 +<code>mvn clean install -separatedApp</code>
 +or you can build full released app in one ''idm.war'' file containing backend and frontend with ''acc'' and ''example'' modules. (requires gulp installation from [[tutorial:dev:build_frontend|frontend installation guide]])
 +<code>mvn clean install -Prelease</code>
 +
 +Also you can build all mandatory project modules one by one in order above using: 
 +<code>mvn clean install</code>
 +
 +===== Deploy =====
 +
 +Deploy ''idm-backend.war'' or ''idm.war'' file located in target folder of ''app'' module to Tomcat/webapps.
 +
 +===== Demo user credentials =====
 +
 +**username:** admin
 +
 +**password:** admin
 +
 +===== Configuration =====
 +<note important>Default profile is using h2 database. It is not nessesary to configure it for first start.</note>
 +
 +All configuration properties are in [[7.3:dev:configuration:backend|documentation]]
 +
 +
  
  • by koulaj