Astronaut README-FIRST.txt
Astronaut WorldVistA
Installers for Linux Beta 0.7 (Falling with Style!) (see WorldVistA license below)
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.
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. Timson, George -- Pointed out IHS fix for SSN problem. Toppenberg, Kevin -- TMG-CPRS, TMG-GUI-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.
Corporations:
Fidelity Information Services -- GT.M Medsphere Systems Corp -- OVID, Other. 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)
This installer has been tested on Fedora 10 and Ubuntu 9.
To install on rpm based systems, log in as root:
# yum install -y --nogpg astronaut-<version info>.rpm
Will install all depencencies and then the rpm or somewhat independently:
# 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, use sudo or sudo su to 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 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:
gtm_path="/opt/lsb-gtm/gtm" 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.
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
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 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:
1) 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@WORLDVISTA.ORG
OR
http://trac.opensourcevista.net/worldvistaehr
Please see this link for information about entering new drugs and drug doseages:
Please look for additional information and updates about this release here:
<http://worldvista.org/World_VistA_EHR/license-and-readme>
All portions of this release that are modified from the original Freedom 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:
http://worldvista.org/World_VistA_EHR/license-and-readme/WorldVistA%20EHR%20GPL%20License.txt
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.
