WorldVistA on Ubuntu

From Ubuntu Doctors Guild

Jump to: navigation, search

WorldVistA consists of two parts: a database server and a collection of client modules. The server runs in Linux, whereas the clients are generally Windows-based (at this time). The first step is to install the WorldVistA server. It can be installed on the operating system of a stand-alone computer or on the guest operating system of a virtual machine (usually running on the same computer as the client modules).

When the VistA server is run within a virtual machine on the same computer as the client modules, a fully self-contained WorldVistA EHR is created on a single computer.

Then proceed in a similar fashion (in each type of operating system installation) for the subsequent installation of Astronaut VistA.


Preparing your server

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


WorldVistA is the largest and most robust CCHIT-approved electronic health record platform in the public domain. It is is based on the US Veterans Administration health record system and is GPL licensed. The database and server can be installed on a standalone server (which would then be accessed over a network by clients on other computers) or can be installed in a virtual machine on a computer which also contains the clients (creating a self-contained EHR on a single computer). There are several installation packages. (The original WorldVistA site is here.)

sudo tasksel install lamp-server
sudo tasksel install openssh-server
sudo apt-get install wget iptables nano
sudo apt-get install xinetd update-inetd whois apache2-suexec
  • Astronaut VistA is made for a 32-bit operating system. If you are using a 64-bit Ubuntu operating system, then also install ia32-libs:
sudo apt-get ia32-libs
sudo echo "deb lucid main" >> /etc/apt/sources.list.d/lucid-partner.list
sudo apt-get update
then installing the Astronaut version of the OpenVistA server:
sudo apt-get install astronaut-wv-server-beta
Note: During the VistA server installation, you may wish to save (as a text file) the installation notes that are displayed for future reference.

Installation Notes

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:
Port: 9260

(Obviously, record the IP address of your own server.)

Installing on a Server edition

Note: The command "apt-get -f install" finds and installs unmet dependencies. This is only needed for Server editions in which a package manager is not installed.

Installing WorldVistA Server in a Virtual Machine

There are two methods for doing this.

Another example solution is demonstrated in this YouTube video.

Use a static IP address for the server

It will be difficult for the WorldVistA clients to locate the WorldVistA server if the IP address of the server is always changing (i.e. repeatedly assigned a new dynamic IP address by the router/network DHCP server). It is best, therefore, to assign a static IP adress to the server.

The network administrator must assign the static IP address on the LAN for use by the server (especially if a DNS nameserver is in use on the network). Let's say the LAN has a router/gateway address of, a static IP address range of -, and the server is assigned an IP address of Then the Ubuntu Server can be configured to use this static IP address.

sudo nano /etc/network/interfaces
# The loopback network interface
auto lo
iface lo inet loopback
# The primary network interface
auto eth0
#iface eth0 inet dhcp
iface eth0 inet static
sudo reboot

Server functions

Connect with a CPRS client

Using the VistA Configuration Utility

Using the VistA Clinical Scheduling utility

The Clinical Scheduler from the Indian Health System's RPMS system has been imported as one of the modules included with an Astronaut VistA installation.

Configure access to the VistA server from the Internet through a virtual server

Other resources

Personal tools
other pages
Google AdSense