Installation How To Vista/Cache for Windows

= Installation Overview =

Version
These instructions have been designed for the following:


 * Operating system: Microsoft&reg; WindowsTM XP service pack 2.
 * VistA version/release number: _____
 * Cache version: _____ for Microsoft&reg; WindowsTM XP.

Terminology
See the VistA introduction on the Main Page for important information on basic concepts and terminology that you must be familiar with in order to understand the installation instructions.


 * M and MUMPS
 * CPRS
 * Broker
 * VistA Domain
 * Patient Records
 * Terminal Client
 * Server Tools

Basic Steps
Installation of VistA consists of the following general steps:


 * 1) Install Cache
 * 2) Install the VistA Package for Cache
 * 3) Reconfigure some files
 * 4) Set up the VistA Domain
 * 5) Set up the Master Records
 * 6) Set up the Broker Service
 * 7) Start the VistA Process
 * 8) Install CPRS
 * 9) Test CPRS

The rest of this installation how to will guide you through all of these steps.

Command Summary
The command summary here is used in M to perform various VistA tasks. It is placed in the beginning of the document so you can easily refer to it. You won't understand any of this until you begin installing VistA, so you can skip reading this and go on to the next section.

= Installing VistA =

Install Cache
This phase of the installation creates an area (a namespace) for you to work in and point that namespace to the distributed VistA database. The instructions below are for Cache 5.0 and below. The instructions for the installation and mapping of the VistA Routines and Globals for using Cache 5.2 may be downloaded from http://OpenSourceVistA.net:8888/NancysVistAServer. They are available in Open Document Format and in Word format and are titled InstallingVistAWithSingleUserVersionOfCache5.2 And place a semi-colon before the I, it should now look like this: Save, Compile, and Close the rountine.

40.  CLOSE Studio and go back to Terminal and run "D ^%CD" and enter "VISTA" for the namespace again. Now determine the what is called the "BOX:VOLUME pair", which is really a VOLUME:BOX pair, for your machine. This is done as follows: VISTA&gt;D GETENV^%ZOSV W Y  Here is a sample return: VISTA^CACHE^ANTHRAX^CACHE:CACHEWEB In this instance, the 4th "piece", assuming ^ is the divider, is CACHE:CACHEWEB, which is the BOX:VOLUME pair. ANTHRAX is the name of the computer this was done on, also known as the NODE. The first CACHE (second "piece") listed is the VOLUME. VISTA is the UCI (also the directory name where CACHE.DAT is located). UCI is an old terminology you do not need to understand, but it helps to know what the UCI should be. The so called BOX:VOLUME pair is actually the VOLUME:BOX pair, but it is always referred to as the "BOX VOLUME pair". In short, this is what the above line corresponds to: UCI^VOL^NODE^BOX:VOLUME Jot down your BOX:VOLUME pair for comparison with what you find as the installation continues to be sure it has been set correctly. It is very important that it be correct in some of the parameter files.

41. Now to create your own domain. From the VISTA Prompt, start VA FileMan by typing &quot;D Q^DI&quot;. At the Select OPTION: Prompt. Type &quot;1&quot;. (You can see why you typed 1 if you type &quot;??&quot; at the option Prompt. That will give you the list of options you can choose from and 1 is ENTER OR EDIT FILE ENTRIES.) At INPUT TO WHAT FILE: type &quot;DOMAIN&quot; and accept the ALL// default to EDIT WHICH FIELD. At Select DOMAIN NAME: enter a local domain name. Substitute an appropriate value for VISTA.MYDOMAIN.COM in the example below.

 Select OPTION: 1  ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: NEW PERSON// DOMAIN EDIT WHICH FIELD: ALL// Select DOMAIN NAME: VISTA.MYDOMAIN.COM Are you adding 'VISTA.MYDOMAIN.COM' as       a new DOMAIN (the 2ND)? No// Y (Yes) FLAGS: ^ Select DOMAIN NAME:

