Governance App Deployment on Linux with Load Balancer

The Governance Apps allow enterprises to create mini-apps that leverage customized forms to conduct surveys and campaigns for governance activities.

This article explains the Governance App deployment process in a Linux environment, including prerequisites and configuration steps.

Prerequisites

• Sudo Access Required to create and manage the gov-app systemd service file.

• Internet Access Needed to download the application.yaml file. If internet access is unavailable, ensure application.yaml is already present in the governance folder.

• Java

  • Java 1.8 is required.

  • Verify installation with:

    Copy

    java -version

• Memory Requirements Minimum 2 GB RAM.

• Load Balancer (Optional) When using a load balancer, configure the domain name and SSL certificates in the same manner as for the main OvalEdge application.

Installation Steps

Governance App Installation

• Create Governance Folder

  • Open a terminal window.

  • Navigate to the OvalEdge home directory.

  • Create a folder named governance by running the following command

  Copy

  mkdir ~/governance

• Download YAML Configuration File Obtain application.yaml from the provided the following link.

• Update Configuration File

  • Add database connection details.

  • Supported credential providers:

    • Default (credentialProvider: default) → credentials stored directly in YAML

      
    • AWS Secrets Manager (credentialProvider: aws) → provide secret keys for jdbcstring, username, and password

      

      
    • Azure Key Vault (credentialProvider: azure) → provide secret keys for jdbcstring, username, and password

      

      
• Create Credentials Folder

  Copy

  mkdir ~/governance/credentials

  Update the path to this folder in application.yaml.

  
• Place Governance App JAR File Copy oe-gov-app.jar into the governance folder.

Service Setup

• Create Service File Navigate to /etc/systemd/system/ and create oe-gov.service:

  Add the following content:

  
• Enable and Start Service

Integration with OvalEdge

• Update Oasis Properties In the OvalEdge installation directory, edit extprop/oasis.properties and configure the Governance App URL:

  
• Restart Tomcat

Verification

• Access the health endpoint to verify service status:

  
• In OvalEdge:

  • Log in as an administrator.

  • Navigate to Administration > System Settings > Others.

  • Locate the Gov App Key setting and update its value with the Governance App domain name.

    

Troubleshooting

• Port Conflicts Ensure the port defined in application.yaml is available and not blocked.

• Log Files Use journalctl -u oe-gov -f to view logs if the service fails to start.

• Configuration Issues Recheck application.yaml and oe-gov.service for errors if deployment fails.

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