Calyx RIM Viewing 5.5 Data Migration Guide

Migrate Data from Calyx RIM Viewing 5.2 CHF 4 to Calyx RIM Viewing 5.4

If you are migrating from a previous version that contains a parent-child TOC structure and you want to retain the same structure, there is no need to perform the cache migration procedure.

If you have a new database, and if you want to convert the TOC structure to either the parent-child or flat structure, the following cache migration procedure must be followed. However, if you recreate cache in Viewing, the TOC structure will be created based on the settings of the attribute enableFlatTOCStructure in the config.xml.

Note: When you migrate cache, the existing cache in .zip file format will be replaced by the newly created cache. However, if you have migrated cache that is created from versions older than Viewing 5.2, with the cache format of .ser, the newly created cache in the .zip format will not replace the .ser file but will be stored along side it. It is recommended that you delete the .ser cache to free up storage space. The cache location is typically: C:\data\EDRCache
  1. Copy the Migration kit folder to your local machine, which is located in the .zip file of Viewing 5.5.
  2. Double-click the MigrationTool.jar file or the startup.bat file to open the Migration Tool window.
    Starting the migration tool via startup.bat uses the Tomcat heap space for database/cache migration.
  3. Select the Database Migration tab.
  4. Enter appropriate values in their respective fields.
    All fields are mandatory. The user credentials used should have administrator privileges on the database.
    Field Name Value
    Database Vendor Select the database platform.
    Database Host Name/IpAddress Host name or IP address of the database server.
    Database Port Number Port number used to connect to the database.
    Database Schema Name Schema name of the database which is used for Viewing.
    Database User Name Valid user name to connect to the database.
    Database User Password User password to connect to the database.
  5. Click Connect.
    The connection to the database is established.
  6. Select the tab Cache Migration.
  7. Click Browse and choose a destination to store the cache to be migrated.
  8. Select Flat Structure or Parent Child.
    Field Name Description
    Flat Structure Selecting Flat Structure shows, under Applications count, the number of applications in the repository that are not yet migrated to flat structure.
    Parent Child Selecting Parent Child shows, under Applications count, the number of applications in the repository that are not yet migrated to Parent-Child structure.
  9. Click Migrate.
    The migration process starts. The result of the migration process is displayed at the bottom of the tool.