Astronaut Background

From VistApedia
Revision as of 20:37, 24 November 2009 by Ssw0213 (talk | contribs) (Moved from Astronaut Installers)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The Astronaut installers are the most advanced, easy and comprehensive way of installing WorldVistA and OpenVistA(tm). Begun in January of 2009, active development continues on them. They have obsoleted many other ways of installing WorldVistA.

This method produces a stable VistA server on a Linux machine, and provides copies of the CPRS front-end client to be run from a Windows desktop. Users may configure VistA and enter patient data, and unlike virtual appliances, their efforts will persist if the machine is turned off or rebooted. Thus a doctor or IT person can try out VistA in a few minutes' time, then come back hours or days later for more hands-on learning.

A truly production grade system would need attention to replication, backups, and upgradeability; issues that are still in development on these packages.

The following excerpt comes from a thread on Hardhats[1]. Download links lead to the Astronaut Installer, updated to Beta 0.7.6 (16 October 2009). Astronaut README-FIRST.txt



Ignacio Valdes Date: Tue, 26 May 2009 01:16:00 -0500

Astronaut WorldVistA Installers for Linux Beta 0.6.3 (Zoltar) (see WorldVistA license below)

Description: Installs WorldVistA EHR/VOE 1.0 via rpm (Fedora/RedHat) or dpkg (.deb file Ubuntu/Debian)

Downloads:

Changes: This release adds full support and bug fixes to support Kevin Toppenberg's superlative TMG-CPRS! Patient registration is finally solved! This also cleans up the design to work side by side with other VSB compliant VistA's like Astronaut Nostromo (installs OpenVistA(tm)). OVID now works, m2web should work by starting or re-starting httpd. m2web does NOT work with SELinux currently and is installed but not working with .deb see below for the last few steps to get m2web to work. EWD is partially installed, but broken.

Default ID's and passwords: System Linux id for an instance now follow the VistA Standard Base spec of <branding>vista<instance> to avoid conflict and allow multiple instances to run side by side. For example worldvistaEHR is the default Linux id for rpm install with password vista!123. The default VistA id is sys.admin vista!123.

Author: Ignacio Valdes [2]

Problems, comments, bugs: Post problems or issues to the Hardhats group:

License: Installer: Affero GNU GPL version 3. No warranties expressed or implied, use at your own risk. (see WorldVistA license below)

These installers have been tested on Fedora 9 and Ubuntu 9.04

To install on rpm based systems, log in as root:

  • # rpm -i astronaut-wv-server-installer-XXX-0.X-X.i386.rpm

IT IS NORMAL TO SEE A BUNCH OF ERROR MESSAGES DURING COMPILATION.

To uninstall:

  • # rpm -e astronaut-wv-server-installer-XXXX-0.X-X

(NOTE: the absence of .i386.rpm for uninstalling)

To install on .deb, dpkg apt-get based systems, log in as root:

  • # dpkg -i astronaut-wv-server-installer-XXXX_0.X-0.X.deb

IT IS NORMAL TO SEE A BUNCH OF ERROR MESSAGES DURING COMPILATION.

To uninstall:

  • # dpkg -r astronaut-wv-server-installer-XXXX_0.X-0.X.deb

You can change the default installation parameters: location, port, etc by creating a file called wv-rpm-defaults in /, (rpm apparently can only find it in /):

gtm_path="/opt/lsb-gtm/V5.3-003_i686"
vista_instance="EHR"
vista_path="/opt/worldvista/$vista_instance"
VISTAUSER="worldvista$vista_instance"
VISTAGROUP="worldvista$vista_instance"
port=9260
vista_port_old_rpc=9210
vista_port_vistalink=8002

Alter the above parameters as desired before running the rpm and it will override the above defaults.

Follow the next steps after the rpm install has run. This gets you to the point of being able to login as a text or CPRS client. BOX:VOLUME PAIR GETS AUTOMATICALLY SET! The pre-set Access Code is: sys.admin with Verify Code: vista!123. You will have to re-set the verify code upon first login. Download the Windows client installers which should all work out of the box with this server. The pre-set Linux id is vista.world password is vista!123 which you will also have to re-set on first login to the Linux vista.world id. To start m2web simply start or restart apache then go to step 10 here: http://vista.vmth.ucdavis.edu/notebook/index/48.html

