Version Warning
The content below is for Apache Syncope <= 1.2 - for later versions the Getting Started guide is available.
Introduction
Once you have created your project, you already have a set of tools for evaluating Syncope in a quite rich scenario, without the need of setting up additional components like JEE container, database, LDAP server and so on.
Running
From the top-level directory of your project, execute:
mvn clean package
then, from the console
subdirectory execute:
mvn -P embedded
Logging
Log files are available under
core/target/log console/target/log
Components available
Syncope core
Syncope core is the main web application, exposing a set of RESTful services.
- Base URL for REST methods: http://localhost:9080/syncope/rest/
- Credentials: 'admin' / 'password'
Syncope console
Syncope console is the administration interface for dealing with Syncope core.
- Access URL: http://localhost:9080/syncope-console
- Credentials: 'admin' / 'password'
Syncope internal storage
Syncope core's persistence is based on JPA: this allows deployment on a wide range of DBMS; when running in embedded mode, H2 (in-memory) is used for internal storage.
A SQL web interface is available at http://localhost:9080/syncope/db.jsp:
- Choose configuration 'Generic H2 (Embedded)'
Insert
jdbc:h2:mem:syncopedb
as JDBC URL
- Click 'Connect' button
External database resource
(Do you want to understand what an external resource is? Check Connectors and resources).
An H2 TCP database is available for propagation.
A SQL web interface is available at http://localhost:9082/:
- Choose configuration 'Generic H2 (Server)'
Insert
jdbc:h2:tcp://localhost:9092/mem:testdb
as JDBC URL
- Set 'sa' as password
- Click 'Connect' button
External LDAP resource
(Do you want to understand what an external resource is? Check Connectors and resources).
An Apache DS instance is available for propagation.
You can configure any LDAP client (as JXplorer, for example) with the following information:
- host: localhost
- port: 1389
base DN:
o=isp
bind DN:
uid=admin,ou=system
- bind password: 'secret'
External SOAP resource
(Do you want to understand what an external resource is? Check Connectors and resources).
An example SOAP server is available at http://localhost:9080/wssample/services.
You can check its internal storage by visiting http://localhost:9080/wssample/exploredb.jsp.
3 Comments
Jesse van Bekkum
Suggestion:
Post where to find the logs on an embedded system. (core/target/log/). This took me a while to find.
Francesco Chicchiriccò
Content updated as per your suggestion, thanks!
Francesco Chicchiriccò
Hi Scott,
thanks for your report.
I have just restored the page permissions and now you should be able to comment; please get involved at user@syncope.apache.org if you are interested in contributing to the project.
About your specific notes: I confirm that changing the internal storage as reported in 1 still works fine, so no changes are required.
About the external database, I've encountered the same error as reported by you above and updated the page with the actual fix - your proposed change points to a new, empty database, not the external test database.
Regards.
1 https://cwiki.apache.org/confluence/display/SYNCOPE/Run+Syncope+standalone+distribution#RunSyncopestandalonedistribution-Internalstorage