============================================================================= Run Date: MAY 29, 2020 Designation: MAG*3*249 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #188 Status: Released Compliance Date: JUN 29, 2020 ============================================================================= Associated patches: (v)MAG*3*230 <<= must be installed BEFORE `MAG*3*249' Subject: VISTA IMAGING EXCHANGE (VIX) MUSE-JLV INTERFACE FIXES Category: - Routine Description: ============ This patch addresses the following issues: 1. Some MUSE studies were being displayed incorrectly (only the first page was being displayed and incorrectly presented in black and white). 2. Large TIFF files failing to load when converting to PDF for display. 3. Cardiology Studies widget in JLV was not displaying exam date or exam status for studies that were returned when queried from the CVIX. 4. Enhancements to logging and password requirements during VIX installation. 5. MUSE studies are unable to be viewed from a CVIX or remote VIX to the home VIX of the study. 6. Enhancements to increase performance due to verbose log files. 7. Enhancements to https configuration to allow JLV to work with the Google Chrome browser. 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. Defect 1198411: Need to be able to pull up the same PDF as what we see in VistA Imaging Clinical Display's MUSE Window Problem: MUSE studies display incorrectly (only the first page was being displayed and incorrectly presented in black and white). Solution: Updated source code to provide the appropriate format identifier on the call to display. 2. Defect 1198418 (Trouble Ticket: INC9028630/INC9443048): TIFF to PDF conversion fails on large (many page) TIFFs due to timeout and are not being displayed reliably. Problem: Large TIFF files fail to load when converting to PDF for display. Solution: Added a parameter (MaxPagesTiffToPdf) to limit the number of pages that convert the TIFF to PDF. Any TIFF larger than that parameter will convert to a JPEG instead. Added an additional parameter (OpTimeOutMins) to set the number of minutes the conversion from TIFF to PDF takes before a time out occurs. 3. Defect 1183889: Muse Study requests are coming back without "study date" or "status" attributes valued. Problem: MUSE widget in JLV not displaying exam date or exam status for EKGs that were returned when queried from the CVIX. Solution: Added exam date and status to the list of values returned to JLV. 4. Defect 1179151 (Trouble Ticket: INC6519462): vix-install-log.txt reveals our service account vista access and verify code. If you search by "accessCode", you'll see it in plain text. Problem: VIX install log reveals access and verify codes. Solution: Changed logging to no longer display access and verify codes in any VIX install logs. 5. Defect 1219949: MUSE studies are unable to be viewed from a CVIX or remote VIX to the home VIX of the study via JLV in new Image Viewer. Problem: Unable to view MUSE studies from a CVIX or remote VIX to the home VIX of the study. Solution: Updated the viewer URL to include musestudy instead of vastudy, to append a '-0' to the end of the study number, and to use the sitenumber instead of the authsitenumber when viewing a remote MUSE study via JLV in the Image Viewer. 6. Defect 1198420: Verbose logs enabled leads to performance degradation. Problem: Verbose Log4J logs with file and line numbers enabled leads to performance degradation. Solution: Updated the Log4J file to remove the performance degradation. 7. Defect 1239175: JLV unable to open in the Google Chrome Browser due to mixed http/https. Problem: Users unable to use JLV in the Chrome Browser due to mixed http/https. Solution: Updates were made to the VIX Viewer configuration file and site service for the VIX Viewer to be https compatible allowing JLV to work with Chrome. Test Sites: ----------- * Mountain Home VAMC, TN * Alexandria VAMC, LA * Jesse Brown VAMC, IL * Grand Junction VAMC, CO Software and Documentation Retrieval Instructions: --------------------------------------------------------------- The software for this patch is being released using a host file. The host file (Kernel Installation and Distribution System (KIDS)) is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P249.KID Other Software Files: This release also includes other software files. They can be obtained at location: /srv/vista/patches/SOFTWARE Alternative Location: Sites may alternatively download the software and/or documentation directly using a web browser from the following URL: https://download.vista.domain.ext File Title File Name -------------------------------------------------------------------------- VistA Imaging Exchange (VIX) Installer MAG3_0P249_VIX_Setup.msi VistA Imaging Exchange (VIX) Scripts MAG3_0P249_VIX_Scripts.zip Central VistA Imaging Exchange (CVIX) Installer MAG3_0P249_CVIX_Setup.msi Central VistA Imaging Exchange (CVIX) Scripts MAG3_0P249_CVIX_Scripts.zip Central VistA Imaging Exchange (CVIX) Hotfix MAG3_0P249_CVIX_Hotfix01.zip Documentation describing the new functionality is included in the release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/application.asp?appid=105 Documentation Title File Name -------------------------------------------------------------- Deployment, Installation, Backout, and Rollback Guide MAG3_0P249_DIBORG.pdf VistA Imaging Exchange (VIX) Installation Guide MAG3_0P249_VIX_Installation_Guide.pdf Central VistA Imaging Exchange (CVIX) Installation Guide MAG3_0P249_CVIX_Installation_Guide.pdf VistA Imaging Exchange (VIX) Patch MAG*3.0*249 Readme MAG3_0P249_VIX_README.txt Note: Only the KIDS and VIX client for MAG*3.0*249 should be installed at medical centers. As a result, the CVIX Installer and Hotfix and related CVIX installation guide are not provided to sites on the Network File Shares. Patch Installation: ------------------- Supported Client Versions: -------------------------- When MAG*3.0*249 is released, the list of supported versions of VIX Installer will change: Client Versions Supported: * 3.0.230 Pre/Post Installation Overview: ------------------------------- MAG*3.0*249 KIDS must be installed on the VistA System prior to running the new executables. 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 may be loaded while the VistA Imaging System is active. Installation will take less than one minute. The MAG3_0P249_VIX_Setup.msi will update the SQL service account password to conform to the fourteen(14) character password policy. Updates were made to ensure that the password complies to the new fourteen(14) character password policy throughout both the new and update installation process. * The password is case sensitive, must contain at least fourteen(14) alphanumeric characters and must contain at least one capital letter and one number. 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. Installation Instructions: -------------------------- KIDS installation will take 2 - 5 minutes. 1. On the VistA system, access the Kernel Installation and Distribution System Menu [XPD MAIN]. a. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/MAG3_0P249.KID 2. Run the Installation option [XPD INSTALLATION MENU]. 3. Load the KIDS file by performing the following steps: a. Run the Load a Distribution option [XPD LOAD DISTRIBUTION] to load the KIDS distribution. b. When prompted, enter the full path and file name MAG3_0P249.KID of the MAG*3.0*249 KIDS file. c. When prompted to continue with the load, enter YES. A Distribution OK! message will be displayed when the load is complete. 4. After loading the KIDS file, use the following options to verify the contents of the patch and to back up any affected routines. a. Verify Checksums in Transport Global [XPD PRINT CHECKSUM] - Run this option to ensure the integrity of the routines in the patch. b. Compare Transport Global to Current System [XPD COMPARE TO SYSTEM] Run this option to view all changes that will be made when the patch is installed. All components (routines, options, and so on) in the patch will be compared. c. Backup a Transport Global [XPD BACKUP] - Run this option to create a backup message for any routines exported with the patch. It will NOT back up any of the other changes. 5. After performing the load and any optional verification steps, install the KIDS file by performing the following steps: a. Run the Install Package(s) [XPD INSTALL BUILD] option. b. When prompted for the install name, enter MAG*3.0*249. c. Answer NO to the following prompts if they appear: i. Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO// ii. Want KIDS to INHIBIT LOGONs during the install? NO// iii. Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// 6. When installation is finished, an Install Complete message will be displayed. VIX Server Client Update Instructions ------------------------------------- MAG3_0P249_VIX_Scripts.zip contains a set of scripts to simplify the update and installation process. Extract the MAG3_0P249_VIX_Scripts.zip file into the directory C:\Program Files\VistA\Imaging\Scripts. Installation Verification ------------------------- Successful VistA installation can be verified by reviewing the first 2 lines of the routines contained in the patch. The second line will contain the patch number in the [PATCH LIST] section. The option Calculate and Show Checksum Values [XTSUMBLD-CHECK] can be run to compare the routine checksums to what is documented in the patch description. Successful VIX installation can be verified by following the instructions in the MAG*3.0*249 VIX Installation Guide. Back-out Procedures for MAG Routines ------------------------------------ Back-out will be done only with the concurrence and participation of the development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between the development team, VA site/region personnel and other appropriate VA personnel. Routine MAGIP249 is an installation routine that is automatically deleted after the KIDS installation. Rollback, Back Out or Uninstalling MAG*3.0*249 MSI -------------------------------------------------- If it is necessary to uninstall the MAG*3.0*249 VIX service, use the Uninstall option from Windows Control Panel to uninstall: "VIX Service Installation Wizard 30.249.3.7773". Then install the previous version of VIX which was included in MAG*3.0*230. To back out the VIX and replace it with prior version, please see the MAG*3.0*249 VIX Installation Guide for more detail. Routine Information: ==================== Routine Name Before Checksum After Checksum Patch List (2nd line) ----------- --------------- -------------- --------------------- MAGIP249 N/A 4150612 **249** Routine MAGIP249 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : OCT 21, 2019 Completed By: Date Completed: MAY 29, 2020 Released By : Date Released : MAY 29, 2020 ============================================================================= Packman Mail Message: ===================== No routines included