To upgrade an ABL Service project to OpenEdge Release 13, you have the following two options:
  • Create a new project in OpenEdge 13, and then copy in the source files and support files from the OpenEdge 12-based workspace.
  • Manually upgrade the existing OpenEdge 12-based project.
    If you choose to manually upgrade the existing project, then complete the following steps for each project. Performing these steps ensures that all configuration properties are fully merged into your OpenEdge 13 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. If your previous installation contains PASOEContent/WEB-INF/oauth2ResSvcClients.cfg, migrate the client ID configuration to oeablSecurity.properties. Starting in OpenEdge 12.2.15, the oauth2ResSvcClients.cfg file is no longer used.:
      1. Open 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 13, 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.