...

All local classes extending default implementations such as DefaultPropagationActions, DefaultPullActions, DefaultPushActions, ... must be changed to implement the related interfaces, e.g. PropagationActions, PullActions, PushActions, ...

Pull correlation rules

For each custom JAVA PullCorrelationRule add a configuration class in package org.apache.syncope.common.lib.policy in common module of the project. For example, if you have a custom pull correlation rule class TestPullRule create a configuration class TestPullRuleConf like this:

package org.apache.syncope.common.lib.policy;

import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;

@XmlRootElement(name = "testPullRuleConf")
@XmlType
public class TestPullRuleConf extends AbstractCorrelationRuleConf implements PullCorrelationRuleConf {

private static final long serialVersionUID = 429126085793346273L;

}

Then reference the latter class from your correlation rule code with the specific annotation like this:

package org.apache.syncope.core.persistence.jpa.dao;

...

@PullCorrelationRuleConfClass(TestPullRuleConf.class)
public class TestPullRule implements PullCorrelationRule {

    @Override
    public SearchCond getSearchCond(SyncDelta syncDelta, Provision provision) {
        // your custom pull search condition
    }
}

Optional

Various methods now return Optional, rather than nullable values as before; for example:

...

DELETE FROM AccessToken;

Remove also all templates assigned to Realms and/or Pull tasks

DELETE FROM ANYTEMPLATEPULLTASK;

DELETE FROM ANYTEMPLATEREALM;

Note: if you want tamplates back you should re-create them once the procedure has finished successfully.

Workflow

The changes below will allow the new Flowable user workflow adapter to deal with the Activiti workflow definition from Syncope 2.0; more details are available in the Flowable website.

Once set, any update to the workflow definition will be automatically migrated to the new Flowable format.

Additional Maven dependencies

Add to core/pom.xml the following dependencies:

...

        <dependency>
          <groupId>org.apache.syncope.core</groupId>
          <artifactId>syncope-core-workflow-flowable</artifactId>
          <version>${syncope.version}</version>
        </dependency>

Flowable configuration adjustments

In core/src/main/webapp/WEB-INF/web.xml, replace

classpath*:/workflow*Context.xml

with

classpath*:/workflowContext.xml
classpath:/workflowFlowableContext.xml

then download workflowFlowableContext.xml, save it under core/src/main/resources and add

<bean id="flowable5CompabilityFactory" class="org.activiti.compatibility.spring.SpringFlowable5CompatibilityHandlerFactory"/>

right before </beans> and 

    <property name="flowable5CompatibilityEnabled" value="true" />
    <property name="flowable5CompatibilityHandlerFactory" ref="flowable5CompabilityFactory"/>

right after </property>.

Logging tuning

Add the following to core/src/main/resources/log4j2.xml:

    <asyncLogger name="org.activiti" additivity="false" level="ERROR">
      <appender-ref ref="mainFile"/>
      <appender-ref ref="main"/>
    </asyncLogger>

Internal Storage

The steps to upgrade the internal storage to Syncope 2.1.0 are outlined in the Reference Guide.

...