Loading a Migration Set

Once the set has been built on the source environment, it becomes visible to target environments that are set up to monitor the source environment.

Migration sets are pulled into target environment using Data Set Operation Integration Point 1) Import from File or 2) Import From Environment options.

In addition to business rule violations, the import process can return the following messages:

Code	Severity	Text
GEN-MIGR-001	Fatal	Cannot find {entity} with key {code or usage name} used by {entity, key}
GEN-MIGR-003	Fatal	Cannot find OhiTable with Name {name} used by {entity, key}
GEN-MIGR-004	Fatal	Cannot find Signature with Name {name} and Subtype {subtype} used by {entity, key}
GEN-MIGR-005	Fatal	Cannot find usage for dynamic field or record {usage name} on {table name} used by {entity, key}
GEN-MIGR-006	Fatal	The dynamic field usage ({name}, {table name}) is not compatible with the existing configuration
GEN-MIGR-007	Fatal	The import file must have a .zip extension
GEN-MIGR-009	Fatal	It is not possible to start a new import while another import or build is in progress
GEN-MIGR-013	Fatal	The migration process failed due to technical issues
GEN-MIGR-015	Fatal	The migration process failed due to non-compatible application-version {application-version}

Note that each configuration item is inserted, updated or deleted on the target environment as a separate transaction. This means that the failure inserting, updating or deleting a single configuration item does not prevent the rest of the payload to migrate.

To ensure consistent processing results, it is recommended to have no active exchanges in processing.

Preventing Configuration Migration between applications & major versions

OHI does not support config migration between a source and, a target that are not on the same release. Doing so can break the system without means of recovering.

To limit this:

• At the time for export, a file containing application and version information is attached automatically to Configuration Migration Set, export zip (Ex: Policies - 3.30.3.0.0). System encrypts this information in the file.

• At the time of import, system reads the file in the Zip and validates the version attached to it with the version of target environment.

• The application does not support configuration migration between a source and target environment that are not on the same major release. If you try to import a configuration migration file that violates this business rule, the system returns message GEN-MIGR-015.

  • GEN-MIGR-015 | The import failed because the source environment {source release number} and, the target environment {target release number} are not the same.