=============================================================================
Run Date: MAR 17, 2026                     Designation: MAG*3*392
Package : MAG - IMAGING                       Priority: EMERGENCY
Version : 3       SEQ #272                      Status: Released
                  Compliance Date: APR 16, 2026
=============================================================================


Subject: FIX MEMORY LEAK ISSUES FOR HDIG APPLICATION

Category: 
  - Informational
  - Other

Description:
============

 This document describes MAG*3.0*392, an emergency patch that involves the 
 HDIG application's underlying infrastructure to address memory leak 
 issues during Query/Retrieve (Q/R) requests and while processing DICOM 
 Correct work items. 
  
 Defects: 
 -------- 
  
 1. INC30334668, INC31326594, INC36490569 - VISTAIS-4168 - After installing
    patch 345 (INC30334668, INC31326594) or patch 357 (INC36490569), Tomcat
    service keeps stopping on servers that service Q/R requests and
    processes DICOM Correct work items.
  
  
 EHRM Impact Statement:
 ----------------------
 This patch should have no EHRM impact, and can be installed at all sites,
 including EHRM converted sites.
  
  
 Patch Components:
 ----------------
 Files & Fields Associated:
  
 File Name (Number)         Field Name (Number)       New/Modified/Deleted
 ------------------         -------------------       --------------------
 N/A
  
  
 Forms Associated:
  
 Form Name                   File Number              New/Modified/Deleted
 ---------                   -----------              --------------------
 N/A
  
  
 Mail Groups Associated:
  
 Mail Group Name             New/Modified/Deleted
 ---------------             --------------------
 N/A 
  
  
 Options Associated:
  
 Option Name                 Type                     New/Modified/Deleted
 -----------                 ----                     --------------------
 N/A
  
  
 Protocols Associated:
  
 Protocol Name               New/Modified/Deleted
 -------------               --------------------
 N/A 
  
  
 Security Keys Associated:
  
 Security Key Name
 -----------------
 N/A 
  
  
 Templates Associated: 
  
 Template Name         Type    File Name (Number)     New/Modified/Deleted 
 -------------         ----    ------------------     -------------------- 
 N/A
  
  
 Remote Procedures Associated: 
  
 Remote Procedure Name       New/Modified/Deleted 
 ---------------------       -------------------- 
 N/A
  
  
 Parameter Definitions Associated:
  
 Parameter Name              New/Modified/Deleted
 --------------              --------------------
 N/A
  
  
 Additional Information:
 -----------------------
  
 Blood Bank Team Coordination:
 N/A
  
 New Service Requests (NSRs):
 N/A
  
 Patient Safety Issues (PSIs):
 N/A
  
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
 1. INC30334668, INC31326594, INC36490569 - VISTAIS-4168
  
 Problem:
 --------
 After installing patch 345 (INC30334668, INC31326594) or patch 357
 (INC36490569), Tomcat service keeps stopping on servers that service Q/R
 requests and processes DICOM Correct work items.
  
  
 Resolution:
 -----------
 1. Updated the java code in HDIG so that the allocated memory is released 
 after use. 
  
 2. Added new element in the C:\VixConfig\DicomServerConfiguration.config 
 file. Value is based on the amount of server memory.
   
    <dicomQRSemaphorePermitsInKB>8000000</dicomQRSemaphorePermitsInKB>
  
 3. Added new Java Options in the Apache Tomcat JVM settings: 
    
    -XX:MinHeapFreeRatio=20, 
    
    -XX:MaxHeapFreeRatio=40
    
    -XX:GCTimeRatio=19
  
  
 Test Sites:
 -----------
 Walla Walla VA Medical Center - Walla Walla, WA
  
 Houston VA Medical Center - Houston, TX
  
 Ann Arbor VA Medical Center - Ann Arbor, MI
  
  
 Test Sites - SNOW Change Order #:
 ---------------------------------
 N/A
  
  
 Software and Documentation Retrieval Instructions:
 --------------------------------------------------
 All patch files can be obtained from the SOFTWARE library by accessing
 the URL:
 https://download.vista.domain.ext/index.html/SOFTWARE.
  
 The software for this patch is being released using a host file.
   
  
 File Title                       File Name                      Format
 --------------------------------------------------------------------------
 Hybrid DICOM Gateway             MAG3_0P392_HDIG_SETUP.MSI      Binary
 Installation File 
  
 Documentation describing the new functionality is included in this
 release. Documentation can be found on the VA Software Documentation
 Library at: VA Software Document Library
  
  
 Documentation Title                     File Name                      
 --------------------------------------------------------------------------
 Patch Description for MAG*3.0*392       MAG3_0P392_PATCH_DESCRIPTION.PDF
  
 Deployment, Installation, Back-Out,     MAG3_0P392_DIBRG.PDF 
 and Rollback Guide
  
  
 Patch Installation:
 -------------------
  
  
 Pre/Post Installation Overview:
 -------------------------------
 N/A 
  
  
 Supported Versions:
 --------------------------
 When MAG*3.0*392 is released, the list of supported versions of HDIG will
 Change:
  
  
 Versions Supported:
 -------------------
 3.0.392 
 3.0.383 
 3.0.354 
  
  
 Versions No Longer Supported:
 -----------------------------
 3.0.357 
 3.0.345/3.0.364
 3.0.314 
  
  
 Installation Instructions:
 --------------------------
  
 Pre-Installation Instructions:
 -------------------------------
 N/A
  
  
 KIDS Installation Instructions:
 -------------------------------
 N/A 
  
  
 Installing and Updating the HDIG:
 ---------------------------------
 For installing or updating the HDIG, refer to the Hybrid DICOM
 Image Gateway (HDIG) Installation Guide.
  
  
 Post-Installation Instructions:
 -------------------------------
 1. Update the log4j2.xml configuration to support high-volume Q/R 
 processing HDIG servers.
  
 Please follow the steps below to update the logging configuration for the 
 HDIG application. 
  
    1. Navigate to C:\VixConfig and locate the log4j2.xml file.
    
    2. Create a backup copy of the file.
    
    3. Open log4j2.xml in a text editor.
    
    4. Update the gov.va.med.imaging.vistaimagingdatasource logger
       configuration to the following:
  
       <Logger name="gov.va.med.imaging.vistaimagingdatasource" 
       level="warn" additivity="false">
             <appender-ref ref="applicationLogger" level="warn " />
       </Logger>
  
    5. Save the file.
  
    6. Restart the Tomcat service. 
  
 2. Restarts on Q/R servers
  
 It is recommended to set up a Task Scheduler to restart the HDIG servers 
 running Q/R every 24 hours to maintain performance and stability.
  
  
 Back-Out/Roll Back Plan: 
 ------------------------
 Please refer to the Deployment, Implementation, Back-Out and Rollback 
 Guide (MAG3_0P392_DIBRG.PDF) for instructions.
  
  
 Uninstalling the Application:
 -----------------------------
 For uninstalling the HDIG and instructions on reinstalling the patch
 (MAG*3.0*392, refer to the Hybrid DICOM Image Gateway (HDIG)
 Installation Guide.
  
  
 KIDS Uninstall:
 ---------------
 N/A

Routine Information:
====================
No routines included.

=============================================================================
User Information:
Entered By  :                               Date Entered  : OCT 28, 2025
Completed By:                               Date Completed: MAR 16, 2026
Released By :                               Date Released : MAR 17, 2026
=============================================================================


Packman Mail Message:
=====================

No routines included