42. Now to complete the DOMAIN set up by Christening the new domain. Go back to the VISTA> Prompt and type &quot;D CHRISTEN^XMUDCHR&quot;.  VISTA>DO CHRISTEN^XMUDCHR * * * * WARNING  * * * * You are about to change the domain name of this facility in the MailMan Site Parameters file. Currently, this facility is named: PLATINUM.VISTA.MED.VA.GOV You must be extremely sure before you proceed! Are you sure you want to change the name of this facility? NO// YES Select DOMAIN NAME: PLATINUM.VISTA.MED.VA.GOV// VISTA.MYDOMAIN.COM The domain name for this facility is now: VISTA.MYDOMAIN.COM PARENT: 4// PLATINUM.VISTA.MED.VA.GOV TIME ZONE: MDT// PDT         PACIFIC DAYLIGHT PLATINUM.VISTA.MED.VA.GOV has been initialized as your 'parent' domain. (Forum is usually the parent domain, unless this is a subordinate domain.) You may edit the MailMan Site Parameter file to change your parent domain. We will not initialize your transmission scripts. Use the 'Subroutine editor' option under network management menu to add your site passwords to the MINIENGINE script, and the 'Edit a script' option to edit any domain scripts that you choose to. not select "VISTA.PLATINUM.MED.VA.GOV" as a parent.
 * Note: Parent domain may be listed as "FORUM.VA.GOV" instead of "PLATINUM". You can

43. Determine the internal entry of the new domain. Remember this number as it will be used in subsequent steps. Get back to the Select OPTION: Prompt and enter &quot;INQUIRE&quot; or &quot;5&quot; (once again, you can type ?? to see the available options and 5 is INQUIRE TO FILE ENTRIES) then at the Select DOMAIN NAME: Prompt, enter the new domain name you just created. Answer &quot;N&quot; to STANDARD CAPTIONED OUTPUT and at PRINT FIELD: answer &quot;NUMBER&quot;. The domain number is &quot;printed&quot; to the screen.

 Select OPTION: 5 INQUIRE TO FILE ENTRIES OUTPUT FROM WHAT FILE: DOMAIN// Select DOMAIN NAME: VISTA.MYDOMAIN.COM ANOTHER ONE: STANDARD CAPTIONED OUTPUT? Yes// N (No) FIRST PRINT FIELD: NUMBER THEN PRINT FIELD: Heading (S/C): DOMAIN LIST// DEVICE:  CONSOLE    Right Margin: 80// DOMAIN LIST                                            APR 11,2003  10:51    PAGE 1 NUMBER 3

Note my setting is |TRM| while CACHE.DAT was defaulted to |TNT|

44. From the VISTA Prompt repoint the KERNEL SYSTEM PARAMETERS and RPC BROKER PARAMETERS files to the new domain, go back to the VISTA> Prompt and enter 'S $P(^XTV(8989.3,1,0),&quot;^&quot;)=3' and 'S $P(^XWB(8994.1,1,0),&quot;^&quot;)=3' where 3 is the internal number of the new domain we just created in the previous step.  VISTA>S $P(^XTV(8989.3,1,0),&quot;^&quot;)=3 VISTA>S $P(^XWB(8994.1,1,0),&quot;^&quot;)=3

45. Then from the VISTA> Prompt again start FileMan with &quot;D Q^DI&quot;. At Select OPTION: enter &quot;6&quot; (UTILITY FUNCTIONS) then select RE-INDEX FILE. At MODIFY WHAT FILE, enter &quot;KERNEL SYSTEM PARAMETERS&quot;. Then do the same for the RPC BROKER PARAMETERS file. See example below for the rest of the dialogue.  VISTA>D Q^DI VA FileMan 22.0 Select OPTION: UTILITY FUNCTIONS Select UTILITY OPTION: RE-INDEX FILE MODIFY WHAT FILE: DOMAIN// 8989.3  KERNEL SYSTEM PARAMETERS    (1 entry) THERE ARE 13 INDICES WITHIN THIS FILE DO YOU WISH TO RE-CROSS-REFERENCE ONE PARTICULAR INDEX? No//  (No) OK, ARE YOU SURE YOU WANT TO KILL OFF THE EXISTING 13 INDICES? No// Y (Yes) DO YOU THEN WANT TO 'RE-CROSS-REFERENCE'? Yes// (Yes) ...EXCUSE ME, LET ME THINK ABOUT THAT A MOMENT... FILE WILL NOW BE 'RE-CROSS-REFERENCED'................ Select UTILITY OPTION: RE-INDEX FILE MODIFY WHAT FILE: KERNEL SYSTEM PARAMETERS// 8994.1  RPC BROKER SITE PARAMETERS            (1 entry) THERE ARE 5 INDICES WITHIN THIS FILE DO YOU WISH TO RE-CROSS-REFERENCE ONE PARTICULAR INDEX? No//   (No) OK, ARE YOU SURE YOU WANT TO KILL OFF THE EXISTING 5 INDICES? No// Y  (Yes) DO YOU THEN WANT TO 'RE-CROSS-REFERENCE'? Yes//   (Yes) ...HMMM, HOLD ON... FILE WILL NOW BE 'RE-CROSS-REFERENCED'......

