============================================================================= Run Date: JUL 27, 2023 Designation: MAG*3*360 Package : MAG - IMAGING Priority: EMERGENCY Version : 3 SEQ #244 Status: Released Compliance Date: AUG 11, 2023 ============================================================================= Subject: VISTA IMAGING EXCHANGE (VIX) MUSE AND DEADLOCK REMEDIATION Category: - Other - Informational Description: ============ NOTE: This patch is to be applied to a MAG*3.0*329 VIX server only and does not have an accompanying Kernel Installation and Distribution System (KIDS) to be installed in VistA/RPMS. This patch addresses the following issues: Patch MAG*3*0*360 delivers updated Java components to address remediation for DICOM SCP startup instantiating a port listener through the Laurel Bridge library twice causing a potential deadlock with the library and users using Clinical Display potentially seeing the wrong MUSE EKG on affected production CVIX and VIX servers. The components listed below will be updated via either an automated script or manual deployment process that is included in the delivery package: "C:\Program Files\Apache Software Foundation\Tomcat 9.0\lib\ImagingRouter -0.1.jar" "C:\Program Files\Apache Software Foundation\Tomcat 9.0\lib\MuseCommon-0.1 .jar" "C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\Study" 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: (IMAG numbers are from VA Jira) 1. Defect (IMAG-4366) Fix DICOM SCP startup of port listener. Problem: -------- The DICOM SCP startup instantiated a port listener through the Laurel Bridge library twice causing a potential deadlock with the library. Resolution: ----------- Now the DICOM SCP startup instantiates a single port listener through the Laurel Bridge library. 2. Defect (IMAG-4365) MUSE can be erroneously queried for images. Problem: -------- When a user queried for images from a VIX containing "vaimage" and the image could not be located or retrieved, MUSE could be queried and return the wrong image. Resolution: ----------- MUSE studies and images now have a "MUSEECG" suffix that VIX explicitly checks for before querying MUSE when images cannot be located. Test Sites: ----------- * Fargo VA Health Care System * Iowa City VA Health Care System Software and Documentation Retrieval Instructions: --------------------------------------------------------------- This release includes software files. Client installer software files can be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE. File Title File Name ------------------------------------------------------------------------- VistA Imaging Exchange (VIX) MUSE and Deadlock Patch* MAG3_0P360_Patch.zip *Note: The patch can be applied to both VIX and CVIX. 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/application.asp?appid=105. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name -------------------------------------------------------------------------- Patch Description MAG3_0P360_PATCH_DESCRIPTION.PDF Patch Installation: ------------------- Pre/Post Installation Overview: N/A Pre-Installation Instructions: N/A Installation Instructions: This patch is a VIX server patch only and does not have an accompanying KIDS to be installed in VistA/RPMS. This patch is being distributed remotely. To verify remote patch deployment (see below): Remote patch deployment verification steps: 1. Using Windows explorer verify the folder C:\temp\MAG3_0P360_Patch exists. 2. Using a browser, go to the VIX homepage: https://FQDN of VIX server/ NOTE: FQDN is the fully qualified domain name of the VIX server. 3. In the browser, verify the current version is listed as 30.360.1.8151. If the version is listed as 30.360.1.8151, the patch is already installed and no further installation is needed. If the version is listed as 30.329.3.8115, the remote deployment did not occur and this patch can be installed on the VIX server via an automated script or manually (see below): Automated script steps: 1. Create a new folder: C:\temp\MAG3_0P360_Patch 2. Place the MAG3_0P360_Patch.zip file in the folder created in step #1 ( C:\temp\MAG3_0P360_Patch"). 3. Extract the contents of MAG3_0P360_Patch.zip into the folder created in step #1 ( C:\temp\MAG3_0P360_Patch"). 4. Run pwsh (PowerShell 7) 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 pwsh launches, type the command: cd "C:\temp\MAG3_0P360_Patch" Then press [ENTER] to change the working directory to this folder. 7. Type the command: .\MAG3_0P360_Patch_Deployer.ps1 And press [ENTER] to execute the automated script. NOTE: If encountering an error running the script, in pwsh type the command: Set-ExecutionPolicy Unrestricted Press [ENTER] to set the policy to allow scripts to run. 8. When prompted to Select File to Upload choose the zip file from the folder in step #2. 9. When prompted with Confirm you want to proceed (Y) or (Q) to Quit answer yes by entering [Y] and press [ENTER]. 10. Answer yes by entering [Y] and press [ENTER] to each of the questions that appear: Is this the correct environment Continue to update sites Do you want to copy the hotfix zip file Do you want to stop the Tomcat9 service Do you want to unpack the hotfix zip file Do you want to proceed with applying the hotfix Do you want to delete the va-image-region in VixCache Do you want to start the Tomcat9 service Do you want to delete the VixRenderCache and restart the Vix Viewer and Render services NOTE: Starting and stopping Tomcat can take several minutes. Manual steps: 1. Create two new folders: a. C:\temp\MAG3_0P360_Patch b. C:\temp\MAG3_0P360_Patch\Backup 2. Extract the contents of the "MAG3_0P360_Patch.zip" file to the folder created in step #1a (C:\temp\MAG3_0P360_Patch) 3. Stop the Tomcat service (Apache Tomcat 9.0 Tomcat9) in Windows Services. Wait for the Tomcat service to stop completely (this may take several minutes and potentially over five minutes). 4. Copy and paste (to create a backup of) the following two files located in C:\Program Files\Apache Software Foundation\Tomcat 9.0\lib to the folder created in step #1b (C:\temp\MAG3_0P360_Patch\Backup): a. ImagingRouter-0.1.jar b. MuseCommon-0.1.jar 5. Copy and paste (to create a backup of) the following files located in C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\Study \WEB-INF\classes\gov\va\med\imaging\study\lbs\ to the folder created in step #1b (C:\temp\MAG3_0P360_Patch\Backup): a. DicomScp.class b. DicomScp$SCPThread.class 6. Copy the jar files extracted in step #2 ("ImagingRouter-0.1.jar" and "MuseCommon-0.1.jar") into the following path to replace the "ImagingRouter-0.1.jar" and "MuseCommon-0.1.jar" files: a. C:\Program Files\Apache Software Foundation\Tomcat 9.0\lib 7. Extract the "Study.zip" contents into C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps, to replace the existing Study folder and .class file (DicomScp.class). [Alternatively,extract the "Study.zip" into the folder created in step #2a ( C:\temp\MAG3_0P360_Patch ). Copy and paste (to replace the DicomScp.class file in the folder) the following: C:\temp\MAG3_0P360_Patch\Study\WEB-INF\classes\gov\va\med\imaging \study\lbs\DicomScp.class C:\temp\MAG3_0P360_Patch\Study\WEB-INF\classes\gov\va\med\imaging \study\lbs\DicomScp$SCPThread.class into C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\Study\WEB-INF\classes\gov \va\med\imaging\study\lbs ] 8. Open the file ViXConfig.xml in the folder C:\VixConfig using Notepad or Notepad++ as an administrator and perform the following: a. In ViXConfig.xml, after the line with change the number inside the opening and closing string tags from 30.329.3.8115 to 30.360.1.8151. b. Save ViXConfig.xml after updating. 9. Start the Tomcat service (Apache Tomcat 9.0 Tomcat9) in Windows Services. Wait for the Tomcat service to start completely (this may take several minutes) Post-Installation Instructions N/A Rollback, Back Out, or Uninstalling MAG*3.0*360 -------------------------------------------------- N/A Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JUN 29, 2023 Completed By: Date Completed: JUL 25, 2023 Released By : Date Released : JUL 27, 2023 ============================================================================= Packman Mail Message: ===================== No routines included