Migration Guide : 3. Upgrading from OpenROAD 3.5
 
Share this page                  
Upgrading from OpenROAD 3.5
 
Overview
Summary of the OpenROAD 3.5 Upgrade Process
Phase 1: Prepare for the Upgrade
Phase 2: Convert the Applications
Phase 3: Conduct Acceptance Testing
Phase 4: Go Live
Overview
Upgrading OpenROAD 3.5 to any release prior to OpenROAD 6.2 is straightforward in most respects, provided it is properly prepared for and carefully executed. Much of the upgrade work involves the automated correction of known upgrade 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 upgrade will be either cost-effective or of sufficient quality.
Upgrading from OpenROAD 3.5 directly to OpenROAD 6.2 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 6.2.
3. Export the application from OpenROAD 6.2.
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 6.2, the changes are irretrievably lost. This is why Actian Corporation strongly recommends that you upgrade OpenROAD 3.5 applications to OpenROAD 5.1 as an intermediate step before moving the applications to OpenROAD 6.2. 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 6.2 from XML.
3. Export the application from OpenROAD 6.2 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 6.2 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 upgrading from OpenROAD 3.5 to any version prior to OpenROAD 6.2 and their resolution. If your intent is to ultimately move from OpenROAD 3.5 to OpenROAD 6.2, you should break the upgrade process into two parts:
Part 1: Upgrade from OpenROAD 3.5 to OpenROAD 5.1 (this chapter).
Part 2: Upgrade from OpenROAD 5.1 to OpenROAD 6.2 (see Upgrading from OpenROAD 5.1).