Environment migration

Owned by Paul Pingaud (Deactivated)
Last updated: Oct 27, 2022 by Miguel Correa Calvo
3 min read

Multiple environments are available to validate setup.
Setup that has been validated on test environment can be easily transferred and deployed on production one thanks to migration feature.

Eligible elements for migration

Some configuration settings and data can be exported and imported.

  • Ruleset chainings:
    This is including all rulesets related to it.

  • Rulesets
    This is including timetables, groups and stock requests related to it.

  • Backoffice parameters:
    This sections includes all parameters defined in Settings page of the admin websites (like Orders, Stock, Orchestration, Stock locations, Items, Delivery and Languages).

  • Delivery config
    This is including routes, areas, metrics, execution times (of delivery config and of store locations related to areas) and delivery restrictions.

Migration is ONLY limited to admin website parameters, site config is NOT eligible for migration.
Translations are NOT eligible for migration.

Export is designed to ease user selection by hiding internal mechanism.
Some elements are including others, it is NOT possible to deny export of included elements.
It is NOT possible to select low level elements.

Export environment config

  1. Connect to admin website of the environment that has to be exported

  2. Go to Configuration → Migration (top right)

  3. Go to Export Environment.

  4. Select the elements to export.

  5. Click on Export button to download locally an export document.
    Some delay may occur before download start, due to generation of document.
    Duration of download depends on exported data and bandwidth.
    Export is based on live version. Draft is NOT included into export.

The module has moved. You can now find it at Configuration → Migration (top right)

Exportation of environment configuration

Import environment config

  1. Connect to admin website of the environment that has to import data.

  2. Go to Configuration/Migration

  3. Go to Import Environment.

  4. Upload export file from local storage
    Duration of upload depends on exported data and bandwidth.
    List of all elements included in export file is displayed.
    Elements that will be added or overwritten are identified.

  5. Select elements to import.

  6. Click on Import button to import data into the environment.
    System will perform a validity check on data.
    Based on content, some warnings may be displayed. Please follow instructions to fix data.

  7. If delivery configs are part of imported data, a draft will be created.
    Draft can be instantly published or delayed.
    If draft publication is NOT performed at end of importation, draft content can be modified and published like any draft (Go to Delivery page and open draft).

Importation of environment configuration