1. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 12/8/2017 1:03:06 PM Eastern Standard 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 BTSSS_CIF_11162017.zip\BTSSS_CIF_11162017 BTSSS_CMP.docx Thu Nov 16 16:01:58 2017 UTC
2 BTSSS_CIF_11162017.zip\BTSSS_CIF_11162017 BTSSS_CMP.docx Fri Dec 8 17:54:20 2017 UTC

1.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 8 1204
Changed 7 17
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   Configurat ion Manage ment Plan
  2   Beneficiar y Travel S elf-Servic e System ( BTSSS)
  3  
  4  
  5  
  6   November 2 017
  7   Version 4. 02
  8   Department  of Vetera ns Affairs
  9  
  10  
  11   Version Hi story
  12   Date
  13   Version
  14   Descriptio n
  15   Author
  16   11/9/2017
  17   4.02
  18   November M onthly Upd ate – chan ged date o n cover pa ge and foo ters 
  19   Christina  Silva
  20   10/11/2017
  21   4.01
  22   October Mo nthly Upda te – no ch anges
  23   Christina  Silva
  24   9/18/2017
  25   3.04
  26   September  Monthly Up date
  27   Christina  Silva
  28   8/31/2017
  29   3.03
  30   CRMOL upda te
  31   Christina  Silva
  32   8/21/2017
  33   3.02
  34   August Mon thly Updat e
  35   Christina  Silva
  36   7/19/2017
  37   3.01
  38   July Month ly Update
  39   Christina  Silva
  40   6/16/2017
  41   2.03
  42   June Month ly Update
  43   Christina  Silva
  44   5/18/2017
  45   2.02
  46   May Monthl y Update
  47   Christina  Silva
  48   4/18/2017
  49   2.01
  50   April Mont hly Update
  51   Christina  Silva
  52   3/15/2017
  53   1.03
  54   March Mont hly Update
  55   Christina  Silva 
  56   2/24/2017
  57   1.02
  58   February M onthly Upd ate
  59   Christina  Silva 
  60   1/26/2016
  61   1.01
  62   January Mo nthly Upda te
  63   Christina  Silva
  64   12/2/2016
  65   0.04
  66   December M onthly Upd ate
  67   Scott Bart el
  68   10/31/2016
  69   0.03
  70   Initial Re lease
  71   Karen Shep herd
  72   10/28/2016
  73   0.02
  74   Edited Doc ument Per  Comments
  75   Karen Shep herd
  76   10/26/2016
  77   0.01
  78   Initial Dr aft 
  79   Karen Shep herd
  80  
  81  
  82  
  83   Table of C ontents
  84   1.Executiv e Summary1
  85   2.Introduc tion1
  86   2.1Purpose  of the Co nfiguratio n Manageme nt Plan1
  87   2.2Scope o f the Conf iguration  Management  Plan2
  88   2.3Structu re of the  Configurat ion Manage ment Plan2
  89   3Configura tion Manag ement Acti vities2
  90   3.1Roles a nd Respons ibilities2
  91   3.2Communi cation4
  92   3.3System  Configurat ion Baseli ne4
  93   3.4Configu ration Con trol Proce ss (CCP)5
  94   3.5Configu ration Man agement Re sources7
  95   APPENDIX A : CONFIGUR ATION MANA GEMENT PLA N APPROVAL 8
  96   Appendix B : Referenc es9
  97   Appendix C : Key Term s10
  98   Appendix D : Suggeste d Configur ation Item s Data Ele ments11
  99   Appendix E : [Facilit y] Current  Configura tion Basel ine Report 16
  100   Appendix F : Configur ation Item s (CI) Sho wing Syste m Boundari es17
  101   Appendix G : Change O rder Appro val Checkl ist18
  102   Appendix H : Change O rder Imple mentation  Plan Templ ate19
  103   Appendix I : Business  Case Just ification2 0
  104   Appendix J : Change M anagement  Back-Out P lan Templa te21
  105  
  106   Executive  Summary
  107   The implem entation o f a Benefi ciary Trav el Self-Se rvice Syst em (BTSSS)  Solution  serves to  fulfill th e Departme nt of Vete rans Affai rs (VA) co mmitment t o Veterans  and to th e American  public to  serve as  good stewa rds of pub lic resour ces. 
  108   This docum ent will p rovide hig h level in formation  on the Con figuration  Managemen t (CM) pro cesses imp lemented t hroughout  all phases  for the B TSSS softw are projec t includin g software , systems,  and docum entation.   The proce ss and pro cedures ou tlined in  this docum ent will c onform wit h the exis ting VA CM  tools and  the overa rching VA  Configurat ion Manage ment Plan  (CMP) in t he Rationa l reposito ry.  The C MP will al so support  the unifi ed Veteran  Informati on Portal  (VIP) Rele ase proces s utilizin g agile de velopment,  frequent  builds and  releases,  and a hig h level of  integrati on with Ag ile Lifecy cle Manage ment (ALM)  tools, wi th automat ed builds  and testin g. ALM and  testing d ata will n eed to be  stored in  the VIP Ra tional Rep ository.  
  109   Introducti on
  110   The Benefi ciary Trav el Self-Se rvice Syst em (BTSSS)  will enab le the VA  to provide  travel re imbursemen t to autho rized Vete rans and t heir benef iciaries a t the poin t-of-care  as well as  through s tandard we b browsers  and the V etLink kio sk at vari ous VA fac ilities. I t will use  state-of- the-art te chnology t hat will a llow Veter ans to sub mit expens es for tra vel reimbu rsement ut ilizing th e BTSSS ap plication  and receiv e timely r eimburseme nt via Ele ctronic Fu nds Transf er (EFT). 
  111   The BTSSS  software s olution wi ll be deve loped and  implemente d using Mi crosoft Dy namics 365  for Custo mer Servic e which is  a COTS-ba sed soluti on that pr ovides str ong custom er support  and acces s to a use r communit y.
  112   Due to thi s projects  use of mu ltiple thi rd party v endors, th e Configur ation Mana gement pro cess will  initially  be split b etween mul tiple tool s. However  due to th e VA’s req uirement t hat all fi nalized co de be stor ed within  its Config uration Ma nagement T ool, this  project wi ll only be  providing  the final  code rele ases in IB M Rational  Team Conc ert (RTC).
  113  
  114   Purpose of  the Confi guration M anagement  Plan 
  115   The overal l objectiv e of this  CMP is to  identify C M roles an d responsi bilities,  resources,  and forma l processe s and proc edures to  ensure tha t all deve lopment of  the BTSSS  software  system are  evaluated  and appro ved before  implement ation. Thi s also inc ludes the  processes  and proced ures for m anaging an d controll ing the de velopment,  delivery,  and maint enance of  all softwa re and doc umentation  products  used for c ontrolling  implement ation, eva luation, a nd auditin g of the C M processe s and Conf iguration  Items (CIs ), to incl ude mainta ining a cu rrent base line confi guration o f the syst em under C onfigurati on Managem ent Contro l. This CM P also out lines the  BTSSS orga nization,  responsibi lities, an d requirem ents to be  followed  by teams p roducing o r modifyin g software  within th e system.  The BTSSS  CMP will a id both ma nagement a nd technic al staff i n the prod uction of  high-quali ty softwar e products  and all t he informa tion perti nent to th e BTSSS sy stem.  
  116   Scope of t he Configu ration Man agement Pl an
  117   The Benefi ciary Trav el Self-Se rvice Syst em (BTSSS)  CMP docum ent, along  with the  correspond ing CM Sta ndard Oper ating Proc edure (SOP ), defines  the Infor mation Sys tem’s stru cture and  methods fo r:
  118   Identifyin g, definin g, and bas e-lining C Is
  119   Creating C I Records
  120   Identifyin g relation ships
  121   Controllin g modifica tions and  releases o f CIs
  122   Reporting  and record ing status  of CIs an d any requ ired modif ications
  123   Ensuring c ompletenes s, consist ency, and  correctnes s of CIs
  124   Controllin g storage,  handling,  and deliv ery of the  CIs
  125   Structure  of the Con figuration  Managemen t Plan
  126   The intend ed audienc e of the C MP are sys tem owners , Organiza tional Ser vice Lines  and divis ions, faci lity chief  informati on officer s, system  administra tors, info rmation se curity off icers and  informatio n owners,  and Office  of Inform ation and  Technology  (OIT) sta ff within  these iden tified are as respons ible for t he day-to- day mainte nance of t he configu ration ite ms on the  BTSSS soft ware devel opment pro ject. This  includes  others who  have a re quirement  or need to  develop,  change, fi x, or enha nce softwa re artifac ts on the  BTSSS soft ware devel opment pro ject.
  127   This CMP,  in conjunc tion with  the OIT Co nfiguratio n and Chan ge Managem ent Proces s Document s, and Ser vice, Deli very and E ngineering  (SDE) Cha nge Manage ment Polic y and Stan dard Opera ting Proce dures, ide ntifies co nfiguratio n manageme nt and cha nge manage ment roles  and respo nsibilitie s and syst em relatio nships. In  addition,  the scope  includes  the automa ted tools  and proces ses used t o manage t he informa tion syste m baseline  configura tion.
  128   Configurat ion Manage ment Activ ities
  129   Roles and  Responsibi lities
  130   Table 1: R oles and R esponsibil ities
  131   Role
  132   Responsibi lity
  133   Program Ma nager
  134   • Oversees  the softw are config uration ma nagement p rocess. 
  135   • Ensures  proper exe cution of  the BTSSS  Plan.
  136   • Identify  dependent  projects.
  137   Configurat ion Manage r
  138  
  139   • Develop  and mainta in Softwar e Configur ation Mana gement (SC M) Procedu res Manual  and work  instructio ns for eac h VA produ ct they ar e assigned .
  140   • Educates  project t eam member s in SCM “ best pract ices.”
  141   • Accounta ble for in stituting  the establ ished proc esses and  reporting  progress s tatistics  based on c hange requ ests.
  142   • Identifi es product  baselines  as necess ary of all  products  within the ir assigne d projects .
  143   • Responsi ble for SC M audits a nd necessa ry status  accounting  related t o the prod uct.
  144   • Maintain s artifact s followin g proper v ersion con trol proce dures.
  145   Software C hange/Buil d Administ rator  
  146   • Develops  and maint ains artif acts follo wing prope r version  control pr ocedures.
  147   • Establis hes, promo tes, and r eleases ba selines.
  148   • Performs  or valida tes interi m and fina l builds.
  149   • Identifi es product  baselines  as necess ary of all  products  within the ir assigne d projects .
  150   Developmen t Manager/ Technical  Lead
  151   • Prepares  release p ackage, re lease arch ives and V ersion Des cription D ocuments ( VDD).
  152   • Ensures  all SCM Pr ocedures M anual and  work instr uctions ar e implemen ted and fo llowed for  all softw are, docum entation,  and/or any  other com ponents fo r which th ey are res ponsible.
  153   • Ensures  all develo pers’ work  within th e specifie d SCM proc ess and re lated guid elines as  specified  in the SCM  Procedure s Manual a nd work in structions .
  154   Developers /System Ad ministrati on
  155   • Develops  and maint ains artif acts follo wing prope r version  control pr ocedures u sing the S CM Procedu res Manual  and work  instructio ns.
  156   • Maintain  accurate,  detailed  informatio n for all  assigned s tories, in  the Ratio nal databa se, relate d to the a pplicable  developmen t detail o f the Agil e lifecycl e.
  157   • Provide  impact ana lysis repo rting prob lems or ch anges, inc luding doc umentation  of sugges ted soluti ons.
  158   • Document ation of b uild, rele ase, and i nstallatio n instruct ions.
  159   Software Q uality Ass urance Ana lyst/Testi ng Analyst
  160   • Update s tories ass igned to t hem accord ing to tes t activity  results.
  161   • Determin es Pass/Fa il for eac h story sc heduled fo r a sprint  release.
  162   • Identifi es defect( s) and/or  enhancemen t(s) for a ny newly d iscovered  problems d uring test ing and cr eates stor ies or def ects in Ra tional.
  163   Technical  Writer
  164   • Develops  technical  deliverab le documen tation to  support th e software  deliverab les. 
  165   • Provides  editing,  formatting , and grap hics suppo rt for doc umentation .
  166   Implementa tion Team/ Operations  Team
  167   • Coordina tes the re lease and  deployment  of softwa re updates  to the ex isting BTS SS Custome r Relation ship Manag ement (CRM OL) system .
  168   • 365 Clou d
  169  
  170   Communicat ion
  171   Communicat ion within  the BTSSS  project w ill utiliz e the feat ures withi n the Rati onal Confi guration M anagement  tool (RTC)  that allo ws for tas ks, work i tems, buil ds, and de ployments  to be proc essed thro ugh a life  cycle. Th at cycle p rogression  is accomp lished by  allocating  to each a ctivity, t ask, or de cision the  role that  is accoun table and/ or respons ible for i t as well  as those r oles to be  consulted  with befo rehand, or  informed  afterward.  The OIT C onfigurati on Managem ent Proces s document  provides  a Responsi ble, Accou ntable, Co nsulted, a nd Informe d (RACI) M atrix to d efine acti vities and  roles. 
  172   BTSSS will  utilize t his matrix  to define  the roles  and respo nsibilitie s within t he project  and will  provide co mmunicatio n via dail y scrum me etings, we ekly team  meetings,  and variou s develope r, test an d deployme nt meeting s as neede d.
  173   Requests f or Change  (RFC)/Stor ies are en tered in t he appropr iate Chang e Manageme nt System  (VA) for r eview, app roval, and  implement ation by t he appropr iate Servi cing Divis ions. Chan ge Control  and Advis ory Board  reviews ar e required  for chang es that im pose downt ime for th e system o r service  or pose a  risk or af fect multi ple facili ties or se rvices.  I t is the r esponsibil ity of the  implement ation team  to notify  potential ly affecte d customer s and pers onnel requ ired to pr ovide supp ort, e.g.  Organizati onal Servi cing Divis ions, Netw ork Chief  Informatio n Officer  (NCIO), Fa cility Chi ef Informa tion Offic er (FCIO),  etc.
  174   System Con figuration  Baseline
  175   Configurat ion identi fication i s the proc ess of ide ntifying,  selecting,  naming, a nd classif ying the d evelopment  items sub ject to ch ange contr ol. This i nvolves de fining the  product s tructure a nd definin g identifi cation con ventions t o be used  for baseli nes of pro ducts, doc uments, so ftware bui lds, and r eleases pa ckages. It ems are no rmally pla ced under  change con trol as so on as they  are insta ntiated, a s tracking  the confi guration a nd new con tents and  implementa tion statu s of new r equirement s going in to an init ial releas e is equal ly as impo rtant as t racking la ter change s.
  176   Within the  Rational  Team Conce rt (RTC) r epository,  unique id entifiers  will be ap plied to p roducts an d their as sociated c ontent.  T he followi ng are the  types of  identifier s used in  accordance  with the  formats de fined in t he applica ble proced ure docume nts:
  177  
  178   File versi ons - Iden tifies the  version o r revision  identifie r of each  software i tem that c omprise th e Product  at any spe cific base line. It a llows iden tification  of unique  items tha t make up  the invent ory of a b aseline. S oftware id entificati on provide s the foun dation for  traceabil ity of rel ated artif acts. The  software i dentificat ion versio n number i s assigned  by the ve rsion cont rol automa ted tool a nd control led in the  developme nt reposit ory. The V DD lists a ll softwar e, its ver sion, and  related ch ange docum ent number s.
  179   Change rec ords– Iden tifies a s et of work  product v ersions cr eated to r esolve a s pecific Ch ange Reque st. The id entifier i s created,  controlle d, and tra cked by th e Change M anagement  System. 
  180   Baseline –  Identifie s a set of  specifica tions or w ork produc ts that ha s been for mally revi ewed and a greed upon , which se rves as th e basis fo r further  developmen t, and whi ch can be  changed on ly through  change co ntrol proc edures.
  181   Build – Id entifies a  set of so lution fil e versions  used to b uild and a ssemble de ployable p ackages.
  182   Release Pa ckage – Id entifies a  set of de ployable f ile versio ns and del iverable d ocument ve rsions tha t constitu te a compl ete releas e package.
  183   Release Ca ndidate –  Identifies  the distr ibution of  the basel ine or app lication m odificatio ns to the  baseline t hat is bei ng staged  for produc tion befor e it becom e a Produc t Release.
  184   For the BT SSS progra m all proj ect relate d document s will be  managed an d controll ed in the  Rational T eam Concer t designat ed reposit ory for th at type of  document.   All proj ect docume ntation mu st adhere  to VA poli cy on prot ection of  VA securit y and VA a rchitectur e content,  desensiti zation of  patient da ta content , Freedom  of Informa tion Act ( FOIA) cont ent redact ion restri ctions, 50 8 accessib ility stan dards, and  documenta tion stand ards where  applicabl e.
  185   Product Ar tifacts ar e those th at change  along with  the devel oped produ ct and mos t likely,  will exper ience chan ge over ti me and thu s require  baselining  and Chang e Manageme nt. They a lso typica lly repres ent specif ic configu rations an d criteria  required  by the dev eloped rel ease of th e product  to which t hey are as sociated w ith and th us should  be package d and migr ated throu gh the sam e series o f life cyc les stages  as all ot her baseli ned artifa cts within  the devel opment env ironment a rchitectur e and util ities.
  186   Configurat ion Contro l Process  (CCP)
  187   OIT and SD E have est ablished p rocess and  procedure s that dic tate the c onfigurati on change  control fo r all hard ware and s oftware co nfiguratio n items. A  VA tool i s used for  requestin g, approvi ng, implem enting, mo nitoring,  and tracki ng, auditi ng and clo sing chang e orders a ffecting c onfigurati on items u nder chang e and conf iguration  control. 
  188   Step 1: Es tablish Sy stem Confi guration B aseline 
  189   Step 2: Re view backl og, identi fy changes , and crea te change  story 
  190   Step 3: Id entify cha nge storie s and plan  Sprint  
  191   Step 4: Pe rform conf iguration  changes
  192   Step 5: Pe rform Secu rity and O perational  Impact An alysis 
  193   Step 6: Im plement co nfiguratio n changes 
  194   Step 7: Ve rify imple mented cha nges are s uccessful  and did no t introduc e addition al issues/ incidents  into the e nvironment .
  195   Step 8: Pe rform Conf iguration  Status Acc ounting  
  196   Step 9: Co nduct Retr ospective  which incl udes Confi guration V erificatio n and Audi t. 
  197   All produc t assets a re expecte d to be ma naged suff iciently t o provide  a stable,  traceable,  dependabl e, and sec ured devel opment, te st, and, p roduction  environmen t within V A and for  VA informa tion asset s managed  outside th e VA for t he purpose s of condu cting busi ness with  or on beha lf of the  VA. Config uration it ems in the  scope of  this docum ent are de fined as a ny object  (software,  hardware,  data, doc umentation , environm ent config urations,  etc.) that  may exper ience chan ge over ti me.
  198   The act of  creating  any softwa re deliver able impli es that ob jects will  be create d and modi fied in th e design a nd develop ment proce ss, which  by definit ion become  CIs along  with the  environmen ts and doc umentation  developed  to suppor t them. Af ter develo pment is c omplete, t esting for  validatio n and cert ification  is require d. This ca n only be  accomplish ed accurat ely if the  integrity  of the so ftware del iverable c an be main tained thr ough forma l change c ontrol.
  199   Formal cha nge contro l involves  the manag ement of c hanges and  versions  to the CIs  that are  introduced  to the ba seline. Ch ange contr ol will al so apply t o product  migration  beyond dev elopment,  to the var ious phase s of testi ng and cer tification , and unti l it is re leased int o a produc tion envir onment.
  200   There are  at least t wo levels  of change  control th at this do cument is  addressing .  The cha nge contro l that tak es place d uring the  Software D evelopment  Life Cycl e (SDLC) i s managed  with the S CM change  management  processes  and proce dures and  the Operat ions chang e control  is managed  by OIT Ch ange Manag ement proc esses and  procedures .  The han doff betwe en softwar e developm ent and OI T will be  handled by  assigned  staff from  both depa rtments th at the SCM  Manager w ill coordi nate.
  201   The comple xity invol ved in the  Change Co ntrol proc ess requir es the imp lementatio n of forma l processe s and proc edures to  be documen ted in det ail for ea ch VA prod uct in the  SCM. Proc edure Manu al(s) and  work instr uctions. T hese docum ents provi de objecti ves, requi rements, a nd step-by -step inst ruction on  the perfo rmance of  Change Con trol activ ities with in the SCM  Environme nt for eac h VA Produ ct. The do cument wil l also pro vide secti ons with i nformation  on key pr ocess area s such as:
  202   The organi zation of  personnel  and the di vision of  tasks for  the VA tea m members.
  203   Decision c riteria an d escalati on require ments spec ific to ea ch level o f change r equest rev iew.
  204   The overal l Change M anagement  Process de scription  and flow.
  205   The descri ption of t he change  control to ols and ho w the team  will use  them
  206   Configurat ion Manage ment Resou rces
  207   The Change  Managemen t Systems  (CMS) is t he automat ed mechani sm that is  used for  tracking p roposed ch anges to c onfigurati on items.  Change ord ers are en tered into  the syste m and work  orders as signed to  the approp riate grou ps for rev iew, appro val, imple mentation,  configura tion statu s accounti ng and con figuration  verificat ion. Chang es are tim e stamped  to provide  a timelin e and revi ewed per l ocal proce ss and pro cedures to  ensure th at changes  are proce ssed corre ctly and a re impleme nted to me et establi shed requi rements. C hanges are  not imple mented wit hout appro val per OI T and SDE  Change Man agement Po licy and p rocedures.
  208   Each area  of the org anization  managing c hanges has  a Change  and Config uration Ma nagement D ivision th at is resp onsible of  ensuring  that appro priate con trol is pu t in place  to manage  the confi guration i tems per V A Handbook  6500 Conf iguration  Management  controls.  
  209   The VA uti lizes the  Rational T eam Concer t tools to  manage al l requirem ents, conf iguration  items, tas ks, activi ties, buil ds and tes ting. This  all-encom passing to ol provide s project  staff and  VA managem ent the ab ility to t rack any f ile, task,  requireme nt or test ing throug h the vari ous stages  of concep tion to de livery. 
  210   APPENDIX A : CONFIGUR ATION MANA GEMENT PLA N APPROVAL
  211  
  212   The unders igned ackn owledge th at they ha ve reviewe d the BTSS S Configur ation Mana gement Pla n and agre e with the  informati on present ed within  this docum ent. Chang es to this  Configura tion Manag ement Plan  will be c oordinated  with, and  approved  by, the un dersigned,  or their  designated  represent atives.
  213  
  214   __________ __________ __________ __________ __________ __________ __________ ________
  215   Signature: Date:
  216   Print Name
  217   Title: 
  218   Role: 
  219  
  220   __________ __________ __________ __________ __________ __________ __________ ________
  221   Signature: Date:
  222   Title: 
  223   Role: 
  224  
  225   __________ __________ __________ __________ __________ __________ __________ ________
  226   Signature: Date:
  227   Print Name
  228   Title: 
  229   Role: 
  230  
  231   Appendix B : Referenc es
  232   The follow ing table  summarizes  the docum ents refer enced in t his docume nt.
  233    
  234   Document N ame
  235   Descriptio n
  236   Location
  237   VA Directi ve 6500
  238   Managing I nformation  Security  Risk: VA I nformation  Security  Program
  239   https:// DNS . URL /vapubs/se arch_actio n.cfm?dTyp e=2
  240  
  241   VA Handboo k 6500
  242   Risk Manag ement Fram ework for  VA Informa tion Syste ms – Tier  3: VA Info rmation Se curity Pro gram
  243   https:// DNS . URL /vapubs/se arch
  244   OIT Config uration Ma nagement P rocess
  245   OIT Config uration Ma nagement P roPath def ined proce ss and sup porting do cument
  246   https://DN S.URL/
  247   sites/fo/c ommittees/ ccb/CMDB/
  248  
       
  249   OIT Change  Managemen t Process  Document
  250   OIT Change  Managemen t ProPath  defined pr ocess and  supporting  document
  251   https://DN S.URL/
  252   sites/fo/c ommittees/ ccb/CMDB/
  253   Definitive %20Documen t%20Storag e/
  254   oit_change _managemen t_process_ document.p df
  255   SDE Change  Managemen t SOP
  256   SDE Change  Managemen t Standard  Operation  Procedure
  257   https://DN S.URL/
  258   sites/fo/c ommittees/ ccb/CMDB/
  259   Definitive %20Documen t%20Storag e/
  260   National%2 0ChM%20Pro cess%20SOP .pdf
  261   Master Tes t Plan
  262   Master Tes t Plan Tem plate
  263   https://wa rriortechn ology.shar epoint.com /sites/bts ss/Shared% 20Document s/Forms/Al lItems.asp x?id=%2Fsi tes%2Fbtss s%2FShared %20Documen ts%2FData% 20Library% 2FProject% 20Docs%2FM TP
  264  
  265   Appendix C : Key Term s
  266   The follow ing table  provides d efinitions  and expla nations fo r terms an d acronyms  relevant  to the con tent prese nted withi n this doc ument.
  267   Term
  268   Definition
  269   ALM
  270   Agile Life cycle Mana gement
  271   CAB
  272   Change Adv isory Boar d
  273   CCB
  274   Change Con trol Board
  275   CCP
  276   Configurat ion Contro l Process
  277   CI
  278   Configurat ion Item
  279   CM
  280   Configurat ion Manage ment
  281   CMS
  282   Change Man agement Sy stems
  283   CMDB
  284   Configurat ion Manage ment Datab ase
  285   CMP
  286   Configurat ion Manage ment Plan
  287   COR
  288   Contractin g Officer  Representa tive
  289   CRMOL
  290   Customer R elationshi p Manageme nt Online
  291   DNS
  292   Domain Nam e Service
  293   FCIO
  294   Facility C hief Infor mation Off icer
  295   FOIA
  296   Freedom of  Informati on Act
  297   IT
  298   Informatio n Technolo gy
  299   OIT
  300   Office of  Informatio n & Techno logy
  301   OS
  302   Operating  System
  303   POC
  304   Point of C ontact 
  305   RACI
  306   Responsibl e, Account able, Cons ulted, and  Informed
  307   RFC
  308   Request fo r Change
  309   SCM
  310   Software C onfigurati on Managem ent
  311   SDE
  312   Service De livery and  Engineeri ng
  313   SOP
  314   Standard O perating P rocedure
  315   VA
  316   Veterans A ffairs
  317   VDD
  318   Version De scription  Documents
  319   VIP
  320   Veteran In formation  Portal
  321   VISN
  322   Veterans I ntegrated  Service Ne twork
  323   Appendix D : Suggeste d Configur ation Item s Data Ele ments
  324   Suggested  standard d ata elemen ts (Data T ype and CI  Type) and  what type  of data w ould be co llected an d how it w ould be us ed.
  325   Field Name
  326   Data Type
  327   CI Type
  328   Descriptio n
  329   Resource N ame
  330   Indexed Te xt
  331   Hardware /  Software  / Service  / Document
  332   A unique n ame of the  Configura tion Item  (CI).  A n ame that r epresents  the Resour ce and is  easy to id entify wha t it is; a  key searc h field wi thin the C onfigurati on Managem ent Databa se (CMDB).
  333   DNS Name
  334   Indexed Te xt
  335   Hardware
  336   The name o f the CI a s identifi ed within  your Domai n Name Ser vice (DNS) ; this hel ps with as sociation  of service s or serve rs to a CI .
  337   Status
  338   Lookup Tab le
  339   Hardware /  Software  / Service  / Document
  340   The curren t status o f the CI.  For exampl e: when fi rst added  to the CMD B, the CI  may be in  a status o f Register ed, then l ater it ma y be Accep ted. This  identifies  how the r ecord move s through  the status /lifecycle ; if a cha nge is bei ng perform ed on the  CI the sta tus would  be changed  to Change  in Progre ss, thus i dentifying  CI’s that  are curre ntly under going some  form of a  change.
  341   Descriptio n
  342   Free Text  Multiple L ines
  343   Hardware /  Software  / Service  / Document
  344   A short de scription  that will  provide ad ditional f eedback to  the end u ser when l ooking up  the CI.
  345   CI Type
  346   Lookup Tab le
  347   Hardware /  Software  / Service  / Document
  348   This is th e type tha t the CI b elongs to.  See list  of suggest ed family  types.
  349   Asset Clas s
  350   Lookup Tab le
  351   Hardware /  Software  / Service  / Document
  352   This is th e classifi cation of  the config uration it em; it is  related to  the famil y, but is  a more spe cific clas sification  of an ass et. This i s the sub- type that  the CI bel ongs to; i t is used  to group c ommon type s on confi guration i tems. An e xample wou ld be “Lap top”; the  “Laptop” C lass is wi thin the h ardware Ty pe.
  353   Comments
  354   Free Text  Multiple L ines
  355   Hardware /  Software  / Service  / Document
  356   Comments r egarding t he specifi c CI; note s that nee d to be pa rt of the  record his tory but a re not wit hin the De scription  of the CI.
  357   COR
  358   Contact Ta ble Lookup
  359   Hardware /  Software  / Service
  360   Contractin g Officer  Representa tive (COR)  associate d with thi s particul ar purchas e or CI.
  361   Customer N ame
  362   Contact Ta ble Lookup
  363   Hardware /  Software  / Service  / Document
  364   Name of th e Customer  point of  contact fo r issues w ith the CI . This per son or gro up is the  primary fo cus point  when issue s or chang es are rel ated to th e CI.
  365   Customer O rganizatio n
  366   Lookup Tab le
  367   Hardware /  Software  / Service  / Document
  368   Name of th e Organiza tion that  the custom er belongs  to. Provi des report ing inform ation abou t what CI’ s are asso ciated to  a specific  organizat ion.
  369   Deployed D ate
  370   Date
  371   Hardware /  Software  / Service  / Document
  372   The date t hat a serv ice, syste m, etc. wa s deployed  to the pr oduction e nvironment .
  373   Financial  Reference
  374   Free Text
  375   Hardware /  Software
  376   A Purchase  Order tha t was used  to obtain  the hardw are or sof tware. It  is useful  when looki ng up othe r informat ion that m ay be foun d in relat ed databas es like th e Asset Ma nagement s ystem.
  377   Function
  378   Lookup Tab le
  379   Hardware
  380   The functi on or purp ose that t he hardwar e Configur ation Item  serves.
  381   Host Name
  382   Free Text
  383   Hardware
  384   In some ca ses, like  UNIX, ther e is a pur pose to id entify the  host name ; this is  on the sam e as DNS N ame.
  385   License Co unt
  386   Numeric
  387   Software
  388   A number o f copies t hat a part icular lic ense allow s the owne r to distr ibute. It  can be use d to deter mine if ad ditional s oftware li censes are  needed or  if there  are too ma ny license s unused.
  389   Type of Li censes
  390   Lookup Tab le
  391   Software
  392   The type o f license  that has b een procur ed, perpet ual or rec urring.
  393   License Ke y Maintain ed By
  394   Contact ta ble Lookup
  395   Software
  396   Who mainta ins the So ftware Lic ense Key t hat is use d to insta ll the sof tware?
  397   Lifecycle  Date
  398   Date
  399   Hardware /  Software  / Service 
  400   This is a  date in th e future d erived fro m the inst all date a nd Informa tion Techn ology (IT)  equipment  life expe ctancy.
  401   Location
  402   Lookup Tab le
  403   Hardware /  Software  / Service  / Document
  404   The locati on where t his partic ular CI is  hosted or  installed . More spe cific loca tion field s may be n eeded, suc h as room,  floor, an d rack as  part of th e physical  location.
  405   Maintenanc e Organiza tion
  406   Lookup Tab le
  407   Hardware /  Software  / Service 
  408   Name of th e Organiza tion that  has Mainte nance resp onsibility  over the  CI; normal ly found w ithin the  Operations  and Maint enance (O& M) Plan.
  409   Maintenanc e Vendor
  410   Lookup Tab le
  411   Hardware /  Software  / Service 
  412   The vendor  that woul d support  the Mainte nance Orga nization w ith a Warr anty or ot her type o f maintena nce agreem ent.
  413   Manufactur er
  414   Lookup Tab le
  415   Hardware /  Software
  416   Manufactur er of the  CI being e ntered int o the CMDB . Name use d for repo rting main tenance co ntracts or  other dat a related  to a speci fic manufa cturer.
  417   Model
  418   Lookup Tab le
  419   Hardware /  Software
  420   The manufa cturer’s m odel name  for the de vice.  Rel ates to th e manufact urer; used  for repor ting and f or mainten ance contr acts.
  421   Version Nu mber
  422   Free Text
  423   Software /  Document
  424   Version Nu mber of so ftware or  documents.   This pro vides a ba seline as  to what ve rsion of s oftware is  installed /authorize d in produ ction or t he version  of a docu ment that  was approv ed and pub lished. No  version c hanges unl ess there  is a chang e process  for it.
  425   Maintenanc e Window
  426   Free Text
  427   Hardware /  Software  / Service
  428   Maintenanc e windows  are establ ished base d on Servi ce Level A greements  (SLA’s) or  other agr eements fo r specific  services  that are a vailable t o the end  user. The  Maintenanc e windows  that are a ssociated  with the C I’s should  clearly s tate if th ey are rec urring mai ntenance w indows, th e days of  the week t hat they a re availab le, and th e hours of  the day t hat they c an be used . Example:  Recurring  - Monday  – Friday 7  to 11 PM  Contact (n ame or rol e of the p erson that  should be  contacted  to valida te/verify  the mainte nance wind ow).
  429   Operating  System
  430   Look Up Ta ble
  431   Hardware /  Software 
  432   Identifies  the Opera ting Syste m (OS) run ning on th e server,  virtual ma chine, lap tops or wo rkstations . It is us ed for pat ching, SA  assignment , reportin g purposes , licensin g, etc.  N OTE: If th is informa tion is av ailable fr om other t ools that  can report  this info rmation an d is not n eeded as p art of int ernal repo rting or l inked to o ther field s that are  not part  of the ext ernal data  source, t hen this f ield could  be left o ut.
  433   Published  Date
  434   Date
  435   Document
  436   The date t hat a docu ment was p ublished f or general  consumpti on.
  437   Region
  438   Lookup Tab le
  439   Hardware /  Software  / Service  / Document
  440   OIT is bro ken out in to differe nt regiona l areas. M ost have t heir own p rocesses a nd procedu res or hav e equipmen t and soft ware that  is regiona lized. If  the CMDB h olds cross -regional  CI’s these  should be  identifie d for repo rting purp oses; othe rwise, the  Organizat ional fiel d should p rovide the  needed fe edback.
  441   Relationsh ips
  442   Lookup Tab le
  443   Hardware /  Software  / Service  / Document
  444   Field is a  one-to-ma ny relatio nship used  to identi fy a relat ionship be tween 2 or  more CI’s  and the t ype of rel ationship  that the C I has. Thi s relation ship could  be with c ontacts, o ther hardw are, softw are, servi ces or doc ument CI’s . An examp le of type s of relat ionships a re listed  below:
  445   Changes Ap proved By
  446   Connects T o
  447   Is Documen ted By
  448   Runs/Runs  On
  449   Renewal Da te
  450   Date
  451   Hardware /  Software
  452   A renewal  date is us ed to esta blish when  a particu lar CI’s m aintenance  agreement  will expi re and wou ld require  renewal t o continue  with the  service.
  453   Cost of Ma intenance  Agreement
  454   Numbers
  455   Hardware /  Software
  456   Recurring  cost of ma intenance  agreements  purchased  under the  contract.
  457   Responsibl e Organiza tion
  458   Lookup Tab le
  459   Hardware /  Software  / Service  / Document
  460   The Organi zation tha t has resp onsibility  over the  CI. It may  be the sa me as main tenance or  customer  organizati on or a di fferent on e.
  461   Responsibl e Owner
  462   Contact Lo okup Table
  463   Hardware /  Software  / Service  / Document
  464   A primary  point of c ontact who  has been  identified  as the Po int of Con tact (POC)  for the R esponsible  Organizat ion.
  465   Responsibl e Vendor
  466   Lookup Tab le
  467   Hardware /  Software
  468   The Respon sible Vend or for a p articular  CI may be  the same a s Maintena nce Vendor  or may be  a differe nt vendor  if mainten ance is su b-contract ed out by  the Primar y Responsi ble Vendor .
  469   Secondary  Contact
  470   Contact Lo okup Table
  471   Hardware /  Software  / Service  / Document
  472   This would  be an alt ernate Poi nt of Cont act that c ould be co ntacted in  the absen ce of the  Primary PO C,
  473   Serial Num ber
  474   Alpha-Nume ric Free T ext
  475   Hardware
  476   Serial Num bers are u nique iden tification  elements  that are d irectly re lated to a sset manag ement; but  by includ ing it wit hin your C MDB you co uld link t o other da tabases th at track t heir CI’s  by Serial  Number.
  477   Service Li ne
  478   Lookup Tab le
  479   Hardware /  Software  / Service  / Document
  480   Support is  broken do wn by Serv ice Lines  within OIT  Field Ope rations, p roviding a  Service L ine associ ated to th e CI would  expedite  maintenanc e issues a nd provide  reporting  capabilit ies on the  type and  number of  CI’s being  maintaine d by a par ticular se rvice line .
  481   Service Li ne Team/Di vision
  482   Lookup Tab le
  483   Hardware /  Software  / Service  / Document
  484   As Service  Lines are  stood up,  so are th e Service  Line Teams /Divisions  that supp ort the se rvice line  and have  a more def ined scope  of their  responsibi lities. Ca pturing th is type of  informati on would p rovide you  with the  same infor mation as  Service Li ne would b ut allow y ou to brea k it down  by the Ser vice Line  Team Divis ion.
  485   Source Sup plier
  486   Lookup Tab le
  487   Hardware
  488   Used for h ardware su pport, thi s is the v endor that  purchased  the equip ment from  the manufa cturer. It  is receiv ed obtaine d from the  Purchase  Order Cont ract.
  489   Created By
  490   System Con tact Field
  491   Hardware /  Software  / Service  / Document
  492   This is an  audit fie ld; it cap tures the  name of th e person t hat create d the reco rd. This s hould be a  system fi eld and ca ptured bas ed on who  was logged  in during  the creat ion of the  record.
  493   Created Da te
  494   System Dat e Field
  495   Hardware /  Software  / Service  / Document
  496   Initial da te of crea tion of th e Configur ation Item  Record.
  497   Modified B y
  498   System Con tact Field
  499   Hardware /  Software  / Service  / Document
  500   This is an  audit fie ld; the pe rson who l ast edited  the recor d would be  listed. T his should  be a syst em field a nd capture d based on  who was l ogged in d uring the  modificati on.
  501   Modified D ate
  502   System Dat e Field
  503   Hardware /  Software  / Service  / Document
  504   Date the C onfigurati on Item Re cord was l ast modifi ed.
  505  
  506   Appendix E : [Facilit y] Current  Configura tion Basel ine Report
  507  
  508   The follow ing table  details th e Hardware /Software  and Servic es associa ted with t he system  under this  CMP.
  509  
  510  
  511   Appendix F : Configur ation Item s (CI) Sho wing Syste m Boundari es
  512  
  513  
  514  
  515   Appendix G : Change O rder Appro val Checkl ist
  516  
  517   Reviewer a nd Approve r must be  different  (the perso n putting  together t he plan, a nd the per son approv ing the pl an)
  518   Correct lo cation ent ered?
  519   Change Ord er descrip tion conta ins requir ed informa tion
  520   What is be ing done?
  521   The busine ss case fo r doing it .
  522   What is th e impact o f the chan ge (what s ervices wi ll be impa cted and w hat will t he impact  most likel y be)?
  523   What else  may be imp acted?
  524   What will  occur if w e don’t do  the chang e?
  525   The implem entation p lan should  be attach ed, never  be pasted,  into the  descriptio n.
  526   Were the c ustomers/s takeholder s notified  as per th e Change A dvisory Bo ard (CAB)  process? 
  527   CAB notifi cation in  the ticket .
  528   Facility O IT respons e or ignor e entered  as a log c omment.
  529   Is the imp lementatio n plan att ached?
  530   Is the Not ification  and Escala tion secti on complet e?
  531   Does the i mplementat ion plan p rovide suf ficient de tail so th at a peer  who is unf amiliar wi th the par ticular fa cility whe re the imp lementatio n is takin g place co uld execut e the plan ?
  532   Does the i mplementat ion plan i nclude a t est plan t hat contai ns checkpo ints for v erificatio n, coordin ation, or  implementi ng back-ou t?
  533   Are verifi cation ste ps (Test P lan) inclu ded?
  534   Do the ver ification  steps ensu re the cus tomers are  functioni ng and not  just the  item modif ied is wor king?
  535   Is the bac k-out plan  attached?
  536   Is the not ification  plan inclu ded?
  537   Are verifi cation ste ps include d?
  538   Do the ver ification  steps ensu re the cus tomers are  functioni ng, the se rvices imp acted are  operationa l, and not  just the  item modif ied is wor king?
  539   Is the nee d by date  realistic?
  540   Is there a n implemen tation dat e/time pri or to the  need by da te?
  541  
  542   If everyth ing is acc urate and  all docume ntation at tached, ch ange Statu s to Appro ved and/or  escalate  to next le vel Change  Control B oard (CCB)  if this i s a signif icant chan ge/downtim e required .
  543  
  544  
  545   Appendix H : Change O rder Imple mentation  Plan Templ ate
  546   Local faci lity Notif ication an d Escalati on Contact s
  547   Name/Role
  548   Business
  549   After-hour s
  550   John Doe,  FCIO
  551   PII
  552   PII
  553  
  554  
  555  
  556   VISN/Servi ce Line No tification  and Escal ation Cont acts
  557   Name/Role
  558   Business
  559   After-hour s
  560  
  561  
  562  
  563   Any pre-im plementati on work th at will be  required
  564  
  565   Step-by-st ep guidanc e for what  needs to  be done in cluding ti me estimat es, escala tion and c oordinatio n points
  566  
  567   Identifica tion of ar eas that m ight cause  problems
  568  
  569   Identifica tion of ro ll-back po ints and/o r criteria  for initi ating the  Back-out p lan
  570  
  571   Test/valid ation step s for the  verificati on phase –  include v alidation  that custo mers are f unctioning  and not j ust the it em modifie d (See Mas ter Test P lan Templa te)
  572  
  573  
  574  
  575  
  576   Appendix I : Business  Case Just ification
  577  
  578   Please pro vide a det ailed desc ription of  this chan ge.
  579  
  580   List the r equirement s needed f or the cha nge (i.e.,  servers,  switches,  software,  etc.).
  581  
  582   Describe t he effect  the change  may have  upon the e nd user, b usiness op eration, a nd infrast ructure, i f known.
  583  
  584   Describe t he impact  on and the  availabil ity to oth er service s that run  on the sa me infrast ructure (o r on softw are develo pment proj ects).
  585  
  586   Describe t he effect  of not imp lementing  the change .
  587  
  588   Estimate t he IT, bus iness, and  other res ources req uired to i mplement t he change,  including  the likel y costs, t he number  and availa bility of  people req uired, the  elapsed t ime, and a ny new inf rastructur e elements  required.
  589  
  590   Estimate a ny additio nal ongoin g resource s required  if the ch ange is im plemented.
  591  
  592   Document d owntime pr ocedures.
  593  
  594  
  595   Document c ommunicati on procedu res (i.e.,  who needs  to be not ified in t he event o f schedule d/unschedu led downti me and how  to notify  this pers on).
  596  
  597  
  598  
  599   Appendix J : Change M anagement  Back-Out P lan Templa te
  600   Change Ord er
  601   Affected S ystems
  602  
  603  
  604   Estimated  time-frame s for rest oring serv ice
  605  
  606   Any pre-im plementati on work th at will be  required
  607  
  608   Step-by-st ep guidanc e to resto re service  to the pr e-change s tate
  609  
  610