Getting started with OpenHIM development¶
The fist thing you will need to do is get you development environment up. This guide describes how to get a development environment up for the OpenHIM-core and the OpenHIM-console.
Setting up your OpenHIM-core dev environment¶
You can use vagrant if you would want to get up and running quickly with a dev environment in a vm. See here to use Vagrant to fire up an instance. Otherwise, read on to learn more.
Ensure you have the following installed:
- Node.js v4 or greater
- MongoDB (in Ubuntu run
sudo apt-get install mongodb, in OSX using Homebrew, run
brew updatefollowed by
brew install mongodb)
The OpenHIM core makes use of the Koa framework, which requires node version 4 or greater.
The easiest way to use the latest version of node is to install
nvm. On Ubuntu, you can install using the install script but you have to add
[[ -s $HOME/.nvm/nvm.sh ]] && . $HOME/.nvm/nvm.sh # This loads NVM to the end of your
~/.bashrc file as well.
nvm is installed, run the following:
nvm install --lts
nvm alias default lts/*
The latest LTS version of node should now be installed and set as default. The next step is to get all the required dependencies using
npm. Navigate to the directory where the openhim-core-js source is located and run the following:
Then build the project:
In order to run the OpenHIM core server, MongoDB must be installed and running.
To run the server, execute:
npm start (this runs
grunt build then
node lib/server.js behind the scenes)
The server will by default start in development mode using the mongodb database ‘openhim-development’. To start the serve in production mode use the following:
NODE_ENV=production node lib/server.js
This starts the server with production defaults, including the use of the production mongodb database called ‘openhim’.
grunt watch- will automatically build the project on any changes.
grunt lint- ensure the code is lint free, this is also run before an
npm link- will symlink you local working directory to the globally installed openhim-core module. Use this so you can use the global openhim-core binary to run your current work in progress. Also, if you build any local changes the server will automatically restart.
grunt test --mochaGrep=<regex>- will only run tests with names matching the regex
grunt test --ddebugTests- enabled the node debugger while running unit tests. Add
debuggerstatements and use
node debug localhost:5858to connect to the debugger instance.
Setting up your OpenHIM-console dev environment¶
Clone the repository at
https://github.com/jembi/openhim-console.git and then run
Install cli tools:
npm install -g grunt-cli grunt bower
Install bower web components:
To run the unit tests run
To start up a development instance of the webapp run
grunt serve. The hostname and port can be changed in
Gruntfile.js. The hostname can be changed to
0.0.0.0 in order to access the site from outside.
Note all changes will be automatically applied to the webapp and the page will be reloaded after each change. In addition JSHint will be run to provide information about errors or bad code style. The unit tests will also be automatically be run if JSHint does not find any problems.
For unit testing we are using mocha with chai.js for assertions. We are using the BDD
should style for chai as it more closely resembles the unit testing style that is being used for the OpenHIM-core component