After installation, the OpenEdge Memory Profiler tool is available as a PAS for OpenEdge instance and can be managed like any other PAS instance.

For more information on the available options to start and stop your instance, see Start and stop a PAS for OpenEdge instance.

This section explains how to start the PAS for OpenEdge instance to launch the OpenEdge Memory Profiler tool using the provided oemp script. After you have completed working with the tool, you can gracefully terminate the PAS instance using the same script to ensure proper shutdown and resource cleanup. The oemp script supports execution on both Windows and Linux platforms. Additionally, this section describes how the oemp script manages the PAS instance through the TCMAN utility.

  1. For convenience, use the extracted oemp script to start the instance from the <oemp-install-dir> using the oemp startup command:
    • On Windows:
      oemp\bin\oemp.bat startup
    • On Linux:
      oemp/bin/oemp.sh startup
    Note:
    • On the Windows platform, a Java console window appears indicating that the instance is running.
    • To run the PAS for OpenEdge instance in the background without displaying the Java console window, you can start the instance using either the OpenEdge Command Center or the OpenEdge Management Console.
  2. To access the OpenEdge Memory Profiler tool, ensure that the oemp PAS for OpenEdge instance is running. Then launch the browser window and type the following URL:
    http://localhost:8880
    Note: Port 8880 is the default HTTP port, which you can use to access the OpenEdge Memory Profiler tool. If you specified an alternate port during installation, substitute it for 8880 in the URL.
    The OpenEdge Memory Profiler Home page appears.

    You can view two sample recordings that represent the execution of an ABL program, which generated JSON data in several iterations. The code has been instrumented with TakeSnapshot() calls to collect data with specific tags (before and after).

    For more information, see Take a memory snapshot programmatically.

    Here are the details of the sample recordings:

    • sample.leak—In this recording, undeleted JSON objects have resulted in a memory leak. The graphs on the Memory Usage page exhibit a continuous upward slope, indicating progressively increased memory usage. Snapshot analysis will reveal significant Application Memory consumption and an unusually large object count. Further inspection of the Classes view within the Snapshot page highlights an excessively high Instances Count for the Progress.Json.ObjectModel.JsonObject class, strongly pointing to a potential memory leak.
    • sample.normal—In this recording, the JSON objects have been deleted. The graphs on the Memory Usage page display a zero slope, indicating stable memory consumption over time. Snapshot analysis will reveal low application memory usage and a reduced object count. Additionally, inspecting the Classes view in the snapshots confirms the absence of object instances for Progress.Json.ObjectModel.JsonObject.
    Recordings placed in the <CATALINA_BASE>/import directory are auto-imported and appear on the Home page. You can add additional watched directories with the help of the batch configuration file. For more information, see Modify batch configuration file.
  3. Optionally, to conveniently shut down the PAS for OpenEdge instance, use the oemp shutdown command:
    • On Windows:
      oemp\bin\oemp.bat shutdown
    • On Linux:
      oemp/bin/oemp.sh shutdown

Understand the startup and shutdown behavior managed by the oemp script

The oemp script uses the TCMAN utility to manage the PAS for OpenEdge instance. When starting the instance, the oemp startup script executes the following command:

<CATALINA_BASE>/bin/tcman.[bat|sh] oeserver -v -start -archive -timeout 300 -json -array

To stop the instance, the oemp shutdown script executes the following command:

<CATALINA_BASE>/bin/tcman.[bat|sh] oeserver -v -stop -force -timeout 300 -json -array.

These commands ensure consistent startup and shutdown behavior with configurable timeout and output formatting options.

For more information on the TCMAN utility, see TCMAN.

For any issues encountered during PAS for OpenEdge instance startup and shutdown, refer to the “Identify issues through logging” section in Troubleshoot OpenEdge Memory Profiler tool installation and runtime.