Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents
maxLevel2
styledecimal
Source changes

Warning
titleBreaking 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.13.0.2
log.directorysyncope.log.dir
conf.directorysyncope.conf.dir
bundles
connid.
directory
locationsyncope.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

    Code Block
    languagexml
    <log>${cargo.log}</log>
    <output>${cargo.output}</output>

    add inside <systemProperties>:

    Code Block
    languagexml
    <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):

Deployment directories

Note

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:

Code Block
-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.