|
|
| (33 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | OpenVistA 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 OpenVistA 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).
| + | [[Astronaut_VistA#Installation_Instructions|may exist]].'' |
| − | | |
| − | When the VistA server is run within a virtual machine on the same computer as the client modules, a fully self-contained OpenVistA EHR is created on a single computer.
| |
| − | | |
| − | * If you will run the OpenVistA server on a standalone computer, then install the [http://ubuntuguide.org/wiki/Ubuntu:All#Servers Ubuntu Server edition] as an operating system on that computer first. (You can [http://ubuntuguide.org/wiki/Ubuntu:All#Servers add an ubuntu-desktop or kubuntu-desktop] GUI to the server later, if you so desire).
| |
| − | | |
| − | * If you will run the OpenVistA server within a virtual machine, then install the Ubuntu Server edition (virtual machine minimal install) into a virtual machine first. See [[VirtualAstronaut|these instructions]].
| |
| − | | |
| − | Then proceed in a similar fashion (in each type of operating system installation) for the subsequent installation of Astronaut VistA.
| |
| − | | |
| − | ===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.
| |
| − | | |
| − | *Port 9260 is used for communications with the VistA server. The server should have a [http://ubuntuguide.org/wiki/Ubuntu:All#Set_a_static_IP_address static IP address] on your LAN, and your LAN should forward port 9260 traffic to the VistA server's IP address. Make sure your firewall allows port 9260 traffic.
| |
| − | | |
| − | It is easiest to set this up before using the Astronaut installer, since the Astronaut server installer autodetects IP address settings.
| |
| − | | |
| − | ===Installation===
| |
| − | Medsphere's [http://medsphere.org OpenVistA] uses one of the largest electronic health record platforms in the public domain. It is based on the US Veterans Administration health record system and is AGPL 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 [[VirtualAstronaut|virtual machine]] on a computer which also contains the [[#Connect_with_a_CPRS_client|clients]] (creating a self-contained EHR on a single computer). There are several installation packages. The original OpenVistA site is [http://medsphere.org/ here].
| |
| − | | |
| − | *Apache2 is required. It can be installed individually (sudo apt-get install apache2) or as part of a [http://ubuntuguide.org/wiki/Ubuntu:All#LAMP_server_installation LAMP] (Linux, Apache2, MySQL5, PHP) installation:
| |
| − | sudo tasksel install lamp-server
| |
| − | | |
| − | *The [http://ubuntuguide.org/wiki/Ubuntu:All#OpenSSH_server OpenSSH server] is required:
| |
| − | sudo tasksel install openssh-server
| |
| − | | |
| − | *If you are installing on a Server edition without a desktop, you will also need:
| |
| − | sudo apt-get install wget iptables nano
| |
| − | | |
| − | *A beta .deb package called Astronaut OpenVistA EHR (for clinics) is [http://sourceforge.net/projects/astronaut/files/ available here]. See [http://astronautvista.com/ the Astronaut website] for additional installation instructions.
| |
| − | :*Install prerequisites:
| |
| − | 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
| |
| − | :*Obtain and install Astronaut OpenVistA:
| |
| − | wget -O astronaut-ov-server-current.deb <nowiki>http://sourceforge.net/projects/astronaut/files/Astronaut%20OpenVistA%28tm%29%20Server/astronaut-ov-server-beta-0.9-3.deb/download</nowiki>
| |
| − | sudo dpkg -i astronaut-ov-server-current.deb
| |
| − | | |
| − | Note: It is recommended to install OpenVistA on a dedicated server. Apache and other server settings will be altered by the installation, which may alter your ability to run other servers on the same machine.
| |
| − | | |
| − | *Open incoming port 9260 in your [http://ubuntuguide.org/wiki/Ubuntu:All#Firewall firewall]. If behind a router, make sure this port is forwarded to the IP address of the computer acting as the OpenVistA server.
| |
| − | | |
| − | *Note: This installation installs the OpenVistA database and server in an Ubuntu Linux OS (that resides either on a standalone computer or in a [[VirtualAstronaut|virtual machine]]). The [[#Connect_with_a_CPRS_client|CPRS user client]] for VistA is written in Delphi for Windows (and works imperfectly in Wine). The CPRS client is therefore usually installed onto a Windows-based PCs (or onto USB flashdrives). These CPRS clients connect through the network to the OpenVistA server on a Ubuntu Linux-based server PC, or directly to the virtual machine.
| |
| − | | |
| − | *Also see the YouTube video.
| |
| − | <!--->
| |
| − | ===Installation Notes===
| |
| − | *The MUMPS database (GT.M) is installed into /opt/lsb-gtm/V5.3-004A_i686.
| |
| − | *The WorldVistA EHR program 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 where 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''
| |
| − | Port: 9260
| |
| − | | |
| − | (Obviously, use the IP address of your own server.)
| |
| − | <--->
| |
| − | | |
| − | === Installing on a Server edition ===
| |
| − | If you are installing on a Server edition without a desktop/package manager installed, you may need to install as root:
| |
| − | sudo -s
| |
| − | sudo dpkg -i astronaut-ov-server-current.deb
| |
| − | sudo apt-get -f install
| |
| − | | |
| − | 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 OpenVistA Server in a Virtual Machine ===
| |
| − | | |
| − | * Install the Ubuntu Server edition (virtual machine minimal install) into a virtual machine (like VirtualBox) and then install Astronaut OpenVistA on top of this. See [[VirtualAstronaut|these instructions]].
| |
| − | | |
| − | === Use a static IP address for the server ===
| |
| − | It will be difficult for the VistA clients to locate the OpenVistA 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 address 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 192.168.1.1, a static IP address range of 192.168.1.125 - 192.168.1.253, and the server is assigned an IP address of 192.168.1.135. Then the Ubuntu Server can be configured to use this static IP address.
| |
| − | | |
| − | *When the Ubuntu Server OS is running, edit the /etc/network/interfaces configuration file:
| |
| − | sudo nano /etc/network/interfaces
| |
| − | | |
| − | *Make sure the settings are similar to:
| |
| − | # The loopback network interface
| |
| − | auto lo
| |
| − | iface lo inet loopback
| |
| − | #
| |
| − | # The primary network interface
| |
| − | auto eth0
| |
| − | #iface eth0 inet dhcp
| |
| − | #
| |
| − | iface eth0 inet static
| |
| − | address 192.168.1.135
| |
| − | broadcast 192.168.1.255
| |
| − | netmask 255.255.255.0
| |
| − | gateway 192.168.1.1
| |
| − | | |
| − | *Reboot the Ubuntu OS again so that the new IP address is used.
| |
| − | sudo reboot
| |
| − | | |
| − | === Connect with a CPRS client ===
| |
| − | | |
| − | *See the [[Astronaut CPRS client package]] installation and configuration instructions.
| |
| − | | |
| − | === Using the VistA Configuration Utility ===
| |
| − | | |
| − | *See the [[VistA Configuration Utility]] usage instructions.
| |
| − | | |
| − | === 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.
| |
| − |
| |
| − | *See the [[VistA Clinical Scheduling Utility]] usage instructions.
| |
| − | <!--->
| |
| − | === Configure access to the OpenVistA server from the Internet through a virtual server ===
| |
| − | (This section is under construction.)
| |
| − | | |
| − | *Copy and edit a configuration file in the Apache2 sites-available folder.
| |
| − | cd /etc/apache2/sites-available
| |
| − | sudo cp default worldvista
| |
| − | sudo kate worldvista
| |
| − | | |
| − | *Edit the virtual host file so that it looks like:
| |
| − | <VirtualHost *:9260>
| |
| − | ServerAdmin webmaster@''worldvista.myoffice.org''
| |
| − | DocumentRoot /opt/worldvista/EHR
| |
| − | ServerName ''worldvista.myoffice.org''
| |
| − | ServerAlias www.''worldvista.myoffice.org'' ''worldvista.myoffice.org''
| |
| − | </VirtualHost>
| |
| − | | |
| − | where ''worldvista.myoffice.org'' is an example URL for your server (use your own, of course)
| |
| − | | |
| − | *Restart Apache2:
| |
| − | sudo /etc/init.d/apache2 restart
| |
| − | | |
| − | *Make sure your router forwards port 9260 to the (static) IP address (on your LAN) at which the computer hosting the VistA server resides.
| |
| − | <--->
| |
| − | <!--->
| |
| − | ==Other resources ==
| |
| − | *This page has been adapted from the original at [http://www.ubuntudoctorsguild.org/public/index.php/WorldVistA_tips Ubuntu Doctors Guild].
| |
| − | <--->
| |