46. Check the VOLUME SET File (#14.5). If you accepted the default VISTA when you ran ZTMGRSET (see previous steps), the VOLUME SET File should not need any changes. At Select OPTION: enter &quot;1&quot; for EDIT OR ENTER FILE ENTRIES. The choice should be INPUT TO WHAT FILE: VOLUME SET//. Accept the default if it is VOLUME SET else type &quot;14.5&quot;, and at EDIT WHICH FIELD: ALL// hit enter. At Select VOLUME SET Prompt type &quot;??&quot; to see a list of entries. When asked which volume set again, type in VISTA or whatever it is exactly as it is (all caps). Leave TASKMAN FILES UCI: VISTA// as VISTA. The values should match what is shown below.  Select OPTION: 1  ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: VOLUME SET// 14.5  VOLUME SET  (1 entry) EDIT WHICH FIELD: ALL// Select VOLUME SET: ?? VISTA You may enter a new VOLUME SET, if you wish Answer should be the name of a volume set. When each cpu can have only one volume set, this is also the cpu name. Answer will be used in extended global references to reach this volume. Select VOLUME SET: VISTA VOLUME SET: VISTA// TYPE: GENERAL PURPOSE VOLUME SET// INHIBIT LOGONS?: NO// LINK ACCESS?: YES// OUT OF SERVICE?: NO// REQUIRED VOLUME SET?: NO// TASKMAN FILES UCI: VISTA// TASKMAN FILES VOLUME SET: VISTA// REPLACEMENT VOLUME SET: DAYS TO KEEP OLD TASKS: 4// SIGNON/PRODUCTION VOLUME SET: Yes// Select VOLUME SET:

47. This step is to get the proper value for the BOX-VOLUME PAIR in the TASKMAN SITE PARAMETERS File. Edit the TASKMAN SITE PARAMETER File (# 14.7) to update the BOX-VOLUME PAIR. Note that when you enter a &quot;?&quot; at the BOX-VOLUME PAIR Prompt, it tells you what the correct value should be.  Select OPTION: 1  ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: VOLUME SET// 14.7  TASKMAN SITE PARAMETERS (1 entry) EDIT WHICH FIELD: ALL// Select TASKMAN SITE PARAMETERS BOX-VOLUME PAIR: ? Answer with TASKMAN SITE PARAMETERS BOX-VOLUME PAIR: VISTA:CACHE You may enter a new TASKMAN SITE PARAMETERS, if you wish Answer must be 3-30 characters in length. The value for the current account is VISTA:CACHEWEB Select TASKMAN SITE PARAMETERS BOX-VOLUME PAIR: VISTA:CACHE BOX-VOLUME PAIR: VISTA:CACHE// VISTA:CACHEWEB RESERVED: ^ Select TASKMAN SITE PARAMETERS BOX-VOLUME PAIR:

<td valign="top" width=25>48. Now update the RPC BROKER SITE PARAMETER File. <td valign="top" width=25> Select OPTION: 1   ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: TASKMAN SITE PARAMETERS// 8994.1  RPC BROKER SITE PARAMETERS EDIT WHICH FIELD: ALL// Select RPC BROKER SITE PARAMETERS DOMAIN NAME: VISTA.MYDOMAIN.COM ...OK? Yes//  (Yes) DOMAIN NAME: VISTA.MYDOMAIN.COM// Select BOX-VOLUME PAIR: VISTA:CACHEWEB// BOX-VOLUME PAIR: VISTA:CACHEWEB// Select PORT: 9210// PORT: 9210// *UCI: STATUS: STOPPED// CONTROLLED BY LISTENER STARTER: YES// N  NO

Set Yourself Up as the System Manager This is a super user who will have elevated privileges. You can add other users such as Physicians, Pharmacists, etc. later.

Set Up More Parameters These are parameters that are more applicable to the VistA Application software.

Set Up Menus for the System Manager EVE is the System Manager menu and XUCOMMAND is a common menu available to all users.

<td valign="top" width=25>90. Exit by entering &quot;^&quot; at any Prompt. At the next Select OPTION to edit: enter &quot;XUCOMMAND&quot;. Then at NAME: XUCOMMAND// type &quot;^10&quot;. At Select ITEM: enter &quot;XMUSER&quot;. <td valign="top" width=25> Select OPTION to edit: XUCOMMAND         SYSTEM COMMAND OPTIONS NAME: XUCOMMAND// ^10  MENU Select ITEM: XQALERT// XMUSER       MailMan Menu Are you adding 'XMUSER' as a new MENU (the 8TH for this OPTION)? No// Y  (Yes) MENU SYNONYM: MM SYNONYM: MM// DISPLAY ORDER: Select ITEM: CREATOR: MANAGER,SYSTEM// ^ Select OPTION to edit:

<td valign="top" width=25>91. To change the default time it takes before users are automatically signed off the system from the default of 300 seconds. This, again, is to give you more time to work as you are learning. Back out to the VISTA Prompt. At the VISTA Prompt, Type &quot;D ^ZU&quot;.

<td valign="top" width=25>92. At ACCESS CODE, type in the code you chose when setting up MANAGER, SYSTEM as a NEW PERSON.

<td valign="top" width=25>93. At VERIFY CODE, hit ENTER. When asked for a new verify code, type the code you choose and remember it.

<td valign="top" width=25>94. At Select Systems Manager Menu Option: Type &quot;OPER&quot;, (short for operations management) and hit enter. You can see all of the choices available to you if you type &quot;??&quot;.

<td valign="top" width=25>95. At Select Operations Management Option: Type &quot;KER&quot; short for Kernel Management Menu and hit enter. At Select Kernel Management Menu Option: Type &quot;ENT&quot;, short for Enter/Edit Kernel Site Parameters. Hit enter.

<td valign="top" width=25>96. You will be presented with a similar screen as in editing the SYSTEM MANAGER characteristics. You can navigate the screen with the TAB key. For DEFAULT TIMED-READ (SECONDS): change it to 3600 to allow an hour before being automatically signed off, or whatever you choose. <td align="center" colspan="2">

Update the Devices, Start Taskman and Mail a Message These are basic devices to complete the setup. You can setup other devices, such as printers, later.

<td valign="top" width=25>98. Again from the VISTA promt, enter &quot;D ^ZTMCHK&quot; to check if TaskMan's environment is OK. This will present you with two screens with information on TaskMan's environment. <td align="center" colspan="2"> <td align="center" colspan="2" class="small">Screen #1

<td align="center" colspan="2"> <td align="center" colspan="2" class="small">Screen #2

<td valign="top" width=25>99. If TaskMan's environment is OK, you are ready to start TaskMan. Go back to the VISTA Prompt and type &quot;D ^ZTMB&quot; to start TASKMAN.

<td valign="top" width=25>100. To monitor TaskMan, enter &quot;D ^ZTMON&quot; from the VISTA Prompt. Enter &quot;^&quot; at the UPDATE// Prompt to exit the monitor or enter a &quot;?&quot; to see what the other options are. <td align="center" colspan="2">

<td valign="top" width=25>101. From the VISTA> programmer Prompt you can check the system status with &quot;D ^%SS&quot;. You should see at least two Taskman processes - %ZTM and %ZTMS. <td align="center" colspan="2">

<td valign="top" width=25>102. Now send a message using Postmaster to your DUZ number. Use D ^%CD to get into the namespace, VISTA, and then type &quot;S DUZ=.5 D ^XUP&quot;. You will get the response SETTING UP PROGRAMMER ENVIROMENT then TERMINAL TYPE SET TO: (your default) and Select OPTION NAME:. You will need to respond: &quot;XMUSER&quot;. At Select Mailman Menu Option: type &quot;S&quot; (for send). At Subject: enter your subject, such as Test, and then hit enter. You will then be prompted You may enter the text of the message and you will be offered the line number 1&gt; where you can type your message, such as the infamous Hello world. Next will be line 2&gt; and if you are done, just hit enter and at EDIT Option: you can do the same. At Send mail to: POSTMASTER// enter the initials you used for your DUZ which were probably SM for System Manager. You will then be told when MailMan was last used, which is probably NEVER. Hit enter at And Send to: and you should receive the message Select Message option: Transmit now// at which you hit enter and will hopefully receive the message Sending [1] Sent. Type &quot;^&quot; to exit. <td valign="top" width=25>103. Now see if you received it. Log on using &quot;D ^ZU&quot;. At the Systems Manager Prompt, type &quot;MAIL&quot;. Then at the Select MailMan Menu Option: type &quot;NEW&quot; Messages and Responses. Read the mail. <td align="center" colspan="2">

Test CPRS
Start and test the RPC Broker. The RPC Broker is VistA's Client/Server software and is needed by VistA's GUI client.

End of Chapter 1 ---&gt; Chapter 2</a>

Work of Nancy Anthracite being transfered from Hardhats.org by --gra'pa Z 12:54, 28 Aug 2005 (CDT)

Install CPRS
= Credits =

Thank you to everyone.