Where to find more about PASOE HealthScanner? - Progress Community

Loading

Skip to Main Content

Where to find more about PASOE HealthScanner?

Where to find more about PASOE HealthScanner? How to use Progress Application Server for OpenEdge HealthScanner? How to start Progress Application Server for OpenEdge HealthScanner? How to start PASOE HealthScanner? How PASOE HealthScanner collects data? Monitor PAS for OpenEdge instances Progress Application Server for OpenEdge HealthScanner

Mar 14, 2023
Knowledge

Title

Where to find more about PASOE HealthScanner?

URL Name

Where-to-find-more-about-PASOE-HealthScanner

Article Number

000184883

Environment

Product: OpenEdge Version: 12.0 and higher OS: All supported platforms Other: PASOE HealthScanner, PASOE HealthScanner

Question/Problem Description

OpenEdge HealthScanner alerts system administrators of potential problems with an instance so that the server can be taken out of service before a failure occurs. It is not designed to research or resolve the problem, only to flag a server that falls below a healthy threshold.

Steps to Reproduce

Clarifying Information

Error Message

Defect Number

Enhancement Number

Cause

Resolution

Quick HealthScanner Setup:

1) Create a regular PAS instance, for example using the command:

$ pasman create -f -p 8820 -P 8821 -s 8822 %WRKDIR%\oepas2
(the pasoe instance can also be created in the OpenEdge Explorer/Management web interface, or an existing pasoe instance can also be used)

2) Enable HealthCheck feature

$ cd oepas2\bin
$ tcman feature HealthCheck=on
$ tcman feature HealthCheck (this should confirm that the HealthCheck feature is enabled by returning 'HealthCheck=on')
$ tcman config psc.as.healthcheck.port=6899 (otherwise the default HealthCheck port 8899 will be used, the healthcheck port need to be unique for each pasoe instance on the used machine)

3) Enable the data collector in {CATALINA_BASE}\conf\appserver.properties, to read results from the probes from conf\health.config:

$ tcman config psc.as.health.enabled=true

4) Start the PAS instance

$ cd health\bin
$ tcman pasoestart -restart
$ tcman env (this should show a line like: 'manager health port: 6899' confirming that the HealthCheck feature is being used)

5) Run the PAS Health Check web app:

$ {CATALINA_BASE}/bin/oehealth[.bat | .sh] -D

The healthCheck feature requires the manager.war file to be deployed, if not already deployed it would need to be installed as well with a command like:

tcman.bat deploy %DLC%\servers\pasoe\extras\manager.war
./tcman.sh deploy $DLC/servers/pasoe/extras/manager.war

Instances created using the -Z pas or -Z prod security model do not include the needed manager.war by default.

The healthCheck feature can only be used on a pasoe instance created using the -Z pas or -Z prod security model, like this:

pasman create -Z pas -p 8840 -P 8841 mySecuredInst
after an additional webapp is added to that pasoe instance, for example using a command like:
tcman deploy -v -a public %DLC%/servers/pasoe/extras/oeabl.war oeapp1

The different pasoe security models are described on https://docs.progress.com/bundle/pas-for-openedge-management/page/About-security-models.html

If a pasoe instance was created using -Z dev and the installed oeabl.war was later on replaced with noaccess.war using commands such as:

tcman.bat undeploy ROOT
tcman.bat deploy %DLC%\servers\pasoe\extras\noaccess.war

or on Linux:

./tcman.sh undeploy ROOT
./tcman.sh deploy $DLC/servers/pasoe/extras/noaccess.war

Then an additional webapp will need to be added to that pasoe instance as well

Example healthCheck URLs:
http://localhost:6899/health?view=summary
http://localhost:6899/health?view=details
http://localhost:6899/health?view=config
http://localhost:6899/health?view=summary
http://localhost:6899/heatmap.html (this link does not return json data but a graphical representation of the health of the pasoe instance)

Further details about OpenEdge HealthScanner usage are available in the HealthScanner documentation on Progress Documentation HUB.
Manage Progress Application Server (PAS) for OpenEdge: Monitor PAS for OpenEdge instances - Use OpenEdge HealthScanner:
https://docs.progress.com/bundle/pas-for-openedge-management/page/Use-the-OpenEdge-HealthScanner.html

Workaround

Notes

Progress Articles:
12.1 PASOE Health check fails with No such attribute: HealthDetails
Guidelines and best practices for High Availability and Fault Tolerance for an OpenEdge Application.
Configuring PASOE for client server for stability.
What's the PASOE oeabl.war file?
How to deploy a secured ROOT webapp for PASOE?

Progress documentation:
https://docs.progress.com/bundle/openedge-security-and-auditing/page/Secure-the-Tomcat-Manager-and-OpenEdge-Manager-web-applications.html

https://docs.progress.com/bundle/pas-for-openedge-management/page/Access-HealthScanner-data.html

Keyword Phrase

Last Modified Date

6/3/2026 5:02 PM

OpenEdge DeploymentOpenEdge ArchitectureOpenEdge DevelopmentOpenEdge General DiscussionsOpenEdge Pro2OpenEdge RDBMS

Drop Files

Upload FilesOr drop files

Disclaimer

The origins of the information on this site may be internal or external to Progress Software Corporation (“Progress”). Progress Software Corporation makes all reasonable efforts to verify this information. However, the information provided is for your information only. Progress Software Corporation makes no explicit or implied claims to the validity of this information.

Any sample code provided on this site is not supported under any Progress support program or service. The sample code is provided on an "AS IS" basis. Progress makes no warranties, express or implied, and disclaims all implied warranties including, without limitation, the implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the sample code is borne by the user. In no event shall Progress, its employees, or anyone else involved in the creation, production, or delivery of the code be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the sample code, even if Progress has been advised of the possibility of such damages.

Loading

Where to find more about PASOE HealthScanner? - Progress Community