To upgrade an ABL Service project to OpenEdge Release 12, you have two options:

  • Create a new project in OpenEdge 12, and then copy in the source files and support files from the OpenEdge 11-based workspace.
  • Manually upgrade the existing OpenEdge 11-based project.

If you choose the latter option, then complete the following steps for each project. Performing these steps ensures that all configuration properties are fully merged into your OpenEdge 12 development environment:

  1. Copy the PASOEContent/WEB-INF/logging.xml file into the PASOEContent/WEB-INF/backup folder.
  2. Copy the %dlc%/servlets/oeabl/WEB-INF/logging.xml file into PASOEContent/WEB-INF folder. Note that this step overwrites the older logging.xml file.
  3. Copy the PASOEContent/WEB-INF/oeablSecurity.properties file into the PASOEContent/WEB-INF/backup folder.
  4. Copy the %dlc%/servlets/oeabl/WEB-INF/oeablSecurity.properties file into the PASOEContent/WEB-INF folder.
  5. Merge any changes from the PASOEContent/WEB-INF/backup/oeablSecurity.properties file into the PASOEContent/WEB-INF/oeablSecurity.properties file.
  6. Starting in OpenEdge 12.2.15, the oauth2ResSvcClients.cfg file is no longer used. The %dlc%/servlets/oeabl/WEB-INF/ directory no longer contains this file. If your existing project contains PASOEContent/WEB-INF/oauth2ResSvcClients.cfg, migrate the client ID configuration to oeablSecurity.properties:
    1. Open your existing oauth2ResSvcClients.cfg and note the client-id value in each <oauth:client> element.
    2. In PASOEContent/WEB-INF/oeablSecurity.properties, set oauth2.resSvc.clientId to those values. Use a comma-separated list for multiple client IDs (for example, oauth2.resSvc.clientId=oeablClient).
    3. Remove the oauth2.resSvc.clientCfg property from oeablSecurity.properties.
    4. Delete PASOEContent/WEB-INF/oauth2ResSvcClients.cfg.
  7. Copy the %dlc%/servlets/oeabl/WEB-INF/oeablSecurity.xml file into the PASOEContent/WEB-INF folder.
  8. Copy the %dlc%/servlets/oeabl/WEB-INF/spring folder and its contents into the PASOEContent/WEB-INF/spring folder.
  9. Copy the %dlc%/servlets/oeabl/WEB-INF/web.xml file into the PASOEContent/WEB-INF folder.
  10. Copy the %dlc%/servlets/oeabl/WEB-INF/home folder and its contents into the PASOEContent/WEB-INF folder.
  11. Copy the %dlc%/servlets/oeabl/static/common* files into the PASOEContent/static folder.
  12. Copy the contents of the %dlc%/servlets/oeabl/static/images folder into the PASOEContent/static/images folder.
  13. Create new PAS for OpenEdge instances that are based on OpenEdge Release 12, as described in Create the PAS for OpenEdge instance.
  14. Deploy the ABL Service projects as PAS for OpenEdge web applications in the newly-created PAS for OpenEdge instances.
Note: OpenEdge 12.2.15 introduces changes to Spring Security and OAuth2 configuration that may require updates to existing ABL Service projects, including the replacement of legacy security configuration files with the supported oeablSecurity.properties configuration model.

For more information, see OpenEdge 12.2.15 Spring security changes