Installation, Back-out, and Rollback Guide Template
Health Administration Product Enhancements (HAPE) FY16 Revenue Enhancements MaintenanceCorrect 5B Record for Cross-ServicingAccounts ReceivablePRCA*4.5*341Deployment, Installation, Back-Out, and Rollback GuideAugust 2018Department of Veterans AffairsOffice of Information and Technology (OI&T)Revision HistoryDateVersionDescriptionAuthor7/17/20181.0Initial Document CreationREDACTEDArtifact Rationale This document describes the Deployment, Installation, Back-out, and Rollback Plan for new products going into the VA Enterprise. The plan includes information about system support, issue tracking, escalation processes, and roles and responsibilities involved in all those activities. Its purpose is to provide clients, stakeholders, and support personnel with a smooth transition to the new product or software, and should be structured appropriately, to reflect particulars of these procedures at a single or at multiple locations.Per the Veteran-focused Integrated Process (VIP) Guide, the Deployment, Installation, Back-out, and Rollback Plan is required to be completed prior to Critical Decision Point #2 (CD #2), with the expectation that it will be updated throughout the lifecycle of the project for each build, as needed. Table of Contents TOC \o \h \z \t "Appendix 1,1" 1Introduction PAGEREF _Toc522795055 \h 51.1Purpose PAGEREF _Toc522795056 \h 51.2Dependencies PAGEREF _Toc522795057 \h 51.3Constraints PAGEREF _Toc522795058 \h 52Roles and Responsibilities PAGEREF _Toc522795059 \h 53Deployment PAGEREF _Toc522795060 \h 63.1Timeline PAGEREF _Toc522795061 \h 63.2Site Readiness Assessment PAGEREF _Toc522795062 \h 63.2.1Deployment Topology (Targeted Architecture) PAGEREF _Toc522795063 \h 63.2.2Site Information (Locations, Deployment Recipients) PAGEREF _Toc522795064 \h 63.2.3Site Preparation PAGEREF _Toc522795065 \h 63.3Resources PAGEREF _Toc522795066 \h 63.3.1Hardware PAGEREF _Toc522795067 \h 73.3.2Software PAGEREF _Toc522795068 \h 73.3.3Communications PAGEREF _Toc522795069 \h 73.3.3.1Deployment/Installation/Back-Out Checklist PAGEREF _Toc522795070 \h 74Installation PAGEREF _Toc522795071 \h 74.1Pre-installation and System Requirements PAGEREF _Toc522795072 \h 74.2Platform Installation and Preparation PAGEREF _Toc522795073 \h 84.3Download and Extract Files PAGEREF _Toc522795074 \h 84.4Database Creation PAGEREF _Toc522795075 \h 84.5Installation Scripts PAGEREF _Toc522795076 \h 84.6Cron Scripts PAGEREF _Toc522795077 \h 84.7Access Requirements and Skills Needed for the Installation PAGEREF _Toc522795078 \h 84.8Installation Procedure PAGEREF _Toc522795079 \h 84.9Installation Verification Procedure PAGEREF _Toc522795080 \h 94.10Implementation Procedure PAGEREF _Toc522795081 \h 94.11System Configuration PAGEREF _Toc522795082 \h 94.12Database Tuning PAGEREF _Toc522795083 \h 95Back-Out Procedure PAGEREF _Toc522795084 \h 95.1Back-Out Strategy PAGEREF _Toc522795085 \h 95.2Back-Out Considerations PAGEREF _Toc522795086 \h 105.2.1Load Testing PAGEREF _Toc522795087 \h 105.2.2User Acceptance Testing PAGEREF _Toc522795088 \h 105.3Back-Out Criteria PAGEREF _Toc522795089 \h 105.4Back-Out Risks PAGEREF _Toc522795090 \h 105.5Authority for Back-Out PAGEREF _Toc522795091 \h 105.6Back-Out Procedure PAGEREF _Toc522795092 \h 115.7Back-out Verification Procedure PAGEREF _Toc522795093 \h 116Rollback Procedure PAGEREF _Toc522795094 \h 116.1Rollback Considerations PAGEREF _Toc522795095 \h 116.2Rollback Criteria PAGEREF _Toc522795096 \h 116.3Rollback Risks PAGEREF _Toc522795097 \h 126.4Authority for Rollback PAGEREF _Toc522795098 \h 126.5Rollback Procedure PAGEREF _Toc522795099 \h 126.6Rollback Verification Procedure PAGEREF _Toc522795100 \h 12IntroductionThis document describes how to deploy and install the Revenue Enhancements Maintenance, CORRECT 5B RECORD FOR CROSS-SERVICING, Accounts Receivable patch PRCA*4.5*341 as well as how to back-out the product and rollback to a previous version or data set. This document is a companion to the project charter and management plan for this effort. PurposeThe purpose of this plan is to provide a single, common document that describes how, when, where, and to whom the Revenue Enhancements Maintenance, CORRECT 5B RECORD FOR CROSS-SERVICING, Accounts Receivable patch PRCA*4.5*341 will be deployed and installed, as well as how it is to be backed out and rolled back, if necessary. The plan also identifies resources, communications plan, and rollout schedule. Specific instructions for installation, back-out, and rollback are included in this document. DependenciesThis product is a VistA patch. It is a follow-up patch to Accounts Receivable patch PRCA*4.5*339 and as such patch *339 must be installed before patch *341. ConstraintsThis product is a VistA patch. The only constraint associated with the patch installation is that patch PRCA*4.5*339 must be installed before this patch can be installed. Roles and ResponsibilitiesTable SEQ Table \* ARABIC 1: Deployment, Installation, Back-out, and Rollback Roles and ResponsibilitiesTeamPhase / RoleTasksHealth Product SupportDeploymentPlan and schedule deployment (including orchestration with vendors)Health Product Support and existing local VAMC and CPAC processesDeployment Determine and document the roles and responsibilities of those involved in the deployment.Health Product Support and VIP Release AgentDeploymentTest for operational readiness Health Product SupportDeploymentExecute deploymentDesignated VistA patch installer for this packageInstallationPlan and schedule installation Designated VistA patch installer for this package and VIP Release AgentInstallationEnsure authority to operate and that certificate authority security documentation is in placeCPAC Revenue AnalystsInstallationsCoordinate training Designated VistA patch installer for this package, and CPAC Revenue Analysts, Health Product Support, and Development TeamBack-outConfirm availability of back-out instructions and back-out strategy (what are the criteria that trigger a back-out) Product Development Team during warranty period, afterwards (software only) Tier 1, Tier 2, Tier 3 / VistA MaintenancePost DeploymentHardware, Software and System SupportDeployment The deployment is planned as a simultaneous national rollout to all VistA production instances. This section provides the schedule and milestones for the deployment. Timeline The deployment and installation is scheduled to run for 30 days starting with the National Release date and concluding with the National Compliance date by which time all VistA production instances should have the patch installed. Site Readiness Assessment This section discusses the locations that will receive the Revenue Enhancements Maintenance, CORRECT 5B RECORD FOR CROSS-SERVICING, Accounts Receivable patch PRCA*4.5*341 deployment. Deployment Topology (Targeted Architecture)N/A for a VistA patch. Site Information (Locations, Deployment Recipients) All VistA production instances. The IOC test sites for this project were Durham (558), Central Alabama HCS (619), and Upstate NY HCS (528).Site Preparation None required other than prerequisite patch installation as described in the patch description and in the Forum NPM.ResourcesThe Revenue Enhancements Maintenance, CORRECT 5B RECORD FOR CROSS-SERVICING, Accounts Receivable patch PRCA*4.5*341 is a VistA patch and does not require any special or specific resources other than an existing and functional VistA system.Hardware There is no specific hardware required other than that which already hosts the VistA system. This is a software enhancement that will not require additional hardware.Software There is no specific software required other than that which already hosts the VistA munications When VistA patches are nationally released from the Forum National Patch Module (NPM) the patch is automatically sent to the targeted VistA systems nationwide. When VistA patches are installed at a site, a notification is sent back to the NPM in order to track which sites have and have not installed a patch. This is part of the standard VistA patch notifications and communications protocols.Deployment/Installation/Back-Out ChecklistThe Release Management team will deploy the patch PRCA*4.5*341, which is tracked in the NPM in Forum, nationally to all VAMCs. Forum automatically tracks the patches as they are installed in the different VAMC production systems as described in the previous section. One can run a report in Forum to identify when the patch was installed in the VistA production at each site, and by whom. A report can also be run, to identify which sites have not installed the patch in their VistA production system as of that moment in time. Therefore, this information does not need to be manually tracked in the chart below. The table is included below if manual tracking is desired and because it is part of the VIP document template.Table 6: 3.3.4.1 Deployment/Installation/Back-Out ChecklistActivityDayTimeIndividual who completed taskDeployInstallBack-OutInstallationPre-installation and System RequirementsThis product is a VistA patch. The only pre-installation and system requirements for deployment and installation of this patch are the prerequisite patches which need to be installed before this patch can be installed. Platform Installation and PreparationThis product is a VistA patch. The only requirement is that patch PRCA*4.5*339 be installed before patch PRCA*4.5*341.Sites should install patches into the test/mirror/pre-prod accounts before the production account as is the normal VistA patch installation standard convention.When installing any VistA patch, sites should utilize the option “Backup a Transport Global” in order to create a backup message of any routines exported with this patch. This step is important to make any routine rollback in a simple and efficient manner.Post-installation checksums are found in the patch description and in Forum NPM.Download and Extract FilesN/A for this VistA patch.Database CreationN/A for this VistA patch.Installation ScriptsN/A for this VistA patch.Cron ScriptsN/A for this VistA patch.Access Requirements and Skills Needed for the InstallationTo install this VistA patch, the patch installer must be an active user on the VistA system and have access to the VistA menu option “Kernel Installation & Distribution System” [XPD MAIN] and have VistA security keys XUPROG and XUPROGMODE. Knowledge on how to install VistA patches using the items on this menu option is also a required skill.Installation ProcedureInstallation Instructions:-------------------------- 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME enter PRCA*4.5*341. a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes such as DDs or templates. 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, DDs, templates, etc. c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install. 5. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' Enter NO 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' Enter NO 7. If prompted 'Delay Install (Minutes): (0 - 60): 0//' respond 0. Installation Verification ProcedureVerify completed installation by comparing the post-install routine checksums against the published checksums in the patch description and in Forum NPM. Implementation ProcedureN/A for this VistA patch. System ConfigurationN/A for this VistA patch. Database TuningN/A for this VistA patch.Back-Out ProcedureBack-Out pertains to a return to the last known good operational state of the software and appropriate platform settings. Back-Out StrategyThe back-out plan for VistA applications is complex and is not able to be a “one size fits all” strategy. The general strategy for VistA software back-out is to repair the code with a follow-up patch. The development team recommends that sites log a ticket if it is a nationally released patch; otherwise, the site should contact the Enterprise Program Management Office (EPMO) directly for specific solutions to their unique problems.Although it is unlikely due to care in collecting approved requirements, SQA/PBM review and multiple testing stages (Primary Developer, Secondary Developer, and Component Integration Testing) a back-out decision due to major issues with this patch could occur during site Mirror Testing, Site Production Testing or after National Release to the Field. The strategy would depend on during which of these stages the decision is made. If during Site Production Testing, unless the patch produces catastrophic problems, the normal VistA response would be for a new version of the test patch correcting defects to be produced, retested and upon successfully passing development team testing would be resubmitted to the site for testing. This project, however, has prepared a set of back-out patch instructions if necessary, as in the case that the project is canceled or the implemented design is found to be so wrong and detrimental to the site’s delivery of services to veterans that the software must be removed. If the defects were not discovered until after national release but during the 30 days support period, a new patch will be entered into the National Patch Module on Forum and go through all the necessary milestone reviews etc. as an emergency patch. After 30 days, the VistA Maintenance Program would produce the new patch, either to correct the defective components or to back-out.Back-Out ConsiderationsIt is necessary to determine if a wholesale back-out of the patch PRCA*4.5*341 is needed or if a better course of action is to correct through a new version of the patch (if prior to national release) or through a subsequent patch aimed at specific areas modified or affected by the original patch (after national release). A wholesale back-out of the patch will still require a new version (if prior to national release) or a subsequent patch (after national release). If the back-out is post-release of patch PRCA*4.5*341, this patch should be assigned status of “Entered in Error” in Forum’s NPM. Load TestingN/A for this VistA patch.User Acceptance TestingThis is detailed in the User Stories in Rational Tools Management.Back-Out CriteriaThe decision to back-out this VistA patch will be made by Health Product Support, CPAC Revenue System Management staff, and the Development Team. Criteria to be determined based on separate and unique factors and will be evaluated upon post-patch installation use of the product.Back-Out RisksN/A for this VistA patch.Authority for Back-OutBack-out authorization will be determined by a consensus consisting of the following individuals:Health Product Support ManagementRelease ManagersCPAC Revenue System ManagersDevelopment TeamBack-Out ProcedureDuring the VistA Installation Procedure of the KIDS build, the installer can back up the modified routines using the ‘Backup a Transport Global’ action.?The installer can restore the routines using the MailMan message that were saved prior to installing the patch.?All software components (routines and other items) must be restored to their previous state at the same time and in conjunction with restoration of the data. This back-out may need to include a database cleanup process. Please contact the EPMO for assistance if the installed patch that needs to be backed out contains anything at all besides routines before trying to back-out the patch. If the installed patch that needs to be backed out includes a pre or post install routine please contact the EPMO before attempting the back-out.From the Kernel Installation and Distribution System Menu, selectthe Installation Menu.?From this menu, you may elect to use thefollowing option. When prompted for the INSTALL enter the patch #.????a. Backup a Transport Global - This option will create a backup?????? message of any routines exported with this patch. It will not?????? backup any other changes such as DD's or templates.Locate the Transport Global Backup message which should have been created as a part of the patch installation and restore the software from that Packman message containing the pre-installation version of the routines. If this message was not created or cannot be found, then contact Health Product Support for help in generating a new Packman message from another source.Back-out Verification ProcedureThe success of the back-out can be verified by verifying checksums for the routines removed to validate that they reflect the nationally released checksums. Rollback ProcedureRollback pertains to data associated with this patch.Rollback ConsiderationsN/A for this VistA patch as there is no data associated with this patch.Rollback CriteriaN/A for this VistA patch as there is no data associated with this patch.Rollback RisksN/A for this VistA patch as there is no data associated with this patch.Authority for RollbackN/A for this VistA patch as there is no data associated with this patch.Rollback ProcedureN/A for this VistA patch as there is no data associated with this patch.Rollback Verification ProcedureN/A for this VistA patch as there is no data associated with this patch.Template Revision HistoryDateVersionDescriptionAuthorMarch 20162.2Changed the title from Installation, Back-Out, and Rollback Guide to Deployment and Installation Guide, with the understanding that Back-Out and Rollback belong with Installation. VIP TeamFebruary 20162.1Changed title from Installation, Back-Out, and Rollback Plan to Installation, Back-Out, and Rollback Guide as recommended by OI&T Documentation Standards CommitteeOI&T Documentation Standards CommitteeDecember 20152.0The OI&T Documentation Standards Committee merged the existing “Installation, Back-Out, Rollback Plan” template with the content requirements in the OI&T End-user Documentation Standards for a more comprehensive Installation Plan.OI&T Documentation Standards CommitteeFebruary 20151.0Initial DraftLifecycle and Release Management ................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.
Related searches
- rate and service guide 2019
- 2019 ups rate and service guide usa
- chronic back pain and disability
- back pain and autoimmune disorders
- back pain and nerve damage
- interview guide template for managers
- education back then and now
- grammar and punctuation guide pdf
- formula to back out percentages
- back pain and inflammatory foods
- how to back out a percentage
- back pain and thigh numbness