Complete Deployment & System Guide for uKnowva HRMS Attendance Sync Application

Your practical handbook to install, configure, and run seamless attendance synchronization

Version: 1.0

Date: April 28, 2026

Application Type: Windows Desktop Application (Single EXE)

Introduction: Why This Application Matters

Managing attendance data across systems can quickly become complex, especially when organizations rely on local databases while also using cloud-based HR platforms. The uKnowva HRMS Attendance Sync Application is designed to remove this gap by acting as a bridge between your internal database and your HRMS or any REST API.

This Windows-based desktop application is built for simplicity and efficiency. Since it comes as a single executable file, there is no need for complicated installations or dependency management. Once deployed, it quietly works in the background, ensuring that attendance data flows automatically, accurately, and securely.

This guide is not just a technical document; it is a complete walkthrough to help you understand what the application needs, how to set it up, and how to ensure it runs smoothly in your environment.

1. Understanding the Application at a Glance

Before diving into setup, it is important to understand what this application actually does.

The Attendance Sync Application connects your local database, whether it is MySQL or Microsoft SQL Server, to uKnowva HRMS or any API endpoint you configure. It extracts attendance data, maps it based on your configuration, and sends it securely to the destination system.

Because it is packaged as a single .exe file, deployment becomes extremely simple. You do not need a full installation wizard or multiple setup steps. Instead, you only need to ensure that the required system components are already available.

2. System Requirements: What Your System Needs

To run the application smoothly, your system must meet certain hardware and software requirements.

On the hardware side, the application is lightweight and does not demand high-end infrastructure. A basic system with a dual-core processor, 4 GB RAM, and minimal disk space can run it. However, for better performance, especially in environments with frequent syncing or large data volumes, a quad-core processor with 8 GB RAM is recommended.

The operating system must be Windows-based, specifically 64-bit versions of Windows 10 or Windows 11. The application is not compatible with 32-bit systems.

On the software side, a few dependencies are mandatory. The Microsoft Visual C++ Redistributable (2015–2022) must be installed, as it provides essential runtime components required for the application to function. If your organization uses Microsoft SQL Server, you will also need the ODBC Driver (version 17 or 18) to enable database connectivity.

Since the application communicates with APIs, a stable internet connection is necessary. Additionally, administrative privileges are required during installation and the first run to ensure proper configuration and system-level access.

 

Component

Minimum Specification

Recommended Specification

Operating System

Windows 10 (64-bit)

Windows 11 (64-bit)

Processor

1.6 GHz Dual Core

2.5 GHz Quad Core or higher

RAM

4 GB

8 GB or more

Hard Disk Space

500 MB free space

1 GB free space

Architecture

64-bit only

64-bit

3. Prerequisites: What to Install Before You Begin

Before you run the application, there are two critical components you must install.

The first is the Microsoft Visual C++ Redistributable package. Without this, the application will fail to start because essential runtime libraries will be missing. You can download it by clicking here.

The second requirement applies only if you are using SQL Server. In that case, you must install the Microsoft ODBC Driver, which allows the application to communicate with your database securely and efficiently. You can download it by clicking here.

Installing these beforehand ensures that you avoid common startup and connectivity errors.

4. Deployment Experience: Setting Up the Application

Follow the steps below to install and configure the uKnowva HRMS Attendance Sync Application on your system.

Step 1: Prepare Your System

Before installing the application, make sure your system is ready.

Install the required dependencies:

  • Microsoft Visual C++ Redistributable (2015–2022)

  • ODBC Driver for SQL Server (only if using SQL Server)

Ensure you have Administrator access on your system. This is required for installation and first-time setup.

Step 2: Download the Application

Download the application file by clicking here.

  • Click here to install uKnowvaSync.exe

Once downloaded, save the file on your system.

Step 3: Place the Application File

After downloading:

Copy the file uKnowvaSync.exe to the following recommended location:

C:\Program Files\uKnowvaSync\

This location is preferred as it keeps system applications organized and secure.

Step 4: Run the Application (First Time Setup)

Navigate to the folder where the application is saved.

Right-click on uKnowvaSync.exe and select:

Run as administrator

This step is mandatory for the first run because the application needs permission to:

  • Create system folders

  • Generate configuration files

  • Initialize security settings

Step 5: Automatic Folder Creation

