THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
Deployment directory
Currently, Syncope needs two three base directories to be defined:
- bundles - where ConnId bundles are stored (check what a connector bundle is);
- log - where all system logs are written;
- conf (optional) - where configuration files are located, if override is needed.
| Warning |
|---|
Bundles directory should only contain connector bundle JAR files. The presence of any other file might cause the unavailability of any connector bundle in Apache Syncope. |
...
| Code Block |
|---|
$ mkdir /opt/syncope $ mkdir /opt/syncope/bundles $ mkdir /opt/syncope/log $ mkdir /opt/syncope/conf |
Internal storage
Internal storage is a database where all information and configurations are stored.
...
Be sure to put the JDBC driver JAR file under $CATALINA_HOME/lib for the Datasource you have defined above.
Glassfish
...
4.1
...
Add JVM option
...
...
-Dcom.sun.enterprise.overrideablejavaxpackages=javax.ws.rs,javax.ws.rs.core,javax.ws.rs.ext
Update core glassfish-web.xml
...
right after </context-root> in core/src/main/webapp/WEB-INF/glassfish-web.xml.
...
Wildfly 8.1
Use JBossPersistenceMappingFactory
Syncope < 1.2.0
Download this file, copy it under
| Code Block |
|---|
core/src/main/resources/ |
...
| Code Block |
|---|
<entry key="openjpa.MetaDataFactory" value="org.apache.syncope.core.persistence.openjpa.JBossPersistenceMappingFactory(URLs=vfs:${project.build.directory}/cargo/configurations/jboss71x/deployments/${project.build.finalName}.war/WEB-INF/classes/, Resources=META-INF/orm.xml)"/>
|
with
| Code Block |
|---|
<entry key="openjpa.MetaDataFactory" value="org.apache.syncope.core.persistence.openjpa.JBossPersistenceMappingFactory(URLs=vfs:/content/${project.build.finalName}.war/WEB-INF/classes/, Resources=META-INF/orm.xml)"/>
|
Syncope >= 1.2.0
Download this file, copy it under
| Code Block |
|---|
core/src/main/resources/ |
and replace
| Code Block |
|---|
<entry key="openjpa.MetaDataFactory" value="jpa(URLs=vfs:${project.build.directory}/cargo/configurations/jboss71x/deployments/${project.build.finalName}.war/WEB-INF/classes/, Resources=META-INF/orm.xml)"/>
|
...
| Code Block |
|---|
<entry key="openjpa.MetaDataFactory" value="jpa(URLs=vfs:/content/${project.build.finalName}.war/WEB-INF/classes/, Resources=META-INF/orm.xml)"/>
|
Set console's jboss-deployment-structure.xml
| Note | ||
|---|---|---|
| ||
This paragraph only applies to Apache Syncope <= 1.0.5. |
Download this file and copy it under
console/src/main/webapp/WEB-INF |
.
Use DataSource
When using a DataSource, a few additional adjustments are needed.
...
Modify console/src/main/resources/configurationconsole.properties so that provided properties reflects the scheme, hostname and port number where your JEE container is running and the URL context where Syncope core will be deployed.
...
| Code Block |
|---|
scheme=http host=localhost port=90808080 pathrootPath=/syncope/rest/ |
Disable console debug
Once you are ready to deploy, you might like to get rid of Wicket debug features provided by the console. Edit console/src/main/webapp/WEB-INF/web.xml, and change development to deployment as in the following configuration fragment (from 1.1 onwards you will have to explicitly add this):
| Code Block |
|---|
<context-param> <param-name>configuration</param-name> <param-value>deployment</param-value> </context-param> |
Build and deploy
Assuming that you have created the two deployment directories defined above, just run
Syncope
...
| Code Block |
|---|
mvn clean package -Dbundles.directory=/opt/syncope/bundles -Dlog.directory=/opt/syncope/log
|
...
>= 1.2.0
| Code Block |
|---|
mvn clean package -Dconf.directory=/opt/syncope/conf -Dbundles.directory=/opt/syncope/bundles -Dlog.directory=/opt/syncope/log |
...
- Point your favorite browser to administration console at http://localhost:90808080/syncope-console/ (assuming that your JEE container is running on localhost, port 90808080)
- Login as 'admin' / 'password'