Introduction

Astronaut VistA is an installer for two Linux-based derivatives of the VistA EHR (Electronic Health Record), the largest EHR in the US (the Veterans Administration's health information system). They are CCHIT-approved for clinical usage and available with open source licenses. Both derivatives are available with an open-source database (GT.M, an open-source MUMPS database derivative).

  • WorldVistA -- a single community edition is available (with enterprise installation services available separately)

  • OpenVistA -- separate enterprise and community editions are available

The servers and clients are packaged separately (for both derivatives). While servers are Linux-based, the WorldVistA clients are Windows-based only. The OpenVistA clients are available for both Windows and Linux.

AstronautVistA provides an installer for the servers of both derivatives, and for configuration utilities and the client packages of WorldVistA as well.

Preparing your server

  • The Astronaut installer uses an emerging standardized installation framework for VistA derivatives (WorldVistA and OpenVistA currently). These instruction reflect this framework, with modifications I have used in setting up my system on Ubuntu.
  • A secure SSH tunnel (using port 22 by default) is used to connect VistA clients with the VistA server. The server should have a static IP address on the LAN, and the LAN (router) should forward port 22 traffic to the VistA server's IP address. (Make sure the client and server firewalls, if any, allow SSH traffic on port 22.) (Within the SSH tunnel, port 9260 traffic between the VistA server and clients will be tunneled. This is set up automatically during the Astronaut installation process.)

It is easiest to set this up before using the Astronaut installer, since the Astronaut installer autodetects IP address settings.

Install the VistA server

  • Apache2 is required. It can be installed individually

 sudo apt-get install apache2
  • or as part of a LAMP (Linux, Apache2, MySQL, PHP) installation:

 sudo tasksel install lamp-server
  • The OpenSSH server is required:

 sudo apt-get install openssh-server
  • Install prerequisites:

 sudo apt-get install xinetd whois apache2-suexec
  • Astronaut VistA is made for a 32-bit operating system. If you are using a 64-bit system, then also install ia32-libs:

 sudo apt-get ia32-libs
  • Add the AstronautVistA repositories:

 sudo echo "deb http://software.astronautvista.com/deb lucid main" >> /etc/apt/sources.list.d/lucid-partner.list
 sudo apt-get update
  • Install either the Astronaut WorldVistA server:

 sudo apt-get install astronaut-wv-server-beta
  • or the Astronaut OpenVistA server:

 sudo apt-get install astronaut-ov-server-beta

When the VistA client(s) and a VistA server are on the same computer, a self-contained EHR can be created on a single computer. (A VistA server can also be run within a virtual machine, allowing it to be completely run within Windows, as well.) See Ubuntu Doctors Guild: WorldVistA and Virtual Servers.

Installing from Medsphere repositories

  • OpenVistA can also be installed using the Medsphere repositories. (Use karmic or jaunty repositories instead of lucid if using one of those versions.)

 wget -q -O - <nowiki>http://mirrors.medsphere.org/pub/msc-repo-key@medsphere.com</nowiki> | sudo apt-key add -
 echo "deb <nowiki>http://mirrors.medsphere.org/pub/apt/ubuntu</nowiki> ''lucid'' main" | sudo tee /etc/apt/sources.list.d/openvistaehr.list
 sudo apt-get update
 sudo apt-get install openvista-utils

Server functions

The VistA server functions are generally configured from a text interface. The VistA server is very flexible and powerful, and therefore can seem complex to customize and daunting for new users.

Accessing the interface is possible in several ways:

  • While logged on the server (using any login ID) by starting VistA Commander from a command-line interface Terminal:

 /opt/openvista/EHR/bin/vista_com.sh
  • Logging in directly to the server using the provided Linux login (openvistaEHR or worldvistaEHR) and opening a (Konsole) Terminal. This loads the VistA Commander interface. (On Astronaut systems, the default initial password is vista!123.)

  • Using the Text Client and VistA Config menu items/shortcuts in the Astronaut Client menu (Windows systems only).

  • Using the built-in VistA Server Text Client menu items/shortcuts in the Ubuntu-Med system.

Then see

Obtain and install VistA clients

  • VistA clients to connect to the VistA server are available separately. See Ubuntu Doctors Guild for download, installation, and configuration instructions.

Installation Notes

  • The MUMPS database (GT.M) is installed into /opt/lsb-gtm/V5.3-004A_i686.
  • The WorldVistA EHR p[rogram is installed into /opt/worldvista/EHR.
  • m2web is installed into /opt/worldvista/EHR/web/m2web.
  • A startup file is installed as /etc/init.d/vista-EHR.
  • The listener port for clients like CPRS is 9260.
  • The listener port for m2web is 80.

The following default actions were done:

  • gtm Mumps interpreter installed in: /opt/lsb-gtm/gtm
  • Default user id created: worldvistaEHR in /home/worldvistaEHR
  • textEHR user id created.
  • VistA software installed in: /opt/worldvista/EHR
  • Started port listener on port: 9260
  • Open port: 9260

NEXT STEPS:

  • Log in as user worldvistaEHR with default password: vista!123
  • You will be prompted to immediately change the password. Use a strong password.
  • Full disk encryption of your Linux is strongly recommended.
  • Write down the IP address of this machine and port:

 IP address of this machine:
 "192.168.0.24"
 Instance name: EHR
 Port: 9260

(Obviously, use the IP address of your own server). These details will be needed for installing the Astronaut VistA client package.

Other resources

This article was originally adapted from the originals at

*Also see the Astronaut installation YouTube video and the Astronaut Client Server Manager YouTube video.

AstronautVistA (last edited 2014-04-26 18:51:30 by perspectoff)