============================================================================= Run Date: MAR 09, 2022 Designation: MAG*3*330 Package : MAG - IMAGING Priority: EMERGENCY Version : 3 SEQ #216 Status: Released Compliance Date: MAR 16, 2022 ============================================================================= Subject: Defect HDIG patch Category: - Informational Description: ============ This document describes MAG*3.0*330 which temporarily mitigates a performance issue introduced by MAG*3.0*273, until a permanent fix is released in a future patch. ** This patch removes SMB2 functionality from MAG*3.0*273 ** Note: With the release of MAG*3.0*330, the following HDIG versions will be available to sites to suit several scenarios: MAG*3.0*330 - Displayed as 30.273.2.7064 in HDIG Stats page. Includes Java and Tomcat updates but removes SMB2 functionality. MAG*3.0*273 - Includes Java and Tomcat updates and introduces SMB2 functionality but with Importer performance issues. MAG*3.0*257 - Oldest approved HDIG version. This patch addresses the following issues: Defect(s): ---------- 1. Defect(INC21390265)- CIS-W\team2\V16\MUS - VHAMUSIMMVDIG10 upgraded to P273; Imports are now processing 1-2 images every 12 seconds backing up images. 2. Defect(INC21353836)- Importer issues with Patch 273. Importer in FAV. On 02/09/2022, an issue was worked on with MUS. The issue involved certain import items (mainly MR) being imported which were coming into the DIG slowly. The latency caused only 1 image to populate into the Image_In folder every 10-20 seconds. All the HDIGs were already upgraded to 273. The importer DIG was updated to 273 on 02/10/2022. It was noticed that a PET exam being imported was exhibiting the same issue, of only populating 1 image every 10-20 seconds. Each image size was only about 60K in size. The importing was switched to a different DIG that was still at P257. The Import was resubmitted to that DIG, and the images populated at a much faster rate. 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: ----------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- 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. INC21390265 - CIS-W\team2\V16\MUS - VHAMUSIMMVDIG10 upgraded to P273; Imports are now processing 1-2 images every 12 seconds backing up images. Problem: -------- The latency of importing images is well beyond expected levels, sometimes taking over 10-20 seconds per image. Resolution: ----------- The MAG*3.0*330 PowerShell Script rolls back JCIFS-NG to SAMBA JCIFS and removes the SMB 2.0 support that was introduced in MAG*3.0*273. 2. INC21353836 - Importer issues with Patch 273. Importer in FAV. On 02/09/2022, an issue was worked on with MUS. The issue involved certain import items (mainly MR) being imported which were coming into the DIG slowly. The latency caused only 1 image to populate into the Image_In folder every 10-20 seconds. All the HDIGs were already upgraded to 273. The importer DIG was updated to 273 on 02/10/2022. It was noticed that a PET exam being imported was exhibiting the same issue, of only populating 1 image every 10-20 seconds. Each image size was only about 60K in size. The importing was switched to a different DIG that was still at P257. The Import was resubmitted to that DIG, and the images populated at a much faster rate. Problem: -------- The latency of importing images is well beyond expected levels, sometimes taking over 10-20 seconds per image. Resolution: ----------- The MAG*3.0*330 PowerShell Script rolls back JCIFS-NG to SAMBA JCIFS and removes the SMB 2.0 support that was introduced in MAG*3.0*273. Test Sites: ----------- Fayetteville VA Medical Center (Fayetteville, Arkansas) Lebanon VA Medical Center(Lebanon, Pennsylvania) Muskogee VA Medical Center (Muskogee, Oklahoma) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the installation instructions in MAG3_0P330_JCIFS_Patch.zip at https://download.vista.domain.ext/index.html/SOFTWARE/. Other Software Files: This release also includes other software files. These files can be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE. File Title File Name -------------------------------------------------------------------------- VistA Imaging HDIG Performance Improvement Patch MAG3_0P330_JCIFS_PATCH.ZIP Documentation Title File Name -------------------------------------------------------------------------- Patch Description for MAG*3.0*330 MAG3_0P330_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P330_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- This patch must be installed by the compliance date. This patch may be loaded while the VistA Imaging System is active. The installation takes less than 5 minutes. Pre-Installation Instructions: ------------------------------ This patch may be installed with users on the system, although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. Dependencies: ------------ This patch must be installed after MAG*3.0*273 for HDIG. Installation Instructions: -------------------------- Note: It is recommended to stop Importing and halt the 2-3 process before installing this update. This emergency patch can be applied via automated script (see below): Automated script steps: 1. Create a new folder: C:\temp\MAG3_0P330_JCIFS_Patch (folder name must match exactly). 2. Copy the downloaded "MAG3_0P330_JCIFS_Patch.zip" file to the C:\temp folder. 3. Extract the contents of the "MAG3_0P330_JCIFS_Patch.zip" file to the folder created in step #1 (C:\temp\MAG3_0P330_JCIFS_Patch). 4. Run Windows PowerShell (not Windows PowerShell ISE) as an administrator. 5. If prompted with "Do you want to allow the following program from an unknown publisher to make changes to this computer?", click Yes. 6. Once Windows PowerShell launches, type the command: cd C:\temp\MAG3_0P330_JCIFS_Patch Then press [ENTER] to change the working directory to this folder. 7. Type the command: .\p330_jcifs_patch.ps1 And press [ENTER] to execute the automated script. NOTE: Starting and stopping Tomcat can take several minutes and potentially over five minutes. 8. After successful installation, the following message will be displayed: "Completed installing P330. Press Enter to exit:" And press [ENTER] to exit out of the installation. Installation Verification ------------------------- 1. Open File Explorer. 2. Verify the following three files are present in the "C:\Program Files\Apache Software Foundation\Tomcat 9.0\lib" folder a. jcifs-1.3.19.jar b. jcifs-ng-2.1.0.jar c. VistaStorage-0.1.jar - right click on the file, go to the Properties, and verify the file Size is 17.1 KB (17,602 bytes). 3. Verify the following two files are NOT present in the "C:\Program Files\Apache Software Foundation\Tomcat 9.0\lib" folder a. jcifs-ng-2.1.4.jar b. bcprov-jdk15on-1.61.jar 4. Go to HDIG Statistics Home page at http://:8080/HDIGManagementWebApp/ViewHDIGStats.jsp a. Verify the version is "30.273.2.7064" Supported Client Versions: -------------------------- When MAG*3.0*330 is released, the list of supported versions of HDIG will change: Client Versions Supported: -------------------------- 3.0.273 3.0.257 Client Versions No Longer Supported: ------------------------------------ 3.0.239 3.0.204 3.0.194 Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ------------------------------ Gateway (HDIG) Installation Guide (Previous Patch: MAG*3.0*273). Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : JR Date Entered : FEB 23, 2022 Completed By: Date Completed: MAR 09, 2022 Released By : Date Released : MAR 09, 2022 ============================================================================= Packman Mail Message: ===================== No routines included