Governance APP on Windows OS

This article outlines the steps required to install and configure the OvalEdge Governance App on a Windows-based system.

Purpose

  • Enable standalone deployment of the Governance App on a Windows machine.

  • Integrate the Governance App with the OvalEdge platform.

Prerequisites

System Requirements

  • Windows Operating System: Windows 10/11 or Windows Server 2016+.

  • Administrative access to the Windows machine.

Java

  • Java Development Kit (JDK) must be installed.

  • Java must be available in the system PATH.

  • Verify installation:

    java -version

Internet Access

  • Required to download dependencies such as the application.yaml file.

Required Permissions

  • Ability to create directories on C:\.

  • Permission to execute .jar files from the command prompt.

  • Ability to open ports (ensure port 8082 is not blocked or in use).

Required Files

  • oe-gov-app.jar – provided by the OvalEdge team.

  • application.yaml – download from the official release link.

  • Access to oasis.properties – located in the extprop directory of the OvalEdge setup.

Tomcat Access

  • Permission to restart the Tomcat service on the OvalEdge host machine.

Installation Steps

Create the Installation Directory

  • Open File Explorer or Command Prompt.

  • Create a directory named govapp on the C: drive:

Download and Place Configuration File

Create the Credentials Folder

  • Inside C:\govapp, create a folder named credentials:

Place the Governance App JAR File

  • Obtain oe-gov-app.jar from the OvalEdge support team.

  • Copy the file into C:\govapp.

Launch the Governance App

  • Open Command Prompt as Administrator.

  • Navigate to the directory:

  • Start the Governance App:

  • Outcome: The Governance App runs in the background.

Port Availability

  • Ensure port 8082 is available and not blocked by firewalls or in use.

  • This port is required for Governance App access.

Governance App Configuration in oasis.properties

Locate and Edit Properties File

  • Navigate to the extprop directory in the OvalEdge installation.

  • Open oasis.properties in a text editor.

Update Governance App Settings

  • Ensure the following configuration is present:

  • Update the host and port if using a different environment.

Restart Tomcat

  • Open Services (services.msc).

  • Locate Apache Tomcat [version].

  • Right-click → Restart.

Verification

  • Wait ~5 minutes after restarting Tomcat.

  • Open the OvalEdge application in a browser.

  • Confirm that the Governance App is operational and integrated.

  • Port Conflicts: If port 8082 is in use, modify application.yaml to specify another port.

  • Log Files: Check the Command Prompt window for runtime logs if the application does not start.

  • Optional Service Setup: For persistent execution, wrap the JAR as a Windows service using a tool like NSSM (Non-Sucking Service Manager).


Copyright © 2025, OvalEdge LLC, Peachtree Corners, GA, USA.


Last updated

Was this helpful?