============================================================================= Run Date: JAN 25, 2022 Designation: MAG*3*273 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #215 Status: Released Compliance Date: FEB 24, 2022 ============================================================================= Subject: HDIG JAVA & TOMCAT Upgrade Category: - Routine Description: ============ Description: This document describes MAG*3.0*273, a patch that provides fixes to Hybrid DICOM Image Gateway. This patch addresses the following issues: Defect(s): -------- 1. IMAG-1105 (INC13682301) - BAY - Issues storing P34 SOPs to Cohesity storage Duplicates: IMAG-1832 INC17070625 IMAG-1106 INC14022442 Adaptive Maintenance: --------------------- 1. IMAG-1903 (Adaptive Maintenance) - HDIG TOMCAT 9.0.40 Upgrade 2. IMAG-1904 (Adaptive Maintenance) - HDIG JAVA 8u281 Upgrade 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. Defect IMAG-1105 (INC13682301) - BAY - Issues storing P34 SOPs to Cohesity storage Problem: -------------------- VA sites are experiencing storage failures when attempting to write newly supported SOP Class artifacts to Tier-2 using the Cohesity grid. Per the CLIN3 POC, the sites are not experiencing any problems writing previously supported SOP Class items to Tier-2; the previously supported SOP class items passes through the legacy gateway. For the newly supported SOP class items the HDIG writes directly to Tier-1 and the tier-2 grids. The Cohesity grid only supports Server Message Block (SMB2), and VistA Imaging solution has SMB1 enabled. It appears the issue occurs because the HDIG does not negotiate SMBv2 when attempting to write to the new Cohesity grid and the Cohesity solution does not support SMBv1. MAG*3.0*239 is installed at the sites that are encountering this problem. Resolution: ----------- Implemented Server Message Block (SMB) Protocol Version 2 using the JCIFS-NG library. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1.Adaptive Maintenance - IMAG-1903 - HDIG TOMCAT 9.0.40 Upgrade Description: ------------ The following task is for Adaptive Maintenance item: HDIG TOMCAT Upgrade Resolution: ----------- Upgraded the application to TOMCAT 9.0.40. 2.Adaptive Maintenance IMAG-1904 - HDIG JAVA 8u281 Upgrade Description: ------------ The following task is for Adaptive Maintenance item: HDIG JAVA 8u281 Upgrade Resolution: ----------- Upgraded the application to JAVA 8u281. Test Sites: ----------- VA Northern Indiana Health Care System (Fort Wayne, IN) VA Madison Health Care (Madison, WI) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the installation guide at https://download.vista.domain.ext/index.html/SOFTWARE/. The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P273.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_0P273.KID Distribution System (KIDS) build for MAG*3.0*273 Hybrid DICOM Gateway MAG3_0P273_HDIG_SETUP.MSI Installation File Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*273 MAG3_0P273_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P273_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Dependencies: ------------ This patch must be installed after MAG*3.0*257 for HDIG. Supported Client Versions: -------------------------- When MAG*3.0*273 is released, the list of supported versions of HDIG will change: Client Versions Supported: -------------------------- 3.0.273 3.0.257 3.0.239 Client Versions No Longer Supported: ------------------------------------ 3.0.204 3.0.194 3.0.192 Pre/Post Installation Overview: -------------------------------- MAG*3.0*273 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*273 KIDS takes 2-5 minutes. There is also a known issue if there are multiple Java versions on the system for HDIG and hence not recommended: For a fresh installation, remove all installed Java applications before the installation of MAG*3.0*273. Verify that the patches listed in the Associated Patches section of this document have been previously installed. Note: If setting up a new server, please follow the steps below to permit installation of Microsoft Visual C++ when LDGW is installed. Right click on the DICOM_setup application Select Properties Select the Compatibility tab Check the box for Compatibility mode Click Apply and select OK Note: 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 Listen file and restart the Tomcat service. Location of Listen file: C:\DCF_RunTime_x64\cfg\apps\defaults 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 ./MAG3_0P273.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*273). B. Select the Backup a Transport Global option to create a backup message of any routines and the build for this patch. It will not backup any other changes such as Data Dictionaries (DDs) or templates. 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 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. If prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. iii. If 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*273 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 273 ;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 273 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*273 Checking Install for Package MAG*3.0*273 Install Questions for MAG*3.0*273 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*273 : 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^MAGIP273. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*273 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: -------------------------------- VistA KIDS: ---------- Verify the checksums of the added/updated routines. Routine Checksum Before Checksum After Patch List ------- --------------- -------------- ----------- MAGIP273 New 4110420 **273** Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ------------------------------ For installing or updating the HDIG, refer to the Hybrid DICOM Image Gateway (HDIG) Installation Guide (Previous Patch: MAG*3.0*257). KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*273 VistA KIDS, select the Kernel Installation & Distribution System menu option, Backup a Transport Global, (see Installation Steps section, step 2-B must be done before installing the patch). Administrators will need to use the PackMan function INSTALL/CHECK MESSAGE. Check the MailMan messages for the backup message sent by the Backup a Transport Global function executed prior to the patch install. 1. Select the message shown below: Backup of MAG*3.0*273 install on And/Or Backup of MAG*3.0*273 install on Routines Only 2. Select the Xtract PackMan option. 3. Select the Install/Check Message option. 4. Enter Yes at the prompt. 5. Enter No at the backup prompt. There is no need to back up the backup. Enter message action (in IN basket): Ignore// Xtract PackMan Select PackMan function: ? Answer with PackMan function NUMBER, or NAME Choose from: 1 ROUTINE LOAD 2 GLOBAL LOAD 3 PACKAGE LOAD 4 SUMMARIZE MESSAGE 5 PRINT MESSAGE 6 INSTALL/CHECK MESSAGE 7 INSTALL SELECTED ROUTINE(S) 8 TEXT PRINT/DISPLAY 9 COMPARE MESSAGE Select PackMan function: Select PackMan function: 6 INSTALL/CHECK MESSAGE Warning: Installing this message will cause a permanent update of globals and routines. Do you really want to do this? NO// YES Routines are the only parts that are backed up. NO other parts are backed up, not even globals. You may use the Summarize Message option of PackMan to see what parts the message contains. Those parts that are not routines should be backed up separately if they need to be preserved. Shall I preserve the routines on disk in a separate back-up message? YES// NO No backup message built. Line 2 Message #43934 Unloading Routine MAGXXXX (PACKMAN_BACKUP) Select PackMan function: Select PackMan function: VistA KIDS Checksums: --------------------- This section lists modified routines for the VistA KIDS build. For each routine, the second line will contain the following information: ;;3.0;IMAGING;** [Patch List]**;**;Mar 19, 2002;Build 4 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums: ------------------ Routine Checksum Before Checksum After Patch List ------- --------------- -------------- ----------- MAGIP273 New 4110420 **273** Routine MAGIP273 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JUL 09, 2020 Completed By: JR Date Completed: JAN 19, 2022 Released By : Date Released : JAN 25, 2022 ============================================================================= Packman Mail Message: ===================== No routines included