Features:

  1. Conforms to VistA Standard Base 0.9 RC 7.
  2. Quick install.
  3. Automatically sets BOX:VOLUME pair!
  4. Creates a text<instance> id, automatically edits, compiles and installs Bhaskar's runzu so that text<instance> runs with no shell and no home directory.
  5. Relatively smaller download size 155Mb complete package containing all files.
  6. Controller software such as vistactl.sh start | stop | restart, xinetd listener automatically configured and installed.
  7. Automatic vista startup with journaling on server start and graceful shutdown. Bhaskar's code.
  8. Automatically opens CPRS port.
  9. Has a backup solution (some assembly required).
  10. Latest WorldVistA and gtm V53003
  11. Installs /opt/worldvista/EHR
  12. Creates default vista id automatically.
  13. Management commands: copy_this_vista_to.sh and change_client_port.sh and uninstall_this_vista.sh
  14. Requires two-factor deletion to really delete an instance. rpm -e only removes symlinks to log files, text-client id and auto-start routines. Requires explicit rm -Rf to really delete it all. rpm -i --force will NOT over-write an existing instance.
  15. Checks for file wv-rpm-defaults and overrides default install parameters for different locations for the install.
  16. Port handling files correspond to worldvista name spaces.
    • M2WEB:
  17. Pre-installs m2web. Start or restart apache then go to step 10 here: http://vista.vmth.ucdavis.edu/notebook/index/48.html Turn off and on SELinux between boots by: echo 0 >/selinux/enforce or echo 1 >/selinux/enforce
  18. Pre-installs Kevin Toppenberg's debugger.
  19. Pre-installs EWD (currently broken).
  20. Pre-installs parts of Ovid (currently broken).
  21. Pre-installs Victory Programming Environment.
  22. MSC Fileman 1034 Had to be removed as it was causing a problem. Stay tuned!
  23. TMG-CPRS support with all associated bug fixes!
    • Caveats:
  24. Beta installer.
               WorldVistA EHR /VOE 1.0 Release 6-2008

IMPORTANT FOR ALL PROVIDERS:

All drugs that the provider may need must be entered into the database BEFORE THE PROVIDER PRESCIBES THEM from WorldVistA EHR.THE DRUG FILE INCLUDED HAS NOT BEEN PREVIOUSLY RELEASED. IT IS ALWAYS IMPERATIVE THAT ANY AND ALL DRUG ORDERS AND PRESCRIPTIONS BE CAREFULLY REVIEWED BY THE PRESCRIBING PHYSICIAN AND DISPENSING PHARMACIST TO INSURE ACCURACY. IF PROBLEMS ARE FOUND, PLEASE REPORT THEM HERE

       INFO "at" WORLDVISTA.ORG
               OR

Please see this link for information about entering new drugs and drug doseages:

Please look for additional information and updates about this release here:

All portions of this release that are modified from the original Freedom of Information Act release provided by the Department of Veterans Affairs carry the GPL license and are Copyright WorldVistA. See this URL for the full text of the license:

YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING THIS PRODUCT. DOWNLOADING OR USING ANY PART OF THE SOFTWARE AND DOCUMENTATION INDICATES THAT YOU ACCEPT THESE TERMS AND CONDITIONS. IF YOU DO NOT AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT, DO NOT PROCEED.

A. General Disclaimer. THE WORLDVISTA-EHR (WV-EHR) SOFTWARE IS PROVIDED TO RECIPIENT HEREUNDER "AS IS" AND ANY USE OF WV-EHR SOFTWARE BY REQUESTOR SHALL BE AT ITS OWN RISK. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, WORLDVISTA AND ITS CONTRACTORS, EMPLOYEES AND AGENTS DISCLAIM ALL WARRANTIES WITH RESPECT TO WV-EHR SOFTWARE, EXPRESS, IMPLIED AND STATUTORY, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, ACCURACY, COMPLETENESS, TIMELINESS, NON INFRINGEMENT OF THIRD-PARTY RIGHTS, NON INTERFERENCE, AND ERROR FREE SERVICE. WORLDVISTA TAKES NO RESPONSIBILITY

FOR MONITORING OR REGULATING THE USE OR ACCURACY OF WV-EHR SOFTWARE. RECIPIENT ACKNOWLEDGES AND AGREES THAT WORLDVISTA IS UNDER NO OBLIGATION TO VERIFY THE ACCURACY OF OR OTHERWISE UPDATE WV-EHR SOFTWARE OR ANY CONTENT CONTAINED THEREIN OR TO NOTIFY RECIPIENT OF ANY INACCURACIES THEREIN OR UPDATES THERETO THAT MAY COME TO THE ATTENTION OF OR BE DEVELOPED BY WORLDVISTA. WV-EHR MAY BE UPDATED PERIODICALLY, AND IT IS THE RESPONSIBILITY OF THE RECIPIENT TO OBTAIN UPDATED VERSIONS OF THE WV-EHR RELEASE AS REQUIRED. WORLDVISTA BEARS NO RESPONSIBILITY FOR PROVIDING UPDATES TO RECIPIENTS. PASSWORD IS asdTYU

B. LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, NEITHER WORLDVISTA NOR ANY OF ITS EMPLOYEES, AGENTS OR CONTRACTORS SHALL BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES, INCLUDING WITHOUT LIMITATION DAMAGES FOR LOST PROFITS OR REVENUES, GOODWILL, WORK STOPPAGE, SECURITY BREACHES, VIRUSES, COMPUTER FAILURE OR MALFUNCTION, USE, DATA OR OTHER INTANGIBLE LOSSES OR COMMERCIAL DAMAGES, EVEN IF ANY OF SUCH PARTIES IS ADVISED OF THE POSSIBILITY OF SUCH LOSSES, ARISING UNDER OR IN CONNECTION WITH THIS AGREEMENT, COMPLIANCE EFFECTIVENESS STUDY TOOLS, THE USE OF OR INABILITY TO USE THE SAME, OR ANY OTHER SUBJECT MATTER HEREOF. IN ADDITION, TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, NEITHER WORLDVISTA NOR ANY OF ITS EMPLOYEES, AGENTS OR CONTRACTORS SHALL BE LIABLE FOR ANY LOSS OR DAMAGE SUFFERED BY RECIPIENT WHICH ARISES OUT OF OR IN CONNECTION WITH ANY INFORMATION OBTAINED BY RECIPIENT VIA OR IN CONNECTION WITH WV-EHR SOFTWARE.


I, Valdes Date: Tue, 26 May 2009 07:18:19 -0700 (PDT) Forgot to add that I have packaged Kevin's TMG-CPRS into an easy to install point-click installer:

To download the TMG-CPRS client installer, it is the one in the big green button called astronaut-tmg-cprs-client-alpha-0.1.exe

Let me know if the dimensions of the Select Patient dialog box are funny where some of the buttons are off screen or not.

Congratulations to the T's: Kevin T and George T, this one is for you!

The windows-vm appliance I hope to have up by today as well.

-- IV


steve wang Date: Tue, 26 May 2009 06:57:38 -0800

Hi All:

What is the official website for WorldVistA EHR/VOE 1.0. It doesn't seem like this is on the worldvista website. Where can I find more documentation on this new version? Also, how can I find out about new releases of EHR/VOE when they come out?

Thanks

Steve


Nancy Anthracite Date: Tue, 26 May 2009 11:07:12 -0400

New releases of WorldVistA EHR will be announced on Hardhats.


K.S. Bhaskar Date: Tue, 26 May 2009 08:31:29 -0700 (PDT)

Steve --

The official web site for WorldVistA EHR is the WorldVistA web site

The distribution point for WorldVistA EHR is Source Forge

and the WorldVistA web site points you to the Source Forge site.

Built on the release of WorldVistA EHR from Source Forge are distributions of repackaged software, sometimes with enhancements. Ignacio's Astronaut packages are an example. By way of analogy, the WorldVistA EHR distributions are like Linux kernels from http://kernel.org whereas the redistributions are like GNU/Linux distributions from Debian, Red Hat, Ubuntu, etc.

New releases of WorldVistA EHR will appear on Source Forge, and will be announced on hardhats, as well as elsewhere.

Regards -- Bhaskar

K.S. Bhaskar President, WorldVistA


I, Valdes Date: Tue, 26 May 2009 19:36:05 -0700 (PDT)

Kevin,

I've used TMG-CPRS all day today and I must say that the integrated patient registration works phenomenally well. Especially when you are under pressure and have lots of distractions. Not having to bring up the text based interface or switch back and forth between them is a dramatic improvement as well as the ability to edit spelling mistakes quickly and easily.

Question: what are you using to render html in notes?

-- IV



I, Valdes Date: Wed, 17 Jun 2009 14:46:07 -0700 (PDT)

FYI, I just released Astronaut WorldVistA Beta 0.6.4 on rpm and deb on sourceforge.net

Changes: After 5 months of intermittent not workings and me just not getting it, iptables (server firewall) rule addition and removal on uninstall for the client port now should work correctly and reliably. The very useful but hard to find or access gtm_acculturation document is now installed in the doc directory by default. There is also few dependency checking tweaks in anticipation of the VistA Community Meeting demo this Friday in Bethesda.

-- IV