Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Patch Subject: BACKGROUND PROCESSOR (BP) DEFECT FIXES
Description:
============
Associated Patches:
===================
This patch must be installed after MAG*3.0*198.
Subject: BACKGROUND PROCESSOR (BP) DEFECT FIXES
========
Category: OTHER
=========
Description:
=============
This document describes MAG*3.0*214, a patch that provides fixes to the
Background Processor (BP). This patch addresses the following issues:
Imaging Site Parameters screen, system displays an error message
"Value is not initialized".
BP Queue processor is stopping with an error at some sites.
After installing the MAG*3.0*196, some background processor sites
are getting prompted for 2-factor authentication when starting the
application.
Network Password Update on BGP causing issues.
Resolved issue of the Event Log displaying incorrect patch.
Patch Components:
=================
This patch includes software and documentation files. This document,
MAG3_0P 214_Patch_Description.pdf, provides an overview, explains the
changes, and outlines the installation for this patch.
MAG3_0P214_README.txt, if present, is an informative file associated with
the patch released.
Software & Documentation:
=========================
File Name Description
========== ===========
MAG3_0P214.KID Kernel Installation and
Distribution System(KIDS)build
for Patch 214
MAG3_0P214_Background_Processor_Setup.exe Background Processor client
installation file.
MAG3_0P214_Patch_Description.pdf Patch Description for P214
Mag_BP_User_Manual.pdf Background Processor User
Manual
Files & Fields Associated:
==========================
There are no files or fields associated with this patch.
Forms Associated:
=================
There are no forms associated with this patch.
Mail Groups Associated:
=======================
There are no mail groups associated with this patch.
Options Associated:
===================
There are no options associated with this patch.
Protocols Associated:
=====================
There are no protocols associated with this patch.
Security Keys Associated:
=========================
There are no security keys associated with this patch.
Templates Associated:
=====================
There are no templates associated with this patch.
Additional Information:
=======================
New Service Requests (NSRs):
============================
There are no new service requests addressed in this patch.
Patient Safety Issues (PSIs):
=============================
There are no patient safety issues associated with this patch.
Defect Tracking System Ticket(s) & Overview
===========================================
1. Defect 740851 (Trouble Ticket # INC0300885)-Imaging Site Parameters
screen, system displays an error message "Value is not initialized".
Problem:
========
Issue 1:
========
When user opens Background Processor - Imaging Site Parameters screen,
system displays an error message "Value is not initialized" and Background
Processor freezes. The user cannot proceed forward.
Issue 2:
========
Users are experiencing an issue where they cannot save the Default User
Preference when selecting a different name from was previous selected.
Resolution:
==========
A new Remote Procedure Call (RPC) "MAGQBP VAL" is called before the
Imaging Site Parameters window is opened. This new RPC will validate the
current values of the pointer fields:
#100 DEFAULT USER PREFERENCE
#.03 IMAGE NETWORK WRITE LOCATION
#2.01 JUKEBOX WRITE LOCATION
#1.02 PACS DIRECTORY
#1.03 PACS IMAGE WRITE LOCATION
A message window will be displayed to the user if any of the current
values are invalid. If the current value of the Default User Preferences
field is invalid, it will be deleted from the IMAGING SITE PARAMETERS File
(#2006.1).
If invalid data is found, a confirmation message will be displayed to the
user. Click OK and the Site Parameters window will open.
Note: If the Site Parameters window does not open, an authorized person
will need to correct the invalid pointer in VistA using Fileman
Enter/Edit.
2. Defect 741310 (Trouble Tickets # INC0298707, INC0586047)-BP Queue
processor is stopping with an error at some sites.
Problem:
========
When running the Jukebox Queue and MAG*3.0*196 is running for a while,
unexpectedly the user will get stuck into an RPC Exception loop. The
users are prompted for access and verify code.
Resolution:
===========
Occasionally, when an RPC Exception occurs, the connection to VistA is
lost. When the connection is lost, the BP will try to silently re-connect
to VistA without user input. In this issue, the user is prompted for
their Access and Verify Codes because the user context has been cleared.
The code has been modified to correctly use the last user context for the
silent re-connect to VistA.
3. Defect 741968 (Trouble Ticket # INC0383466)- 2-Factor Authentication
prompt appearing for some users.
Problem:
========
After installing the MAG*3.0*196, when launching the BP Queue Processor,
some sites are getting prompted for 2-factor authentication. The users
launch the BP Queue Processor then will receive the 2 - Factor
Authentication message. If the user clicks cancel, the BP Queue Processor
will launch the window for access/verify code. The 2 - Factor
Authentication should not appear at all. Some users are using Dameware to
remote login to the server and login into the server using the
administration password.
Resolution:
===========
MAG*3.0*196 and newer versions of the BP use the Broker Development Kit
(BDK) version 65 to connect to VistA. BDK 65 incorporates 2FA
authentication to login to VistA. The BP code has been modified to use the
login functionality from the last version of the BDK that did not
incorporate 2FA authentication.
4. Defect 744739 (Ticket # R16489435FY17) - Network Password Update on
BGP causing issues.
Problem:
========
When the user updates the Network Password in the Background Processor,
the system would randomly add an extra space to the end of the encrypted
password stored in VistA, which causes the user issues when trying to log
into other areas of VistA Imaging.
Resolution:
===========
The BP uses Kernel functions to generate encrypted passwords. If spaces
exist in the encrypted password, the BP will continually re-encrypt the
password until no spaces exist. The user may see an information window
that says the password will be re-encrypted. But there is no action
required on the user's part, except clicking 'OK'.
5. Defect 806306: BP Event Log Issue
Problem:
========
In the Event Log, of the BP Main Window, the value for 'Vista Imaging
Install' incorrectly displays 3.0p196.
Resolution:
===========
The Event Log was fixed to correctly display the latest installed BP
Patch (MAG*3.0*214).
Test Sites:
===========
The following sites are test sites for this patch:
Oscar G. Johnson VAMC (Iron Mountain)
Phoenix VA Healthcare System
Syracuse VAMC (VISN2-Upstate NY)
Software and Documentation Retrieval Instructions:
==================================================
Software being released and/or documentation describing the new
functionality introduced by this patch are available.
Sites may retrieve the software and/or documentation directly using
Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE
directory at the following OI Field Offices:
Location Site
======== ====
Hines domain.ext
Salt Lake City domain.ext
Documentation can also be found on the VA Software Documentation Library
at: http://www4.domain.ext/vdl/.
Patch Installation:
===================
Supported Client Versions
=========================
When MAG*3.0*214 is released, the list of supported versions of
Background Processor will change:
Supported Versions No Longer Supported
================== ===================
3.0.214
3.0.198
3.0.196
3.0.135
Note: When a user enters invalid Access/Verify Codes while logging into
VistA, the system gives them an error message.
In patch 214, the Error message is hidden under the main Vista Sign-on
window. The user has to move the VistA Sign-on window, then click 'OK' in
the Error message window to be able to continue. A fix for this issue is
scheduled for a future Background Processor patch.
Pre/Post Installation Overview:
===============================
MAG*3.0*214 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.
Important: Any Background Processor applications that are running must be
stopped and closed prior to the installation of the KIDS and
Client software. Any image capture application (Clinical
Capture and DICOM Gateway processing) can continue to run
during the installation.
Use default answers for KIDS load/install questions.
Patch-Files: http://code.osehra.org/VistA.git/tree/master/Packages/Imaging/Patches/MAG_3.0_214- Loading branch information
1 parent
b85d516
commit fe98219