samindcon/osehravista repository overview

OSEHRA VistA is a set of software components designed to support open source EHR solutions based upon the award-winning VistA EHR developed by the US Department of Veterans Affairs.

OSEHRA VistA is not intended as a complete EHR solution, but as a baseline of open source community code that will strengthen all VistA-based EHR implementations and accelerate community innovation.

OSEHRA VistA consists of FOIA VistA, with redacted code replaced to ensure functionality, plus added innovations and established, OSEHRA-certified software from the community.

The following is a COMPLETE list of all the changes made to FOIA VistA to create OSEHRA VistA:

• M-Unit (v 1.5)⁠
• Enhanced XML Tools⁠
• Enhancements to Kernel (for both GT.M/YDB and Cache)⁠
• VPE⁠
• PX*1.0*211⁠ (Alpha pre-release version for community testing)
• Enhanced XINDEX⁠
• Log4M⁠
• PSN*4.0*10001 (NDF Community Update)⁠
• Non-Kernel Routines Fixes⁠
• Undo VA redaction of XUSRB1; this requires a recompilation of CPRS with the correct unredacted hash (No other changes are made in CPRS)
• Manual edit of routine DPTLK7 on line PROMPT+16 to prevent it from calling the MPI

⁠How to Setup VistA Docker Container

docker run -p 9430:9430 -p 8001:8001 -p 2222:22 -d -P --name=osehravista osehra/osehravista

This will require several minutes before the system completes the setup. Type the following command to see if OSEHRA VistA container is running

docker ps

You should see the following response:

CONTAINER ID      IMAGE             COMMAND             CREATED            STATUS              PORTS                                                        NAMES
6f26dfab803f        osehra/osehravista   "/bin/sh -c /home/..."   6 minutes ago           Up 6 minutes         0.0.0.0:8001->8001/tcp, 0.0.0.0:9430->9430/tcp, 0.0.0.0:2222->22/tcp   osehravista

⁠Accessing VistA

The Docker container sets up the RPC broker, a TCPIP socket-based protocol, which is used for data exchange between VistA and clients such as CPRS, Vitals, and other GUIs. The container also sets up the SSH service to support the terminal-based Roll-and-Scroll UI. The container is accessable via the ip address=127.0.0.1 from the following ports:

• 9430 - RPC Broker
• 2222 - SSH

NOTE: CPRS uses the RPC Broker and the correct command line arguments are: S=127.0.0.1 P=9430

You can also access the container using SSH client such as PuTTY by using the address as described in the note above and using the correct port 2222 for container install.

⁠Docker Container User Accounts:

There are two operation systems user accounts that are created automatically during the installation process that make accessing the VistA Roll-and-Scroll UI easier. The use of the accounts becomes clear when you use the Roll-and-Scroll UI in the later section below:

NOTE: by default ${instance} is osehra. The GT.M system runs under the “osehra” system account.

VistA User Accounts:

Accessing VistA Using the CPRS, Vitals, and BCMA Demo Client Applications

Go to the clients page⁠

Stop OSEHRA VistA Container

Exit from the OSEHRA session, and then from the shell type docker stop osehravista

Restart OSEHRA VistA Container

To start up the OSEHRA VistA, from the shell type docker start osehravista

Delete OSEHRA VistA Container

To remove the osehravista container, run this: docker rm osehravista

⁠VistA Clients

To run the clients, you can either download them individually from https://code.osehra.org/files/clients/OSEHRA_VistA/⁠ or use the installer at https://code.osehra.org/files/clients/OSEHRA_VistA/Installer_For_All_Clients/OSEHRA_VISTA_GUI_Demo.msi⁠. Don't forget to change the target of the shortcut (or to create the shortcut) as described in: https://www.osehra.org/content/install-docker-clients⁠.