Page Comparison

...

The following step-by-step guide helps you in installing Bahmni using Docker. Docker is an open platform for developers and system admins to build, ship, and run distributed applications. Following instructions are mainly targeted for Mac OS X and Linux users. But they should work with any operating system that supports Docker.  

Installing Docker

• • On Linux

    1. Open a terminal and run 'curl https://get.docker.com | $SHELL'.  Or if you don't have 'curl' installed in your system try using 'wget -O - https://get.docker.com | $SHELL'.
       Note: If you can't use any of the above tools in your system, then visit https://get.docker.com in your browser, save the displayed script and run in your favorite shell. 
       
       

    2. After the above step completes, run 'sudo usermod -aG docker $USER'. This command will add you to the docker group, so that, you can run docker command without needing sudo.

       Info
       title Docker Command
       docker

       
       

  • On Mac OS X / Windows

    1. Download and install the boot2docker package. Complete the installation using default selections. In case you get a message that "Running Virtual Box detected", please shutdown all the vms and restart the installation. Details on understand boot2docker - http://viget.com/extend/how-to-use-docker-on-os-x-the-missing-guide
       
       

    2. Set the following environment variables in your .bashrc or .zshrc file (source .bashrc to get your changes reflected)

       Info
       export DOCKER_HOST=tcp://192.168.59.103:2376 export DOCKER_CERT_PATH=~/.boot2docker/certs/boot2docker-vm export DOCKER_TLS_VERIFY=1

       
       

    3. Start the boot2docker (installed in previous step) using the following command.  The "boot2docker init" command is required only for the first time.

       Info
       title Starting Boot2Docker
       boot2docker init boot2docker up

       
       

    4. Try executing the following command to check if your installation was successful.

       Info
       title Docker Command
       docker

       
       

...

For the first time, it takes around 15-25 minutes depending on your internet speed.  Please note that it is just for the first time.  Subsequently it will be much faster. If this script fails (in rare cases) to download the images from dockerhub-bahmni, you can manually download the required images based on the required images and rerun "sh bahmni install". 

The Bahmni installation comes up with its own MySQL and PostgreSQL database backup.  You will have a fully functional bahmni up and running.

...

• The command "docker exec -it <containerid> /bin/bash", will take you inside the container.  Think of it like SSHing into the box. You can browse through the folders using this command.

  
  

  Upgrading docker in Mac

  Info
  title Upgrading docker in Mac
  sudo boot2docker upgrade boot2docker ssh sudo /etc/init.d/docker restart  #check the upgraded version docker --version

  
  

...

1. Sometimes, running the "docker ps" command gives a timeout issue.  Looks like its an issue with docker 1.6.2 and people are tracking it here
   http://stackoverflow.com/questions/26686358/docker-cant-connect-to-boot2docker-because-of-tcp-timeout
2. On Linux based OS, make sure to install "ruby-dev" and "npm-legacy" packages as well to avoid build failures on openmrs-distro-bahmni and openmrs-module-bahmniapps

3. When using boot2docker and docker pull is giving timeout, try this:

   Info
   title Docker pull timeout
   boot2docker down #Add a rule to forward traffic from 127.0.0.1:2376 to port 2376 on the boot2docker vm: vboxmanage modifyvm "boot2docker-vm" --natpf1 "docker,tcp,127.0.0.1,2376,,2376" boot2docker up $(boot2docker shellinit) export DOCKER_HOST=tcp://127.0.0.1:2376

   
   

Related articles

Dev setup using Vagrant and Docker - https://gist.github.com/craigbarrau/05771d6ca28873548c90

...