$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Monday, 07/25/22 at 11:23 ============================================================================= Run Date: AUG 15, 2022 Designation: ANRV*5.1*1 Package : ANRV - VISUAL IMPAIRMENT SERVICE TE Priority: EMERGENCY Version : 5.1 SEQ #1 Status: Released Compliance Date: AUG 17, 2022 ============================================================================= Associated patches: (v)ANRV*5*1 <<= must be installed BEFORE `ANRV*5.1*1' Subject: TRM COMPLIANCE UPDATES AND DEFECTS FIX FOR BR APPLICATION Category: - Informational - Routine - Other Description: ============ The Blind Rehabilitation System (BRS) is a Veterans Health Administration (VHA)-wide application used to track and manage the delivery of care to visually impaired patients. The purpose of this patch: Re-engineer the BRS application to comply with VA Technical Reference Model (TRM) and secure coding standards. Release the new version 5.1 of BRS to production for use by VA staff with Two Factor Authentication (2FA) capability. Migrate the BRS application to the VA Enterprise Cloud (VAEC). The current version of BRS was written with Apache Struts is no longer compliant with the VA TRM or VA secure coding standards. As a result, code defects cannot be resolved until compliance is restored. Lastly, the current version of BRS is located in a physical data center Capital Region Readiness Center (CRRC). This on-premise deployment is to be replaced with a VAEC implementation, using cloud service provider Amazon Web Services (AWS). Patch Components: ----------------- This enhancement patch is composed of a JAVA GUI component and a VistA Mumps component. Installation instructions for the patch are below. The patch is a packman message that contains updates to the BLIND REHAB/VIST 5.1 [ANRVJ BLINDREHAB] option and adds a new option ANRVJ VIAB [ANRVJ VIAB SERVICE]. The JAVA GUI instructions are listed in the Blind Rehabilitation Centralized Server Installation/Implementation Guide. This is a Web Application JAVA Build. This is a Centralized Server promotion. NO installation is required at local sites. Option name Type New/Modified/Deleted ----------- --------- ----------------- ANRVJ_BLINDREHAB Broker (Client/Server) Modified XUS DIVISION SET Remote Procedure (RPC) New (added) XUS SIGNON SETUP RPC New (added) XUS AV CODE RPC New (added) XUS ESSO VALIDATE RPC New (added) XWB CREATE CONTEXT RPC New (added) ORWU USERINFO RPC New (added) ANRVJ VIAB SERVICE Menu New Overview: -------- The current version of Blind Rehabilitation is no longer compliant with the VA TRM or VA secure coding standards. As a result, code defects cannot be resolved, and application enhancements cannot be pursued until compliance is restored. The current version 5.0 of BRS is located at physical data centers CRRC. Resolution: ----------- This on-premise deployment is to be replaced with a VAEC implementation, using cloud service provider Amazon Web Services (AWS). Test Sites: ----------- Charlie Norwood VA Medical Center (Augusta, GA) Southern Arizona VA Medical Center (Tucson, AZ) Software and Documentation Retrieval Instructions: -------------------------------------------------- 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 --------------------------------------------------------------------- Deployment, Installation, Back-out, ANRV_5_1_1_DIBRG.pdf and Rollback Guide User Manual ANRV_5_1_1_UM.pdf Release Notes ANRV_5_1_1_RN.pdf Blind Rehabilitation Centralized Server Installation/Implementation Guide ANRV_5_1_1_CIG.pdf Patch Installation: ------------------- Pre/Post Installation Overview: -------------------------- This patch has a VistA Mumps component and a JAVA GUI component. Installation instructions for the JAVA GUI component can be found in the BRS Server and Client Installation Guide; this guide isn't available on the software directory. Pre-Installation Instructions: Follow these instructions to install the Mumps component of ANRV*5.1*1. The patch is recommended to be installed during non-peak hours with minimal users on the system to avoid potential disruptions. This patch should take less than 5 minutes to install. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 2. Prior to installing the patch you may want to make use of the following optional installation options located on the KIDS Installation menu: a. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. b. 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 (routines, DD's, templates, etc.). c. Backup a Transport Global - This option will 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 build name ANRV*5.1*1 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 ************************NOTE************************************** For this install choose Build. 3. Install the KIDS distribution via the 'Install Package(s)' option on the KIDS Installation menu. a. When prompted 'Want to continue installing this build? NO// 'Answer YES b. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//' Answer YES c. When prompted 'Want KIDS to INHIBIT LOGONS during the install' NO//' Answer NO. d. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' Answer NO. NOTE: ANRV5P may be deleted after installation of ANRV*5.1*1. Post-Installation Instructions: ------------------------------- Sites will need to update BRS Icons and shortcuts to new Production URL https://vaww.blindrehab.domain.ext/ to be provided by the Program. Back-Out/Roll Back Plan: ------------------------ Backout of this patch will be performed only with the concurrence and participation of the appropriate VA site/region personnel. The decision to back out the patch will be a joint decision between VA site/region personnel and other appropriate VA personnel. Prior to installing the patch, the site/region should have saved a backup of in a mail message using the Backup a Transport Global [XPD BACKUP] menu option. The message containing the backed up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function INSTALL/CHECK MESSAGE is then used to install the backed-up routines onto the VistA system. Note: In the event a site decides to back out this patch, the site should contact the National Service Desk (NSD) to submit a Service Now Incident. Please reference the Blind Rehabilitation (ANRV) Deployment, Installation, Back-out and Rollback Guide. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.1;BLIND REHABILITATION;**[Patch List]**;JUN 2, 2022;Build 12 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: ANRV5P Before: n/a After: B1217152 **1** ============================================================================= User Information: Entered By : Date Entered : MAR 26, 2009 Completed By: Date Completed: AUG 15, 2022 Released By : Date Released : AUG 15, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT