Note | ||
---|---|---|
| ||
The content below is for Apache Syncope <= 1.2 - for later versions the Getting Started guide is available. |
Table of Contents | ||
---|---|---|
|
Introduction
This document describes how to create a new Syncope project.
A Syncope project includes (at least) two web applications: the core and the console. This page helps you get both web applications up and running with your own project as quickly as possible.
...
Maven archetypes are templates of projects. Maven can generate a new project from such a template. For a project using Syncope, you need the website archetype. In the folder in which the new project folder should be created, type the command shown below. On Windows, run the command on a single line and leave out the line continuation characters ('\').
Code Block |
---|
mvn archetype:generate \ -DarchetypeGroupId=org.apache.syncope \ -DarchetypeArtifactId=syncope-archetype \ -DarchetypeRepository=http://repo1.maven.org/maven2 \ -DarchetypeVersion=1.12.111 |
The archetype is configured with default values for all properties required by the archetype. If you want to customize any of these property values, type 'n' when prompted for confirmation.
...
Take a look at available releases of the archetype project at central Maven repository, then change the archetypeVersion
in the mvn command above accordingly.
...
title | Bugs in Apache Syncope 1.1.0 |
---|
A couple of bugs (SYNCOPE-352, SYNCOPE-356) have been found in Apache Syncope 1.1.0, already fixed for release versions >= 1.1.1.
Upgrade to 1.1.1 is strongly suggested.
...
.
...
Snapshot (development) releases
...
If you want to test a snapshot release, be sure to:
change
toCode Block http://repo1.maven.org/maven2
in the mvn command aboveCode Block mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \ -DarchetypeGroupId=org.apache.syncope \ -DarchetypeArtifactId=syncope-archetype \ -DarchetypeRepository=http://repository.apache.org/content/repositories/snapshots
\ -DarchetypeVersion=1.2.11-SNAPSHOT
add the following code right before
</project>
in rootpom.xml
of the generated project:Code Block <repositories> <repository> <id>ASF</id> <url>https://repository.apache.org/content/repositories/snapshots/</url> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories>
...
Now build your project using the following command in the root folder of your project:
Code Block |
---|
mvn clean package
|
This will produce two WAR files:
...