Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Clarified that both DDL and migration scripts must always be run

...

Info
titleWorkflow Data Migration

If you have existing workflow data in your DSpace instance, you You will also need to follow the Data Migration Procedure below.

Data Migration

...

Warning

Please note that enabling the Configurable Reviewer Workflow makes changes to the structure of your database that are currently irreversible in any graceful manner, so please backup your database in advance to allow you to restore to that point should you wish to do so. It should also be noted that only the XMLUI has been changed to cope with the database changes. The JSPUI will no longer work if the Configurable Reviewer Workflow is enabled.

...

SQL based migration can be used when the out of the box original workflow framework is used by your DSpace installation. This means that your DSpace installation uses the workflow steps and roles that are available out of the box. The migration script will migrate the policies, roles, tasks and workflowitems from the original workflow to the new workflow framework. The following SQL scripts are available depending on the database that is used by the DSpace installation:

  • [dspace]/etc/oracle/xmlworkflow/xml_workflow.sql
  • [dspace]/etc/oracle/xmlworkflow/workflow_migration.sql

or

  • [dspace]/etc/postgres/xmlworkflow/xml_workflow.sql
  • [dspace]/etc/postgres/xmlworkflow/workflow_migration.sql

You need to run both scripts (xml_workflow.sql and then workflow_migration.sql) for the DBMS you are using.

Java based migration

In case your DSpace installation uses a customized version of the workflow, the migration script might not work properly and a different approach is recommended. Therefore, an additional Java based script has been created that restarts the workflow for all the workflowitems that exist in the original workflow framework. The script will take all the existing workflowitems and place them in the first step of the XML configurable workflow framework thereby taking into account the XML configuration that exists at that time for the collection to which the item has been submitted. This script can also be used to restart the workflow for workflowitems in the original workflow but not to restart the workflow for items in the XML configurable workflow.

...