Monitoring PASOE application best practices

Monitoring PASOE application best practices.
How to verify the PASOE is working as expected.
How to verify the PASOE's client sessions, connections and agent sessions
How to run the proant scripts to monitor a PASOE instance

There are several ways to use the PASOE OEMANAGER REST API's to gather information on the behavior of a running PASOE instance:

• How to call into the OEManager's REST API for insight into PASOE?
• How to enable Swagger for PASOE instance
• Where to find more about PASOE HealthScanner?

These APIs allow total flexibility while providing a wealth of information. However, in some cases a higher level of information is needed; something similar to the capabilities of the asbman command-line utility for the Classic AppServer. An equivalent command-line utility is available for PASOE.

For OpenEdge 12.8 or later
Use the oemanager command-line utility. For more details, please refer to the following documentation:
https://docs.progress.com/bundle/pas-for-openedge-management/page/OEMANAGER-utility.html

For OpenEdge 12.7 or earlier
Use the OEManager CLI Tools. Note that this is released as "as-is" code (under the Apache 2.0 license) and is not formally supported. The documentation for the OEManager CLI Tools is located at https://github.com/progress/iceberg/tree/main/PAS/Management/OEManager/ABL and https://github.com/progress/iceberg/blob/main/PAS/Management/OEManager/ABL/USAGE.md. There is an automated and a manual deployment method.

These are the basic steps for the automated deployment method:

• Download the repository with the OEManager CLI Tools by going to https://github.com/progress/iceberg , click on the green "Code" button and select "Download ZIP".
• Unzip the content and navigate to iceberg-main\PAS\Management\OEManager\ABL within a Proenv session.
• Run "proant deploy -Dpath=<Path to PASOE instance>" to deploy the OEManager CLI Tools to the relevant PASOE instance (e.g. "proant deploy -Dpath=C:\OpenEdge\122\WRK\oepas1").
• Inside the Proenv session, navigate to the "utils" directory within the PASOE instance (e.g. "C:\OpenEdge\122\WRK\oepas1\utils").
• Run the "oemanager" command to see the help output and the default values for the parameters.
• Run the "oemanager status” command to display information about the PASOE instance. Additional parameters for the oemanager command can be specified if needed, for example: "oemanager -Dscheme=https -Dhost=myhost.domain.com -Dport=8811 -Dablapp=oepas2 status"

Check the OEMgrConn.log file in case of failures.

If receiving the error "[PCTRun] No applications available. Is the PASOE instance correctly configured and running?", here are a few possible causes:

1. oemanager is NOT deployed (This is required)
2. Bad syntax, run oemanager without parameters for a list of proper syntax. 
3. Incorrect username and password
4. The instance is not running.