Versions Compared

Key

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

...

  1. the internal storage
  2. your 1.01.X project's (the one created from archetype) sources
  3. configured bundles and logs directories

...

An example of such changes is reported in the attached sample for MySQL (this file is also present in resources of core-upgrader module of the project): the set of SQL statements you need to run vary depending on the DBMS used for internal storage.

...

  • In core/pom.xml add following dependency from core-upgrader module:

    Code Block
    languagexml
    <dependency>
      <groupId>org.apache.syncope</groupId>
      <artifactId>core-upgrader</artifactId>
      <version>${project.version}</version>
    </dependency>
  • Again in core/pom.xml add resource after <resources> tag as follows:

    Code Block
    languagexml
    <resource>
      <directory>../core-upgrader/src/main/resources</directory>
      <filtering>true</filtering>
      <includes>
        <include>upgradeApplicationContext.xml</include>
      </includes>
    </resource>

Build, deploy and run

This first run should succeed without logging any exceptionBuild project, deploy to choosen container and run it. The first run should log exceptions about ContentInitializer (in particular about creation of resources, connectors, etc), but this is normal.

You should now have full access to all Syncope features.1.2.X features and at this point Syncope is fully-working and container has no need to be restarted.

Nevertheless is recommended to deploy again Syncope (upgraded) project without core-upgrader dependencies, in fact if container is started with "enabled" core-upgrader, some exceptions

will be noticed due to failure of upgrade task; but despite this few exceptions (after restart) no persistent changes are made to Syncope 1.2.X and it remains in a solid and working state.

Therefore following steps are optional (but recommended): 

Stop the JEE container <version>${project.version}</version>and follow below steps.

Disable ContentUpgrader

In core/src/main/resources/persistenceContext.xml remove last import:

Code Block
languagexml
<import resource="classpath*:upgradeContext.xml"/>

and from core/pom.xml remove dependency from core-upgrader and resource added two steps before.

Build, deploy and run

This final run should log no exceptions and you can enjoy all Syncope 1.2.X new amazing features!