# 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:

  ```bash
  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:

  ```bash
  mkdir C:\govapp
  ```

  <figure><img src="/files/gCKsqUFFOLufNpuxGKN6" alt=""><figcaption></figcaption></figure>

#### Download and Place Configuration File

* Download `application.yaml` from:\
  [https://ovaledge-releases.s3.ap-south-1.amazonaws.com/Release7.1.1/windows/application.yaml](https://ovaledge-releases.s3.ap-south-1.amazonaws.com/Release7.1.1/windows/application.yaml?utm_source=chatgpt.com)

  <figure><img src="/files/kxtRICZBAnTRITdAaEwr" alt=""><figcaption></figcaption></figure>
* Save it to `C:\govapp`.

  <figure><img src="/files/vATcfCxSzSImHSxGaqqQ" alt=""><figcaption></figcaption></figure>
* Customize the contents (database credentials, service URLs, etc.).

  <figure><img src="/files/7zlEDuMgD0xwsmONqLmq" alt=""><figcaption></figcaption></figure>

#### Create the Credentials Folder

* Inside `C:\govapp`, create a folder named `credentials`:

  ```bash
  mkdir C:\govapp\credentials
  ```

  <figure><img src="/files/ij2eBczK6bnSIdnzzGmB" alt=""><figcaption></figcaption></figure>

#### Place the Governance App JAR File

* Obtain `oe-gov-app.jar` from the OvalEdge support team.
* Copy the file into `C:\govapp`.

  <figure><img src="/files/jAeezeMTVfhm9yBGQKoz" alt=""><figcaption></figcaption></figure>

#### Launch the Governance App

* Open Command Prompt as Administrator.
* Navigate to the directory:

  ```bash
  cd C:\govapp
  ```
* Start the Governance App:

  ```bash
  start java -jar "oe-gov-app.jar" --spring.config.location="application.yaml" 2>nul 1>nul
  ```

  <figure><img src="/files/k4F3UvmeCr77NTTriw3D" alt=""><figcaption></figcaption></figure>
* 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.

  <figure><img src="/files/ohoIADTKovH2TZAr3GQy" alt=""><figcaption></figcaption></figure>

### Governance App Configuration in oasis.properties

#### Locate and Edit Properties File

* Navigate to the `extprop` directory in the OvalEdge installation.

  <figure><img src="/files/rlaggxnIHjo7oqLH3w6V" alt=""><figcaption></figcaption></figure>
* Open `oasis.properties` in a text editor.

  <figure><img src="/files/j1GbN6dgyCWYZiLtDWuq" alt=""><figcaption></figcaption></figure>

#### Update Governance App Settings

* Ensure the following configuration is present:

  ```properties
  governance.app.url=http://localhost:8082
  ```
* Update the host and port if using a different environment.

#### Restart Tomcat

* Open **Services** (`services.msc`).
* Locate **Apache Tomcat \[version]**.
* Right-click → **Restart**.

  <figure><img src="/files/lDzdz7GKtAz4k6PnBerh" alt=""><figcaption></figcaption></figure>

### Verification

* Wait \~5 minutes after restarting Tomcat.
* Open the OvalEdge application in a browser.
* Confirm that the Governance App is operational and integrated.

  <figure><img src="/files/mIunEV6FTvOhXOcohGmQ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

* **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)**.
  {% endhint %}

***

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

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ovaledge.com/deployment-and-maintenance/integration/governance-app-on-windows-os.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.