FreeSHR-Playbooks

Owned by Mritunjay Dubey
Last updated: Jul 03, 2017

We are using ansible to install/provision all our HIE-Components. FreeSHR-Playbooks is a github repository which stores all the ansible playbooks for HIE-Components.

Structure of FreeSHR-Playbooks:-

  • The inventories folder contains the information about where each of the services will be installed. Each Service can be installed on a single host or multiple hosts in case of multi-node server. For each environment there will be a separate file.
  • The group_vars folder contains the different parameters for each services which are configurable depending on the enviornment. E.g.:- SHR port might be different in two different environment.
  • The roles folder contains the tasks to be performed to setup/install a service. E.g.:- A role named SHR-Server will have tasks to setup SHR-Server.
  • There are below playbook files:-
    • cassandra.yml is responsible for installing cassandra and creating users for cassnadra.
    • datasense.yml installs datasense service.
    • go.yml installs go-server and go-agents.
    • mci.yml installs complete MCI-Package which includes MCI-Server, HealthId-Sever, MCI-LR, MCI-Background-Jobs and MCI-Admin UI.
    • nagios.yml installs nagios server and nrpe-agents.
    • patient-journal.yml installs patient-journal server.
    • shr.yml installs SHR-Server, freeshr-update-service and shr-migration-service.
    • tr.yml installs Terminology-Server and Tr-Feed-Omod. It can be used to insert some seed data for TR as well.
    • all.yml installs haproxy and stub identity server.
    A single playbook is responsible for installing more than one services. In each playbook file there are tags to install each particular service which can be mentioned to install a specific service instead of all the services in that playbook. 

Setting up provisioner box:-

Before we start the installing we need to setup a box from where we can run the ansible commands. For other environments we provision/deploy services from go-agent machines. For local environment we will setup a vagrant box for the same purpose.

  • Install VirtualBox and Vagrant.
  • Clone the FreeSHR-Playbooks Repository.
  • Go into the folder where you have cloned the repository.

  • Run vagrant up. It will start a vagrant box with centos 6.5.

  • Run vagrant ssh. It will open the shell for the centos box.

  • Run sudo yum install epel-release. This will install epel-release which is needed to install ansible on centos.

  • Run sudo yum install ansible. This will install ansible 2.x.

Note:- Ansible establishes a SSH connection to install services on other machines with a given user (vagrant for local environments). Before installing services on a fresh box it is recommended to perform a SSH from provisioner box to target box with vagrant user.