-
Notifications
You must be signed in to change notification settings - Fork 11
OpenHMIS Development VM
This page contains instructions to provide developers new to the OpenHMIS project with a quick on-ramp to contribution. It contains instructions to deploy a development VM intended for use to contribute to the expansion and refinement of the OpenHMIS project.
This document shall guide the developer through:
- installing the necessary software (VirtualBox),
- downloading the VM,
- (**) Git’ing the most recent code for the OpenHMIS software and demo applications,
- exercising the demo applications,
- opening the development environment,
- (**) making a minor change, and
- (**) submitting code changes through Git.
(**) Some items have not yet been documented.
See the Access Appendix for usernames and passwords within the VM.
We will start by installing the necessary software. Extracting the VM will require a freeware product called 7-zip and running the virtual machine will require a local installation of VirtualBox. 7-zip is a freeware archiving utility built by Igor Pavlov, and VirtualBox is a freeware virtualization product provided by Oracle While the VM runs on a Linux OS (CentOS), it can be run in many environments - Windows, Mac, Linux and Solaris.
- Download and install VirtualBox and the VirtualBox Extension Pack. (https://www.virtualbox.org/wiki/Downloads)
- When asked, install the network interfaces.
We will download the VM (a virtual hard drive including the operating system, software, and OpenHMIS code.
- Download the VM currently posted in a Google Drive folder. (https://drive.google.com/folderview?id=0B4u_ywt7L5jucW5BUnhZT3hoV2M&usp=sharing#list)
- Extract the VM using 7-zip.
- Open the VM in VirtualBox, either by double-clicking pathway.ova or by opening VirtualBox, clicking Start, and browsing to pathway.ova
- Login using the username and password found in the Access Appendix.
We will upload the VM’s code to the most recent OpenHMIS codebase.
- This is not yet documented. Sorry! We are currently looking at implementing EGit and Mylyn in the VM’s Eclipse installation to ease your pain getting the most recent code. Email [email protected] or [email protected] and we’ll work through it together.
We will start by opening the IntakeDemo (http://localhost:8080/IntakeDem/login) and log in using credentials found in the Access Appendix.
- (To make this work, the Tomcat service will need to be running. See ‘Opening the Development Environment’ step 4.)
- Log in using the credentials found in the Access Appendix.
- Select an intake client - enter ‘S’
- Play! Let us know what works and what doesn’t. ([email protected] or [email protected])
The VM has Eclipse pre-installed to allow contributions to the OpenHMIS project.
- Open Eclipse.
- Accept the default workspace.
- You will see the IntakeDemo, OpenHMIS-master, and Tomcat v7.0 Server at localhost-config under Servers.
- Highlight the Tomcat v7.0 Server and push the run button to start the Tomcat service.
Pathway’s goal is to provide others with an opportunity to commit real changes to our communities.
- This is not yet documented. Sorry! Email [email protected] or [email protected] and we’ll work through it together.
This is where you make REAL change, adding new functionality to ALL of our communities.
- This is not yet documented. Sorry! We are currently looking at implementing EGit and Mylyn in the VM’s Eclipse installation to ease your pain submitting the most recent code. Email [email protected] or [email protected] and we’ll work through it together.
These are usernames and passwords used to access applications within the VM.
O/S
username: root
password: pathway
MySQL (open MySQL Workbench)
username: root
password:
IntakeDemo
(http://localhost:8080/Intakedemo/login)
username: len
password: 12oclockhi
(verify using MySQL Workbench, checking the USER_INFO table)