After launching the application for the first time, the system will automatically create a configuration folder at:

C:\ProgramData\uKnowvaSync\

This folder will store:

  • Configuration settings

  • Field mappings

  • Log files

No manual action is required in this step.

Step 6: Configure Database & API Settings

Once the application opens:

Locate the configuration section in the application interface.

Enter the required details such as:

  • Database connection details

  • API endpoint and credentials

  • Field mapping (if applicable)

Use the available options in the interface to verify the connection before saving.

Step 7: Enable Auto-Start (Recommended)

To automate the sync process:

Find the option "Auto-start with Windows" in the application.

Enable this setting.

Once enabled:

  • The application will start automatically when the system boots

  • It will run in the background

  • No manual intervention will be required

What Happens After Setup?

Once all steps are completed:

  • The application runs silently in the background

  • Attendance data is automatically synced

  • Logs are maintained for tracking and troubleshooting

5. Behind the Scenes: Files & Folder Structure

After the first run, the application organizes its working environment by creating a structured folder inside your system directory.

This folder contains several important configuration files. Each file serves a specific purpose.

The database configuration file stores connection details in an encrypted format to ensure security. The API configuration file defines how the application interacts with the external system. The mapping configuration file ensures that fields from your database correctly match the API structure.

There is also a file dedicated to auto-sync settings, which controls how frequently data synchronization occurs. A log file keeps track of all application activities, making it easier to debug issues if they arise.

Finally, an encryption key file is generated to protect sensitive credentials. This ensures that even if someone accesses the configuration files, the data remains secure.

 

File Name

Purpose

db_config.json

Stores encrypted database connection details

api_config.json

Stores API configurations and endpoints

auto_config.json

Controls auto-sync settings

sync-log

Records application activity and errors

encryption.key

Stores the encryption key for credentials

mapping_config.json

Maps database fields to API fields

 

6. Security Design: How Your Data Stays Protected

Security is a critical aspect of any HR-related application, and this solution is built with multiple safeguards in place.

All database credentials are encrypted using AES-256 encryption, ensuring that sensitive information cannot be easily accessed or misused. The application also requires administrative privileges to run, which limits access to authorized users only.

In addition, only users who are part of the system’s Administrators group can execute the application. This prevents unauthorized usage.

For organizations that require an extra layer of protection, optional Windows login verification can be enabled, ensuring that only authenticated users can initiate the sync process.

7. Running the Application: Modes of Operation

The application is flexible in how it operates, depending on your usage needs.

If you prefer a visual interface, you can run it in normal mode by simply double-clicking the executable file. This opens the graphical interface where you can manage configurations and monitor sync activity.

For silent operation, the application supports a background mode. In this mode, it runs without displaying the interface and performs synchronization tasks automatically.

If auto-start is enabled, the application launches itself when the system starts and continues to run in the background, ensuring uninterrupted data syncing.

8. Troubleshooting: Handling Common Issues

Even with a smooth setup, there may be situations where the application does not behave as expected. Understanding common issues can help you resolve them quickly.

If the application fails to start, the most likely cause is a missing Visual C++ Redistributable. Installing or reinstalling it usually resolves the issue.

If there are problems connecting to SQL Server, it is often due to a missing or incorrect ODBC driver. Installing the correct version typically fixes the connection.

Access-related errors usually occur when the application is not run with administrative privileges. Running it as an administrator resolves such issues.

If the system tray icon does not appear or auto-start is not working, it usually means the application was not granted the required permissions during setup.

For database connection errors, verifying credentials and testing the connection using the built-in tools can help identify the problem.

Conclusion

The uKnowva HRMS Attendance Sync Application is designed to simplify one of the most critical backend processes in HR operations, data synchronization. By combining ease of deployment, strong security, and flexible configuration, it ensures that your attendance data flows seamlessly between systems without manual effort.

What makes this application truly effective is its balance between simplicity and control. It is easy enough for non-technical users to deploy, yet powerful enough to handle complex integration scenarios.

By following this guide, you can confidently set up and run the application in your environment, ensuring accurate, real-time synchronization that supports better decision-making and operational efficiency.

If needed, this setup can also be scaled or customized further, making it a future-ready solution for growing organizations.

If you face any issues during installation or configuration, you can reach out to the support team at This email address is being protected from spambots. You need JavaScript enabled to view it..

Was this Article helpful?