Migrating to a New Version of unblu

Note: This section covers materials exclusive to the Super Admin and Admin roles.

Note: This Migration section is only relevant for on-premises installations. Cloud migrations are performed automatically, without the need for any customer action.

Note: Although the credentials for the Admin role allow them to see the Migration page we would strongly advise that any action taken here is at least overseen by the Super Admin. Missteps here can have serious and/or messy consequences.

In versions preceding 4.2 one could either use configuration files (default.properties and text.properties) or use a command line interface to set configuration and text values.

From version 4.2 onwards there is a GUI where you can copy and paste configurations and text in order to have those configuration and text values applied to the latest version.

Note: Migration must be performed in single steps between each version. Thus, if you want to upgrade from 3.5 to 4.3 you must first migrate from 3.5 to 4.0, then 4.0 to 4.1, 4.1 to 4.2., then 4.2 to 4.3.

Note: You must migrate both the source configurations and the text in two separate steps.

Migrating Configuration Values

1. From the main menu select Global > Configuration Migration.

Note: This procedure is the same for source and text settings (given that one uses a configuration.properties file and the other a text.properties file).

1. In Configuration migration select the appropriate Version Steps radiobutton then, from the Scope drop-down, select the appropriate scope:

   • Immutable
   • Global
   • Account
   • Area
   • Team
   • User
   • APIKey

Note: Unless you have specific reasons to do otherwise, we would recommend you always use the IMMUTABLE setting in the drop-down list. The other settings can be useful for testing, or if you have applied some specific configurations and are aware of exactly what values you wish to migrate. Most (or all) values designated at levels other than IMMUTABLE are held in the database and will be updated, if necessary, automatically upon startup of the system.

1. Paste the old configuration settings into the Source box.

1. Click the Migrate button.

Note: Unless you have specific reasons to do otherwise, we would recommend you always use the IMMUTABLE setting in the drop-down list. The other settings can be useful for testing, or if you have applied some specific configurations and are aware of exactly what values you wish to migrate. Most (or all) values designated at levels other than IMMUTABLE are held in the database and will be updated, if necessary, automatically upon startup of the system.

1. Paste the old configuration settings into the Source box.

   

2. Click the Migrate button. Note: Clicking the Migrate button does not perform the migration. See steps below for instructions on actually migrating values.

In the picture above the version is already at 4.3. But this allows you to see that in the Protocol box we are getting messages that there are no changes and that the configuration should be kept.

1. Finally, copy the values from the Destination box into your default.properties file.

Note: the Protocol box is informational and allows you to see which values will be changed and which values will not.

Migrating Text Values

This procedure is the same as Migrating Configuration Values (given that one uses a configuration.properties file and the other a text.properties file).

When you want to migrate text values select Text Migration instead of Configuration Migration.

• deployonprem