Upgrade and Data Migration

After the upgrade of the system with app upgrade <file.ISO> or cluster upgrade <file.ISO>, any changes and updates to core model schemas need to be added to the system database. It is recommended that this step is run in a terminal opened with the screen command.

This database upgrade is carried out from the Command Line Interface (CLI) by means of voss upgrade_db. It is recommended that this step is run in a terminal opened with the screen command.

From instructions in the newly upgraded ISO, the schemas of system core models are updated as required and existing data is migrated to these updated model schemas. Schema updates would include updated version numbers and may for example add or remove new model attributes to schemas and add new default data.

Migration instructions from existing model versions to new updated versions are used to create the updated model schemas and update data to be stored in the system database.

In the case of the installation of an updated template, the app template <template_file> command will also execute any migration instructions included in the template file to upgrade the database with the updated template data.