Difference between revisions of "Astronaut Background"

From VistApedia
Jump to: navigation, search
(Moved from Astronaut Installers)
 
 
Line 1: Line 1:
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.  
+
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 VistA.
  
 
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.  
 
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.  
Line 9: Line 9:
 
----
 
----
 
----
 
----
[[Ignacio Valdes]] Date: Tue, 26 May 2009 01:16:00 -0500
+
[[Ignacio Valdes]] Astronaut VistA Installers Beta 0.9-5 (3rd Stage) (see respective distro licenses in /usr/share/vista_parts/doc/*vista)
  
Astronaut WorldVistA Installers for Linux Beta 0.6.3 (Zoltar) (see
+
6/19/2010
WorldVistA license below)
 
  
Description: Installs WorldVistA EHR/VOE 1.0 via rpm (Fedora/RedHat)
+
Notes: Finally out for your yum and apt-get beta testing pleasure. The plan is to come out of beta in about a month so do your best to find problems and let me know. The latest client installer 0.9.9.4 is up on sourceforge.net. Will have it up on launchpad.net sometime this week.
or dpkg (.deb file Ubuntu/Debian)
 
  
Downloads:  
+
The bad news: this release is incompatible with previous Astronauts due to directory layout long names and other changes.
* https://sourceforge.net/projects/worldvistaautoi/files
+
The good news: The directory layout is highly unlikely to change again.  
  
Changes: This release adds full support and bug fixes to support Kevin
+
Description: Installs Astronautized WorldVistA(tm) EHR/VOE 1.0 or OpenVistA(tm) SP4 via yum (Fedora/RedHat/CentOS) or apt-get (Ubuntu/Debian)
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
+
OBSOLETE: yum and apt-get are the preferred methods for server (but NOT client) installation. Server downloads at http://sourceforge.net/projects/astronaut/files/ are now OBSOLETE. Client installer .exe file is still obtained at: http://sourceforge.net/projects/astronaut/files/
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 [http://groups.google.com/groups/profile?hl=en&enc_user=AkEOmRIAAAAjdhBNd96ium9PDiiUTs9QII73Nnd8MGuFrQYThHx-nw]
+
Installation:  
  
Problems, comments, bugs: Post problems or issues to the Hardhats
+
Debian/Ubuntu systems using apt-get:
group:
 
* http://groups.google.com/group/Hardhats or to
 
* [http://groups.google.com/groups/profile?hl=en&enc_user=AkEOmRIAAAAjdhBNd96ium9PDiiUTs9QII73Nnd8MGuFrQYThHx-nw Ignaco Valdes]
 
  
License: Installer: Affero GNU GPL version 3. No warranties expressed
+
# sudo echo "deb http://174.143.201.52/deb  lucid main" >> /etc/apt/sources.list.d/lucid-partner.list
or implied, use at your own risk. (see WorldVistA license below)
+
# sudo apt-get update
  
These installers have been tested on Fedora 9 and Ubuntu 9.04
+
Then:
  
To install on rpm based systems, log in as root:
+
WorldVistA:
 +
# sudo apt-get install astronaut-wv-server-beta
 +
OpenVistA:
 +
# sudo apt-get install astronaut-ov-server-beta
  
* # rpm -i astronaut-wv-server-installer-XXX-0.X-X.i386.rpm
 
  
IT IS NORMAL TO SEE A BUNCH OF ERROR MESSAGES DURING COMPILATION.
+
Fedora/RedHat/CentOS using yum:
  
To uninstall:
+
As root,
 +
# cd /etc/yum.repos.d
 +
# vi astroapt.conf
  
* # rpm -e astronaut-wv-server-installer-XXXX-0.X-X
+
Add the following code:
 +
[base]
 +
name=Astronaut Yum Repository
 +
baseurl=http://174.143.201.52
 +
gpgcheck=0
  
(NOTE: the absence of .i386.rpm for uninstalling)
+
Save the file, then:
  
To install on .deb, dpkg apt-get based systems, log in as root:
+
WorldVistA:
 +
# yum install astronaut-wv-server-beta
 +
OpenVistA:
 +
# yum install astronaut-ov-server-beta
  
* # dpkg -i astronaut-wv-server-installer-XXXX_0.X-0.X.deb
+
Changes in 0.9-5: Many.
  
IT IS NORMAL TO SEE A BUNCH OF ERROR MESSAGES DURING COMPILATION.
+
Clients:
  
To uninstall:
+
. All client software updated to the latest.
 +
. Calculation capable templates in TMG-CPRS.
 +
. Vitals entry template enabled by default.
 +
. Multiple reliability and workflow issues in VistA-Config.
  
* # dpkg -r astronaut-wv-server-installer-XXXX_0.X-0.X.deb
+
Server:
  
You can change the default installation parameters: location, port,
+
. Much more modular, yum, apt-get repository based.
etc by creating a file called wv-rpm-defaults in /, (rpm apparently
+
. Semi-automatic and automatic upgradeability of all installed packages.
can only find it in /):
+
. Code bulk for all versions consolidated for bzr repository and packager friendliness.
<pre>
+
. Journaling and backup code has been 'gone through' completely.
gtm_path="/opt/lsb-gtm/V5.3-003_i686"
+
. Nightly 5am backup installs by default into /etc/cron.d/astronaut-vista-bak. Note: PAM authentication requires that you MUST login to the default <branding>vista<instance> linux id and change the default password or the nightly cron job will NOT work.
vista_instance="EHR"
+
. Full instance directory names like globals, routines versus g, r. 
vista_path="/opt/worldvista/$vista_instance"
+
. Added avinstanceadd.sh and instancedel.sh versus a forced instance add as before.
VISTAUSER="worldvista$vista_instance"
+
. Created restore.sh so that a rpm/deb can be reinstated easily if half removed.
VISTAGROUP="worldvista$vista_instance"
+
. All editions use scratch.dat now.
port=9260
+
. WorldVistA drug file bad pointers fixed.
vista_port_old_rpc=9210
 
vista_port_vistalink=8002
 
</pre>
 
  
Alter the above parameters as desired before running the rpm and it
+
Previously released in 0.9 series: Fixed startup scripts and installers that were starting Taskman as root which resulted in Taskman processes running as root. vistactl.sh and vistactlstart.sh will no longer allow starting as root. Performs vistactl.sh stop before un-installing. VistA Commander start/stop/status should work now. There is a server log file now that records server start and stop. More bar-coding with the astro_install_file recording the filename that it was installed with. Added student users to mumps.dat Fixed Victory Programming Environment loading and some VistA Commander problems, added vistactl.sh status to VistA Commander menu. Changed env file to reside in etc rather than bin as well as all the .sh's that where impacted by the change. Added vistatatus.sh a quick status check for Taskman and mumps processes. Changed the client communication id convention to client<port> and text<port> as well as other files to allow for a universal client installer and the same instance name as long as <branding>vista is different. For the Astronaut WorldVistA(tm) edition, changed MENU TEXT field of the OR CPRS GUI CHART entry in the OPTION file from 1.0.26.76 to 1.0.26.66 to allow a universal client installer. The Astronaut OpenVistA(tm) edition has been transformed to VistA Standard Base section I conformance. For security, all "real person name" users have been changed to role based names such as "Nurse, One" and all access codes except sys.admin has been randomized. KIDS patches to allow TMG-CPRS and VistA-Config to work have been applied as archived in the kids subdirectory.  
will override the above defaults.
 
  
Follow the next steps after the rpm install has run. This gets you to
+
Default ID's and passwords: System Linux id for an instance 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.
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:
+
Copyright (c) Astronaut, LLC 2010 http://astronautvista.com
  
# Conforms to VistA Standard Base 0.9 RC 7.
+
Author: Ignacio Valdes <ivaldes@hal-pc.org>
# Quick install.
 
# Automatically sets BOX:VOLUME pair!
 
# 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.
 
# Relatively smaller download size 155Mb complete package containing all files.
 
# Controller software such as vistactl.sh start | stop | restart, xinetd listener automatically configured and installed.
 
# Automatic vista startup with journaling on server start and graceful shutdown. Bhaskar's code.
 
# Automatically opens CPRS port.
 
# Has a backup solution (some assembly required).
 
# Latest WorldVistA and gtm V53003
 
# Installs /opt/worldvista/EHR
 
# Creates default vista id automatically.
 
# Management commands: copy_this_vista_to.sh and change_client_port.sh and uninstall_this_vista.sh
 
# 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.
 
# Checks for file wv-rpm-defaults and overrides default install parameters for different locations for the install.
 
# Port handling files correspond to worldvista name spaces.
 
#* M2WEB:
 
#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
 
# Pre-installs Kevin Toppenberg's debugger.
 
# Pre-installs EWD (currently broken).
 
# Pre-installs parts of Ovid (currently broken).
 
# Pre-installs Victory Programming Environment.
 
# MSC Fileman 1034 Had to be removed as it was causing a problem. Stay tuned!
 
# TMG-CPRS support with all associated bug fixes!
 
#* Caveats:
 
# Beta installer.
 
  
                WorldVistA EHR /VOE 1.0 Release 6-2008
+
Contributors of code, modules or other in Alphabetic order (Ommitted? Don't want to appear? Let me know.)
  
IMPORTANT FOR ALL PROVIDERS:
+
Individuals:
 +
Anthracite, Nancy -- Original install document, general knowledge.
 +
Bodtke, Peter -- Testing, documentation.
 +
Bhaskar, KS -- GT.M, Acculturation documentation, architecture, shell scripts.
 +
Dorsey, Jon -- VistA Standard Base co-proposer.
 +
Hagood, Eddie -- TMG-GUI-Config and fixes.
 +
Habiel, Sam -- BMX functionality, GUI-Scheduling.
 +
Landis, "Gus" -- VistA Standard Base co-proposer.
 +
Noorden, Lars -- Mupip man page.
 +
Meiling, Ben -- VistA Standard Base co-proposer.
 +
Papillion, Anthony -- VistA Standard Base co-proposer.
 +
Pardue, Andy -- OVID.
 +
Self, Jim -- m2web
 +
Tai, Jonathan -- GT.M knowledge, VistA Standard Base, rpm wizardry, similar installer.
 +
Timson, George -- Pointed out IHS fix for SSN problem.
 +
Toppenberg, Kevin -- TMG-CPRS, TMG-VistA-Config, TMGIDE, general knowledge.
 +
Trotter, Fred -- VistA Standard Base co-proposer.
 +
Trotter, Rick -- Assistance with Launchpad.
 +
Watson, Steve -- Testing, documentation, VistA Standard Base co-proposer.
 +
Whitby, Butch -- Testing, , VistA Standard Base co-proposer, Misc.
 +
Whitten, David -- Global expertise, debugging, architecture, IPv6 patch.
 +
Zimmer, John L -- Device console problem.
  
All drugs that the provider may need must be entered into the database
+
Corporations:
BEFORE THE PROVIDER PRESCIBES THEM from WorldVistA EHR.THE DRUG FILE
+
FIS -- GT.M
INCLUDED HAS NOT BEEN PREVIOUSLY RELEASED. IT IS ALWAYS IMPERATIVE THAT
+
Medsphere Systems Corp -- OVID, some merged installer code.  
ANY AND ALL DRUG ORDERS AND PRESCRIPTIONS BE CAREFULLY REVIEWED BY THE
+
M/Gateway Developments Ltd -- EWD
PRESCRIBING PHYSICIAN AND DISPENSING PHARMACIST TO INSURE ACCURACY.   IF
+
WorldVistA -- Processed FOIA VistA/VOE.
PROBLEMS ARE FOUND, PLEASE REPORT THEM HERE
 
  
        INFO "at" WORLDVISTA.ORG
+
Government:
                OR
+
Indian Health Service -- BMX, scheduling GUI.
* http://trac.opensourcevista.net/worldvistaehr
+
Veterans Affairs -- FOIA VistA.
  
Please see this link for information about entering new drugs and drug
+
Problems, comments, bugs: Post problems or issues to the Hardhats group: http://groups.google.com/group/Hardhats or to <ivaldes@hal-pc.org>
doseages:
 
  
* http://worldvista.org/World_VistA_EHR/license-and-readme/ReadMe%20-%20WorldVistA%20Pharmacy%20Drug%20File%202008-01-31.pdf/view
+
License: Installer: Affero GNU GPL version 3. No warranties expressed or implied, use at your own risk. (see WorldVistA license below)
  
Please look for additional information and updates about this release
+
Follow the next steps after the apt-get/yum install has run. This gets you to the point of being able to login as a text or CPRS client.  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 worldvistaEHR password is vista!123 which you will also have to re-set on first login to the Linux worldvistaEHR id.
here:
 
  
* http://worldvista.org/World_VistA_EHR/license-and-readme
+
Features:
 
 
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:
 
 
 
* http://worldvista.org/World_VistA_EHR/license-and-readme/WorldVistA%20EHR%20GPL%20License.txt/view
 
 
 
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:
 
 
 
* https://sourceforge.net/project/platformdownload.php?group_id=255113
 
 
 
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
 
 
 
* http://worldvista.org
 
 
 
The distribution point for WorldVistA EHR is Source Forge
 
* http://sourceforge.net/projects/worldvista-ehr
 
 
 
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
+
1) Conforms to VistA Standard Base 0.9 RC 10.
sourceforge.net
+
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 V53004A
 +
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 astro-defaults and overrides default install parameters for different locations for the install.
 +
16) Port handling files correspond to worldvista name spaces.
 +
17) Pre-installs m2web. Turn off and on SELinux between boots by:  echo 0 >/selinux/enforce or echo 1 >/selinux/enforce
 +
18) Refreshed: Pre-installs Kevin Toppenberg's debugger, see http://vistapedia.net for activation.
 +
19) Compatible with ewd-for-astronaut.
 +
20) Pre-installs OVID.
 +
21) Pre-installs Victory Programming Environment, see http://vistapedia.net for activation.
 +
22) MSC Fileman 1036.
 +
23) TMG-CPRS support with all associated bug fixes.
 +
24) TMG-GUI-Config now supports user management.
 +
25) BMX RPC broker and necessary parts pre-loaded.
 +
26) GUI-Scheduling components pre-loaded.
 +
27) Man page for mupip command.
  
Changes: After 5 months of intermittent not workings and me just not
+
Caveats:
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
+
1) Beta installer.

Latest revision as of 16:49, 24 June 2010

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 VistA.

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 Astronaut VistA Installers Beta 0.9-5 (3rd Stage) (see respective distro licenses in /usr/share/vista_parts/doc/*vista)

6/19/2010

Notes: Finally out for your yum and apt-get beta testing pleasure. The plan is to come out of beta in about a month so do your best to find problems and let me know. The latest client installer 0.9.9.4 is up on sourceforge.net. Will have it up on launchpad.net sometime this week.

The bad news: this release is incompatible with previous Astronauts due to directory layout long names and other changes. The good news: The directory layout is highly unlikely to change again.

Description: Installs Astronautized WorldVistA(tm) EHR/VOE 1.0 or OpenVistA(tm) SP4 via yum (Fedora/RedHat/CentOS) or apt-get (Ubuntu/Debian)

OBSOLETE: yum and apt-get are the preferred methods for server (but NOT client) installation. Server downloads at http://sourceforge.net/projects/astronaut/files/ are now OBSOLETE. Client installer .exe file is still obtained at: http://sourceforge.net/projects/astronaut/files/

Installation:

Debian/Ubuntu systems using apt-get:

  1. sudo echo "deb http://174.143.201.52/deb lucid main" >> /etc/apt/sources.list.d/lucid-partner.list
  2. sudo apt-get update

Then:

WorldVistA:

  1. sudo apt-get install astronaut-wv-server-beta

OpenVistA:

  1. sudo apt-get install astronaut-ov-server-beta


Fedora/RedHat/CentOS using yum:

As root,

  1. cd /etc/yum.repos.d
  2. vi astroapt.conf

Add the following code: [base] name=Astronaut Yum Repository baseurl=http://174.143.201.52 gpgcheck=0

Save the file, then:

WorldVistA:

  1. yum install astronaut-wv-server-beta

OpenVistA:

  1. yum install astronaut-ov-server-beta

Changes in 0.9-5: Many.

Clients:

. All client software updated to the latest. . Calculation capable templates in TMG-CPRS. . Vitals entry template enabled by default. . Multiple reliability and workflow issues in VistA-Config.

Server:

. Much more modular, yum, apt-get repository based. . Semi-automatic and automatic upgradeability of all installed packages. . Code bulk for all versions consolidated for bzr repository and packager friendliness. . Journaling and backup code has been 'gone through' completely. . Nightly 5am backup installs by default into /etc/cron.d/astronaut-vista-bak. Note: PAM authentication requires that you MUST login to the default <branding>vista<instance> linux id and change the default password or the nightly cron job will NOT work. . Full instance directory names like globals, routines versus g, r. . Added avinstanceadd.sh and instancedel.sh versus a forced instance add as before. . Created restore.sh so that a rpm/deb can be reinstated easily if half removed. . All editions use scratch.dat now. . WorldVistA drug file bad pointers fixed.

Previously released in 0.9 series: Fixed startup scripts and installers that were starting Taskman as root which resulted in Taskman processes running as root. vistactl.sh and vistactlstart.sh will no longer allow starting as root. Performs vistactl.sh stop before un-installing. VistA Commander start/stop/status should work now. There is a server log file now that records server start and stop. More bar-coding with the astro_install_file recording the filename that it was installed with. Added student users to mumps.dat Fixed Victory Programming Environment loading and some VistA Commander problems, added vistactl.sh status to VistA Commander menu. Changed env file to reside in etc rather than bin as well as all the .sh's that where impacted by the change. Added vistatatus.sh a quick status check for Taskman and mumps processes. Changed the client communication id convention to client<port> and text<port> as well as other files to allow for a universal client installer and the same instance name as long as <branding>vista is different. For the Astronaut WorldVistA(tm) edition, changed MENU TEXT field of the OR CPRS GUI CHART entry in the OPTION file from 1.0.26.76 to 1.0.26.66 to allow a universal client installer. The Astronaut OpenVistA(tm) edition has been transformed to VistA Standard Base section I conformance. For security, all "real person name" users have been changed to role based names such as "Nurse, One" and all access codes except sys.admin has been randomized. KIDS patches to allow TMG-CPRS and VistA-Config to work have been applied as archived in the kids subdirectory.

Default ID's and passwords: System Linux id for an instance 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.

Copyright (c) Astronaut, LLC 2010 http://astronautvista.com

Author: Ignacio Valdes <ivaldes@hal-pc.org>

Contributors of code, modules or other in Alphabetic order (Ommitted? Don't want to appear? Let me know.)

Individuals: Anthracite, Nancy -- Original install document, general knowledge. Bodtke, Peter -- Testing, documentation. Bhaskar, KS -- GT.M, Acculturation documentation, architecture, shell scripts. Dorsey, Jon -- VistA Standard Base co-proposer. Hagood, Eddie -- TMG-GUI-Config and fixes. Habiel, Sam -- BMX functionality, GUI-Scheduling. Landis, "Gus" -- VistA Standard Base co-proposer. Noorden, Lars -- Mupip man page. Meiling, Ben -- VistA Standard Base co-proposer. Papillion, Anthony -- VistA Standard Base co-proposer. Pardue, Andy -- OVID. Self, Jim -- m2web Tai, Jonathan -- GT.M knowledge, VistA Standard Base, rpm wizardry, similar installer. Timson, George -- Pointed out IHS fix for SSN problem. Toppenberg, Kevin -- TMG-CPRS, TMG-VistA-Config, TMGIDE, general knowledge. Trotter, Fred -- VistA Standard Base co-proposer. Trotter, Rick -- Assistance with Launchpad. Watson, Steve -- Testing, documentation, VistA Standard Base co-proposer. Whitby, Butch -- Testing, , VistA Standard Base co-proposer, Misc. Whitten, David -- Global expertise, debugging, architecture, IPv6 patch. Zimmer, John L -- Device console problem.

Corporations: FIS -- GT.M Medsphere Systems Corp -- OVID, some merged installer code. M/Gateway Developments Ltd -- EWD WorldVistA -- Processed FOIA VistA/VOE.

Government: Indian Health Service -- BMX, scheduling GUI. Veterans Affairs -- FOIA VistA.

Problems, comments, bugs: Post problems or issues to the Hardhats group: http://groups.google.com/group/Hardhats or to <ivaldes@hal-pc.org>

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

Follow the next steps after the apt-get/yum install has run. This gets you to the point of being able to login as a text or CPRS client. 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 worldvistaEHR password is vista!123 which you will also have to re-set on first login to the Linux worldvistaEHR id.

Features:

1) Conforms to VistA Standard Base 0.9 RC 10. 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 V53004A 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 astro-defaults and overrides default install parameters for different locations for the install. 16) Port handling files correspond to worldvista name spaces. 17) Pre-installs m2web. Turn off and on SELinux between boots by: echo 0 >/selinux/enforce or echo 1 >/selinux/enforce 18) Refreshed: Pre-installs Kevin Toppenberg's debugger, see http://vistapedia.net for activation. 19) Compatible with ewd-for-astronaut. 20) Pre-installs OVID. 21) Pre-installs Victory Programming Environment, see http://vistapedia.net for activation. 22) MSC Fileman 1036. 23) TMG-CPRS support with all associated bug fixes. 24) TMG-GUI-Config now supports user management. 25) BMX RPC broker and necessary parts pre-loaded. 26) GUI-Scheduling components pre-loaded. 27) Man page for mupip command.

Caveats:

1) Beta installer.