$TXT Created by TEST.CPE.VSM1.CHEYENNE.DOMAIN.EXT (KIDS) on Wednesday, 12/09/20 at 07:50 ============================================================================= Run Date: DEC 15, 2020 Designation: KMP*4*1 Package : KMP - CAPACITY MANAGEMENT Priority: Mandatory Version : 4 SEQ #1 Status: Released Compliance Date: JAN 15, 2021 ============================================================================= Associated patches: (v)XU*8*670 <<= must be installed BEFORE `KMP*4*1' (v)KMP*4*0 <<= must be installed BEFORE `KMP*4*1' Subject: REAL TIME VISTA SYSTEM MONITOR Category: - Routine - Data Dictionary Description: ============ The purpose of patch KMP*4.0*1 is to deploy routines enabling real time collection of VistA System Monitor metrics. Currently metrics are collected over the course of a day and sent in large batches via Mailman. This new functionality will collect and send metric data in small increments. This will lower the burden on the wide area network and provide data to assist in VistA support efforts in real time. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- VSM CONFIGURATION (8969) START PERFMON (1.08) New ENCRYPT (1.09) New NATIONAL IP ADDRESS (4.01) New NATIONAL FQDN (4.02) New NATIONAL PORT (4.03) New APIKEY (4.04) New VSM MONITOR DEFAULTS (8969.02) START PERFMON (.09) New ENCRYPT (.1) New NATIONAL IP ADDRESS (2.01) New NATIONAL FQDN (2.02) New NATIONAL PORT (2.03) New APIKEY (2.04) New Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- KMPV VTCM DATA RETRANSMISSION Run Routine New KMPV VSTM DATA RETRANSMISSION Run Routine New KMPV VBEM DATA RETRANSMISSION Run Routine New KMPV VMCM DATA RETRANSMISSION Run Routine New KMPV VHLM DATA RETRANSMISSION Run Routine New KMPV VCSM DATA RETRANSMISSION Run Routine New KMPV VETM DATA RETRANSMISSION Run Routine New KMPV VTCM DATA TRANSMISSION Run Routine Modified KMPV VSTM DATA TRANSMISSION Run Routine Modified KMPV VBEM DATA TRANSMISSION Run Routine Modified KMPV VMCM DATA TRANSMISSION Run Routine Modified KMPV VHLM DATA TRANSMISSION Run Routine Modified Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- KMPV ALLOW TEST SYSTEM New KMPV CONTACT New KMPV MANAGEMENT MENU Modified KMPV EDIT CFG Deleted KMPV RESTORE CFG Deleted Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- KMPV MANAGMENT List VSM CONFIGURATION (8969) Modified Remote Procedures Associate: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Integration Agreements: IA#: Name-Components: Usage: ---- ---------------- ------ 7135 VPR GET PATIENT DATA XML Private 7136 VPR GET PATIENT DATA JSON Private 7138 DIRECT READ OF ERROR LOG FILE Private 7139 DIRECT READ OF ERROR TRAP SUMMARY FILE Private Additional Information: ---------------------- Blood Bank Coordination: ------------------------ EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch KMP*4*1 contains changes to a package referenced in ProPath standard titled: BBM Team Review of VistA Patches. This patch does not alter or modify any VistA Blood Bank software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch KMP*4*1 have no adverse effect on Blood Bank software functionality, therefore RISK is none. New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: ---------------------------- N/A Problem 1: -------- Data supporting VistA operations, capacity and performance is currently collected throughout each day, but only transmitted nightly in a large MailMan message for each VistA System Monitor. The large MailMan messages cannot be deleted. This data is needed in real time to assist in triage of operational issues that arise and to determine current capacity or performance issues and causes. Resolution 1: ------------ VistA System Monitor code has been altered to send data at the end of each collection period. Data will be sent via small HTTP requests. This will provide data in real time and negate the need to store large MailMan messages on the VistA sites. Problem 2: ---------- There are no VSM monitors to collect CPRS Coversheet Load Timings or Error Trap data. Resolution 2: ------------- Deploy VSM monitors that will send the CPRS Coversheet Load Timing data and Error Trap data in the same format as existing VSM collectors. These collectors will be managed with the same management tools as existing VSM collections. Test Sites: ----------- North Chicago VAMC Hines VAMC West Haven VAMC Spokane VAMC Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. 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/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name -------------------------------------- Installation Guide kmp_4_1_ig.pdf Technical Manual kmp_4_1_tm.pdf User Manual kmp_4_1_um.pdf Patch Installation: Pre/Post Installation Overview: ------------------------------ The Post Installation routine creates new entries in the VSM CONFIGURATION file related to the new monitors being installed. It deletes any legacy RUM/SAGG data. Lastly, it creates the KMP.VistaSystemMonitor class, the KMP Security Application, and the KMP Security SSLConfig. Pre-Installation Instruction: ----------------------------- This patch can be queued for installation. TaskMan does not have to be stopped, Health Level 7 (HL7) filers do not need to be stopped, the current VistA System Monitors do not need to be stopped, and users may be on the system. The patch should be installed during non-peak hours to minimize potential for disruption to users. This patch should take less than 10 minutes to install. It will take a few minutes during the install for existing RUM/SAGG data to be deleted. Note 1: The patch list for the second line of each routine should be **1**. This is the first patch in a new package release, thus the prior patch list is superseded by the current release patch list. Note 2: During installation you will likely see the following message: This Patch is for Version 4, you are running Version 1 Want to continue installing this build? NO// Answer YES to this prompt. The discrepancy is due to a realignment of KMPX namespaces under KMP as a parent. There is no problem. Note 3: The KMPVOPS security key is required to access the VSM Management menu option. Installation Instructions: -------------------------- 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 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. (KMP*4.0*1) NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option for each patch contained in the Host File. For each patch you can specify what to backup; the entire Build or just Routines. The backup message can be used to restore just the routines or everything that will restore your system to pre-patch condition. 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 of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. (KMP*4.0*1) i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer . ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer . iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer . Post-Installation Instructions: ------------------------------ There are no Post-Installation actions. Back-Out/Roll Back Plan: ------------------------ Depending on the reason for executing a backout the following steps should be taken: 1) Inform CPE of the problem. VA IT EPMO VistA System Monitor .Depending on the nature of the issue one or more of the following steps may be taken. A) In the VSM Management menu Select "Delete Data" and confirm deletion for each monitor listed. NOTE: if necessary, the monitors can be stopped manually via command prompt commands. If needed CPE will engage with the VistA ESL to provide specific guidance. B) If decided to be the correct action and if capability is not compromised CPE can remotely revert the VSM functionality to the previous version. C) Lastly, CPE will triage any problems and determine the best means to address. Routine Information: ==================== The second line of each of these routines now looks like: ;;4.0;CAPACITY MANAGEMENT;**[Patch List]**;3/1/2018;Build 27 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: KMPBEMRT Before: n/a After: B54900492 **1** Routine Name: KMPCSMRT Before: n/a After: B45091186 **1** Routine Name: KMPDBD01 Before: B1657961 After: B1443601 **1** Routine Name: KMPDSS Before: B5431197 After: B5411976 **1** Routine Name: KMPETMRT Before: n/a After: B34501556 **1** Routine Name: KMPHLMRT Before: n/a After: B86489478 **1** Routine Name: KMPMCMRT Before: n/a After: B61665748 **1** Routine Name: KMPPST3 Before: n/a After: B59700788 **1** Routine Name: KMPPST3A Before: n/a After: B27040733 **1** Routine Name: KMPPST3B Before: n/a After: B53675638 **1** Routine Name: KMPPST3C Before: n/a After: B85178395 **1** Routine Name: KMPSTMRT Before: n/a After: B50229979 **1** Routine Name: KMPSYNTH Before: n/a After:B244977143 **1** Routine Name: KMPTASK Before: n/a After: B97819818 **1** Routine Name: KMPTCMRT Before: n/a After: B84289901 **1** Routine Name: KMPUTLW Before: n/a After:B118150714 **1** Routine Name: KMPUTLW2 Before: n/a After: B70701886 **1** Routine Name: KMPVCBG Before:B123736244 After:B161602278 **1** Routine Name: KMPVCCFG Before: B56139201 After: B54238170 **1** Routine Name: KMPVLM Before: B24931836 After: B23797066 **1** Routine Name: KMPVRUN Before: B4241858 After: B18402802 **1** ============================================================================= User Information: Entered By : Date Entered : OCT 21, 2019 Completed By: Date Completed: DEC 14, 2020 Released By : Date Released : DEC 15, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT