Salesforce

manager and host-manager web applications are not deployed by default when creating a new Progress Application Server for OpenEdge (PASOE) instance.

« Go Back

Information

 
Titlemanager and host-manager web applications are not deployed by default when creating a new Progress Application Server for OpenEdge (PASOE) instance.
URL Namemanager-and-host-manager-web-applications-are-not-deployed-by-default-when-creating-a-new-Progress-Application-Server-for-OpenEdge-PASOE-instance
Article Number000118226
EnvironmentProduct: OpenEdge
Version: 11.7x, 12.x
OS: All supported platforms
Other: PASOE
Question/Problem Description
Tomcat Manager and OpenEdge Manager Web applications are not deployed by default when creating a new Progress Application Server for OpenEdge (PASOE) instance.

When creating a PASOE from the command line tool, Tomcat Manager (manager.war) and OpenEdge Manager (oemanager.war) Web applications are not deployed by default .
Steps to Reproduce1. Create an new PASOE instance in Development mode using one of the following commands:

${DLC}/bin/pasman create -Z dev -p 11080 -P 11443 -s 11445 -N oepasdev1 ${WRKDIR}/oepasdev1
${DLC}/servers/pasoe/tcman create -Z dev -p 11080 -P 11443 -s 11445 -N oepasdev1 ${WRKDIR}/oepasdev1

Where:
${DLC} : The OpenEdge installation base directory path
${WRKDIR} : The OpenEdge working directory path


2. Observe that the manager.war and oemanager.war Web application archives are missing from ${WRKDIR}/oepasdev1/webapps.
Clarifying Information
Creating a new PASOE instance using the pasman or tcman command line tool without  the -f option.
The -f option copies all deployed web application archives (.war files) from ${DLC}/servers/pasoe/webapps to the new instance.

There are two Tomcat Web applications that provide remote online administration access: 
  • Manager application (manager.war) allows you to manage web applications, including deployment and stopping and starting web applications. 
  • Host Manager (host-manager.war) allows you to manage virtual hosts.

In PAS for OpenEdge, a Java Web application, OpenEdge Manager (oemanager.war), is deployed instead of the Tomcat Host Manager (host-manager.war). The oemanager.war application provides a REST API for remote administration of the OpenEdge Web applications and ABL language engines. It duplicates the same administration API supported by Tomcat's JMX interface, but it uses JSON input/output payloads instead. It is required to support OEE/OEM management and monitoring of ABL applications.
 
Error Message
Defect NumberOCTA-16592
Enhancement Number
Cause
Standard Tomcat configuration files and applications (like host-manager.war) are preserved in ${DLC}/servers/pasoe/extras.

This is expected behavior. The Tomcat manager and OpenEdge Manager Web applications are never deployed by default with either Development or Production instances.

A documentation defect has been logged to provide clarification over that default behavior.
Resolution
  • If you have installed the PAS for OE Dev product
The manager.war and oemanager.war are installed into the ${DLC}/servers/pasoe product. 
Subsequently, you can choose to deploy those installed remote administration web applications (manager.war & oemanager.war) from the PAS for OE installation into newly created instances using the pasman  create or tcman create command with the -f option.

For instance, with the pasman command:
${DLC}/bin/pasman create -f -Z dev -p 11080 -P 11443 -s 11445 -N oepasdev1 ${WRKDIR}/oepasdev1
 
  • If you have only installed the PAS for OE Prod product
For security reasons, manager.war and oemanager.war are not part of the default set of applications that can be deployed in with the production license using the pasman  create or tcman create command with the -f option.
The manager.war and oemanager.war are therefore NOT  present in the ${DLC}/servers/pasoe/webapps product.  

The manager.war and oemanager.war web apps can be found in the ${DLC}/servers/pasoe/extras/ directory and manually installed into a production instance on-demand, using the following set of commands: 
 
${DLC}/bin/pasman create -Z prod -p 10080 -P 10443 -s 10445 -N oepasprod1 ${WRKDIR}/oepasprod1
${WRKDIR}/oepasprod1/bin/tcman deploy ${DLC}/servers/pasoe/extras/manager.war
${WRKDIR}/oepasprod1/bin/tcman deploy ${DLC}/servers/pasoe/extras/oemanager.war


Similarly, for both PAS for OE Dev and PAS for OE Prod license, Standard Tomcat configuration files and applications (like host-manager.war) are preserved in ${DLC}/servers/pasoe/extras.
Therefore, if you need to deploy the Tomcat host manager application (host-manager.war) to an existing instance run:
 
${WRKDIR}/oepas1/bin/tcman deploy ${DLC}/servers/pasoe/extras/host-manager.war


 
Workaround
Notes
References to Other Documentation:
"Introducing PAS for OpenEdge: Apache Tomcat and the Progress Application Server for OpenEdge : Manager applications", OpenEdge 11.7 Documentation, documentation.progress.com/output/ua/OpenEdge_latest/index.html#page/pasoe-intro/manager-applications.html
“Development Server and Production Server Security Issues.” OpenEdge 11.7 Documentation, documentation.progress.com/output/ua/OpenEdge_latest/index.html#page/pasoe-admin/development-server-and-production-server-securit.html.

“Administrative tools: PASMAN” OpenEdge 11.7 Documentationdocumentation.progress.com/output/ua/OpenEdge_latest/index.html#page/pasoe-admin/pasman.html
“Administrative tools: TCMAN” OpenEdge 11.7 Documentationdocumentation.progress.com/output/ua/OpenEdge_latest/index.html#page/pasoe-admin/tcman.html
 

Keyword Phrase
Last Modified Date2/15/2023 5:49 PM

Powered by