4239. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 10/5/2018 9:06:42 PM Central 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.

4239.1 Files compared

#	Location	File	Last Modified
1	MHEDP3_VAOS_VATS_SM_Sept2018.zip\VAR 4.5.2	ARA-VAR-Resources4.5.x-InstallationInstructions-250718-1910-3660.docx	Thu Sep 27 18:10:00 2018 UTC
2	MHEDP3_VAOS_VATS_SM_Sept2018.zip\VAR 4.5.2	ARA-VAR-Resources4.5.x-InstallationInstructions-250718-1910-3660.docx	Sat Oct 6 01:32:07 2018 UTC

4239.2 Comparison summary

Description	Between Files 1 and 2
Description	Text Blocks	Lines
Unchanged	3	1388
Changed	2	6
Inserted	1	1
Removed	0	0

4239.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

4239.4 Active regular expressions

No regular expressions were active.

4239.5 Comparison detail

1	VAR-Resour ces 4.5.x - Installa tion Instr uctions
2
3	Assumption s
4	Service an d Data Sou rce Depend encies Pro perty Over rides
5	SSL CertCo nfigutaion
6	VARDB Data Source Co nfiguratio n MDWS Con figuration MVIConfig uration
7	MongoDB Co nfiguratio n Facility Timezone Configurat ion Var Ap i Keys Con figuration
8	Recall Rem inders Con figuration Versions before 4.2
9	Version VA R 4.2
10	Enable Pri mary Care direct sch eduling Co mmunity Ca re
11	Import Com munity Car e Types of Care (if it has not been done ) Create P referred P rovider (i f it has n ot been do ne)
12	Create Off ice Hours (if it has not been done)
13	Update Com munity Car e Appointm ent Reques t in Oracl e DB (if i t has not been done) Update Ap pointment Request in Oracle DB (if it ha s not been done)
14	Update App ointment R equest in Oracle DB (if it has not been done)
15	Version VA R 4.3
16	Installati on
17	Rollback P rocedure ( to version 4.2.9) Ve rsion VAR 4.4
18	Installati on
19	Rollback P rocedure ( to version 4.3) Vers ion VAR 4. 5
20	Installati on
21	Rollback P rocedure ( to version 4.4) Disa bling Feat ures
22	CDW Check List
23	Important Note About Recall Re minders Ap pDynamics Configurat ion Deploy ment
24	Validation
25	Rollback P rocedure ( v4.3.0+87 to v4.2.9+ 86) Mongo Rollback
26	PMDS Ticke t Tracker
27
28
29	Assumption s
30	Operations personnel is famili ar with JE E applicat ions and k nows how t o deploy a pplication s. Operati ons person nel knows how to tak e backups and revert deploymen ts if ther e are fail ures. Oper ations per sonnel kno ws how to procure en vironment- specific p roperty va lues.
31	IP address es are int erchangeab le with fu lly qualif ied domain names.
32
33
34	Pre-requis ites:
35
36	APIGateway , Consul, and other PPG compon ents.
37	Containers above mus t already be running in the sw arm. Assoc iated Proj ect: veter an-appoint ment-reque sts
38	Priority: Standard
39
40	Components : DTR, Nex us, Consul , MongoDb, Oracle
41
42
43
44	Installati on:
45
46	Jenkins Jo b already created at : http:// URL :8080/job/ var-resour ces-app-bu ild/ DTR r egistry ne eds to exi st at: URL /vamis/var -resources
47	Nexus regi sty'ssccs' needs to exist in: URL :9250/nexu s
48
49	Service/Ap plication to be Depl oyed
50
51	Service
52	Branch
53	URL
54	VarMessagi ngMicroser vice
55	Release 2. 0.2+17
56	https://co derepo.mob ilehealth. va.gov
57	/projects/ VAR/repos/ var-messag ing- micro service/br owse?at=re fs%2Fheads % 2FReleas e-2.0.1-Br anch
58	Facility R esources
59	Release 2. 0.2+19
60	https://co derepo.mob ilehealth. va.gov
61	/projects/ VAR/repos/ facility-r esources
62	/browse?at =refs%2Fhe ads%2FRele ase- 2.0.1 -Branch
63
64	Consul key s:
65
66	export VAM F_ENVIRONM ENT=ece-de v
67	export CON SUL_HTTP_A DDR= DNS :8500 Add the follow ing sectio n of code to the doc ker-compos e.yml file :
68	```
69	var-resour ces: image : var-reso urces link s:
70	var-messag ing-micros ervice dep ends_on:
71	var-messag ing-micros ervice por ts:
72	- "9092:80 80"
73	environmen t:
74	JAVA_OPTS= -XX:+CMSCl assUnloadi ngEnabled -Xrs -Dcom .sun.xml.w s.transpor t.http.cli ent.HttpTr ansportPip e.dump=tru e
75	```
76
77	Run the fo llowing co mmands to register t he service with Cons ul:
78
79	```
80	curl -H "X -Consul-To ken: $CONS UL_TOKEN" -s -X PUT $CONSUL_HT TP_ADDR:85 00/v1/kv/v amf/$VAMF_ ENVIRONMEN T/apigatew ay/1.0
81	/services/ var-resour ces -d '{"lo cation":"/ var/Vetera nAppointme ntRequestS ervice","s ervice":"v ar-resourc es-8080"," redirect": "off","hea ders":{"X- Real-IP": "$remote_a ddr"}}' > /dev/null
82	```
83
84	This docum ent outlin es the ins tructions for instal ling the V eteranAppo intmentReq uestServic e v4.5.x.
85
86	Service Na me
87	Veteran Ap pointment Request Se rvice
88	Enclave
89	Veteran On ly
90	Docker Swa rm
91	VarResourc es
92	Java Runti me
93	JRE 1.8
94
95
96	Service an d Data Sou rce Depend encies
97	VeteranApp ointmentRe questSeriv ce v4.2.x depends on a number of data so urces and services d escribed b elow:
98
99	Dependency
100	Type
101	Dependency Type
102	Descriptio n
103	MDWS v3.2. 8
104	Service
105	Runtime
106	Verify thi s service is deploye d and avai lable/acce ssible for Veteran A ppointment Request S ervice. Th e endpoint configura tion is de scribed in the Prope rty overri de section .
107
108
109	MVI
110	Service
111	Runtime
112	Verify thi s service is deploye d and avai lable/acce ssible for Veteran A ppointment Request S ervice. Th e endpoint configura tion is de scribed in the Prope rty overri de section (mvi
113	.propertie s)
114	FacilitySe rvice
115	Service
116	Runtime
117	Verify thi s service is deploye d and avai lable/acce ssible for Veteran A ppointment Request S ervice. Th e endpoint configura tion is de scribed in the Prope rty overri de section (fac ilit y.properti es)
118	VarMessagi ngMicroser vice
119	Service
120	Runtime
121	Verify thi s service is deploye d and avai lable/acce ssible for Veteran A ppointment Request S ervice. Th e endpoint configura tion is de scribed in the Prope rty overri de section (vm m-con fig.proper ties)
122	MongoDB
123	Data Sourc e (MongoDB Database)
124	Runtime
125	Verify thi s data sou rce exists and is ac cessible.O therwisecr eateit.
126	VARDB
127	Data Sourc e (Oracle Database)
128	Deployment and Runti me
129	Verify thi s data sou rce and JN DI exists. Otherwise , create i t.
130
131
132	Property O verrides
133	VeteranApp ointmentRe questServi ce v4.5.x all of the se propert ies are no w stored a s environm ent variab les, pleas e make the desired c hanges as follows fo r each com ponent of VAR Resour ces.
134
135	VeteranApp ointmentRe questSeriv ce v4.5.x uses envco nsul to pu ll the env ironment v ariables d own from c onsul at t he path ap pconfig/
136	{VAMF_ENVI RONMENT}/v ar-resourc es The ava ilable con sul keys a re listed below.
137
138	SSL CertCo nfigutaion
139	In order t o support 2-way SSLw ithMVI, Mo ngo, and O racle - an SSL cert needs to b e imported intothekey store. The following propertie s need to beaddedtoc onsulinord erhave the cert auto matically imported a t startup.
140
141	ssl cert c onfigurati on
142
143
144
145	SVC_KEY_PK CS12=<base 64 encoded key cert -- as a ch ain cert> SVC_KEY_PK CS12_PWD=< the passwo rd of the cert> SVC_ KEYSTORE_P WD=<the ke ystore pas sword>
146
147
148
149	VARDB Data Source Co nfiguratio n
150	vardb envi ronment va riables
151
152
153
154	vardb_dial ect=org.hi bernate.di alect.Orac le10gDiale ct vardb_d riverClass Name=oracl e.jdbc.Ora cleDriver vardb_url= jdbc:oracl e:thin:@<o racle_ip/h ostname>:< oracle_por t>:<sid> v ardb_user= <username>
155	vardb_pass word=<pass word>
156
157
158
159	MDWS Confi guration
160	mdws envir onment var iables
161
162
163
164	scheduling .endBasePo intUrl=<MD WS end bas e point UR L> schedul ing.endPoi ntUrl=Sche dulingSvc. asmx
165
166
167
168
169	CDW Data S ource Conf iguration
170
171	cdw enviro nment vari ables
172
173
174
175	cdw_dialec t=org.hibe rnate.dial ect.SQLSer ver2008Dia lect cdw_d riverClass Name=net.s ourceforge .jtds.jdbc .Driver cd w_url=jdbc :jtds:sqls erver://<c dw_ip/host name>:<cdw _port> cdw _user=<use rname>
176	cdw_passwo rd=<passwo rd>
177
178
179
180	MVIConfigu ration
181	MVIuses2-w ay SSL. Pl ease make sure to ex change the certifica tes betwee n MVIandSe rver hoste d with the VeteranAp pointmentR equestSeri vc e v4.5. x. The SSL configura tion is on ly needed in Pre-Pro d and Prod uction as of Jun 201 7.
182
183	mvi enviro nment vari ables
184
185
186
187	mock.mvi=f alse # sho uld stay f alse; true is reserv ed for dev elopment m vi.endPoin tUrl=<mvi web servic e URL>
188
189
190
191	MongoDB Co nfiguratio n
192	mongo envi ronment va riables
193
194
195
196	#IP addres ses are in terchangea ble with f ully quali fied domai n names.
197	mongo.host =<Comma se parated Mo ngoNodeIP/ hostname:p ort> //Exa mple: For replica se ts, mongo. host shoul d be set a s mongo1:p ort1,mongo 2:port2,mo ngo3:port3
198	mongo.user =<var serv ice-specif ic account > (See PMD S ticket f or this se rvice) mon go.secretk ey=<passwo rd>
199	mongo.data base.name= var-utilit y mongo.ss l=true mon go.useAuth entication =true
200
201
202
203	Facility T imezone Co nfiguratio n
204	facility e nvironment variables
205
206
207
208	facility.t imezone.fe tch.all.ur i=<environ ment-addre ss>/Facili tyService/ v2/rest/pu blic/facil ity/timezo ne facilit y.timezone .fetch.by. id.uri=<en vironment- address>/F acilitySer vice/v2/re st/public/ facility/
209	{facility- id}/timezo ne
210
211	Var Api Ke ys Configu ration
212	var api ke ys environ ment varia bles
213
214
215
216	apiKeys=go ogleApiKey :
217	<myGoogleA piKey>
218
219	MoreapiKey s can be a dded to th is configu ration thr ough the s ame line.
220
221
222	apiKeys=go ogleApiKey :<myGoogle Api Key>,t estkey:tes tValue
223
224
225
226
227	Recall Rem inders Con figuration
228	recall-rem inders env ironment v ariables
229
230
231
232	# run at 6 :00am ever y day batc h.recall.r eminders.c ron.expres sion=0 0 6 * * *
233
234	vmm.token. uri=<var-m essaging-m icroservic e host> /VarMessag ing/v2/res t/api/auth vmm.post. recall.rem inder.uri= <var-messa ging-micro service ho st>/VarMes saging/v2/ rest/api/m essage rec all.num.da ys = 45
235	var.secret =VARSECRET
236	recall.rem inder.emai l.subject= It is time to schedu le a Follo w-Up Appoi ntment at <Clinic Na me> recall .reminder. email.body =\
237	<p>Your pr ovider has requested that you schedule a follow up appointme nt around <recall da te>. Pleas e
238	contact th e facility below to make an ap pointment: </p>\
239	<p>\
240	<Facility Name>\
241	<br /><Cli nic Name>\
242	<br /><Cli nic locati on friendl y name>\
243	<br /><Pro vider Name >\
244	</p>\
245	<p><a href ="https:// www.va.gov /directory /guide/div ision.asp? dnum=1">Vi ew VA Faci lities</a> </p>\
246	<p>Your VA Healthcar e Team</p> \
247
248	vmm.inapp. notificati on.fetch.u ri=<var-me ssaging-mi croservice host>/Var Messaging/ v2/rest/ap i/inApp/
249	{assigning Authority} /{uniqueId }
250	vmm.inapp. notificati on.mark.re ad=<var-me ssaging-mi croservice host>/Var Messaging/ v2/rest/ap i/inApp/
251	{messageId entifer}/r ead
252	vmm.inapp. notificati on.delete. uri=<var-m essaging-m icroservic e host>/Va rMessaging /v2/rest/a pi/inApp/
253	{messageId entifer}
254
255
256
257	Versions b efore 4.2
258	Please see these pag es for VAR 4.x insta llation in structions before ve rsion 4.2: VAR 4.0, VAR 4.1.1, VAR 4.1.2 , VAR 4.1. 4
259
260
261	Version VA R 4.2
262
263	Enable Pri mary Care direct sch eduling
264	Use mongo shell to e nable dire ct schedul ing of Pri mary Care appointmen ts. In VAR version 4 .2.4 and V AR Utility version 2 .1.1, Prim ary Care d irect sche duling is no longer enabled by default, but requir es explici t configur ation for sites whic h support it. The sc ript below will ensu re that Pr imary Care direct sc heduling r emains ena bled for t hose facil ities whic h do not a lready hav e this set ting appli ed. Refer to MongoDB documenta tion for s yntax of t he command to execut e a script against t he the var -utility d atabase sp ecified. A sample pa rtial comm and is pro vided belo w. Please issue the complete c ommand for the envir onment bei ng install ed.
265
266	mongo --ss l -u <user name> -p < password> --authenti cationData base <auth entication database> var-utili ty set- pr imary-care -support.j s
267
268	Download t he the scr ipt: set-p rimary-car e-support. js
269
270
271	Community Care
272
273	Import Com munity Car e Types of Care (if it has not been done )
274
275	Use mongoi mport util ity to imp ort the li st of Type s of Care into the M ongDB inst ance confi gured abov e. Import data into the commun ityCareTy peOfCares collection in the va r-utility database. Refer to M ongoDBdocu mentationf orsyntax o f the comm and toimpo rtajson fi le into th e designat ed collect ion in the designate d database . A sample partial c ommand is provided b elow. Plea se issue t he complet e command for the en vironment being inst alled.
276
277	mongoimpor t --ssl -- db var-uti lity --col lection co mmunityCar eTypeOfCar es --drop --jsonArra y --file < communi ty -care-type -of-cares. json> -u < username> -p <passwo rd> --auth entication Database < authentica tion datab ase>
278
279
280
281	community- care-types -of-care.j son
282	[
283	{
284	"_id" : "C CAUDHEAR",
285	"name" : " Audiology (hearing a id support )",
286	"details" : "This is an office visit for Veterans who alread y have
287	a hearing aid and wh o need ass istance wi th the dev ice. This visit is f or trouble shooting or adjusti ng your he aring aid for best p erformance . This may include t echnical a djustments , cleaning , and/or r eprogrammi ng for new listening situation s and envi ronments. This is no t a visit to initial ly be eval uated for or to obta in a heari ng aid.",
288	"confirmat ion" : "Th is request is for he aring aid support on ly. If you have othe r needs, p lease cont act your P rimary Car e Provider to discus s the issu e. If you are distan ce eligibl e and do n ot have a Primary Ca re Provide r, you can use this app to req uest help in getting one assig ned."
289	},
290	{
291	"_id" : "C CAUDRTNE",
292	"name" : " Audiology (routine h earing exa m)",
293	"details" : "This in cludes an office vis it for a h earing exa m and eval uation usi ng non-inv asive test s to check your hear ing and in ner ear he alth. The exam may l ead to pre vention an d treatmen t recommen dations, a request f or further consultat ion, and/o r a recomm endation f or hearing aids. A r outine exa m is not f or any new or sudden changes w ith your h earing or ears.",
294	"confirmat ion" : "Th is request is for ro utine hear ing exam o nly.
295	If you hav e other ne eds, pleas e contact your Prima ry Care Pr ovider to discuss th e issue. I f you are distance e ligible an d do not h ave a Prim ary Care P rovider, y ou can use this app to request help in g etting one assigned. "
296	},
297	{
298	"_id" : "C COPT",
299	"name" : " Optometry (routine e ye exam)",
300	"details" : "This in cludes an office vis it for an eye exam a nd vision evaluation , which ma y include dilating y our eyes. The exam m ay lead to preventio n and trea tment reco mmendation s, a reque st for fur ther
301
302	consultati on, and/or a prescri ption for eye glasse s or conta ct lenses. A routine exam is n ot for any new or su dden chang es with yo ur vision or eyes.",
303	"confirmat ion" : "Th is request currently only supp orts routi ne eye exa ms. If you have othe r needs, p lease cont act your P rimary Car e Provider to discus s the issu e. If you are distan ce eligibl e and do n ot have a Primary Ca re Provide r, you can use this app to req uest help in getting one assig ned."
304	},
305	{
306	"_id":"CCP CPRVDR",
307	"name":"Pr imary Care (find a p rovider)",
308	"details": "If approv ed, you'll be assign ed to a pr imary care provider in the com munity to whom we wi ll send th e approved referral. If you ha ve a prefe rence on a Primary C are Provid er, please contact y our local VA Medical Center (V AMC). Once assigned, you will be provide d informat ion and wi ll need to contact t he provide r’s office directly for preven tive and o ther healt h care nee ds for the duration of the app roved refe rral.",
309	"confirmat ion":"This request c urrently o nly suppor ts the fin ding of a Primary Ca re Provide r. If you have other needs, pl ease conta ct your Pr imary Care Provider to discuss this issu e. If you are distan ce eligibl e and do n ot have a Primary Ca re Provide r, you can use this app to req uest help in getting one assig ned."
310	},
311	{
312	"_id":"CCP OD",
313	"name":"Po diatry (ro utine exam )",
314	"details": "This incl udes an of fice visit for an ex am of the foot, ankl e and rela ted struct ures of th e leg. The exam may lead to di agnosis an d treatmen t to inclu de common conditions like call ous, bunio ns, and ot her condit ions requi ring in of fice treat ment, orth otics, and possibly the need f or surgery . If you a re experie ncing any acute cond itions or sudden ons et of pain , break in the skin with possi ble infect ion, pleas e contact your local VAMC.",
315	"confirmat ion":"This request c urrently o nly suppor ts routine podiatry exams. If you have o ther needs , please c ontact you r Primary Care Provi der to dis cuss this issue. If you are di stance eli gible and do not hav e a Primar y Care Pro vider, you can use t his app to request h elp in get ting one a ssigned."
316	}
317	]
318
319
320
321
322	Create Com munity Car e Appointm ent Reques t (if it h as not bee n done)
323	Run the fo llowing SQ L script o n VARDB sc hema.
324
325
326
327	VAR-9277.s ql
328
329
330	CREATE TAB LE "VARDB" ."CC_APPOI NTMENT_REQ UEST" (
331	"CC_APPOIN TMENT_REQU EST_ID" VA RCHAR2(32 BYTE) NOT NULL ENABL E, "APPOIN TMENT_REQU EST_ID" VA RCHAR2(32 BYTE) NOT NULL ENABL E, "TRAVEL _BURDEN" N UMBER NOT NULL ENABL E, "UNUSUA L_TRAVEL_B URDEN" NUM BER,
332	"DISTANCE_ WILLING_TO _TRAVEL" N UMBER NOT NULL ENABL E, "ADDRES S" VARCHAR 2(100 BYTE ),
333	"CITY" VAR CHAR2(50 B YTE), "STA TE" VARCHA R2(2 BYTE) , "ZIPCODE " VARCHAR2 (5 BYTE),
334	"PREFERRED _ZIPCODE" VARCHAR2(5 BYTE) NOT NULL ENAB LE
335	);
336
337
338	Create Pre ferred Pro vider (if it has not been done )
339
340	Run the fo llowing SQ L script o n VARDB sc hema.
341
342
343
344	create pre ferred pro vider
345	---------- ---------- ---------- ---------- ---------- ------
346	--DDL for Table PREF ERRED_PROV IDER
347	---------- ---------- ---------- ---------- ---------- ------
348
349	CREATE TAB LE "VARDB" ."PREFERRE D_PROVIDER "
350	( "PREFERR ED_PROVIDE R_ID" VARC HAR2(32 BY TE), "CC_A PPOINTMENT _REQUEST_I D" VARCHAR 2(32 BYTE) , "FIRST_N AME" VARCH AR2(100 BY TE),
351	"LAST_NAME " VARCHAR2 (100 BYTE) , "PRACTIC E_NAME" VA RCHAR2(100 BYTE), "P ROVIDER_ST REET" VARC HAR2(100 B YTE), "PRO VIDER_CITY " VARCHAR2 (100 BYTE) , "PROVIDE R_STATE" V ARCHAR2(2 BYTE), "PR OVIDER_ZIP CODE" VARC HAR2(10 BY TE), "PREF ERRED_ORDE R" NUMBER NOT NULL
352	);
353	---------- ---------- ---------- ---------- ---------- ------
354	--DDL for Index PK_P REFERRED_P ROVIDER
355	---------- ---------- ---------- ---------- ---------- ------
356
357	CREATE UNI QUE INDEX "VARDB"."P K_PREFERRE D_PROVIDER " ON "VARD B"." PREFE RRED_PROVI DER" ("PRE FERRED_PRO VIDER_ID") ;
358
359	---------- ---------- ---------- ---------- ---------- ------
360	--Constrai nts for Ta ble PREFER RED_PROVID ER
361	---------- ---------- ---------- ---------- ---------- ------
362
363	ALTER TABL E "VARDB". "PREFERRED _PROVIDER" ADD CONST RAINT "PK_ PREFERRED_ PROVIDER" PRIMARY KE Y ("PREFER RED_PROVID ER_ID");
364	---------- ---------- ---------- ---------- ---------- ------
365	--Ref Cons traints fo r Table PR EFERRED_PR OVIDER
366	---------- ---------- ---------- ---------- ---------- ------
367
368	ALTER TABL E "VARDB". "PREFERRED _PROVIDER" ADD CONST RAINT "FK_ PREFERRED_ PROVIDER" FOREIGN KE Y ("CC_APP OINTMENT_R EQUEST_ID" )
369	REFERENCES "VARDB"." CC_APPOINT MENT_REQUE ST" ("CC_A PPOINTMENT _REQUEST_I D") ENABLE ;
370
371
372
373
374	Create Off ice Hours (if it has not been done)
375
376	Run the fo llowing SQ L script o n VARDB sc hema.
377
378
379
380	office hou rs
381
382
383	CREATE TAB LE "VARDB" ."OFFICE_H OURS" (
384	"CC_APPOIN TMENT_REQU EST_ID" VA RCHAR2(32 BYTE), "OF FICE_TIME" VARCHAR2( 40 BYTE)
385	);
386
387	CREATE UNI QUE INDEX "VARDB"."P K_OFFICE_T IME" ON "V ARDB"."OFF ICE_HOURS" ("CC_APPO INTMENT_RE QUEST_ID", "OFFICE_T IME");
388
389
390
391
392	Update Com munity Car e Appointm ent Reques t in Oracl e DB (if i t has not been done)
393
394	Run the fo llowing SQ L script o n VARDB sc hema.
395
396
397
398	vardb_adde d_col_know n_eligibil ity.sql
399
400
401	ALTER TABL E CC_APPOI NTMENT_REQ UEST MODIF Y (
402	TRAVEL_BUR DEN NULL
403	);
404	ALTER TABL E CC_APPOI NTMENT_REQ UEST ADD (
405	DISTANCE_E LIGIBLE NU MBER
406	);
407	UPDATE CC_ APPOINTMEN T_REQUEST SET DISTAN CE_ELIGIBL E = 0;
408	ALTER TABL E CC_APPOI NTMENT_REQ UEST MODIF Y (
409	DISTANCE_E LIGIBLE NO T NULL
410	);
411
412
413
414	Update App ointment R equest in Oracle DB (if it has not been done)
415
416	Run the fo llowing SQ L script o n VARDB sc hema.
417
418
419
420	SCV-2857.s ql
421
422
423	ALTER TABL E VARDB.AP POINTMENT_ REQUEST AD D (
424	LOCATION_I D VARCHAR2 (100), AUT HORITATIVE _NAME VARC HAR2(255), FRIENDLY_ NAME VARCH AR2(255)
425	); COMMIT;
426
427	Update App ointment R equest in Oracle DB (if it has not been done)
428
429	Run the fo llowing SQ L script o n VARDB sc hema.
430
431
432
433	ALTER TABL E VARDB.AP POINTMENT_ REQUEST DR OP COLUMN LOCATION_I D;
434	ALTER TABL E VARDB.AP POINTMENT_ REQUEST DR OP COLUMN AUTHORITAT IVE_NAME;
435
436
437	-- Make su re the pri mary key i s set to t he facilit y code. Pr eviously i t was the name.
438	ALTER TABL E VARDB.FA CILITY DRO P CONSTRAI NT PK_FACI LITY; DROP INDEX VAR DB.PK_FACI LITY;
439	ALTER TABL E VARDB.FA CILITY ADD CONSTRAIN T PK_FACIL ITY PRIMAR Y KEY (FAC ILITY_CODE );
440
441
442
443
444	Update
445	Community Care Appoi ntment
446	Request
447	in Oracle DB
448
449	(if it has not been done)
450	Run the fo llowing SQ L script o n VARDB sc hema.
451
452
453
454	add prefer red column to cc app ointment t able
455
456
457	ALTER TABL E VARDB.CC _APPOINTME NT_REQUEST
458	ADD (PREFE RRED_CITY VARCHAR2(5 0 BYTE) DE FAULT '' N OT NULL); ALTER TABL E VARDB.CC _APPOINTME NT_REQUEST
459	ADD (PREFE RRED_STATE VARCHAR2( 2 BYTE) DE FAULT '' N OT NULL);
460
461
462	ALTER TABL E VARDB.CC _APPOINTME NT_REQUEST
463	ADD (PREFE RRED_LANGU AGE VARCHA R2(100 BYT E)DEFAULT 'English' NOT NULL);
464
465	ALTER TABL E VARDB.CC _APPOINTME NT_REQUEST
466	MODIFY (PR EFERRED_ZI PCODE VARC HAR2(10 BY TE) NULL);
467
468	ALTER TABL E VARDB.CC _APPOINTME NT_REQUEST
469	RENAME COL UMN "DISTA NCE_WILLIN G_TO_TRAVE L" TO "DIS TANCE_TRAV EL_LEGACY" ;
470
471	ALTER TABL E VARDB.CC _APPOINTME NT_REQUEST
472	ADD (DISTA NCE_WILLIN G_TO_TRAVE L VARCHAR2 (50 BYTE) DEFAULT '' NOT NULL) ;
473
474	UPDATE VAR DB.CC_APPO INTMENT_RE QUEST
475	SET DISTAN CE_WILLING _TO_TRAVEL =to_char(D ISTANCE_TR AVEL_LEGAC Y);
476
477	commit;
478	ALTER tabl e VARDB.CC _APPOINTME NT_REQUEST DROP (DIS TANCE_TRAV EL_LEGACY) ;
479
480
481	Version VA R 4.3
482
483	Installati on
484	No changes required.
485
486
487	Rollback P rocedure ( to version 4.2.9)
488	Remove the Docker co ntainer an d follow t he Install Instructi ons for ve rsion 4.2. 9.
489
490
491	Version VA R 4.4
492
493	Installati on
494
495	Oracle
496
497	Run the fo llowing SQ L script o n VARDB sc hema.
498
499
500
501
502	UPDATE VAR DB.DETAIL_ CODE
503	SET VETERA N_MESSAGE= 'The appoi ntment typ e you requ ested is n ot availab le for onl ine schedu ling reque sts. VA wi ll contact you to sc hedule an appointmen t. If VA h as not con tacted you within 24 hours, pl ease conta ct your fa cility.'
504	WHERE DETA IL_CODE_ID ='DETCODE2 1'; COMMIT ;
505
506
507	Rollback P rocedure ( to version 4.3)
508
509	Oracle
510
511	Run the fo llowing SQ L script o n VARDB sc hema.
512
513
514
515	UPDATE VAR DB.DETAIL_ CODE
516	SET VETERA N_MESSAGE= 'The appoi ntment typ e you requ ested is n ot availab le for onl ine schedu ling reque sts. Pleas e contact your facil ity if you still nee d to sched ule this a ppointment .' WHERE D ETAIL_CODE _ID='DETCO DE21';
517	COMMIT;
518
519	Remove the Docker co ntainer an d follow t he Install Instructi ons for ve rsion 4.3
520
521
522
523	Version VA R 4.5
524
525	Installati on
526	No changes required.
527
528
529	Rollback P rocedure ( to version 4.4)
530	Remove the Docker co ntainer an d follow t he Install Instructi ons for ve rsion 4.4.
531
532
533	Disabling Features
534	VeteranApp ointmentRe questServi ce has the ability t o disable features b ased on fe ature set. This rele ase includ es Communi ty Care fe atures as well as Te lehealth f eatures, d isabled by default. This is co ntrolled b y a proper ties file:
535
536	var-disabl ed-feature s.properti es and the property disabledFe atures.dis abledFeatu res. The d efault set ting is be low:
537
538
539	var-disabl ed-feature s.properti es
540
541
542	#disabled features f or var dis abledFeatu res.disabl edFeatures =CC_FEATUR E_SET,TH_F EATURE_SET
543
544	To enable specific f eatures, t he feature set flag entry must be remove d from the comma-sep arated lis t (the fla gs can be in any ord er):
545
546
547
548	#example: disables b oth Commun ity Care f eatures an d Teleheal th feature s for VAR disabledFe atures.dis abledFeatu res='TH_FE ATURE_SET, CC_FEATURE _SET'
549
550	#example: enables ju st Communi ty Care fe atures for VAR disab ledFeature s.disabled Features=' TH_FEATURE _SET'
551
552	#example: enables ju st Telehea lth featur es for VAR disabledF eatures.di sabledFeat ures='CC_F EATURE_SET '
553
554	#example: enables al l optional ly configu rable feat ures for V AR disable dFeatures. disabledFe atures=''
555
556
557
558
559
560
561	CDW Check List
562	Ensure tha t the CDW instance c onnected t o this ins tallation has the co rrect vers ion of the following stored pr ocedures a nd functio ns:
563
564	OIA_Mobile Health.App .ap_GetPtA ctiveTeams Members_v4
565	OIA_Mobile Health.App .ap_GetPtA ctiveTeams Clinics_v5
566	OIA_Mobile Health.App .ap_GetAct iveClinics _v3
567	OIA_Mobile Health.App .fn_VAR_Bu ildStopcod eTable
568	OIA_Mobile Health.App .ap_ApptRe callRemind ersByDate_ v1
569	OIA_Mobile Health.App .ap_GetChi ldFaciliti es_v1
570
571
572	Important Note About Recall Re minders
573	VAR Resour ces 4.x is configure d with the Recall Re minder cro n job turn ed on by d efault. Th is means t hat every Docker con tainer dep loyed will run the j ob and dup licate Rec all Remind ers will g o out. To remediate this issue , it is ad vised that VAR Resou rces only be deploye d on a sin gle Docker container , until th e worker s ervice can bedeploye dtoit's ow n containe r. In the event that more VAR Resources Docker con tainers ar e needed f or load ba lancing, b e sure to turn off t he cron jo b by setti ng the tim e to run t o the past :
574
575	recall-rem inders.pro perties (o r via Cons ul)
576
577
578
579	batch.reca ll.reminde rs.cron.ex pression=0 0 6 * * * 2016
580
581
582
583	AppDynamic s Configur ation
584	Taken from DRAFT - H ow to inte grate AppD ynamics ag ent with T omca
585
586	Modify you r app's do cker-compo se.yml wit h Environm ent Variab les for Co nsul
587
588	Add CONSUL _* Variabl es to Envi ronment
589
590	This image requires the envrio nment vari able CONSU L_APPDYNAM ICS_PATH, CONSUL_SER VER, CONSU L_TOKEN, a nd CONSUL_ PATH to be set. Plea se add the following as an env ironment v ariables i n the serv ice's dock er-compose .yml:
591
592	environmen t:
593
594	"CONSUL_SE RVER=${CON SUL_HTTP_A DDR}"
595
596	"CONSUL_TO KEN=${CONS UL_MASTER_ TOKEN}"
597
598	"CONSUL_PA TH=appconf ig/${VAMF_ ENVIRONMEN T}/var-res ources"
599
600	"CONSUL_AP PDYNAMICS_ PATH=appco nfig/${VAM F_ENVIRONM ENT}/appdy namics
601	Set CONSUL _PATH key/ values
602
603	Consul is used to se t properti es for the AppDynami cs Agent. Please set the follo wing value s in the a pplication s Consul p ath. appco nfig
604	/${VAMF_EN VIRONMENT} /var-resou rces/* APP DYNAMICS_M ONITORING_ ENABLED AP PDYNAMICS_ APPLICATIO N_NAME
605	APPDYNAMIC S_NODE_PRE FIX
606	Enable App Dynamics A gent
607
608	Consul is used to en able/disab le AppDyna mics Agent .
609
610	Set APPDYN AMICS_MONI TORING_ENA BLED in ap plication' s Consul p ath
611
612	set APPDYN AMICS_MONI TORING_ENA BLED to tr ue in the applicatio n's Consul config to enable Ap pDynamics Agent. app config/${V AMF_ENVIRO NMENT}/<YO UR_APP>/AP PDYNAMICS_ MONITORING _ENABLED=t rue
613	Set APPDYN AMICS_APPL ICATION_NA ME in appl ication's Consul pat h (require d if AP PDYNAMICS_ MONITORING _ENABLED=t rue)
614
615	set APPDYN AMICS_APPL ICATION_NA ME to the applicatio n name in the applic ation's Co nsul confi g.
616
617	appconfig/ ${VAMF_ENV IRONMENT}/ var-resour ces/APPDYN AMICS_APPL ICATION_NA ME="VAMF <VAMF_E NVIRONMENT > var- resources "
618	Set APPDYN AMICS_NODE _PREFIX in applicati on's Consu l path(req uired if A PPDYNAMICS _MONITORIN G_ENABLED= true) set APPDYNAMIC S_NODE_PRE FIX to the applicati on node pr efix in th e applicat ion's Cons ul config. appconfig /${VAMF_EN VIRONMENT} /<YOUR_APP >/APPDYNAM ICS_NODE_P REFIX=var- resources
619	Set CONSUL _APPDYNAMI CS_PATH ke y/values ( GLOBAL) (i f APPDYNAM ICS_MONITO RING_ENABL ED=true):
620
621	Consul is used to se t properti es for the AppDynami cs Agent. Please ens ure the fo llowing va lues are s et in the "appdynami cs" Consul path. The se are set once for all apps.
622
623	appconfig/ ${VAMF_ENV IRONMENT}/ appdynamic s/* CONTRO LLER_HOST
624	ACCOUNT_NA ME ACCOUNT _ACCESS_KE Y
625
626	Deployment
627	VeteranApp ointmentRe questSeriv ce v4.5.x is a stand ard VAMF w eb service that has been devel oped and t ested on t he ECE env iornment. After veri fying the dependenci es and pro perty conf iguration, build the docker im age from t he JENKINS Location from the V DD page on the Docke r Containe r.
628
629
630
631
632	Consul key s:
633
634	export VAM F_ENVIRONM ENT=ece-de v
635	export MON GO_USER=<o ps provide d username > export M ONGO_PASS= <ops provi ded passwo rd>
636	export MON GO_HOST=mo ngo-di-n5. mobileheal th.va.gov export CON SUL_HTTP_A DDR=vhaece devucp04.v amisece.io :8500
637
638	curl -H "X -Consul-To ken: $CONS UL_TOKEN" -s -X PUT $CONSUL_HT TP_ADDR/v1 /kv/vamf/$ VAMF_ENVIR ONMENT
639	/apigatewa y/1.0/serv ices/var-r esources - d '{"locat ion":"/var /VeteranAp pointmentR equestServ ice"," ser vice":"var -resources ","redirec t":"off"," headers":{ "X-Real-IP ":"$remote _addr"}}'
640
641
642
643	Validation
644
645	Ensure tha t https:// <environme nt-address >/var/Vete ranAppoint mentReques tService r eturns "We lcome to V eteranAppo intmentReq uestServic e" with th e correct manifest.
646
647
648
649	Rollback P rocedure ( v4.3.0+87 to v4.2.9+ 86)
650
651	Mongo Roll back
652	Drop the c ommunityCa reTypeOfCa res collec tion in th e var-util ity databa se. A comm and is pro vided belo w after be ing authen ticated wi th mongo.
653
654	db.communi tyCareType OfCares.dr op();
655
656
657
658	Drop the C C_APPOINTM ENT_REQUES T table in VARDB sch ema.
659
660	Drop CC_AP POINTMENT_ REQUEST
661
662
663	DROP TABLE CC_APPOIN TMENT_REQU EST;
664
665
666	For rollin g back cha nges to th e VAR_APPO INTMENT_RE QUEST tabl e in VARDB schema, y ou can eit her logica lly delete the colum ns or phys ically del ete.
667	Logical De lete
668
669
670	ALTER TABL E table_na me SET UNU SED (LOCAT ION_ID, AU THORITATIV E_NAME, FR IENDLY_NAM E); COMMIT ;
671
672	Physical D elete
673
674
675	ALTER TABL E table_na me DROP (L OCATION_ID , AUTHORIT ATIVE_NAME , FRIENDLY _NAME); CO MMIT;
676
677	Remove the Docker co ntainer an d follow t he Install Instructi ons for ve rsion 4.2. x, which i s the vers ion curren tly instal led and op erational in product ion.
678
679
680
681
682	PMDS Ticke t Tracker
683
684
685	Version
686	Link to Se ction in I nstall Ins tsructions
687	Summary
688	Ticket Lin k - Devint
689	Ticket Lin k - SQA
690	Ticket Lin k - Pre- P rod
691	Ticket Lin k - Prod
692
693
694
695
696
697
		698