Installation v2.0

Installing PopHealth from Code

These instructions have only been tested for Ubuntu version 1204 LTS.

Dependencies

Git

You will first need to install the Git version control system on your machine, in order to download the popHealth source code packages. Instructions for installing Git on your system and platform are available here

###Ruby 1.9.2

popHealth requires the use of the Ruby 1.9.2 or higher programming language. Instructions for installing Ruby are available here

###Bundler

Once you have installed all the dependency utilities, you will need to install Bundler, the application dependency management tool. To install Bundler, run the following command:

gem install bundler

###MongoDB

popHealth requires the use of the MongoDB open source, document-based database. To use popHealth, you will need to have installed MongoDB 2.2.0 or higher prior to downloading the popHealth code. Instructions for installing MongoDB are available here. As part of the setup process of MongoDB, you should also ensure the Mongo 'bin' directory is in your operating system's PATH environment variable.

Install Application

popHealth Web Application

If you intend on making any contributions to the popHealth project, you will be required to use a fork of the popHealth Git repository. To do this, you will need to create an account on GitHub, and create a fork of the popHealth repository. Instructions for creating a GitHub account are available here. Once you have created a GitHub account, you will be able to create a fork of of the popHealth repository off of the repository website here. If you have created your own fork, replace the clone url below with your own.

git clone git://github.com/pophealth/popHealth.git
git branch develop origin/develop
git checkout develop

Once the clone process has completed, you will need to install the popHealth Dependencies.

cd popHealth
bundle install

popHealth Setup

You will need an NLM account in order to load value sets from the VSAC service and download the measure bundle.

Register for an account at: https://uts.nlm.nih.gov/home.html. . Once you have the bundle and the account you can run the following commands to load the bundle.

curl -u NLM_USERNAME:NLM_PASSWORD http://demo.projectcypress.org/bundles/bundle-latest.zip -o ../bundle-latest.zip
bundle exec rake bundle:import[/path/to/bundle.zip,true,'ep']
bundle exec rake pophealth:download_value_sets[NLM_USERNAME,NLM_PASSWORD]

This will also install 37 test patients.

Start popHealth

bundle exec rails s
bundle exec rake jobs:work

Point your browser to http://localhost:3000

If you see a login page, you've successfully installed popHealth!