Relevant changes

Changes in SyncopeConf table

As per SYNCOPE-457, the SMTP server configuration is defined in the mail.properties file.

Consequently, the rows withe the following four keys in the SyncopeConf table are no longer used and can be removed:

• smtp.host
• smtp.port
• smtp.username
• smtp.password

The following properties should be defined in the mail.properties file, providing appropriate values.

smtpHost=none.syncope.apache.org
smtpPort=25
smtpUser=syncope
smtpPassword=secret
smtpProtocol=smtp
smtpEncoding=UTF-8
smtpConnectionTimeout=3000
mailDebug=true

Additionally other smtp protocol configuration properties can be specified as defined by the java mail spec

Suggested procedure

Make the TODO tab empty

1. Approve or reject any pending approval
2. Manage any pending user request

Backup

Make full backup of

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

The new 1.2.X project

1. create a new 1.2.X project
2. copy any existing Java class you have developed for the former 1.1.X project and make necessary adaptations
3. include any connector bundle you might have added in the former 1.1.X project
4. configure the internal storage as done for the former 1.1.X project

Perform custom SQL upgrade

At this point you need to manually perform some SQL changes according to the description above.

An example of such changes is reported in the attached sample for MySQL: the set of SQL statements you need to run vary depending on the DBMS used for internal storage.

Enable ContentUpgrader

• In core/src/main/resources/persistenceContext.xml add (at the end of file) before </beans>:
  
  

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

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

  <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:

  <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 exception.

You should now have full access to all Syncope features.

Stop the JEE container

<version>${project.version}</version>