When you upgrade an OpenEdge Release 11 environment to OpenEdge 12, there are a number of tasks that you must perform to ensure that your applications and operating environment will function properly. The specific tasks that are required depend on the specific OpenEdge components that you are upgrading.

The following steps describe the general workflow of upgrading to OpenEdge 12:

  1. Prior to installing OpenEdge 12, Progress recommends that you review the following:
    • The deprecated and de-supported features and functionality that are listed in the OpenEdge 12 Platform Compatibility Guide, available on https://docs.progress.com. This document also identifies the platform requirements for installing and running OpenEdge 12.

      See also Before You Install in Install OpenEdge.

    • OpenEdge 12 Release Notes.
  2. Install the OpenEdge 12 software.
  3. Complete the database upgrade steps described in Convert an OpenEdge Release 11 Database to OpenEdge Release 12.
    Note: When your existing database is enabled for Transparent Database Encryption (TDE) and uses the RC4 encryption algorithm for any of its tables, indexes, LOBs, or areas, you must change the TDE policy for each RC4-encrypted object to use an encryption algorithm that is supported in OpenEdge 12. You must perform this update before you convert your database to version 12, as described in Convert an OpenEdge Release 11 Database to OpenEdge Release 12.
  4. Upgrade your application development environment, described in Development Environment Upgrade Tasks.
  5. Optionally, create a new PAS for OpenEdge instance.
  6. Rebuild all applications in your OpenEdge 12 development environment. When upgrading your ABL applications, note the tasks described in Upgrade ABL Applications.
    Note: Progress recommends Progress Developer Studio for OpenEdge for use on development systems only. To upgrade your OpenEdge applications that are deployed in a production environment, first recompile and update them on a development system, then export the upgraded applications to the OpenEdge production system.
  7. Update system configuration property settings as required, described in OpenEdge Management AdminServer Configuration Upgrade.
  8. Upgrade OpenEdge security as described in Upgrade Security to OpenEdge 12.
  9. Be sure to read the information described in Migration notes.
  10. When promoting your upgraded applications to testing, staging, and production environments, be sure to install OpenEdge 12 in those environments and create new PAS for OpenEdge instances that are based on OpenEdge 12.