...
Table of Contents | ||||
---|---|---|---|---|
|
Warning | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
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:
Detailed upgrade instructions are reported below. |
POM
In the root pom.xml
:
- change parent/version from 3.0.0 1 to 3.0.12
- change properties/syncope.version from 3.0.0 1 to 3.0.1
Configuration Properties
Core mail setting are now based on Spring Boot e-mail.
- 2
In fit/pom.xml
:
for
cargo-maven3-plugin
:
remove
...
Code Block language
...
xml
...
provisioning.smtp.host=none.syncope.apache.org
provisioning.smtp.port=25
provisioning.smtp.username=
provisioning.smtp.password=
provisioning.smtp.protocol=smtp
provisioning.smtp.defaultEncoding=UTF-8
provisioning.smtp.debug=false
provisioning.smtp.javamailProperties[mail.smtp.starttls.enable]=false
<log>${cargo.log}</log> <output>${cargo.output}</output>
add inside
<systemProperties>
:
...
Code Block language
...
xml
...
spring.mail.host=none.syncope.apache.org
spring.mail.port=25
spring.mail.username=
spring.mail.password=
spring.mail.properties.mail.smtp.auth=false
spring.mail.properties.mail.smtp.starttls.enable=false
Internal Storage
New indexes shall be created to improve overall performance.
PostgreSQL
Code Block | ||
---|---|---|
| ||
CREATE INDEX SyncopeUser_realm_id ON SyncopeUser(realm_id);
CREATE UNIQUE INDEX SyncopeUser_username ON SyncopeUser(username);
CREATE INDEX SyncopeUser_lower_username ON SyncopeUser(LOWER(username));
CREATE INDEX SyncopeGroup_realm_id ON SyncopeGroup(realm_id);
CREATE UNIQUE INDEX SyncopeGroup_name ON SyncopeGroup(name);
CREATE INDEX SyncopeGroup_lower_name ON SyncopeGroup(LOWER(name));
CREATE INDEX AnyObject_realm_id ON AnyObject(realm_id);
CREATE UNIQUE INDEX AnyObject_name ON AnyObject(name);
CREATE INDEX AnyObject_lower_name ON AnyObject(LOWER(name)); |
Oracle
Code Block | ||
---|---|---|
| ||
CREATE INDEX SyncopeUser_realm_id ON SyncopeUser(realm_id);
CREATE INDEX SyncopeUser_lower_username ON SyncopeUser(LOWER(username));
CREATE INDEX SyncopeGroup_realm_id ON SyncopeGroup(realm_id);
CREATE INDEX SyncopeGroup_lower_name ON SyncopeGroup(LOWER(name));
CREATE INDEX AnyObject_realm_id ON AnyObject(realm_id);
CREATE INDEX AnyObject_lower_name ON AnyObject(LOWER(name); |
MySQL | MariaDB
...
language | sql |
---|
...
<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
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.