Difference between revisions of "Astronaut README-FIRST.txt"

From VistApedia
Jump to: navigation, search
 
(→‎Astronaut WorldVistA)
Line 1: Line 1:
 
== Astronaut WorldVistA ==
 
== Astronaut WorldVistA ==
 
   
 
   
−
Installers for Linux Beta 0.7 (Falling with Style!) (see WorldVistA license below)
+
<pre>
−
+
Astronaut VistA Installers Beta 0.9-5 (3rd Stage) (see respective distro licenses in /usr/share/vista_parts/doc/*vista)
−
Description: Installs WorldVistA EHR/VOE 1.0 via rpm (Fedora/RedHat) or dpkg (.deb file Ubuntu/Debian)
 
−
 
−
Downloads: http://sourceforge.net/projects/worldvistaautoi/files/
 
−
 
−
Changes: Mostly minor changes and fixes to ensure that multiple instances work using a simple bash-style default override file and the --force option. This release anticipates ewd-for-astronaut to work soon. gpg signing is now present in rpm, deb to follow.
 
  
−
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.
+
6/19/2010
−
+
 
−
Author: Ignacio Valdes <ivaldes@hal-pc.org>
+
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
−
+
 
−
Contributors of code, modules or other in Alphabetic order (Ommitted? Don't want to appear? Let me know.)
+
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
−
+
 
−
Individuals:
+
launchpad.net sometime this week.  
−
Anthracite, Nancy -- Original install document, general knowledge.
+
 
−
  Bodtke, Peter -- Testing, documentation.
+
The bad news: this release is incompatible with previous Astronauts due to directory layout long names and other changes.
−
Bhaskar, KS -- GT.M, Acculturation documentation, architecture, shell scripts.
+
The good news: The directory layout is highly unlikely to change again.  
−
Dorsey, Jon -- VistA Standard Base co-proposer.
+
 
−
Hagood, Eddie -- TMG-GUI-Config and fixes.
+
Description: Installs Astronautized WorldVistA(tm) EHR/VOE 1.0 or OpenVistA(tm) SP4 via yum (Fedora/RedHat/CentOS) or apt-get
−
Habiel, Sam -- BMX functionality, GUI-Scheduling.
+
 
−
Landis, "Gus" -- VistA Standard Base co-proposer.
+
(Ubuntu/Debian)
−
Noorden, Lars -- Mupip man page.
+
 
−
Meiling, Ben -- VistA Standard Base co-proposer.
+
OBSOLETE: yum and apt-get are the preferred methods for server (but NOT client) installation. Server downloads at
−
Papillion, Anthony -- VistA Standard Base co-proposer.
+
 
−
Pardue, Andy -- OVID.
+
http://sourceforge.net/projects/astronaut/files/ are now OBSOLETE. Client installer .exe file is still obtained at:
−
Self, Jim -- m2web
+
 
−
Tai, Jonathan -- GT.M knowledge, VistA Standard Base, rpm wizardry.
+
http://sourceforge.net/projects/astronaut/files/
−
Timson, George -- Pointed out IHS fix for SSN problem.
+
 
−
Toppenberg, Kevin -- TMG-CPRS, TMG-GUI-Config, TMGIDE, general knowledge.
+
Installation:  
−
Trotter, Fred -- VistA Standard Base co-proposer.
+
 
−
Trotter, Rick -- Assistance with Launchpad.
+
Debian/Ubuntu systems using apt-get:
−
Watson, Steve -- Testing, documentation, VistA Standard Base co-proposer.
+
 
−
Whitby, Butch -- Testing, , VistA Standard Base co-proposer, Misc.
+
# sudo echo "deb http://software.astronautvista.com/deb lucid main" >> /etc/apt/sources.list.d/lucid-partner.list
−
Whitten, David -- Global expertise, debugging, architecture, IPv6 patch.  
+
# sudo apt-get update
−
+
 
−
Corporations:
+
Then:
−
Fidelity Information Services -- GT.M
+
 
−
Medsphere Systems Corp -- OVID, Other.
+
WorldVistA:
−
M/Gateway Developments Ltd -- EWD
+
# sudo apt-get install astronaut-wv-server-beta
−
WorldVistA -- Processed FOIA VistA/VOE.
+
OpenVistA:
−
+
# sudo apt-get install astronaut-ov-server-beta
−
Government:
+
 
−
Indian Health Service -- BMX, scheduling GUI.
+
 
−
Veterans Affairs -- FOIA VistA.
+
Fedora/RedHat/CentOS using yum:
−
+
 
−
Problems, comments, bugs: Post problems or issues to the Hardhats group: http://groups.google.com/group/Hardhats or to <ivaldes@hal-pc.org>
+
As root,  
−
+
# cd /etc/yum.repos.d
−
License: Installer: Affero GNU GPL version 3. No warranties expressed or implied, use at your own risk. (see WorldVistA license below)
+
# vi astro.repo
−
+
 
−
This installer has been tested on Fedora 10 and Ubuntu 9.
+
Add the following code:
−
+
[base]
−
To install on rpm based systems, log in as root:
+
name=Astronaut Yum Repository
−
+
baseurl=http://software.astronautvista.com/rpm
−
# yum install -y --nogpg astronaut-<version info>.rpm
+
gpgcheck=0
−
+
 
−
Will install all depencencies and then the rpm or somewhat independently:
+
Save the file, then:
 +
 
 +
WorldVistA:
 +
# yum install astronaut-wv-server-beta
 +
OpenVistA:
 +
# 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
  
−
# rpm -i astronaut-wv-server-installer-XXX-0.X-X.i386.rpm
+
start and stop. More bar-coding with the astro_install_file recording the filename that it was installed with. Added student users
  
−
IT IS NORMAL TO SEE A BUNCH OF ERROR MESSAGES DURING COMPILATION.
+
to mumps.dat Fixed Victory Programming Environment loading and some VistA Commander problems, added vistactl.sh status to VistA
  
−
To uninstall:
+
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.
  
−
# rpm -e astronaut-wv-server-installer-XXXX-0.X-X
+
Added vistatatus.sh a quick status check for Taskman and mumps processes. Changed the client communication id convention to
  
−
(NOTE: the absence of .i386.rpm for uninstalling)
+
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
  
−
To install on .deb, dpkg apt-get based systems, use sudo or sudo su to log in as root:
+
<branding>vista is different. For the Astronaut WorldVistA(tm) edition, changed MENU TEXT field of the OR CPRS GUI CHART entry in  
  
−
# dpkg -i astronaut-wv-server-installer-XXXX_0.X-0.X.deb
+
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
  
−
IT IS NORMAL TO SEE A BUNCH OF ERROR MESSAGES DURING COMPILATION.
+
transformed to VistA Standard Base section I conformance. For security, all "real person name" users have been changed to role
  
−
To uninstall:
+
based names such as "Nurse, One" and all access codes except sys.admin has been randomized. KIDS patches to allow TMG-CPRS and
  
−
# dpkg -r astronaut-wv-server-installer-XXXX_0.X-0.X.deb
+
VistA-Config to work have been applied as archived in the kids subdirectory.  
  
−
You can over-ride the default installation parameters: location, port, etc by creating a file called astro-defaults in /, (rpm apparently can only find it in /). You should probably only try to change the default vista_instance but all changeable defaults are:
+
Default ID's and passwords: System Linux id for an instance follow the VistA Standard Base spec of <branding>vista<instance> to  
  
−
gtm_path="/opt/lsb-gtm/gtm"
+
avoid conflict and allow multiple instances to run side by side. For example worldvistaEHR is the default Linux id for rpm install
−
export gtm_dist=$gtm_path
 
−
gtm_group="gtm"
 
−
#gtm_path="/opt/lsb-gtm/V5.3-004A_i686"
 
−
vista_instance="EHR"
 
−
vista_path="/opt/worldvista/$vista_instance"
 
−
VISTAUSER="worldvista$vista_instance"
 
−
VISTAUSER_PASSWD="vista!123"
 
−
VISTAGROUP="worldvista$vista_instance"
 
−
TEXTUSER="text$vista_instance"
 
−
TEXTUSER_PASSWD="not#1sostrong"
 
−
instance_client_port=9260
 
−
vista_port_old_rpc=9210
 
−
vista_port_vistalink=8002
 
−
astro_vers_release="0.7.5"
 
−
gtm_vers_release="V5.3-004A"
 
  
−
Alter the above parameters as desired before running the rpm and it will override the above defaults.
+
with password vista!123. The default VistA id is sys.admin vista!123.
  
−
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.  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. To start m2web simply start or restart apache then go to step 10 here: http://vista.vmth.ucdavis.edu/notebook/index/48.html
+
Copyright (c) Astronaut, LLC 2010 http://astronautvista.com
−
 
−
Features:
 
  
−
  1) Conforms to VistA Standard Base 0.9 RC 10.
+
Author: Ignacio Valdes <ivaldes@hal-pc.org>
−
  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 wv-rpm-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. 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) Refreshed: Pre-installs Kevin Toppenberg's debugger, see http://vistapedia.net for activation.
 
−
19) Pre-installs EWD (currently broken).
 
−
20) Pre-installs OVID.
 
−
21) Pre-installs Victory Programming Environment, see http://vistapedia.net for activation.
 
−
# 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.
 
−
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:
+
Contributors of code, modules or other in Alphabetic order (Ommitted? Don't want to appear? Let me know.)
  
−
1) Beta installer.
+
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.
  
−
                WorldVistA EHR /VOE 1.0 Release 6-2008
+
Government:
 +
Indian Health Service -- BMX, scheduling GUI.
 +
Veterans Affairs -- FOIA VistA.
  
−
IMPORTANT FOR ALL PROVIDERS:
+
Problems, comments, bugs: Post problems or issues to the Hardhats group: http://groups.google.com/group/Hardhats or to
  
−
All drugs that the provider may need must be entered into the database
+
<ivaldes@hal-pc.org>
−
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@WORLDVISTA.ORG
+
License: Installer: Affero GNU GPL version 3. No warranties expressed or implied, use at your own risk. (see WorldVistA license
−
                OR
 
−
        http://trac.opensourcevista.net/worldvistaehr
 
  
−
Please see this link for information about entering new drugs and drug
+
below)
−
doseages:
 
  
−
<http://worldvista.org/World_VistA_EHR/license-and-readme/ReadMe%20-%20WorldVistA%20Pharmacy%20Drug%20File%202008-01-31.pdf>
+
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
  
−
Please look for additional information and updates about this release
+
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
−
here:
 
  
−
<http://worldvista.org/World_VistA_EHR/license-and-readme>
+
login. Download the Windows client installers which should all work out of the box with this server. The pre-set Linux id is
  
−
All portions of this release that are modified from the original Freedom
+
worldvistaEHR password is vista!123 which you will also have to re-set on first login to the Linux worldvistaEHR id.  
−
of Informtion 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:
+
Features:
  
−
http://worldvista.org/World_VistA_EHR/license-and-readme/WorldVistA%20EHR%20GPL%20License.txt
+
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
  
−
YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING
+
shell and no home directory.
−
THIS PRODUCT. DOWNLOADING OR USING ANY PART OF THE SOFTWARE AND
+
5) Relatively smaller download size 155Mb complete package containing all files.
−
DOCUMENTATION INDICATES THAT YOU ACCEPT THESE TERMS AND CONDITIONS. IF
+
6) Controller software such as vistactl.sh start | stop | restart, xinetd listener automatically configured and installed.
−
YOU DO NOT AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT, DO NOT
+
7) Automatic vista startup with journaling on server start and graceful shutdown. Bhaskar's code.
−
PROCEED.
+
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
  
−
A. General Disclaimer. THE WORLDVISTA-EHR (WV-EHR) SOFTWARE IS
+
auto-start routines. Requires explicit rm -Rf to really delete it all. rpm -i --force will NOT over-write an existing instance.
−
PROVIDED TO RECIPIENT HEREUNDER "AS IS" AND ANY USE OF WV-EHR SOFTWARE BY
+
15) Checks for file astro-defaults and overrides default install parameters for different locations for the install.
−
REQUESTOR SHALL BE AT ITS OWN RISK.  TO THE MAXIMUM EXTENT PERMITTED BY
+
16) Port handling files correspond to worldvista name spaces.
−
APPLICABLE LAW, WORLDVISTA AND ITS CONTRACTORS, EMPLOYEES AND AGENTS
+
17) Pre-installs m2web. Turn off and on SELinux between boots by: echo 0 >/selinux/enforce or echo 1 >/selinux/enforce
−
DISCLAIM ALL WARRANTIES WITH RESPECT TO WV-EHR SOFTWARE, EXPRESS, IMPLIED
+
18) Refreshed: Pre-installs Kevin Toppenberg's debugger, see http://vistapedia.net for activation.
−
AND STATUTORY, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF
+
19) Compatible with ewd-for-astronaut.
−
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, ACCURACY,
+
20) Pre-installs OVID.
−
COMPLETENESS, TIMELINESS, NON INFRINGEMENT OF THIRD-PARTY RIGHTS, NON
+
21) Pre-installs Victory Programming Environment, see http://vistapedia.net for activation.
−
INTERFERENCE, AND ERROR FREE SERVICE. WORLDVISTA TAKES NO RESPONSIBILITY
+
22) MSC Fileman 1039.
 +
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.
  
−
FOR MONITORING OR REGULATING THE USE OR ACCURACY OF WV-EHR SOFTWARE.
+
Caveats:
−
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
+
1) Beta installer.
−
APPLICABLE LAW, NEITHER WORLDVISTA NOR ANY OF ITS EMPLOYEES, AGENTS OR
+
</pre>
−
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.
 

Revision as of 03:44, 15 July 2010

Astronaut WorldVistA

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:

# sudo echo "deb http://software.astronautvista.com/deb  lucid main" >> /etc/apt/sources.list.d/lucid-partner.list
# sudo apt-get update

Then:

WorldVistA:
# sudo apt-get install astronaut-wv-server-beta
OpenVistA:
# sudo apt-get install astronaut-ov-server-beta


Fedora/RedHat/CentOS using yum:

As root, 
# cd /etc/yum.repos.d
# vi astro.repo

Add the following code:
[base]
name=Astronaut Yum Repository
baseurl=http://software.astronautvista.com/rpm
gpgcheck=0

Save the file, then:

WorldVistA:
# yum install astronaut-wv-server-beta
OpenVistA:
# 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 1039.
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.
Retrieved from "https://vistapedia.com/index.php?title=Astronaut_README-FIRST.txt&oldid=7613"