Bahmni Virtual Box

Whether you use Windows, Linux or Mac, you can use this process to have Bahmni running on your machine for Testing or Development. Note that it is NOT recommended to use this in production. The idea is to download the Bahmni Virtual (Vagrant) Box which is pre-installed with CentOS, and all softwares. To make the vagrant box run on your machine you will need Virtual Box, Vagrant and GIT installed (See steps below). Once you have this Vagrant box running, you can then make changes to file in the box, and see them reflect immediately. If you still wish to go ahead, and make code changes, and deploy them - then development setup will be needed, so that you can modify files in your base OS, and run them inside the Vagrant box after recompilation.

• Git: http://git-scm.com/book/en/v2/Getting-Started-Installing-Git
• VirtualBox:https://www.virtualbox.org/wiki/Downloads
• Vagrant: https://www.vagrantup.com/downloads.html (Please install Vagrant version 1.7 or newer, 2.0.2 is the recommended version)

This command will download a CentOS Vagrant Box from the internet, and install it on your machine ('vagrant box list' command shows a list of locally installed boxes).

If you already have a Bahmni vagrant box on your machine, but would like to update to the latest published box, please perform the following steps.

If you wish to transfer the same vagrant box from your machine to another machine, you can also do that. This has the following advantages:

1. Any data you setup in your vagrant box will also be available to the other box/machine. 
2. If the other machine doesn't have fast internet access, then also you can perform this machine to machine box transfer, and save on bandwidth.
3. Its quicker than downloading the whole box!

Steps to perform:

Reference document: https://www.dev-metal.com/copy-duplicate-vagrant-box/

1. Create Reference Box: Create a new vagrant box that has everything from your box packaged into it using the following commands: 

   # Execute these commands from the same folder where your vagrant box is kept.
    
   # Halt vagrant
   vagrant halt
    
   # Create a new .box. This will create a package.box file
   vagrant package

2. Use Box on Target Machine: On the new machine, perform the following steps: Create a new folder, say: "D:/my-bahmni-vagrant"
3. Copy over the "package.box" file and "Vagrantfile" from your machine into the above folder.
4. Edit the Vagrantfile and do the following: 
5. Save the Vagrant file and execute "vagrant up" command.

   # Change this value as below
   config.vm.box = "my-bahmni-box"
    
   # Add this line to point the url to the package.box
   config.vm.box_url = "file:///d:/my-bahmni-vagrant/package.box"

Now the vagrant box on the new machine should be up. You can repeat step 2 on other machines, now that you have a package.box as reference for others.

Read this document:관련 문서: How to export your Bahmni Vagrant/Image or VM directly to AWS

If you are unable to download the box using the "vagrant up" command, you can choose to download it via some other downloader utility directly using this link:

v0.93.2: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.93.2/providers/virtualbox.box

v0.93.1: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.93.1/providers/virtualbox.box

v0.93: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.93/providers/virtualbox.box

v 0.92: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.92/providers/virtualbox.box

v 0.91: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.91/providers/virtualbox.box

v 0.90: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.90/providers/virtualbox.box

v 0.89: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.89/providers/virtualbox.box

v 0.88: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.88/providers/virtualbox.box

v 0.87: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.87/providers/virtualbox.box

v 0.86: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.86/providers/virtualbox.box

v 0.85: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.85/providers/virtualbox.box

v 0.83: https://app.vagrantup.com/bahmni-team/boxes/bahmni/versions/0.83/providers/virtualbox.box

After download, rename the box to "package.box". Place the box in your "bahmni-vagrant" folder, and edit the Vagrant file as below:

Now save the Vagrantfile. And then execute the "vagrant up" command.

From Bahmni v0.89, the Bahmni virtualbox comes with oh-my-zsh shell, Git installed. This will helpful for the newbies to navigate inside vagrant box. For details check this PR.