Installing the OpenEdge Memory Profiler tool is a straightforward process with minimal configuration. The installation script handles the setup of the PAS for OpenEdge instance, embedded database, and supporting files. Here are the step-by-step installation instructions:
  1. Launch a Proenv session to ensure the <DLC> and <WRKDIR> environment variables are correctly set.

  2. Navigate to the <oemp-install-dir> folder, where you extracted the contents of the oemp-<version>.zip file. This folder should contain an oemp directory.

  3. To view usage instructions, along with the OpenEdge version, application version, and configurable properties such as ports, run the oemp script without arguments from the <oemp-install-dir> directory:
    • On Windows:
      oemp\bin\oemp.bat
    • On Linux:
      oemp/bin/oemp.sh
    For a quick reference, the following table lists the operation shortcuts to manage the PAS for OpenEdge instance:
    Table 1. Operation shortcuts
    Command Description
    oemp help Displays the usage instructions for the oemp utility.
    oemp install Creates:
    • A new PAS for OpenEdge instance named oemp by default.
      Note: You can override the name of the PAS for OpenEdge instance during installation by setting the instance property.
    • The reportdb database.
    oemp delete Deletes the oemp PAS for OpenEdge instance and the associated reportdb database.
    Note: This command also removes all .oemp files located in the watched directories and imported data stored in the database
    oemp query Uses TCMAN to query the status of the PAS for OpenEdge instance.
    oemp startup [timeout=300] Starts the PAS for OpenEdge instance using TCMAN.

    Optionally, you can specify timeout=300 to wait up to 300 seconds for startup.
    oemp shutdown [timeout=300] Stops the PAS for OpenEdge instance using TCMAN.

    Optionally, you can specify timeout=300 to wait up to 300 seconds for shutdown.
  4. To initiate installation of the OpenEdge Memory Profiler tool, run the oemp install command from <oemp-install-dir>.
    • On Windows:
      oemp\bin\oemp.bat install
    • On Linux:
      oemp/bin/oemp.sh install
    The following table lists the configuration options and their default values applied during the installation process. These parameters define the setup of the PAS for OpenEdge instance and its associated database.
    Note: These configuration options can be overridden by specifying alternative values through the command line. For a more persistent means of adjusting values, you may change parameters in the oemp.properties file located in the <oemp-install-dir>/oemp/conf directory.
    Table 2. Installation properties
    Property Default value Description
    http 8880 Specifies the port number for HTTP connections to the PAS for OpenEdge instance.
    https 8883 Specifies the port number for secure HTTPS connections.
    shut 8884 Defines the Tomcat shutdown port used to stop the PAS for OpenEdge server.
    db_port 8896 Sets the primary service port for the database.
    db_port_min 8980 Specifies the minimum port number for dynamic database connections.
    db_port_max 8998 Specifies the maximum port number for dynamic database connections.
    wrkDir <WRKDIR> Specifies the parent directory of the PAS for OpenEdge instance. By default, the <WRKDIR> environment variable, set during the OpenEdge installation, is used to determine this location.
    instance oemp Specifies the name of the PAS for OpenEdge instance. This name is combined with wrkDir to form the full path to the instance, commonly referred to as <CATALINA_BASE>.
    The oemp install command:
    • Creates the oemp PAS for OpenEdge instance in <WRKDIR> by default.
      Note: The <WRKDIR>/oemp is referred to as <CATALINA_BASE>.
    • Extracts ABL Application files and deploys WebApps.
    • Tailors the PAS for OpenEdge instance properties with suitable defaults.
    • Sets up a self-contained reportdb database in <CATALINA_BASE>/db.
    • Creates a <CATALINA_BASE>/import to be used as a watched directory with auto-import enabled.
    • Generates the create_oemp.txt log file in the <oemp-install-dir>/oemp/bin directory.
      Note: The oemp PAS for OpenEdge instance and database are tightly coupled. Starting the instance will also start the database, and shutting it down stops both.
The next section outlines the steps for managing operation of the OpenEdge Memory Profiler tool. For more information, see Run the OpenEdge Memory Profiler tool.