Once you have finished developing your OpenEdge Mobile Service or OpenEdge REST Service it needs to be deployed into a test or production environment. The following steps need to be taken to achieve this:
1) Export the OpenEdge Mobile Service or OpenEdge REST Servicea) Export your OpenEdge Mobile application:
- In Developer Studio, right-click on the name of your project in the Project Explorer view and choose Export -> Mobile Web Application.
- Choose the Mobile Project name, Destination, and Mobile/REST services.
- Optionally, choose a Mobile Web App to package with the services. This is when you would like to expose your Mobile app to web browser clients.
- Click Finish. The WAR file is created and placed in the destination you selected.
- OR -
b) Export your OpenEdge REST Service:
- In Developer Studio, right-click on the name of your project in the Project Explorer view and choose Export -> REST Application.
- Choose the RESTProject name, Destination, and REST services.
- Click Finish. The WAR file is created and placed in the destination you selected.
2) Deploy the WAR file to TomcatThere are three ways to deploy the WAR file to Tomcat:
a) Manually deploying the WAR file:
Note that the Rest Application is not visible in the OE Explorer after manually copying the <application>.war file to the /webapps folder.
For the list of applications to be visible in the OE Explorer it needs to be defined in the following file in the Tomcat instance: /webapp/oerm/WEB-INF/oerm.data/oermDeployedAppList.xml
However, this file is not updated when the .war file is manually copied.
The application details need to be added manually to the oermDeployedAppList.xml file.
And then restart the Tomcat instance.
...Or use the 'Deploy' button in the OE Explorer console (see option 'b').
See more information in the following documentation page:
https://docs.progress.com/bundle/openedge-classic-appserver-administration-117/page/Managing-Web-server-deployed-REST-Web-applications-using-the-REST-Management-Agent.html
b) Deploy the WAR file through OpenEdge Explorer or OpenEdge Management:
- Click Resources in the management console menu. All resources managed by your console appear in the grid frame.
- Filter or search for the OE Web Server instance where you want to deploy the REST Web application.
- Click the OE Web Server instance. The REST Applications page appears.
- In the REST Applications section of the page, click the Deploy button.
- In the Deploy REST Application .war dialog that comes up, browse for the path and name of the WAR (.war) file for the REST Web application that you want to deploy.
- Click Deploy to deploy the REST Web application with the default settings. A confirmation message appears, and the WAR file name is identified in the REST Applications section of the REST Applications page.
- Click on the deployed REST Web application and change its properties to comply with your environment.
- Click on the Enable button to enable your REST Web application.
c) Deploy the WAR file through the restman command-line utility for environments that have a REST Management Agent (e.g. restmgr1):
- Within a Proenv environment, type in the following command to deploy the WAR file:
restman -i <rest management agent> -war <war file> -deploy
restman -i <rest management agent> -appname <service name> -enable
