1. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 5/26/2017 2:33:36 PM Eastern Daylight Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.

1.1 Files compared

# Location File Last Modified
1 YS_5.01_121_T2.zip ys501121_Deployment Installation Roll Back Back-Out Guide.docx Thu May 25 18:24:24 2017 UTC
2 YS_5.01_121_T2.zip ys501121_Deployment Installation Roll Back Back-Out Guide.docx Fri May 26 13:52:27 2017 UTC

1.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 1 648
Changed 0 0
Inserted 0 0
Removed 0 0

1.3 Comparison options

Whitespace
Character case Differences in character case are significant
Line endings Differences in line endings (CR and LF characters) are ignored
CR/LF characters Not shown in the comparison detail

1.4 Active regular expressions

No regular expressions were active.

1.5 Comparison detail

  1   Mental Hea lth YS*5.0 1*121
  2   Deployment , Installa tion, Back -Out, and  Rollback G uide
  3  
  4  
  5   March 2017
  6   Department  of Vetera ns Affairs
  7   Office of  Informatio n and Tech nology (OI &T)
  8   .
  9  
  10  
  11   Revision H istory
  12   Date
  13   Version
  14   Descriptio n
  15   Author
  16   March 2017
  17   1.0
  18   Updated wi th team in put
  19   Aaron Lind strom, VA  PM; James  Goldsmith,  HP PM
  20   March 2017
  21   0.01
  22   Initial Ve rsion
  23   Kevin Meld rum
  24  
  25   Artifact R ationale
  26   This docum ent descri bes the De ployment,  Installati on, Back-o ut, and Ro llback Pla n for new  products g oing into  the VA Ent erprise. T he plan in cludes inf ormation a bout syste m support,  issue tra cking, esc alation pr ocesses, a nd roles a nd respons ibilities  involved i n all thos e activiti es. Its pu rpose is t o provide  clients, s takeholder s, and sup port perso nnel with  a smooth t ransition  to the new  product o r software , and shou ld be stru ctured app ropriately , to refle ct particu lars of th ese proced ures at a  single or  at multipl e location s.
  27   Per the Ve teran-focu sed Integr ated Proce ss (VIP) G uide, the  Deployment , Installa tion, Back -out, and  Rollback P lan is req uired to b e complete d  prior t o Critical  Decision  Point #2 ( CD #2), wi th the exp ectation t hat it wil l be updat ed through out the li fecycle of  the proje ct for eac h build, a s needed. 
  28  
  29  
  30  
  31  
  32  
  33   Table of C ontents
  34   1Introduct ion5
  35   1.1Purpose 5
  36   1.2Depende ncies5
  37   1.3Constra ints5
  38   2Roles and  Responsib ilities5
  39   3Deploymen t6
  40   3.1Timelin e6
  41   3.2Site Re adiness As sessment7
  42   3.2.1Deplo yment Topo logy (Targ eted Archi tecture)7
  43   3.2.2Site  Informatio n (Locatio ns, Deploy ment Recip ients)7
  44   3.2.3Site  Preparatio n7
  45   3.3Resourc es7
  46   3.3.1Facil ity Specif ics (optio nal)7
  47   3.3.2Hardw are7
  48   3.3.3Softw are7
  49   3.3.4Commu nications7
  50   4Installat ion7
  51   4.1Pre-ins tallation  and System  Requireme nts7
  52   4.2Platfor m Installa tion and P reparation 7
  53   4.3Access  Requiremen ts and Ski lls Needed  for the I nstallatio n9
  54   4.4Install ation Proc edure9
  55   4.5Install ation Veri fication P rocedure10
  56   4.6System  Configurat ion11
  57   4.7Databas e Tuning11
  58   5Back-Out  Procedure1 1
  59   5.1Back-Ou t Strategy 11
  60   5.2Back-Ou t Consider ations11
  61   5.3Back-Ou t Criteria 11
  62   5.4Back-Ou t Risks11
  63   5.5Authori ty for Bac k-Out11
  64   5.6Back-Ou t Procedur e11
  65   5.7Back-ou t Verifica tion Proce dure12
  66   6Rollback  Procedure1 2
  67   6.1Rollbac k Consider ations12
  68   6.2Rollbac k Criteria 12
  69   6.3Rollbac k Risks12
  70   6.4Authori ty for Rol lback12
  71   6.5Rollbac k Procedur e12
  72   6.6Rollbac k Verifica tion Proce dure13
  73  
  74   Introducti on
  75   This docum ent descri bes how to  deploy an d install  the patch  YS*5.01*12 1 of the M ental Heal th package , as well  as how to  back-out t he product  and rollb ack to a p revious ve rsion or d ata set. T his docume nt is a co mpanion to  the proje ct charter  and manag ement plan  for this  effort in  this docum ent.
  76   Purpose
  77   The purpos e of this  plan is to  provide a  single, c ommon docu ment that  describes  how, when,  where, an d to whom  Mental Hea lth patch  YS*5.01*12 1 will be  deployed a nd install ed, as wel l as how i t is to be  backed ou t and roll ed back, i f necessar y. The pla n also ide ntifies re sources, c ommunicati ons plan,  and rollou t schedule . Specific  instructi ons for in stallation , back-out , and roll back are i ncluded in  this docu ment.  
  78   Dependenci es
  79   It is assu med that t his patch  is being i nstalled i nto a full y patched  VistA syst em.  In pa rticular,  patch YS*5 .01*119 mu st be inst alled prio r to the i nstallatio n of this  patch.
  80   Constraint s
  81   There are  no constra ints beyon d the inst allation i nto an up- to-date Vi stA system .
  82   Roles and  Responsibi lities
  83   The follow ing descri bes the ro les and re sponsibili ties assoc iated with  the testi ng and rel ease of YS *5.01*121.   This is  a VistA pa tch that w ill be dep loyed via  the normal  Mailman r oute.
  84   Table 1: D eployment,  Installat ion, Back- out, and R ollback Ro les and Re sponsibili ties
  85   ID
  86   Team
  87   Phase / Ro le
  88   Tasks
  89   Project Ph ase (See S chedule)
  90  
  91   Project Ma nager
  92   Deployment
  93   Determine  and docume nt the rol es and res ponsibilit ies of tho se involve d in the d eployment.
  94   Design
  95  
  96   SQA, Test  Sites
  97   Deployment
  98   Test for o perational  readiness  
  99   Test
  100  
  101   Project Ma nager, Rel ease Manag er
  102   Deployment
  103   Execute de ployment
  104   Release
  105  
  106   Individual  VistA Sit es
  107   Installati on
  108   Plan and s chedule in stallation  
  109   Release
  110  
  111   Release Ma nager
  112   Back-out
  113   Confirm av ailability  of back-o ut instruc tions and  back-out s trategy (w hat are th e criteria  that trig ger a back -out) 
  114   Release
  115  
  116   Sustainmen t Team
  117   Post Deplo yment
  118   Hardware,  Software a nd System  Support
  119   Sustain
  120   Deployment  
  121   The deploy ment is pl anned as a  simultane ous (Natio nal Releas e) rollout .
  122   This secti on provide s the sche dule and m ilestones  for the de ployment. 
  123   Timeline 
  124   The deploy ment and i nstallatio n is sched uled to ru n from Mar ch 2017 th rough June  2017 as d epicted in  the Maste r Deployme nt Schedul e in the P CL-5 MHAS  Project Ma nagement P lan. Refer  to RTC/MH LTH/MHLTH_ MHAS_PCL5/  MHLTH_MHA S_PCL5_Doc umentation  (6: UAT S ept_7_2016 )/PM/Overa rching.
  125   Site Readi ness Asses sment 
  126   This secti on discuss es the loc ations tha t will rec eive the Y S*5.01*121  deploymen t. 
  127   Deployment  Topology  (Targeted  Architectu re)
  128   This will  be a patch  to VA Vis tA systems  distribut ed via FOR UM.
  129   Site Infor mation (Lo cations, D eployment  Recipients
  130   This patch  will be i nstalled o n all Vist A instance s within t he 90 day  compliance  window af ter it is  nationally  released.   The test  sites are  Cleveland  and Milwa ukee.
  131   Site Prepa ration 
  132   Other than  a fully p atched Vis tA system,  there is  no other p reparation  required.
  133   Resources
  134   Facility S pecifics ( optional)
  135   N/A
  136   Hardware 
  137   N/A
  138   Software 
  139   N/A
  140   Communicat ions 
  141   When the p atch is re leased, th e notifica tion of th e released  patch wil l be sent  to VistA s ites per t he usual m echanism v ia FORUM.
  142   When sites  choose to  install t he patch,  they shoul d notify u sers of th e Mental H ealth pack ages about  the insta llation an d updates  to Mental  Health ins truments.
  143   Installati on
  144   Pre-instal lation and  System Re quirements
  145   Mental Hea lth patch  YS*5.01*11 9 must be  installed  prior to t he install ation of Y S*5.01*121 .  The env ironment c heck for Y S*5.01*121  will veri fy this.
  146   Platform I nstallatio n and Prep aration
  147   Mental Hea lth patch  YS*5.01*11 9 must be  installed  prior to t he install ation of Y S*5.01*121 .  The env ironment c heck for Y S*5.01*121  will veri fy this.
  148   This patch  installs  new instru ments that  will cons ume about  2MB of dis k space in  the ^XTMP  global du ring insta llation.   The growth  of the ^Y TT global  will be ab out 1MB.
  149   This patch  can be lo aded with  users in t he system  but it is  recommende d that it  be install ed when us er activit y is low.  Installati on time wi ll be less  than 5 mi nutes.
  150   It is reco mmended th at you use  the “Back up a Trans port Globa l” option  that is re ferenced i n the inst allation i nstruction s.  This w ill be use ful should  it be dec ided to ba ck out the  installat ion.
  151   To ensure  the integr ity of the  transport  global, u se the “Ve rify Check sums in Tr ansport Gl obal” to c ompare the  checksums  with the  list that  follows: 
  152   The checks ums below  are new ch ecksums, a nd can be  checked wi th CHECK1^ XTSUMBLD.
  153   Routine Na me: YS121P ST
  154       Before :       n/ a   After:  B23620999   **121**
  155   Routine Na me: YSASA2
  156       Before : B2382840 7   After:  B24374661   **24,30, 32,38,121* *
  157   Routine Na me: YSASFM
  158       Before : B1245976 8   After:  B13567691   **24,30, 32,37,38,5 5,76,121**
  159   Routine Na me: YSASGP H
  160       Before :  B959440 2   After:  B10438975   **24,30, 37,121**
  161   Routine Na me: YSASLI B
  162       Before : B1297505 7   After:  B13582273   **24,37, 121**
  163   Routine Na me: YSASOL
  164       Before : B2923665 4   After:  B30117483   **24,30, 32,38,121* *
  165   Routine Na me: YSASPR T
  166       Before :  B481747 1   After:   B5189916   **24,30, 38,76,121* *
  167   Routine Na me: YSASRU
  168       Before : B2447097 4   After:  B24477197   **24,30, 32,38,55,1 06,121**
  169   Routine Na me: YSASRU 1
  170       Before :  B608197 2   After:   B6409525   **24,30, 32,38,121* *
  171   Routine Na me: YSASSE L
  172       Before : B2367474 8   After:  B27844186   **24,30, 38,76,121* *
  173   Routine Na me: YSASU
  174       Before : B2208917 1   After:  B23877912   **38,121 **
  175   Routine Na me: YSASU1
  176       Before :  B708234 4   After:   B7521838   **38,121 **
  177   Routine Na me: YTQAPI 1
  178       Before : B2827275 1   After:  B28881859   **85,119 ,121**
  179   Routine Na me: YTQAPI 14
  180       Before : B3074991 3   After:  B31797790   **85,97, 96,103,119 ,121**
  181   Routine Na me: YTQAPI 2
  182       Before : B2342948 2   After:  B24402405   **85,96, 119,121**
  183   Routine Na me: YTQAPI 2A
  184       Before :       n/ a   After:  B20357821   **121**
  185   Routine Na me: YTQAPI 8
  186       Before : B3277151 1   After:  B33168164   **85,121 **
  187   Routine Na me: YTQAPI 9
  188       Before : B2967523 7   After:  B30004209   **85,96, 119,121**
  189   Routine Na me: YTXCHG
  190       Before :       n/ a   After:  B53596106   **121**
  191   Routine Na me: YTXCHG E
  192       Before :       n/ a   After:  B29307956   **121**
  193   Routine Na me: YTXCHG I
  194       Before :       n/ a   After:  B54913462   **121**
  195   Routine Na me: YTXCHG L
  196       Before :       n/ a   After:  B41031528   **121**
  197   Routine Na me: YTXCHG M
  198       Before :       n/ a   After:  B68668785   **121**
  199   Routine Na me: YTXCHG P
  200       Before :       n/ a   After:  B14086583   **121**
  201   Routine Na me: YTXCHG S
  202       Before :       n/ a   After:    B897882   **121**
  203   Routine Na me: YTXCHG T
  204       Before :       n/ a   After:  B19049216   **121**
  205   Routine Na me: YTXCHG U
  206       Before :       n/ a   After:  B33209921   **121**
  207   Routine Na me: YTXCHG V
  208       Before :       n/ a   After:  B28434999   **121**
  209   Routine Na me: YTXUTL
  210       Before :       n/ a   After:   B4333737   **121**
  211    
  212   Routine li st of prec eding patc hes: 76, 1 06, 119
  213   Access Req uirements  and Skills  Needed fo r the Inst allation
  214   The instal lation mus t be perfo rmed by so meone with  access to  the KIDS  Install me nu.
  215   Installati on Procedu re
  216   1.  Choose  the PackM an message  containin g this pat ch and inv oke the IN STALL/CHEC K MESSAGE  PackMan op tion.  
  217   2.  Start  up the Ker nel Instal lation and  Distribut ion System  Menu [XPD  MAIN]: 
  218               Edits and  Distribut ion ...  
  219            U tilities . ..  
  220            I nstallatio n ...  
  221         Sele ct Kernel  Installati on & Distr ibution Sy stem Optio n: Install ation
  222            1       Load  a Distrib ution
  223            2       Veri fy Checksu ms in Tran sport Glob al
  224            3       Prin t Transpor t Global
  225            4       Comp are Transp ort Global  to Curren t System
  226            5       Back up a Trans port Globa l
  227            6       Inst all Packag e(s)
  228                    Rest art Instal l of Packa ge(s)
  229                    Unlo ad a Distr ibution
  230     3.  From  this menu , you may  elect to u se the fol lowing opt ions (When  prompted  for the IN STALL NAME , enter YS *5.01*121) :
  231       a.  Ba ckup a Tra nsport Glo bal - This  option wi ll create  a backup m essage of  any routin es exporte d with thi s patch. I t will not  backup an y other ch anges such  as DD's o r template s.
  232       b.  Co mpare Tran sport Glob al to Curr ent System  - This op tion will  allow you  to view al l changes  that will  be made wh en this pa tch is ins talled.  I t compares  all compo nents of t his         patch (ro utines, DD 's, templa tes, etc.) .
  233       c.  Ve rify Check sums in Tr ansport Gl obal - Thi s option w ill allow  you to ens ure the in tegrity of  the routi nes that a re in the  transport  global.
  234     
  235   4.  Use th e Install  Package(s)  option an d select t he package  YS*5.01*1 21.
  236       a.  Wh en prompte d "Want KI DS to Rebu ild Menu T rees Upon  Completion  of Instal l? NO//",  answer NO.
  237       b.  Wh en prompte d "Want KI DS to INHI BIT LOGONs  during th e install?  NO//", an swer NO.
  238       c.  Wh en prompte d "Want to  DISABLE S cheduled O ptions and  Menu Opti ons and Pr otocols? N O//", answ er NO.
  239   Installati on Verific ation Proc edure
  240   After inst allation,  notify men tal health  package u sers that  the follow ing new in struments  are availa ble:
  241    Alcohol S moking and  Substance  Involveme nt Screeni ng
  242    - NIDA mo dified ver sion                                 ASSIST -NIDA
  243    Brief Res iliency Sc ale                                  BRS
  244    Cross-Cut ting Sympt om Assessm ent for DS M-5            CCSA-D SM5
  245    Client Ev aluation o f Motivati onal Inter viewing        CEMI
  246    Couple Sa tisfaction  Index                               CSI
  247    Couple Sa tisfaction  Index - 4  Item                     CSI-4
  248    Couple Sa tisfaction  Index Par tner Versi on             CSI PA RTNER VERS ION
  249    Couple Sa tisfaction  Index - 4  Item Part ner Versio n   CSI-4  PARTNER
  250                                                              VERSIO N
  251    Geriatric  Anxiety I nventory                             GAI
  252    Insomnia  Severity I ndex                                 ISI
  253    Modified  Katz Index  of ADLs                             KATZ-A DL-6pt
  254    Pain Stag es of Chan ge Questio nnaire                    PSOCQ
  255    Perceived  Stress Sc ale                                  PSS
  256    Restless  Legs Syndr ome Rating  Scale                    RLS
  257    Smith Mor ning-Eveni ng Scale                             SMEQ
  258    Sleep Nee d Question naire                                SNQ
  259    Snoring,  Tired, Obs erved, Blo od Pressur e              STOP
  260   These inst ruments ar e no longe r availabl e:
  261    Alcohol U se Invento ry (Revise d)                        AUIR
  262    Center fo r Epidemio logic Stud ies Depres sion Scale  
  263      (5-item  version)                                       CESD5
  264    Depressio n Outcome  Module 8.0                           DOM80
  265    Depressio n Outcomes  Module: G eriatric S creen          DOMG
  266    Employmen t Readines s Scale                              ERS
  267    Health Lo cus of Con trol Scale                           HLOC
  268    Rotter In ternal-Ext ernal Scal e                         IEQ
  269    Rotter Lo cus of Con trol                                 RLOC
  270    Spiritual  Assessmen t Inventor y                         SAI
  271    Crowne-Ma rlowe Soci al Desirab ility Scal e              SDES
  272    Short Mic higan Alco holism Scr eening Tes t              SMAST
  273    Validity  Scale                                           VALD
  274    Ward Atmo sphere Sca le                                   WAS
  275   System Con figuration
  276   N/A
  277   Database T uning
  278   N/A
  279   Back-Out P rocedure
  280   Back-Out S trategy
  281   It is poss ible to pa rtially ba ck-out the  installat ion of YS* 5.01*121.   This woul d involve  restoring  instrument  specifica tions to t heir previ ous state  and then r estoring t he saved r outines.   The back-o ut of chan ges to the  data dict ionary wou ld require  a patch t o a patch.
  282   Back-Out C onsiderati ons
  283   Please con tact VistA  support a nd the dev elopment t eam before  attemptin g a back-o ut.  The b ack-out pr ocedure wi ll still l eave some  changes in  place.  I n addition , the inst allation o f subseque nt patches  may be pr oblematic  if YS*5.01 *121 is no t installe d.
  284   Back-Out C riteria
  285   A back-out  should on ly be cons idered if  there is a  patient s afety issu e, if Ment al Health  Assistant  no longer  functions,  or if the re is some  other cat astrophic  failure.
  286   Back-Out R isks
  287   The risks  vary depen ding on wh at is caus ing the fa ilure of t he system.   The main  risk is t hat the Me ntal Healt h package  would be l eft in an  unknown co nfigured s tate.
  288   Authority  for Back-O ut
  289   The VistA  system man ager deter mines if a  back-out  of YS*5.01 *121 shoul d be consi dered.
  290   Back-Out P rocedure
  291   If you wis h to resto re newly i nstalled i nstruments  to their  previous s tate, you  must do th at before  any other  back-out s teps.  See  the instr uctions fo r restorin g the prev ious instr ument stat e in the R ollback Pr ocedure se ction to d o this.
  292   To back-ou t routines , you must  have alre ady select ed the “Ba ckup a Tra nsport Glo bal” optio n during t he install ation proc ess.  To r estore the  previous  routines:
  293   Choose the  PackMan m essage con taining th e backup y ou created  during in stallation .
  294   Invoke the  INSTALL/C HECK MESSA GE PackMan  option.  
  295   Select Ker nel Instal lation & D istributio n System O ption: Ins tallation
  296   Use the In stall Pack age(s) opt ion to ins tall the p reviously  saved rout ines.
  297   If you nee d to back- out data d ictionary  modificati ons, remov e protocol s, options , or templ ates, you  will need  to contact  the devel opment tea m for a pa tch.
  298   Back-out V erificatio n Procedur e
  299   Verificati on of the  back-out p rocedure w ould be th e resoluti on of the  problem th at caused  the need f or the bac k-out.
  300   Rollback P rocedure
  301   Rollback C onsiderati ons
  302   YS*5.01*12 1 adds new  and updat es existin g mental h ealth inst ruments.   It is poss ible to ro ll back th ese change s within o ne week of  the insta llation.
  303   Rollback C riteria
  304   A rollback  might be  considered  if the be havior of  mental hea lth instru ments appe ars to be  adversely  affected a fter insta llation of  YS*5.01*1 21.  The V istA suppo rt and pro duct devel opment tea m should b e contacte d to deter mine if th ere is an  alternativ e fix shor t of a rol lback.
  305   Rollback R isks
  306   A rollback  could adv ersely imp act future  installat ions of me ntal healt h instrume nts and ca use proble ms with sc oring exis ting menta l health i nstruments .
  307   Authority  for Rollba ck
  308   The VistA  system man ager deter mines if a  rollback  of mental  health ins truments d istributed  by YS*5.0 1*121 shou ld be cons idered.
  309   Rollback P rocedure
  310   When YS*5. 01*121 is  installed,  a backup  is made of  each inst rument tha t will be  updated.   These inst rument bac kups are s aved in th e MH INSTR UMENT EXCH ANGE file.   Each bac kup begins  with the  text “YTBa ckup” foll owed by th e instrume nt name.
  311   You must p ossess the  XUPROG ke y to view  backup ent ries.
  312  
  313  
  314  
  315  
  316  
  317  
  318   On the MHA 3 Utilitie s menu (YT Q MHA3 MEN U), run th e “Instrum ent Exchan ge” option .  You wil l see some thing like  this scre en:
  319  
  320  
  321   Optionally , if you w ant to see  how many  records wi ll be rest ored, choo se “Trial  Install” t hen select  the numbe r of the b ackup you  wish to re store.
  322   When you a re ready t o restore  an instrum ent, choos e “Install  Exchange  Entry” the n select t he number  of the bac kup you wa nt to rest ore.
  323   Rollback V erificatio n Procedur e
  324   Verify the  restore b y checking  to see th at the ins trument be haves as i t did prio r to the i nstall.