=Overview=
Vagrant lets you quickly spin up full environments for the purpose of PMF unit testing on different platforms and for DB testing. With Vagrant, we can set up automated installs that include full packaging of RDBMSs, WebFOCUS, and PMF. What's more they can be set up to mix and match in various combinations, any of which would be very tedious to install and set up without it. A successful run takes approximately 10-20 minutes (ignoring first time use initial box "image" downloads). Upon which the script will output various status updates concluding with the local guest VM ip address.In the event you are setting the application up for the first time on your machine, an additional ~20 minutes will be required to download the virtual box images from the hashicorp official server.
=Pre-Install Checklist=
*1. Install virtualbox and vagrant from https://www.virtualbox.org/wiki/Downloads and http://www.vagrantup.com/downloads.html respectively. Choose appropriate OS for each.
*2. Install Python 2.7.X from https://www.python.org/downloads. If already installed on Windows, make sure Python27 is accessible in the Environment Path variable for Windows. Otherwise the cmd line will have no reference to the command "python".
*3. Checkout from SVN @ http://pmfsvn/viewvc/PMF/projects/vagrant/.
=General Instructions:=
*1. From terminal/command line run "python Automate_Vagrant_Config.py" while in the project directory.
*2. Choose desired options.
*3. Run the command “vagrant up” from the command line while in the vagrant_project directory.
*4. Upon completion message, double click on loadWF.html within Current Working Directory, to have the portal open in your default browser.
** One may also connect using SSH via “vagrant ssh” within the terminal if on Linux. However, if on Windows Putty must be installed. Using Putty SSH into 127.0.0.1 with user:”vagrant” password:”vagrant”. If for some reason the connection is refused, copy and paste the displayed ip address for the VM and attempt using that address and port 22.
=Add Additional Boxes=
*1. If one wants to add additional “desired” boxes. One must find the particular box id online at https://atlas.hashicorp.com/boxes/search . This is the official hashicorp repository . A boxes name is usually of the format X/Y where X and Y describe certain properties (Ex: hashicorp/precise64 is assembled by hashicorp and is 64 bit flavor of Ubuntu).
*2. Upon obtaining the official box id, one must open Automate_Vagrant_Config.py in their editor of choice.
*3. There is one location where changes must be made. The first is in the global dictionary named OPERATING_SYSTEMS. If the official box id of the newly desired box is X/Y the entry will look like this (Remember to insert within the dictionaries’ brackets {}). ** “X/Y” : { “name” : ” X/Y”, “description” : “insert description here”}
*4. The script will now automatically query your system for currently installed vagrant boxes and install boxes that are absent.