Migration Guide > Migration Guide > M. Migrating from OpenROAD 3.5
Was this helpful?
Migrating from OpenROAD 3.5
Overview
Migrating OpenROAD 3.5 to any release prior to OpenROAD 12.0 is straightforward in most respects, provided it is properly prepared for and carefully executed. Much of the migration work involves the automated correction of known migration issues covered later in this chapter. In most other cases, minimal code changes should suffice. However, certain issues need careful attention, and one may require significant work (the move away from database drivers for installations that use non-Ingres databases). It is unlikely that a completely manual migration will be either cost-effective or of sufficient quality.
Migrating from OpenROAD 3.5 directly to OpenROAD 12.0 is not recommended because the process is irreversible. To illustrate, consider the following procedure:
1. Export an application from OpenROAD 3.5.
2. Import the application into OpenROAD 12.0.
3. Export the application from OpenROAD 12.0.
4. Import the application back into OpenROAD 3.5.
The application is unintentionally corrupted by this process. For example, all button labels in the application are now missing. Unless a backup of the original OpenROAD 3.5 exported application was preserved before importing it into OpenROAD 12.0, the changes are irretrievably lost. This is why Actian Corporation strongly recommends that you migration OpenROAD 3.5 applications to OpenROAD 5.1 as an intermediate step before moving the applications to OpenROAD 12.0. Then the following procedure can be performed, if necessary, without corrupting the application:
1. Export an application from OpenROAD 5.1 to XML.
2. Import the application into OpenROAD 12.0 from XML.
3. Export the application from OpenROAD 12.0 to XML.
4. Import the application back into OpenROAD 5.1 from XML.
Note:  To preserve the integrity of the application through the export and import process, you must export and import using XML, a feature introduced in OpenROAD 5.1. If you use the original proprietary import/export technique to move an application from OpenROAD 5.1 through OpenROAD 12.0 and then back to OpenROAD 5.1, the application will be corrupted as mentioned in the first procedure. For more information, see "XML Import and Export" in the Workbench User Guide.
This chapter focuses on the known issues specific to migrating from OpenROAD 3.5 to any version prior to OpenROAD 12.0 and their resolution. If your intent is to ultimately move from OpenROAD 3.5 to OpenROAD 12.0, you should break the migration process into two parts:
Part 1: Migration from OpenROAD 3.5 to OpenROAD 5.1 (this chapter).
Part 2: Migration from OpenROAD 5.1 to OpenROAD 12.0 (see Migrating from OpenROAD 5.1).
Last modified date: 06/25/2024