Try OpenEdge Now
skip to main content
Administration
REST Administration : REST Management Agent Administration : Installing and Configuring REST Management Agent : Installing a REST Management Agent on a DMZ server
 
Installing a REST Management Agent on a DMZ server
A DMZ server is a server that does not allow you to open untrusted network ports. Since the AdminServer uses ports that might be interpreted as untrusted, the standard REST Management Agent configuration might not run on such a server. The REST Management Agent supports a remote configuration to work around this issue. The remote configuration installs only enough of OpenEdge on the remote server to run the REST Management Agent. This installation includes the REST Management Agent Java Servlet and the files used to support its local configuration.
The remote REST Management Agent uses a ubroker.properties file with a limited set of static startup parameters. You must manually edit this file to change the REST Management Agent instance's static configuration properties.
You can continue to administer the remote REST Management Agent's dynamic run-time properties and deploy and manage REST services by mapping it to an AdminServer on the Intranet behind the DMZ server.
To run a remote REST Management Agent configuration:
1. Install the remote REST Management Agent, oerm.war, on the DMZ server. Manually edit the static startup parameters in its ubroker.properties file and install the REST Management Agent as a Web application in the local Web server's Java container.
2. Start the REST Management Agent in the Web server's Java container, and verify that a browser can access its URL from the Internet.
3. Connect to an AdminServer on the Intranet and configure a "remote" REST Web application instance using OpenEdge Management/OpenEdge Explorer or the RESTMAN utility by specifying the remote REST Management Agent's URL. For details, see the OpenEdge Management/OpenEdge Explorer online help.
The Intranet AdminServer creates a REST Management Agent's mapping entry in its local ubroker.properties file with the URL of the remote REST Management Agent's administration REST service.
4. Use OpenEdge Management/OpenEdge Explorer or the RESTMAN utility to manage the remote REST Management Agent's dynamic run-time properties and deploy and manage the REST Management Agent's REST services.
OpenEdge Management or OpenEdge Explorer connects to the Intranet AdminServer where you mapped the REST Management Agent, and then connects to the remote REST Management Agent's REST administration service. When OpenEdge Management or OpenEdge Explorer sends an operation to the Intranet AdminServer, the AdminServer turns it into a REST message and forwards it to the REST Management Agent's REST administration service which executes the operation.