Source changes
Breaking changes
Syncope 3.0.2 is the first release compliant with reproducible builds.
This implies some changes in the build process that are likely to affect the Maven projects based on Syncope 3.0.1.
In general, the following property replacements shall be made:
| 3.0.1 | 3.0.2 |
|---|---|
| log.directory | syncope.log.dir |
| conf.directory | syncope.conf.dir |
| connid.location | syncope.connid.location |
Detailed upgrade instructions are reported below.
POM
In the root pom.xml:
- change parent/version from 3.0.1 to 3.0.2
- change properties/syncope.version from 3.0.1 to 3.0.2
In fit/pom.xml:
for
cargo-maven3-plugin:
remove<log>${cargo.log}</log> <output>${cargo.output}</output>add inside
<systemProperties>:<syncope.conf.dir>${basedir}/../core/target/test-classes</syncope.conf.dir> <syncope.connid.location>file:${basedir}/../core/target/bundles/</syncope.connid.location>
Other files
In all instances of log4j2.xml:
- replace all occurrencies of
${log.directory}with${sys:syncope.log.dir}
In all instances of MasterContent.xml:
- replace all occurrencies of
${conf.directory}with${syncope.conf.dir} - replace all occurrencies of
${connid.location}with${syncope.connid.location}
Replace the following files with their 3.0.2 counterparts (re-apply any customization previously made):
- core/src/main/resources/core.properties
- console/src/main/resources/console.properties
- enduser/src/main/resources/enduser.properties
- wa/src/main/resources/wa.properties
- sra/src/main/resources/sra.properties
Deployment directories
The following instructions are related to the reference directory layout, hence might need to be adjusted depending on your actual layout.
Ensure to add the following system properties:
-Dsyncope.conf.dir=/opt/syncope/conf -Dsyncope.connid.location=file:/opt/syncope/bundles -Dsyncope.log.dir=/opt/syncope/log
Operations
If the Elasticsearch extension was enabled, a full re-index is required to keep working.
