Migration process phases
There are three phases in the data migration process: preparation, migration, and maintenance.
![Migration process phases](../images/migration_phases.gif)
Preparation
Before you begin the data migration, analyze and prepare your data in IBM® Engineering Requirements Management DOORS® ( DOORS ):- Assess the value of the overall migration effort.
- Identify potential risk areas that might have an impact on migration.
- Run the Migration
Metrics utility to assess the data that you want to migrate:
- Examine the shape and size of the data; for example, the number of objects, links, OLE objects, and attributes.
- Consider the hygiene of the data in terms of the consolidated type system. Determine the number of attributes of each type and how similar are they to each other. Remove attributes that have no business value in future work.
- Harmonize type systems to avoid the proliferation of artifact types in IBM Engineering Requirements Management DOORS Next.
- Check for differences in case sensitivity.
- Check for inconsistent enumeration values in attributes that share a common name.
For example, consider a scenario in which you have a custom attribute "Importance" in two modules and the attributes were created by using different enumeration types. You might see the following output in your Migration Metrics results:
You can do one of three options:- Do nothing and allow Engineering Requirements Management DOORS Next to create different attribute types while the package is imported.
- Rename one or both attributes for a more specific name, such as "Stakeholder Importance".
- Revise the type in one attribute to match the other, so that the enumeration values are the same in both attributes.
- Convert Layout DXL. Migration of Layout DXL is not supported; however, columns you can convert Layout DXL to Attribute DXL. The calculated values for Attribute DXL are migrated.
- Simplify tables. DOORS supports complex table structures. For best results, simplify the table structure before migrating tables.
Migration
The migration phase can occur over a long time. While it might be advantageous to migrate some project data in the near term, you might need to retain some active project data in DOORS for years. Prioritize your project data and migrate it incrementally when business needs justify the migration. To avoid overloading the content in Engineering Requirements Management DOORS Next, do not migrate completed projects. Instead, focus on current and future work that can benefit from the capabilities in Engineering Requirements Management DOORS Next.
To migrate modules after you complete your preparation, do these migration tasks:
- Create migration packages in DOORS .
- Export these packages and then import them into Engineering Requirements Management DOORS Next.
- After modules are successfully imported into Engineering Requirements Management DOORS Next, update the status of the modules in DOORS .
Maintenance
After the migration packages are successfully imported, the original data is maintained in DOORS as a historical archive. Links to the data in DOORS are created when the packages are imported into Engineering Requirements Management DOORS Next. Users can use these links access history, baselines, discussions, and other data that was not included in the migration. All new work on the data is done in Engineering Requirements Management DOORS Next. Your teams can use both the DOORS client and the IBM Engineering Requirements Management DOORS - Web Access (DWA) client to review the historical data. Work in Engineering Requirements Management DOORS Next can include these activities:
- More harmonization of artifact types.
- Typical administrative tasks to set up team areas, users, and access controls.
As a one-time occurrence, the migration capability does not update any changes to the data in both tools. After migration, teams can continue to exchange data from Engineering Requirements Management DOORS Next and DOORS with customers, suppliers, and other stakeholders by using ReqIF and other formats. However, this data is local in the application where it is exchanged. The data is not updated automatically in the other application that was involved in the migration.