ubuntu-10.04_22VCMEWDVistAGTM.zip (a shortcut to download is at http://tinyurl.com/68l825e) contains a Toaster (virtual machine disk image) created at the 22nd VistA Community Meeting (http://worldvista.org/Conferences/22nd-vista-community-meeting) of WorldVistA EHR VOE/ 1.0 Release 6-08 with MGateway's EWD (build 836) on a 32-bit stack of FIS GT.M V5.4-001 on Ubuntu 10.04.1 LTS.
The Toaster is a raw image that you can boot with virtually any available virtualization. For example, kvm/QEMU (bundled with most Linux distributions; available with a GUI for Windows at http://www.davereyn.co.uk) can boot the raw disk image natively. If you use Virtual Box (http://virtualbox.org), you may need to convert the raw disk image to a VDI file using a non-GUI command such as VBoxManage convertraw.
If you boot the virtual machine in a NAT'd configuration (the default for kvm/QEMU), you will need to forward ports from the host to the following ports on the guest:
- 22 for ssh access
- 9297 for CPRS GUI access
- 80 for web access
For example, the following should work on Linux, forwarding port 2222 on the host to port 22 on the guest, port 8080 on the host to port 80 on the guest and port 9297 on the host to port 9297 on the guest:
kvm -m 512 -redir tcp:2222::22 -redir tcp:8080::80 -redir tcp:9297::9297 ubuntu-10.04_22VCMEWDVistAGTM.raw
The following shold work with QEMU on Windows from the command prompt, assuming QEMU and the disk image are in the same diretory:
kvm -kernel-kqemu -m 512 -L . -redir tcp:2222::22 -redir tcp:8080::80 -redir tcp:9297::9297 ubuntu-10.04_22VCMEWDVistAGTM.raw
Note that other flags may refine performance. For example, on my Ubuntu 10.10 host, I boot it with:
kvm -cpu host -m 512 -redir tcp:2222::22 -redir tcp:8080::80 -redir tcp:9297::9297 -drive file=ubuntu-10.04_22VCMEWDVistAGTM.raw,if=virtio,index=0,cache=none,aio=native
To connect to the virtual machine with ssh, use the userid gtmuser, password "GT.M Rocks!" (including the space and omtting the quotes). For example, I connect to it with the command:
ssh -p 2222 gtmuser@localhost
Once connected, you can run VistA without EWD with the command: WVEHRVOE10/V5.4-001_x86/run, e.g.:
gtmuser@gtmworkshop:~$ WVEHRVOE10/V5.4-001_x86/run
GTM>zwr ^LAB(69.9,"B",*)
^LAB(69.9,"B","VOE Office",1)=""
GTM>zwrite ^LAB(69.9,"B",*)
^LAB(69.9,"B","VOE Office",1)=""
GTM>zwrite ^%zewd("config",*)
%GTM-E-GVUNDEF, Global variable undefined: ^%zewd
You can run VistA with EWD (actually, EWD plus m_apache) with the command: WVEHRVOE10MGW/V5.4-001_x86/run, e.g.:
gtmuser@gtmworkshop:~$ WVEHRVOE10MGW/V5.4-001_x86/run
GTM>zwrite ^LAB(69.9,"B",*)
^LAB(69.9,"B","VOE Office",1)=""
GTM>zwrite ^%zewd("config",*)
^%zewd("config","security","validSubnet","10.0.2.2")=""
The latter has values in MGateway globals. The MGateway globals reside in a different database from the default (VistA) globals which are common to both environments. For example:
gtmuser@gtmworkshop:~$ WVEHRVOE10/V5.4-001_x86/run
GTM>set ^GTMVersion=$zversion
GTM>halt
gtmuser@gtmworkshop:~$ WVEHRVOE10MGW/V5.4-001_x86/run
GTM>write $GTMVersion
%GTM-E-INVSVN, Invalid special variable name
GTM>write ^GTMVersion
GT.M V5.4-001 Linux x86
GTM>kill ^GTMVersion
GTM>halt
gtmuser@gtmworkshop:~$ WVEHRVOE10/V5.4-001_x86/run
GTM>write ^GTMVersion
%GTM-E-GVUNDEF, Global variable undefined: ^GTMVersion
GTM>halt
gtmuser@gtmworkshop:~$
Assuming you have a Windows host, to connect to the guest with the CPRS GUI (you will need to use a compatible version), use a command such as: CPRSChartWVEHR-VOE1.0.exe wine CPRSChartWVEHR-VOE1.0.exe s=localhost p=9297 splash=off ccow=disable
(I have forgotten what the Access and Verify codes are, and I have forgotten how to set them - just search the archives of the Hardhats list at http://groups.google.com/group/hardhats with your favorite search engine.)
If you connect to port 80 on the guest, you will get the default Apache "It works!" message. In the example with ports forwarded as above http://localhost:8080 to connect to it. But if you connect to the EWD Management Portal (using the port forwarded as above, the URL from the host would be http://localhost:8080/ewd/ewdMgr/index.mgwsi), you will see an MGateway page.
Please post questions to the Hardhats list. Please note that WorldVistA EHR is packaged with a few small fixes for GT.M that I have written and submitted to WorldVistA, Medsphere and DSS. All the FOSS software in this Toaster is the result of decades of labor on the part of a cast of thousands. My only contribution has been to package all of it in one virtual machine. This packaging is my own personal effort.
PLEASE DO NOT USE THIS TOASTER IN PRODUCTION FOR REAL PATIENT DATA.
K.S. Bhaskar
bhaskar at bhaskars dot com
January 18, 2011
