There could be changes in the runtimedata structure from one release to another or in the content of the essential files used by servers. So, Runtimedata Migration is essential whenever there is a need to migrate from a previous installation to the new one.
The three types of migration explained in this section are:
Migrating Standalone Profile Runtimedata
Preliminary Steps
Ensure that the below exercise is completed before you start with executable steps:
- Stop all running Event Processes and Fiorano servers in the old installer.
Clear runtimedata of the new Installation present in the $NEW_FIORANO_HOME directory. If required, take a backup of the runtimedata.
Executable Steps
Step 1: Set the required parameters in RunTimeDataMigration.properties file
To migrate a runtimedata from previous version to the new Fiorano installation, you have to first configure the RunTimeDataMigration properties file. Hence, perform the following actions before running the utility:
- Go to the location $FIORANO_HOME/esb/FioranoMigration/bin/ to find the RunTimeDataMigration.properties file.
- Open the RunTimeDataMigration.properties file and provide values for the below properties in the file:
- FIORANO_HOME:
- OLD_INSTALLER_BUILD
- NEW_ESTUDIO_WORKSPACE
- OLD_ESTUDIO_WORKSPACE
Descriptions for the parameters in the Runtimedata Migration properties file are in the table below.
Property | Description |
---|---|
OLD_FIORANO_HOME | Path to old Fiorano Installer from which runtimedata is being migrated. Example |
OLD_INSTALLER_BUILD | Provide the installer Build number of the previous installation from which runtimendata is being migrated Example |
NEW_ESTUDIO_WORKSPACE | Path to the new eStudio workspace; location to which eStudio data is to be migrated. Example |
OLD_ESTUDIO_WORKSPACE | Path to the old eStudio workspace. Location from which eStudio data is to be migrated. Example |
Step 2: Execute the Migration Script
Open console from the location $FIORANO_HOME/esb/FioranoMigration/bin and execute the following script:
The runtimedata containing the migrated data will be present in the new installation.
Migrating Shared HA Profile Runtimedata
For migrating Shared HA Profile Runtimedata, follow the same steps as illustrated in the Migrating Standalone Profile Runtimedata section, but provide the following values too in the RunTimeDataMigration.properties file:
- EXISTING_SHARED_HA_FES_DATABASES
- EXISTING_SHARED_HA_FPS_DATABASES
Descriptions for the parameters in the RunTimeDataMigration properties file are in the table below.
Property | Description |
EXISTING_SHARED_HA_FES_DATABASES | Path to the SHARED HA FES Database(s). Example |
EXISTING_SHARED_HA_FPS_DATABASES | Path to the SHARED HA FPS Database(s). Example |
Migrating Runtimedata from Replicated HA profiles to Shared HA
This migration is used when user wants to use Replicated HA profile Runtimedata for Shared HA profiles.
For migrating Shared HA Profile Runtimedata, follow the same steps as illustrated in the Migrating Standalone Profile Runtimedata section, but provide the following values too in the RunTimeDataMigration.properties file:
- REPLICATED_HA_FES_PROFILES
- REPLICATED_HA_FPS_PROFILES
- SHARED_HA_FES_DATABASE
- SHARED_HA_FPS_DATABASE
Descriptions for the parameters in the RunTimeDataMigration properties file are in the table below.
Property | Description |
REPLICATED_HA_FES_PROFILES | Replicated FES HA profile for which Shared HA Database to be created. Example |
REPLICATED_HA_FPS_PROFILES | Replicated FPS HA profile for which Shared HA Database to be created. Example |
SHARED_HA_FES_DATABASE | Path to SHARED HA FES Database. Example |
SHARED_HA_FPS_DATABASE | Path to SHARED HA FPS Database. Example |
The runtimedata containing the migrated data will be present in the new installation.
Post Migration Activities
After Migration, perform the following actions to ensure and confirm a proper migration:
- Add the latest license to the license folder present at Fiorano_Home
- After running the servers, there should not be any errors on the server console and server status should be shown in the Server Status Tab of the Dashboard (Fiorano Web Console)