============================================================================= Run Date: OCT 31, 2022 Designation: MAG*3*324 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #232 Status: Released Compliance Date: DEC 01, 2022 ============================================================================= Associated patches: (v)MAG*3*302 <<= must be installed BEFORE `MAG*3*324' Subject: Defect patch for HDIG Category: - Routine Description: ============ This document describes MAG*3.0*324, a patch that provides fixes to HDIG application. This patch addresses the following issues: Defect(s): ---------- 1. INC22986279 - DICOM Importer III failed to import non-DICOM PDF images. Note: This ticket is duplicated by: INC23001837 - Importer 3 not working. 2. INC22993142 - Vista Q/R is timing out, unable to pull images via Q/R from vista storage. 3. INC23141931 - Post MAG*3*302 installation, the HDIGs are no longer writing to several logs. Adaptive Maintenance: --------------------- 1. VA sites started experiencing latency in HDIGs that were servicing Importer requests after installing 30.273.2.7063, 30.273.2.7064, 30.302.3.7073 or 30.302.3.7074 when the storage location is supporting SMB2.0. 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 -------------- -------------------- N/A Additional Information: ----------------------- N/A 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. INC22986279- DICOM Importer III failed to import non-DICOM PDF images. Problem: -------- Non-Dicom files especially PDF files were not getting imported. Resolution: ----------- The solution recommended by the fortify scan tool that was implemented as a part of MAG*3.0*302 was not adequate. This patch improved on the recommendation from Fortify scan by updating the Java code. The Java code explicitly closes the file handle. This fixes the failure in DICOM Importer III when importing non-DICOM PDF images. 2. INC22993142 - Vista Q/R is timing out, unable to pull images via Q/R from vista storage. Problem: -------- VistA Q/R was timing out while pulling previously supported SOP Class images from Vista Storage. Resolution: ----------- The solution recommended by the fortify scan tool that was implemented as a part of MAG*3.0*302 was not adequate. This patch improved the recommendation from Fortify scan by updating the Java code. The code now utilizes Try-Catch block to catch any errors so that VistA Q/R will no longer time out when pulling images from VistA Storage. 3. INC23141931 - Post MAG*3*302 installation, the HDIGs are no longer writing to several logs. Problem: -------- HDIG Summary and DCF logs were not working. Resolution: ----------- Updated the log file with correct library settings for dcfLogger and summaryLogger in the log4j2.xml file located at C:\VixConfig\ in the HDIG Server. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. VA sites started experiencing latency in HDIGs that were servicing Importer requests after installing 30.273.2.7063, 30.273.2.7064, 30.302.3.7073 or 30.302.3.7074 when the storage location is supporting SMB2.0. Description: ------------ MAG*3.0*330 was released to remove SMB2.0 functionality from the HDIG servers that were servicing Importer requests. Resolution: ----------- This patch addresses the latency issues of SMB2.0 reported in 30.273.2.7063 by implementing JCIFS-NG library version 2.1.7. Test Sites: ----------- Miami VAMC (Miami, FL) Muskogee VAMC (Muskogee, Oklahoma) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the installation guide at: HDIG Installation Guide (domain.ext) The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P324.KID 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 --------------------------------------------------------------------- Kernel Installation and MAG3_0P324.KID Distribution System (KIDS) build for MAG*3.0*324 Hybrid DICOM Gateway MAG3_0P324_HDIG_SETUP.MSI Installation File Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*324 MAG3_0P324_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P324_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Dependencies: ------------- This patch must be installed after MAG*3.0*302 for HDIG. Supported Client Versions: -------------------------- When MAG*3.0*324 is released, the list of supported versions of HDIG will change: Client Versions Supported: -------------------------- 3.0.324 3.0.302 3.0.273 Client Versions No Longer Supported: ------------------------------------ 3.0.257 3.0.239 3.0.204 Pre/Post Installation Overview: ------------------------------- MAG*3.0*324 must be installed on the VistA System and on 64-bit HDIG servers. This patch must be installed by the compliance date. All sites running VistA Imaging 3.0 must install the KIDS portion of this patch. This patch can be loaded while the VistA Imaging System is active, and users are on the system. Installing the MAG*3.0*324 KIDS takes 2-5 minutes. Notes: There is a known issue if there are multiple Java versions on the system for HDIG: For a fresh installation, remove all installed Java applications before the installation of MAG*3.0*324. To avoid losing configuration changes, sites with a modified HDIG Listen file will need to save a copy of the file before installing this patch. After the installation is complete, restore the file and restart the Tomcat service. Access the LISTEN file at the following location: C:\DCF_RunTime_x64\cfg\apps\defaults To avoid losing configuration changes in the PeriodicCommandsConfiguration.config file, sites with a modified PeriodicCommandsConfiguration.config file will need to save a copy of the file before installing this patch. The location of PeriodicCommandsConfiguration.config file is here: C:\VixConfig. Installation Instructions: -------------------------- 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/MAG3_0P324.KID 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu: A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME, enter the patch or build name (ex. MAG*3.0*324). NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter your build MAG*3.0*324 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure this message? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. vii. Repeat step ii for each build in the host file. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install?', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install?', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols?', answer NO. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*324 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 324 ;Created on Nov 09, 2020@20:45:05 This Distribution was loaded on Nov 19, 2020@10:14:39 with header of VistA Imaging 3.0 - Patch 324 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*324 Checking Install for Package MAG*3.0*324 Install Questions for MAG*3.0*324 Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// HERE Install Started for MAG*3.0*324 : Nov 19, 2020@10:14:53 Build Distribution Date: Nov 09, 2020 Installing Routines:... Nov 19, 2020@10:14:53 Running Post-Install Routine: POS^MAGIP324. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*324 Installed. Nov 19, 2020@10:14:53 Installing and Updating the HDIG: --------------------------------- For installing or updating the HDIG, refer to the Hybrid DICOM Image Gateway (HDIG) Installation Guide. Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Please refer to the Deployment, Implementation, Back-Out and Rollback Guide (MAG3_0P324_DIBORG.PDF) for Client Installation instructions. Uninstalling the Application: ----------------------------- After uninstalling MAG*3.0*324, due to the change in the encryption algorithm, the existing ImagingExchangeWebApp.log and ImagingDCFApp.log should be renamed, so that the new installation will start fresh logs. Both log files are located at C:\Program Files\Apache Software Foundation\Tomcat 9.0\logs. For installing or updating the HDIG, refer to the Hybrid DICOM Image Gateway (HDIG) Installation Guide. Previous Patch: MAG*3.0*302 (SMB1 and SMB2 support) or MAG*3.0*273/MAG*3.0*330 Patch Description -(SMB1 support only)). KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*324 VistA KIDS, the patch backup must be installed. The Kernel Installation & Distribution System menu option, Backup a Transport Global should have been used to create a patch backup of the build prior to installing the patch. (see Installation Instructions section step 2B above). Administrators will need to check MailMan for the backup message sent by the Backup a Transport Global function executed prior to the patch install. The patch backup must first be loaded from the MailMan backup message, by performing the message action Xtract KIDS, followed by the PackMan function INSTALL/CHECK MESSAGE. The patch may then be installed using the Install Package(s) option in the KIDS Installation menu. 1. Navigate to the Mailman inbox containing the patch backup message. a. Select the MAG*3.0*324 backup message as shown below: * Backup of MAG*3.0*324 install on b. At the "Enter message action:" prompt, select the Xtract PackMan option. c. At the "Select PackMan function:" prompt, select the Install/Check Message option. d. Enter Yes at the prompt "OK to continue with Load?" 2. Navigate to the Kernel Installation and Distribution System Menu and select the Installation Menu. From this menu: a. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Example, Loading Patch Backup (Build) -------------------------------------------- IN Basket Search *=New/!=Priority.........Subject...............Lines.From.....Read/Rcvd 13093. [313643] 09/06/22 Backup of MAG*3.0*324 3099 Search finished. Enter message number or command: 13093 Subj: Backup of MAG*3.0*324 on Sep 06, 2022 [#313643] 09/06/22@12:43 3099 lines From: MANAGER,SYSTEMS In 'IN' basket. Page 1 -------------------------------------------------------------------------- $TXT Created by PROGRAMMER,MAG at DOSO.DOMAIN.EXT (KIDS) on Tuesday, 09/06/22 at 12:42 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. Type to continue or '^' to exit: ^ Enter message action (in IN basket): Ignore// Xtract KIDS Select PackMan function: 6 INSTALL/CHECK MESSAGE Line 8 Message #313643 Unloading KIDS Distribution MAG*3.0*324b OK to continue with Load? NO// YES Distribution OK! Want to Continue with Load? YES// Loading Distribution... MAG*3.0*324b Example, Installing Patch Backup (Build) ----------------------------------------------- Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System Select Kernel Installation & Distribution System Option: INstallation Select Installation Option: INstall Package(s) Select INSTALL NAME: MAG*3.0*324b This Distribution was loaded on Sep 07, 2022@11:54:20 with header of Backup of MAG*3.0*324 on Sep 06, 2022 It consisted of the following Install(s): MAG*3.0*324b Checking Install for Package MAG*3.0*324b Install Questions for MAG*3.0*324b Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO// Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// Linux Telnet /SSh MAG*3.0*324b -------------------------------------------------------------------------- Build Distribution Date: Sep 06, 2022 Installing Routines: Sep 07, 2022@11:54:36 Installing PACKAGE COMPONENTS: Installing OPTION Sep 07, 2022@11:54:36 Updating Routine file... Updating KIDS files... MAG*3.0*324b Installed. Sep 07, 2022@11:54:36 NO Install Message sent -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Note: Routine MAGIP324 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP324 Before: n/a After: B4110396 **324** ============================================================================= User Information: Entered By : JR Date Entered : DEC 01, 2021 Completed By: Date Completed: OCT 31, 2022 Released By : Date Released : OCT 31, 2022 ============================================================================= Packman Mail Message: ===================== No routines included