Set migration settings

How to ... ››
Parent Previous

Migration Settings



Description


When migrating an existing Octobox configuration file (OCF) from one environment to another, the settings related to the new environment can be set automatically while importing the OCF.


The settings to replace are listed and defined in a migration file that is selected in the migration setting on the configuration window.

The substitution can be performed on the paths and URLs defined in an OCF.



Location



The migration XML is selected in the configuration window and can be found just below the main configuration definition.



Defining migration settings


For each setting to replace a 'ConfigMigrationItem' must be added.

In each item 2 settings must be entered:



List of Predefined Properties




Example of a migration file replacing a string by another string


<?xml version="1.0" encoding="utf-8"?>

<ConfigMigration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<Items>

<ConfigMigrationItem>

<SearchText>\\\\MyOldServerName\\ACC</SearchText>

<ReplaceText>\\MyNewServerName\PRD</ReplaceText>

</ConfigMigrationItem>

</Items>

</ConfigMigration>


In the above sample a migration item is defined that automatically replaces each occurrence of the search text '\\myoldservername\acc'

with the text '\\MyNewServerName\PRD' in a selected configuration file.



Example of a migration file replacing the value of a predefined property by another value


<?xml version="1.0" encoding="utf-8"?>

<ConfigMigration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<Items>

<ConfigMigrationItem>

<SearchText>[FolderLogging]</SearchText>

<ReplaceText>\\MyNewServerName\PRD\Logging</ReplaceText>

</ConfigMigrationItem>

</Items>

</ConfigMigration>


In the above sample a migration item is defined that automatically replaces each value of the occurrence of the predefined property 'FolderLogging'

with the text '\\MyNewServerName\PRD\Logging' in a selected configuration file.