PAS for OpenEdge supports an application deployment strategy where an ABL application and its components are deployed as an OpenEdge Application Archive (OEAR).

For more information about ABL applications, see ABL applications in Learn about Progress Application Server for OpenEdge.

To deploy an ABL application as an OpenEdge Application Archive (.oear) file, follow these steps:
  1. Obtain the OpenEdge Application Archive (.oear) file. Information about creating OpenEdge Application Archives can be found in Create an OpenEdge Application Archive using tcman export and Create an OpenEdge Application Archive using an Ant Build.
  2. On the target instance where you want to deploy the OEAR, undeploy the ROOT web application, and any web application that exists in the OEAR package. For example:
    proenv>importInstance\bin\tcman.sh undeploy ROOT OK - undeployed application 
ROOT from local directory C:\OpenEdge\WRK122\importInstance\webapps
  3. From the /bin directory of your target instance, run the tcman import command with the path to the OpenEdge Archive (.oear) file. For example:
    proenv>importInstance\bin\tcman import .\oepas1.oear Importing 
archive C:\OpenEdge\WRK122\oepas1.oear Buildfile: C:\OpenEdge\WRK122\importInstance\
temp\appimport\tlr\build.xml ablapp_deploy: BUILD SUCCESSFUL Total time: 0 seconds 
OK - deployed C:\Progress\OPENED~2\servers\pasoe\extras\oeabl.war to local directory 
C:\OpenEdge\WRK122\importInstance2\webapps as application ROOT Buildfile: 
C:\OpenEdge\WRK122\importInstance\ablapps\oepas1\tlr\build.xml ablapp_deployed: 
BUILD SUCCESSFUL Total time: 0 seconds Successfully imported oepas1 to 
C:\OpenEdge\WRK122\importInstance
    The tcman import command adds the ABL application to the openedge.properties file of the instance, adds any security policies for the ABL application to the instance, deploys all web applications to the instance, and adds their details to openedge.properties file.

    During the import into the target instance, the tcman import command reads the build.xml script for tailoring instructions and outputs them to the console. To learn more about tailoring a build.xml file, see Tailor an ABLApp installation using Ant.

A few things to note when deploying an OEAR using the tcman import command:
  • If you are deploying an OEAR into an instance with existing ABL applications or ABL web applications with the same names as those included in the OEAR package, you must undeploy those applications using tcman undeploy before importing the new OEAR file and applications. Undeploying all web applications from an ABL application removes the ABL application from the instance.
  • If your OEAR package includes a ROOT web application, you must undeploy ROOT on the target instance.
  • The tcman import command does not patch or update applications on the target instance. It replaces existing applications.

For more information about tcman import syntax and usage, see Import an ABL application (import) in PAS for OpenEdge Administration Tools Reference.