Try OpenEdge Now
skip to main content
Command and Utility Reference : RESTMAN republish (Application)

RESTMAN republish (Application)

Redeploys only those files that you specify in the command to their corresponding locations in the Web application folder on a Web server.
You can add, update, or delete files from the REST Web application using the republish command.


Operating system
   -name instance-name
   -appname application-name
   -filename[file-name.paar|.zip ]
-name instance-name
The name of the REST Management Agent instance.
-appname application-name
The name of the REST Web application.
-filename[file-name.paar | ]
The name of the REST Web application's paar file or the name of the ZIP file (that contains all the files according to the folder structure of the REST Web application) that you want to republish.
For example, if you want to publish a new or an already deployed paar file of a Web application on the Web server, then you must provide the file-name.paar filename and extension in the syntax.
For other files in the REST Web application project, you must create a ZIP file with all the files that you want to republish, placed according to the folder structure of the REST Web application on the Web server, and then republish it using the republish command. For example, if you have a REST Web application, myApplication, on the Web server, and if you want to republish the Web application's security configuration file, appSecurity-anonymous.xml, at the Web server location apache-tomcat-instance\webapps\myApplication\WEB-INF\, you must place the security file in a folder with the folder structure myApplication\WEB-INF\adapters\appSecurity-anonymous.xml, and compress it as and specify in the republish command.
You can also create the above ZIP file using the RESTGEN utility. For more information on RESTGEN utility, see RESTGEN.
Note: You must add the versionInfo.json file to your ZIP file if you want to delete any file from the REST Web application, or if you want to simultaneously update, add, and delete files using the RESTMAN republish command. For more information on creating and adding the versionInfo.json file to your ZIP file, see Deleting a REST Web application's files.


The republish command throws an error if you try to redeploy a REST Web application that does not have the same folder structure as that of the application in the Web server. If an error occurs while using replublish, you can use the RESTMAN utility's deploy command to deploy a fresh instance of the REST Web application. For more information about deploying a fresh instance of a REST Web application, see RESTMAN deploy.