Difference between revisions of "CPRS Installation"

From VistApedia
Jump to: navigation, search
 
(107 intermediate revisions by 37 users not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
  
 +
This page [[record~|Record]]s the process of installation of the [[CPRSComputerized Patient Record System]] Graphical User Interface client program on the [[Microsoft Windows OS]].
  
=== CPRS Versions ===
+
=== [[CPRS~|CPRS]] Versions ===
  
This will list links for the various CPRS versions.
+
This table will list links for the various [[CPRS~|CPRS]] versions. (The most current version is at the top)
  
  version 1.0.18.2 ---> in the OR_30_125.ZIP   (dated about 12/01)*Nancy has it nanthracite at verizon dot net
+
{| class="grey" border="1" cellpadding="2"
  version 1.0.19.---> in the OR_30_132.ZIP    (dated about 5/02)*Nancy has it
+
      |+ [[CPRS~|CPRS]] Versions
  version 1.0.20.21 ---> in the OR_30_148.ZIP    (dated about 11/02)*Nancy has it
+
      |-
  version 1.0.22.16 ---> in the OR_30_206.ZIP   (dated about 1/04)*Nancy has it
+
      ! Version Number
  version 1.0.23.15 ---> in the OR_30_187.ZIP    (dated about 2/04)*Nancy and Sourceforge WorldVistA have this one
+
      ! Distribution File
  version 1.0.24.26 ---> in the OR_30_190.ZIP   (dated Aug 2, 2004
+
      ! Availability
  version 1.0.24.27 ---> in the OR_30_224.ZIP   (dated Sep 3, 2004)
+
      ! Date
   version 1.0.25.28 ---> in the OR_30_195.zip   (dated Feb 9, 2005)
+
      |-
  version 1.0.25.40 ---> in the OR_30_231.zip    (dated May 6, 2005)
+
   | version 1.0.27.90
  version 1.0.25.42 ---> in the OR_30_235.zip    (dated July 9,2005) Replace 1.0.25.40 with this for patient safety
+
  | OR-3_SEQ-273_PAT-296.ZIP
 +
   | http://foia-vista.osehra.org/Patches_By_Application/CPRS%20GUI%20FILES/CPRS%20VERSION%2027/OR-3_SEQ-273_PAT-296.ZIP Download folder on the OSEHRA site]
 +
   | 8/2009
 +
      |-
 +
| version 1.0.27.83
 +
| OR_30_304.ZIP
 +
|  [http://foia-vista.osehra.org/Patches_By_Application/CPRS%20GUI%20FILES/CPRS%20VERSION%2027/or_30_304.zip Download folder on OSEHRA site]
 +
| 11/2008 Emergency Correction of Patient Safety Issues
 +
      |-
 +
| version 1.0.27.77
 +
| OR_30_243.ZIP  
 +
| [http://opensourcevista.net:8888/NancysVistAServer/OR_30_243.ZIP or  Download folder OSEHRA site http://foia-vista.osehra.org/Patches_By_Application/CPRS%20GUI%20FILES/CPRS%20VERSION%2027/OR_30_243.ZIP]
 +
| 08/2008
 +
    |-
 +
|   version 1.0.26.69
 +
| OR_30_270.zip
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server] or
 +
[https://downloads.va.gov/files/FOIA/Software/VistA_FOIA_Historical_Files/VISTA_FOIA_RELEASES_BEFORE_2008/OR-Order%20Entry-Results%20Reporting/ Download folder on VA site]
 +
      |-
 +
| version 1.0.26.69
 +
| for WorldVistA EHR
 +
| on the Sourceforge WorldVistA EHR site and http://opensourcevista.net:8888/NancysVistAServer
 +
| (dated June 2007)
  
To use a particular version of CPRS, the server-side software code must match.  The files are found at ftp.va.gov/vista/Software/Packages/Order Entry-Results Reporting - OR/  and the source code is in the "Programs" subdirectory of this directory
+
      |-
 +
|  version 1.0.26.68
 +
| OR_30_258.zip
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
| Note Below (NB):(dated July 17, 2006)
 +
      |-
 +
|  version 1.0.25.42
 +
| OR_30_235.zip
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
| (dated July 09, 2005) <br>Note: Replace .25.40 with .25.42 for patient safety
 +
      |-
 +
|  version 1.0.25.40
 +
| OR_30_231.zip
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
| (dated May 06, 2005)
 +
      |-
 +
| version 1.0.25.28
 +
| OR_30_195.zip
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
| (dated Feb 09, 2005)
 +
      |-
 +
|  version 1.0.24.27
 +
| OR_30_224.ZIP 
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|  (dated Sep 03, 2004)
 +
      |-
 +
|  version 1.0.24.26
 +
| OR_30_190.ZIP 
 +
|  [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|  (dated Aug 02, 2004)
 +
      |-
 +
|  version 1.0.23.15
 +
| OR_30_187.ZIP
 +
| *Sourceforge WorldVistA and [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|  (dated about 02/04)
 +
      |-
 +
| version 1.0.22.16
 +
| OR_30_206.ZIP
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|    (dated about 01/04)
 +
      |-
 +
| version 1.0.20.21
 +
| OR_30_148.ZIP
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|  (dated about 11/02)
 +
      |-
 +
| version 1.0.20.21
 +
| OR_30_148.ZIP
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|(dated about 11/02)
 +
      |-
 +
|  version 1.0.19.7 
 +
| OR_30_132.ZIP
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
|  (dated about 05/02)
 +
      |-
 +
| version 1.0.18.2
 +
| OR_30_125.ZIP
 +
| [http://opensourcevista.net:8888/NancysVistAServer Nancy's VistA Server]
 +
| (dated about 12/01)
 +
      |}
 +
 
 +
----
 +
 
 +
=== version change trick ===
 +
NB: There is a trick to making version 1.0.26.68.  It is done for you in  CPRSDir.zip which can be found along with the instructions for creating it at:
 +
 
 +
http://downloads.opensourcevista.net/VADemo9-26-06
 +
 
 +
 
 +
To find out which version to use, look next to the option [[OPTION OR CPRS GUI CHART|named "OR CPRS GUI CHART"]] like this example where [[~|CPRS~|CPRS]] version 1.0.23.15 was needed:
 +
 
 +
D Q^DI
 +
 +
VA FileMan 22.0
 +
Select OPTION: 5  INQUIRE TO FILE ENTRIES
 +
 +
OUTPUT FROM WHAT FILE: DEVICE// OPTION
 +
1  OPTION                          (10126 entries)
 +
2  OPTION SCHEDULING                (116 entries)
 +
CHOOSE 1-2: 1  OPTION                    (10126 entries)
 +
Select OPTION NAME: OR CPRS GUI CHART      CPRSChart version 1.0.23.15
 +
ANOTHER ONE:
 +
 +
To use a particular version of [[CPRS~|CPRS]], the server-side software code must match.  The files are found at ftp.va.gov/vista/Software/Packages/Order Entry-Results Reporting - OR/  and the source code is in the "Programs" subdirectory of this directory                                                    
  
 
Thus:  
 
Thus:  
Line 26: Line 133:
 
[ftp://ftp.va.gov/vista/Software/Packages/Order%20Entry-Results%20Reporting%20-%20OR/Programs/ <nowiki>...Packages/Order Entry-Results Reporting - OR/Programs/ </nowiki>]
 
[ftp://ftp.va.gov/vista/Software/Packages/Order%20Entry-Results%20Reporting%20-%20OR/Programs/ <nowiki>...Packages/Order Entry-Results Reporting - OR/Programs/ </nowiki>]
  
Note: MS Explorer and Konqueror function just fine. But Mozilla & Firefox do not like the ftp://ftp.va.gov/ site; and give this error:
+
The wget(1) utility is capable of fetching the files from this server
The FTP server 215 MSDOS A N (FTPServer V4R2 by BisonWare International)
+
 
is currently unsupported.
+
AceFTP is a freeware FTP program that works, if needed
 +
http://software.visicommedia.com/en/productsfreeware/
 +
 
 +
''(In the past this FTP site could not be reached with Mozilla/Firefox. That has been corrected.)''
 +
----
  
The wget(1) utility '''is''' capable of fetching the files from this server.
+
=== 1.0.26.69 (and TMG-CPRS) spoof --> 1.0.26.76 ===
  
=== 'TEXT-BASED' CPRS ===
+
Since the changes between 1.0.26.69 and 1.0.26.76 are relatively minor, in this case, version  can be used by changing the option in the option file like this:
  
There is a text-based way of accessing notes etc from a console.  Here is an email that describes this more.
+
  D P^DI
  
 +
  VA FileMan 22.0
  
 +
  Select OPTION: 1  ENTER OR EDIT FILE ENTRIES
  
> Hello,
+
  INPUT TO WHAT FILE: OPTION//
>
+
  EDIT WHICH FIELD: ALL//
  
- Hide quoted text -
+
  Select OPTION NAME: OR [[CPRS~|CPRS]] GUI CHART      [[CPRS~|CPRS]]Chart version 1.0.26.76
> I have been trying to get CPRS to work on my 1 computer local installation
+
  NAME: OR CPRS GUI CHART//
> of VISTA. I was reading the archives, and Kevin T. said that one could try
+
  MENU TEXT: CPRSChart version 1.0.26.76  Replace 76 With 69
> starting a text-based CPRS to see if connections were working.
+
    Replace
>
+
    CPRSChart version 1.0.26.69
> I have scoured the VA documentation, and maybe I am missing something. Is
+
----
> there an index of the commands one uses to start components of VISTA? For
+
When using TMG-CPRS, another way of reaching the exact same result is to add ''' "SPOOF-VER=1.0.26.76" ''' to the end of the Windows shortcut to [[CPRS~|CPRS]] like so:
> example, in Cache terminal, I enter D Q^DI to start Fileman. So, how would I
 
> start the text-based CPRS? I found the documentation for it, (Clinician's
 
> Getting Started Guide-List Manager Version).
 
>
 
> Frankly, I'm stumped!
 
>
 
> Thanks for your patience,
 
>
 
  
In VistA, there is a huge menu system. These are called "OPTIONS".
+
... S=192.168.xxx.xxx P=92xx CCOW=DISABLE SPOOF-VER=1.0.26.76
When one logs into VistA in a standard fashion (i.e. do ^ZU or do
 
^XUS), then the user is taken directly to their default menu option.
 
Alternatively, you log in via the programmers entrancd (do ^XUP), then
 
you are allowed to choose whatever menu option starting point you
 
want.
 
  
There are over 9,000 menu options, arrange in various heirarchies.
+
(This method has the (admittedly dubious) advantage of allowing ''both'' a CPRS v1.0.26.68 ''and'' a v1.0.26.76 to connect without changing the server side.
When I was exploring this, I wrote a routine that scanned ALL the
 
options, and put them into an HTML page in their heirarchy. You can
 
look at this on my site:
 
http://kdtop.vistaoffice-ehr.com  On the left hand side, see a menu
 
entry for OPTIONS FOR XUP (this is a list of the menu options and
 
their descriptions, but not arrange in a heirarchy.), and also VISTA
 
MENUS. This will give you an idea of what is available.
 
  
You may find the menu EVE to be a good high-level menu starting point.
+
'''Caution:''' One needs to know that the two versions truly are compatible or be willing to risk nasty side-effects, perhaps even damage to the server's database.
But there are major modules that are not available even from this
+
----
one.
+
=== SSH Tunnel ===
 +
Communications between CPRS and the VistA server are not encrypted by default. Access/Verify Codes and all patient data are transmitted in the clear. However, these can be protected by setting up an encrypted "tunnel" between client and server.
  
Now, with that background, the menu option that you want is:
+
[[Setting up an SSH Tunnel between CPRS & VistA]]
OR OE/RR MENU CLINICIAN
+
----
 +
=== Automatic Windows Installer ===
  
I can do some of the things that CPRS does, but not all. My
+
The [http://sourceforge.net/projects/worldvistaautoi/files Astronaut] suite of automatic installers includes cprs, tmg-cprs and many other clients, available in point-click windows .exe installers. IP address and port number are entered by the user.  
understanding is that the text-based version came first. They they
+
----
were parallel for awhile.  Now all new development goes into the
+
=== Wine/Crossover compatability ===
windows GUI CPRS.
 
  
Hope that helps.
+
[[Wine/Crossover]]
Kevin
 

Latest revision as of 14:29, 9 July 2016

This page Records the process of installation of the CPRSComputerized Patient Record System Graphical User Interface client program on the Microsoft Windows OS.

CPRS Versions

This table will list links for the various CPRS versions. (The most current version is at the top)

CPRS Versions
Version Number Distribution File Availability Date
version 1.0.27.90 OR-3_SEQ-273_PAT-296.ZIP http://foia-vista.osehra.org/Patches_By_Application/CPRS%20GUI%20FILES/CPRS%20VERSION%2027/OR-3_SEQ-273_PAT-296.ZIP Download folder on the OSEHRA site] 8/2009
version 1.0.27.83 OR_30_304.ZIP Download folder on OSEHRA site 11/2008 Emergency Correction of Patient Safety Issues
version 1.0.27.77 OR_30_243.ZIP or Download folder OSEHRA site http://foia-vista.osehra.org/Patches_By_Application/CPRS%20GUI%20FILES/CPRS%20VERSION%2027/OR_30_243.ZIP 08/2008
version 1.0.26.69 OR_30_270.zip Nancy's VistA Server or

Download folder on VA site

version 1.0.26.69 for WorldVistA EHR on the Sourceforge WorldVistA EHR site and http://opensourcevista.net:8888/NancysVistAServer (dated June 2007)
version 1.0.26.68 OR_30_258.zip Nancy's VistA Server Note Below (NB):(dated July 17, 2006)
version 1.0.25.42 OR_30_235.zip Nancy's VistA Server (dated July 09, 2005)
Note: Replace .25.40 with .25.42 for patient safety
version 1.0.25.40 OR_30_231.zip Nancy's VistA Server (dated May 06, 2005)
version 1.0.25.28 OR_30_195.zip Nancy's VistA Server (dated Feb 09, 2005)
version 1.0.24.27 OR_30_224.ZIP Nancy's VistA Server (dated Sep 03, 2004)
version 1.0.24.26 OR_30_190.ZIP Nancy's VistA Server (dated Aug 02, 2004)
version 1.0.23.15 OR_30_187.ZIP *Sourceforge WorldVistA and Nancy's VistA Server (dated about 02/04)
version 1.0.22.16 OR_30_206.ZIP Nancy's VistA Server (dated about 01/04)
version 1.0.20.21 OR_30_148.ZIP Nancy's VistA Server (dated about 11/02)
version 1.0.20.21 OR_30_148.ZIP Nancy's VistA Server (dated about 11/02)
version 1.0.19.7 OR_30_132.ZIP Nancy's VistA Server (dated about 05/02)
version 1.0.18.2 OR_30_125.ZIP Nancy's VistA Server (dated about 12/01)

version change trick

NB: There is a trick to making version 1.0.26.68. It is done for you in CPRSDir.zip which can be found along with the instructions for creating it at:

http://downloads.opensourcevista.net/VADemo9-26-06


To find out which version to use, look next to the option named "OR CPRS GUI CHART" like this example where CPRS~|CPRS version 1.0.23.15 was needed:

D Q^DI

VA FileMan 22.0
Select OPTION: 5  INQUIRE TO FILE ENTRIES

OUTPUT FROM WHAT FILE: DEVICE// OPTION
1   OPTION                           (10126 entries)
2   OPTION SCHEDULING                (116 entries)
CHOOSE 1-2: 1  OPTION                     (10126 entries)
Select OPTION NAME: OR CPRS GUI CHART       CPRSChart version 1.0.23.15
ANOTHER ONE: 

To use a particular version of CPRS, the server-side software code must match. The files are found at ftp.va.gov/vista/Software/Packages/Order Entry-Results Reporting - OR/ and the source code is in the "Programs" subdirectory of this directory

Thus:

ftp://ftp.va.gov/vista/Software/Packages/Order Entry-Results Reporting - OR/

The Delphi source code for each of these (e.g. OR_30_235_SRC.ZIP) will be found in the subdirectory ...Packages/Order Entry-Results Reporting - OR/Programs/

The wget(1) utility is capable of fetching the files from this server

AceFTP is a freeware FTP program that works, if needed http://software.visicommedia.com/en/productsfreeware/

(In the past this FTP site could not be reached with Mozilla/Firefox. That has been corrected.)


1.0.26.69 (and TMG-CPRS) spoof --> 1.0.26.76

Since the changes between 1.0.26.69 and 1.0.26.76 are relatively minor, in this case, version can be used by changing the option in the option file like this:

 D P^DI
 VA FileMan 22.0
 Select OPTION: 1  ENTER OR EDIT FILE ENTRIES
 INPUT TO WHAT FILE: OPTION//
 EDIT WHICH FIELD: ALL//
 Select OPTION NAME: OR CPRS GUI CHART       CPRSChart version 1.0.26.76
 NAME: OR CPRS GUI CHART//
 MENU TEXT: CPRSChart version 1.0.26.76  Replace 76 With 69
   Replace
    CPRSChart version 1.0.26.69

When using TMG-CPRS, another way of reaching the exact same result is to add "SPOOF-VER=1.0.26.76" to the end of the Windows shortcut to CPRS like so:

... S=192.168.xxx.xxx P=92xx CCOW=DISABLE SPOOF-VER=1.0.26.76

(This method has the (admittedly dubious) advantage of allowing both a CPRS v1.0.26.68 and a v1.0.26.76 to connect without changing the server side.

Caution: One needs to know that the two versions truly are compatible or be willing to risk nasty side-effects, perhaps even damage to the server's database.


SSH Tunnel

Communications between CPRS and the VistA server are not encrypted by default. Access/Verify Codes and all patient data are transmitted in the clear. However, these can be protected by setting up an encrypted "tunnel" between client and server.

Setting up an SSH Tunnel between CPRS & VistA


Automatic Windows Installer

The Astronaut suite of automatic installers includes cprs, tmg-cprs and many other clients, available in point-click windows .exe installers. IP address and port number are entered by the user.


Wine/Crossover compatability

Wine/Crossover