Difference between revisions of "OpenVistA-CIS client package"

Revision as of 18:41, 28 February 2010

The Medsphere OpenVista-CIS package is a modification of CPRS which has image viewing and other commercial ehancements added. (See this for a list of all Medsphere projects.)

It uses the .NET framework in Windows or the MONO framework in Linux. There are versions for both platforms. (Mac users may be able to adapt the Linux version.) OpenVistA-CIS was developed on the Gtk platform (a widely-used Linux development platform).

Installation on Windows

• Download and install the Gtk runtime environment for Windows

• Download and install the OpenVistA-CIS Windows installer

• If using Windows VistA or Windows 7, see this troubleshooting thread.

• If using an Astronaut OpenVistA server package, it is easiest to start OpenVistA-CIS using the Astronaut shortcut.

Installation on Linux

(These instructions are oriented towards Ubuntu/Kubuntu users). See this page for more information about dependencies.

• Install the Mono platform and other required dependencies in Ubuntu 9.10 (Karmic):

• mono-runtime
• libmono-corlib2.0-cil
• libgtk2.0-cil
• libglade2.0-cil
• libmono-cairo2.0-cil
• libmono-winforms2.0-cil
• libmono-system-runtime2.0-cil

You can install all of the dependencies at once using the following command:

sudo apt-get install mono-runtime libmono-corlib2.0-cil libgtk2.0-cil libglade2.0-cil libmono-cairo2.0-cil libmono-winforms2.0-cil libmono-system-runtime2.0-cil

• Create directories and download the binaries into them:

mkdir ~/openvistacisclient
cd ~/openvistacisclient
wget http://sourceforge.net/projects/openvista/files/OpenVista%20CIS/1.0%20RC2/openvistacis-0.9.96-client.zip/download
mkdir ~/openvistacisvitals
cd ~/openvistacisvitals
wget http://sourceforge.net/projects/openvista/files/OpenVista%20CIS/1.0%20RC2/openvistacis-0.9.96-vitals.zip/download

• Unzip the binaries into their respective folders:

cd ~/openvistacisclient
unzip openvistacis-0.9.96-client.zip
cd ~/openvistacisvitals
unzip openvistacis-0.9.96-vitals.zip

• Run (or create a shortcut to run) the OpenVistA-CIS client:

cd ~/openvistacisclient
mono OpenVistaCIS.exe

and the OpenVistA-CIS Vitals module:

cd ~/openvistacisvitals
mono OpenVistaVitals.exe

Note: If running from a menu item shortcut, make sure you set the directory as the workpath:

Menu Editor -> New item

-> General -> Name: OpenVistA-CIS Client -> Command: mono OpenVistaCIS.exe

-> Advanced -> Work path: ~/openvistacisclient

Connect OpenVistA-CIS to a server through an SSH tunnel

• A list of SSH commands is here.

ssh -l client9260 -L 9201:127.0.0.1:9260 remoteserver.computer.xyz -p 22

This command uses the client9260 SSH user (the default on the Astronaut OpenVistA server), the local 9201 port (default on OpenVistA-CIS clients), the remote 9260 port (the default on the Astronaut OpenVistA server), and the SSH 22 port (the default). Any of these can be changed, of course (depending on your configuration).

This method requires a password authentication (manually in the terminal).

• Start the OpenVistA-CIS Client:

OpenVistA-CIS Client -> Server: 127.0.0.1 -> Port: 9201

Automated password authentication script

(Under construction).

Installation on Mac

Connect OpenVistA-CIS Client to a server

• Use your Access Code / Verify Code (default at installation is sys.admin / vista!123 for Astronaut systems) as the LoginID / Password.

• If you happen to have installed the OpenVistA-CIS Client(s) on the same computer as an Astronaut OpenVistA server, and port 9260 is open (in the firewall) on that computer, you can generally connect directly:

OpenVistA-CIS Client -> Server: localhost -> Port: 9260

Connect to the Medsphere Demo server

• Test your setup by connecting to the Medsphere Demo server. Instructions are here.

• Connection Information

• Login ID: PU1234 -> Password: PU1234!!
• Server: openvista.medsphere.org
• Port: 9201 for the newer demo database
• Port: 9202 for the original demo database

Note: if you're not running the latest version of OpenVista-CIS, you must use --proxy-mode=builtin to connect. The demo server no longer runs the bridge.

• Other OpenVista user accounts include:

• MANAGER,SYSTEM: -> access/verify/e-sig: SM1234 / SM1234!! / SM1234
• USER, PHYSICIAN: -> access/verify/e-sig: PU1234 / PU1234!! / PU1234
• USER,NURSE: -> access/verify/e-sig: NU1234 / NU1234!! / NU1234