Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Last revision Both sides next revision
tutorial:dev:build_backend [2017/09/13 15:29]
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