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 ...

    • DICOM Forwarding Setup Guide

      Overview This guide explains how to configure a DICOM workflow where K PACS sends images to Orthanc, and Orthanc automatically forwards those images to a DICOM Router. This setup is typically used in clinics or hospitals to centralize image routing ...

    • 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 ...

    • KMS RIS Agent User Guide

      What is the KMS RIS Agent? The KMS RIS Agent is an automated system that assists hospitals in managing radiology orders and medical images. It works as a digital assistant that: Automatically fetches new radiology orders from your Hospital ...

    • Radiology Diagnostic Flow Integration Guide with RIS Agent and SATUSEHAT

      Summary This article explains the complete workflow of Diagnostic Radiology Integration (X-Ray, CT, MRI, USG) in the Ksatria eHospital, including interaction between eHospital → IHS Service → RIS Agent → DICOM Router → Modality → SATUSEHAT. Overview ...