This page contains topics supporting ongoing discussion at dev@syncope.apache.org.
Tracked as SYNCOPE-753.
Essentially, we need:
- a tool generating (mostly) valid
*Content.xml
in 2.0 format, taking a 1.2content.xml
(ideally exported from a 1.2 deployment) - a "Syncope" ConnId connector which can be used to pull users and groups from an existing 1.2 deployment
- a reference migration procedure to follow
The idea is that, given an existing 1.2 deployment, one will:
- generate a new 2.0 project
- export
content.xml
from 1.2 deployment - run the migration tool to convert most of
content.xml
into someMasterContent.xml
- there are some items which cannot be directly migrated, as virtual schemas and related mappings - put the generated
MasterContent.xml
undercore/src/test/resources/domains
in the new 2.0 project - run the new 2.0 project in embedded mode while watching all logs - if errors are found, make appropriate corrections into
core/src/test/resources/domains/MasterContent.xml
- this might involve migrate 1.2 customized classes into their respective 2.0 counterparts - once errors are gone, access the admin console in embedded mode and look if every configuration item is at its place (schema, connectors, resources, mappings, notifications, ...)
- manually add the items that cannot be automatically migrated
- if using delegated administration, reconstruct roles and entitlements under the new security model
- verify that all operations (CRUD / propagate / synchronize / push) about users and roles in 1.2 are now working (CRUD / propagate / pull / push) with users and groups in 2.0
- export the working configuration and save it as
core/src/test/resources/domains/MasterContent.xml
At this point:
- add the "Syncope" ConnId connector to the 2.0 project
- start in embedded mode, define connector instance and resource for such a connector - you will need to connect to the internal storage of the 1.2 deployment
- pull users and / or groups from the newly created resource