How to Setup and Configure LIS Agent

How to Setup and Configure LIS Agent

Overview

Integration with medical laboratory equipment into an Electronic Medical Record (EMR) system is crucial for seamless data exchange, reducing manual input errors, and improving workflow efficiency in healthcare facilities. To address this challenge, Ksatria Medical Systems (KMS) provides the LIS Agent.

The LIS Agent is a Java application designed to connect to a database and perform various tasks, especially to connect to laboratory equipment to fetch and update the examination results.
This guide provides step-by-step instructions to set up the application, configure it to run automatically on Windows startup, set environment variables, and run in the background.

Prerequisites

Installation Steps

1. Prepare the Application Files

  1. Create a folder for the LIS Agent, e.g., C:\Program Files\LIS Agent.

  2. Copy the following files into this folder:

    • agent-0.0.1-SNAPSHOT.jar (The LIS Agent application JAR file)

    • start-lis-agent.bat (Batch script to start the application)

2. Set Environment Variables

To ensure the application can access the necessary configuration, set the following environment variables:

Step 1: Open System Properties

  1. Right-click "This PC" or "My Computer", then select "Properties".

  2. Click on "Advanced system settings".

  3. Click on the "Environment Variables" button.
  4. Alternatively, you can use search and find the "Edit the system environment variables".

Step 2: Add New Variables

  1. Under "System variables" or "User variables", click "New".
  2. Add the following variables one by one:

    1. LIS_DB_HOST = localhost
    2. LIS_DB_NAME = [your_database_name]
    3. LIS_DB_USERNAME = [your_database_username]
    4. LIS_DB_PASSWORD = [your_database_password]
    5. LIS_HIS_AUTH_URL = https://[your_subdomain].ksatria.cloud/api/online/registration
    6. LIS_HIS_LAB_URL = https://[your_subdomain].ksatria.cloud/api/lab
  3. Click "OK" to save changes.

3. Create a Shortcut for Automatic Startup

To run the application automatically when Windows starts:

Step 1: Create a Shortcut

  1. Right-click on start-lis-agent.bat, then select "Create shortcut".

Step 2: Add the Shortcut to the Startup Folder

  1. Press Win + R to open the Run dialog.

  2. Type shell:startup and press Enter to open the Startup folder.

  3. Move or copy the shortcut into this folder.

4. Running the Application

Once the computer starts, the start-lis-agent.bat script will execute automatically, setting the environment variables and launching the Java application in the background.

To manually start the application:

  1. Double-click start-lis-agent.bat.

  2. The LIS Agent will begin running in the background.


5. Verifying the Application

To confirm that the application is running:

  • Open Task Manager (Ctrl + Shift + Esc) and check for a Java process.

  • Review application logs for any errors or status messages.

Troubleshooting

If the application does not start, check the following:

Conclusion

By following these steps, the LIS Agent application will run automatically on Windows startup, leveraging environment variables for seamless configuration.
If you need assistance, contact your system administrator or the development team.

Note: This article credit to I Nyoman Surya Pradipta who create the README files regarding the LIS Agent Setup and Configuration

    • Related Articles

    • Documentation for Testing Unidirectional Interface with LIS Agent

      Overview Unidirectional interfacing is commonly used for analyzers that lack the capability to internally scan barcodes and directly communicate with a Laboratory Information System (LIS). This method allows data to flow in one direction—from the ...

    • WhatsApp Notification Integration Setup

      Introduction The WhatsApp Notification feature in Ksatria eHospital enables hospitals and clinics to automatically send notifications to patients, such as: Registration confirmation Consultation reminders Prescription ready for pickup WhatsApp Credit ...

    • How to Create, Search, and Edit Warehouse

      Warehouse in Ksatria eHospital is used to manage hospital storage locations for medical supplies, consumables, and other inventory items. With this feature, users can: Create and configure warehouse information. Define multiple storage locations ...

    • Claim Module Overview

      The Claim module in Ksatria eHospital acts as an electronic repository for all health insurance data used in the hospital. It supports both: Private insurance (from general health insurance companies) Government insurance (such as BPJS or other ...

    • Changelog Ksatria eHospital v2509092 (09-09-2025)

      Changelog Ksatria eHospital v2509092 (09-09-2025) New Features and Enhancements: > Enhancement to add a new column in the registration database > To add validation in patient provider > New features to Show Notification for SOAP AI Generation ...