CMDI 1.2 Rollout

Planned to take place in June 2016. Also see the ​rollout plan (slightly outdated in the details by now).

Detailed release workflow

Steps in order of execution

Preparation

• [] Prepare component conversion, i.e. fix/remove problematic components and profiles

VLO and harvester

• [] Validate existing harvest result (with CMDI 1.1) as a reference. Store validation results.
• [] Deploy the OAI harvester with support for CMDI 1.2, configure harvest result to CMDI 1.2
• [] Deploy the VLO version with support for CMDI 1.2

Toolkit

• [] Tag/release toolkit on GitHub, make development branch (master should be stable)
• [] Check if the toolkit is available and up-to-date at ​https://infra.clarin.eu/CMDI/1.x

Component Registry

• [] Stop the Component Registry
• [] Upgrade of all component and profile definitions within the Component Registry with the component upgrade tool
• [] Deploy and start the Component Registry version with support for CMDI 1.2

Testing

• [] Validate existing harvest result (with CMDI 1.1) to see that CMDI 1.1 records still validate (the same way). Compare to pre-deployment validation results.
• [] Run a harvest with conversion to CMDI 1.2
• [] Validate harvest results (CMDI 1.1 and CMDI 1.2)

Component conversion

A utility called the ​ComponentUpdater applies the upgrade stylesheet to all components in the Component Registry database and validates the output. If all components transform and validate successfully, it commits the changes.

Problematic components

The components (and profiles) listed by id below become invalid (with respect to schema or schematron rules) after conversion. They need to be adapted or removed before the migration.

Components that need to be fixed

• clarin.eu:cr1:c_1280305685305
  • minimal cardinality > maximum cardinality
• clarin.eu:cr1:c_131192775234
  • duplicate enumeration items
• clarin.eu:cr1:c_1311927752346
  • duplicate enumeration items
• clarin.eu:cr1:c_1311927752348
  • duplicate enumeration items

Components that can be removed

These are all unused components clearly created for test purposes.

• clarin.eu:cr1:p_1337778924929
• clarin.eu:cr1:p_1288172614022
• clarin.eu:cr1:p_1288172614024
• clarin.eu:cr1:p_1290431694477
• clarin.eu:cr1:p_1274880881900
• clarin.eu:cr1:p_1317737532981