Upgrading existing Orion databases to support Unicode

If you have an existing Orion database without UTF-8 support, use the OrionMigrator, component in the orion module to migrate your data into a new Rdbms database device. Set the Use Unicode Encoding Scheme property to true before you setup the OrionMigrator.

Follow this procedure to upgrade existing Orion databases to support Unicode:

Before using the OrionMigrator, first make sure you have 2 working Rdbms devices. One of those Rdbms devices will be the one already in use for your Orion App(s) and the other will be a new database.
Open the orion palette, drag and drop the OrionMigrator component into the station Services Container.
Modify the Old Db Ord option to point to the Rdbms Device that you are currently using for your Orion App(s).
Modify the New Db Ord option to point to the new Rdbms Device that you want to use for your Orion App(s).
If you plan to migrate all Orion Apps to the same Rdbms Device, then leave the App Ord List option blank. This will also move the ‘OrionAudit’ and ‘OrionAppVersion’ tables to the New DB as well.
Choose one of these Migration Type options based on the following:
- New Database — optimized for speed but throws an exception if any record already exists.
- Insert Only — if a record exists then skip it.
- Overwrite — if a record exists, overwrite it and if the update fails, stop the migration.
- Force Overwrite — if a record exists, overwrite it and ignore all errors.
  
  NOTE: If you are using the OrionMigrator with an Enterprise Security station and you have an Intrusion Zone in the station, then you must use the Overwrite option instead of New Database.
Restart the station to get the OrionMigrator into an"{Ok}" status. Right click the OrionMigrator and select Actions Migrate.
If successful, all migrated Orion Apps will have their database Ord changed to point to the new Rdbms device. You will be told how many items were migrated.

If the OrionMigrator fails, your Orion Apps will continue to function in the old Rdbms Database. No database Ords will change. There may be some data in the new database. You should repeat the procedure but use the Force Overwrite option to complete the transfer.
When finished, remove the OrionMigrator component from the station Services Container and restart the station to complete the procedure.