Try OpenEdge Now
skip to main content
Administration
REST Administration : REST Web Application Administration : Managing REST Web applications : Republishing a REST Web application
 
Republishing a REST Web application
In a development environment, you must use the RESTMAN utility's republish command to redeploy (that is, republish) a REST Web application that is deployed on a Web server. The republish command redeploys only the selected files that you specify in the command to their corresponding locations in the REST Web application's folder on the Web server.
Typically, when REST Web application developers have to redeploy and test their applications after updating a few files, such as add or modify a REST Web service (.paar) at %CATALINA_BASE%\webapps\app-name\WEB-INF\adapters\app-name, they use the RESTMAN utility's republish command, not the deploy command.
Using the RESTMAN utility's republish function helps:
*Reduce network latency: The republish command only redeploys the changed set of the REST Web application, not all the files of the Web application (which the deploy function does). This reduces network latency.
*Avoid Locked JAR errors (in Windows): Sometimes, the deploy command fails to redeploy a REST Web application because the Web server encounters a locked JAR file because of the way file-locking is implemented in Windows. In such a case, we must use the republish command to successfully redeploy the REST Web application. The republish command deploys only the selected files you specify in the command instead of deploying all the REST Web application files, which helps avoid any locked JAR errors.
Note: The republish function throws an error when you try to redeploy a REST Web application that does not have the same folder structure as that of the application instance that exists in the Web server.
If you receive errors while using the republish option, use the RESTMAN utility's deploy function to deploy a fresh instance of your REST Web application. For more information about the deploying a fresh instance of a REST Web application, see Deploying a REST Web application.
For more information about using RESTMAN to republish a REST Web application, see RESTMAN republish (Application). For more information about using OpenEdge Management or OpenEdge Explorer to deploy a REST Web application, see the OpenEdge Management and OpenEdge Explorer: Configuration manual, or the OpenEdge Management or the OpenEdge Explorer Help.