chusri · December 20, 2019 03:27 · Nov 8, 2015 · Nov 8, 2015 · Nov 6, 2015
diff --git a/mac-vagrant-howto.rst b/mac-vagrant-howto.rst
@@ -1,18 +1,20 @@
 =================================
-Howto Vagrant on Mac w Virtualbox
+Vagrant on Mac w Virtualbox
 =================================
 
-NSoT engineers have built Vagrantfiles for you to deploy test NSoT software (Demo) in a multitude of environments. This tutorial will help you load a Macintonsh computer (OS X) with Vagrant, Virtual Box, and dependencies.
+NSoT engineers have built Vagrantfiles for you to deploy NSoT software in a multitude of linux environments. This tutorial will help you load a Macintonsh computer (OS X) with Vagrant, Virtual Box, and dependencies so that you can start virtual servers and test the software.
 
-NSoT publishes complete installations, demos, and branch versions, in a multitude of environments. These tutorials are in addition to, not an alternative for the pip-install method. 
+NSoT publishes complete installation instructions for linux distributions, branch versions, and Vagrantfiles in addition to, not an alternative for the pip install method::
+
+    $ pip-install nsot
 
 The Goal:
 =========
-Install Brew, VirtualBox, Vagrant and  Vagrant-Manager, on a Macintosh 10.10.x system to deploy test versions of NSOT. When done we will be able to provision a variety of linux distributions with NSOT pre-configured, as virtual servers, via Vagrantfile(s).
+Install Brew, VirtualBox, Vagrant and  Vagrant-Manager, on a Macintosh 10.10.x system to deploy test versions of NSOT. When done we will be able to load a variety of linux distributions with NSOT pre-configured, as virtual servers inside a test environment.
 
 Context:
 ========
-We will use Vagrant and associated Virtual Server software to build Ubuntu, Debian, CentOS, and other installations of Network Server of Truth (NSOT) elsewhere in these documents. This guide is to help those unfamiliar with how to install and use Vagrant and Virtualbox in the first place 
+We will use Vagrant and associated Virtual Server software to build NSoT on a variety of Linux distributions elsewhere in these documents. This guide is to help those unfamiliar with how to install and use Vagrant and Virtualbox, making the Vagrantfiles published more useful.
 
 Vagrant allows us to provision complete virtual machines (Unix, Linux, Mac, or Windows) inside the Mac Operating system as virtual machines. The vagrant virtual servers are configured with a single file (called a “Vagrantfile.”) started with a single command (vagrant up), are contained within a single folder, and can be destroyed with a single command (vagrant destroy). This environment is nicely segregated from your day to day computing, and allows you to test our software in a variety of environments.
 

diff --git a/mac-vagrant-howto.rst b/mac-vagrant-howto.rst
@@ -1,55 +1,124 @@
-NSOT engineers have built Vagrantfiles for you deploy test NSOT software (Demo) in a multitude of environments. This tutorial will prepare your computer for those demonstration servers. This tutorial prepares a Mac OS X environment with Vagrant.
+=================================
+Howto Vagrant on Mac w Virtualbox
+=================================
 
-NSOT publishes complete installations, demos, and branch versions, in a multitude of environments. These tutorials are in addition to, not an alternative for the pip-install method. 
+NSoT engineers have built Vagrantfiles for you to deploy test NSoT software (Demo) in a multitude of environments. This tutorial will help you load a Macintonsh computer (OS X) with Vagrant, Virtual Box, and dependencies.
+
+NSoT publishes complete installations, demos, and branch versions, in a multitude of environments. These tutorials are in addition to, not an alternative for the pip-install method. 
 
 The Goal:
+=========
 Install Brew, VirtualBox, Vagrant and  Vagrant-Manager, on a Macintosh 10.10.x system to deploy test versions of NSOT. When done we will be able to provision a variety of linux distributions with NSOT pre-configured, as virtual servers, via Vagrantfile(s).
 
-Context: We will use Vagrant and associated Virtual Server software to build Ubuntu, Debian, CentOS, and other installations of Network Server of Truth (NSOT) elsewhere in these documents. This guide is to help those unfamiliar with how to install and use Vagrant and Virtualbox in the first place 
+Context:
+========
+We will use Vagrant and associated Virtual Server software to build Ubuntu, Debian, CentOS, and other installations of Network Server of Truth (NSOT) elsewhere in these documents. This guide is to help those unfamiliar with how to install and use Vagrant and Virtualbox in the first place 
 
 Vagrant allows us to provision complete virtual machines (Unix, Linux, Mac, or Windows) inside the Mac Operating system as virtual machines. The vagrant virtual servers are configured with a single file (called a “Vagrantfile.”) started with a single command (vagrant up), are contained within a single folder, and can be destroyed with a single command (vagrant destroy). This environment is nicely segregated from your day to day computing, and allows you to test our software in a variety of environments.
 
-Assumptions: You are running a computer with Mac OS X 10.10.x installed.
- (The graphics are from a 10.10.5 installation).
- Overview:
-Install Prerequisite Software (XCode)*.
-Install Brew*.
-Brew Vagrant **.
-“Hello World” Vagrant **.
+Assumptions:
+============
+You are running a computer with Mac OS X 10.10.x installed.
+
+Overview:
+=========
+1 Install Prerequisite Software (XCode)*.
+2 Install Brew.
+3 Brew Vagrant.
+4 “Hello World” Vagrant.
+
+1. Install Prerequisite Software - XCode & XCode Tools:
+======================================================
+Click link to Get Xcode —>             
+https://itunes.apple.com/au/app/xcode/id497799835?mt=12
 
-Install Prerequisite Software (XCode from App Store via Link):
-Click link to Get Xcode —>             https://itunes.apple.com/au/app/xcode/id497799835?mt=12
 Agree to EULA and Install.
+
 Install Prerequisite Software (XCode Tools from Command Line):
 Open a Terminal (Launchpad —> Other —> Terminal).
-At the command prompt run the following command to install XCode Tools.
-	 	  xcode-select —install 
-Agree to install at Prompt.
-Accept the EULA.
-Install Prerequisite Software (Homebrew from Command Line):
-Using the same terminal, now download Homebrew by copying this command.   ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 
-This will ask for your password, and install Homebrew on your Mac.
-Run this command from the terminal to update and confirm install of Homebrew.  brew doctor 
-Agree to EULA for Terminal in Mac OS X 
-From Command line run this command to bring up licenses:  sudo xcodebuild -license 
-Check that Brew is up to date.
-From Command line run this command to ensure Homebrew is up to date:  brew update  
-Install Vagrant and Virtualbox via Homebrew:
-From command line run this to download, verify, and install VirtualBox.  brew install Caskroom/cask/virtualbox 
-From command line run this to download, verify, and install VirtualBox extension pack for your version of virtualbox. brew install Caskroom/cask/virtualbox-extension-pack 
-From command line run this to download, verify, and install Vagrant.  brew install Caskroom/cask/vagrant 
-From command line run this to download, verify, and install Vagrant-Manager.  brew install Caskroom/cask/vagrant-manager
-Start a Virtual Ubuntu Server:
-Download an OS —> We’ll use Ubuntu. From Command line enter the following to make a sandbox directory, cd into it, and then download the OS:  mkdir sandbox && cd sandbox && vagrant box add precise64 http://files.vagrantup.com/precise64.box 
-Initialize the installation inside the sandbox folder (aka make the Vagrantfile). (You can modify the Vagrantfile and look at it after this step.)  vagrant init precise64 
-Start the Ubuntu server via Vagrant by typing this at command line:  vagrant up 
-To login to the new server via ssh, enter the following via command line:  vagrant ssh 
-Change what you like. Mess it up if you care to. Once done poking around, logout.  exit 
-To destroy the Ubuntu virtual server installation  vagrant destroy 
-To rebuild from the OS again…  vagrant up   Conclusion: After the login regimen finishes, you should be inside the new server you just created, for the second time. You have built a new server, Destroyed it, and built another in less time than it takes to drink a cup of coffee.    
-
-
-
-Homebrew installation based on the guide published here. http://coolestguidesontheplanet.com/installing-homebrew-os-x-yosemite-10-10-package-manager-unix-apps/
-
-** Based on the Vagrant installation guide published here.     http://sourabhbajaj.com/mac-setup/Vagrant/README.html
+At the command prompt run the following command to install XCode Tools
+
+    $ xcode-select —install 
+
+- Accept the EULA.
+- Agree to install at Prompt.
+
+2. Install Prerequisite Software (Homebrew from Command Line):
+==============================================================
+
+Using the terminal, download and install Homebrew with this command::
+
+    $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+    
+    
+Run this command from the terminal to update and confirm install of Homebrew::
+
+    $ brew doctor 
+
+
+From Command line run these commands to update Brew and view the version (licenses)::
+
+    $ brew update
+    $ sudo xcodebuild -license 
+
+3. Install Vagrant and Virtualbox via Homebrew:
+===============================================
+
+Download, verify, and install VirtualBox::
+
+    $ brew install Caskroom/cask/virtualbox
+    
+Download, verify, and install VirtualBox extension pack for your version of virtualbox::
+
+    $ brew install Caskroom/cask/virtualbox-extension-pack
+
+Download, verify, and install Vagrant::
+
+    $ brew install Caskroom/cask/vagrant
+
+Download, verify, and install Vagrant-Manager::
+
+    $ brew install Caskroom/cask/vagrant-manager
+    
+4. Start a Virtual Ubuntu Server:
+=================================
+Now that we have it all installed, let's spin up an Ubuntu server, log in to it, play, log out, and then destroy it.
+
+From Command line enter the following to make a sandbox directory, cd into it, and then download the Ubuntu::
+
+    $ mkdir sandbox && cd sandbox 
+    $ vagrant box add precise64 http://files.vagrantup.com/precise64.box
+    
+Initialize the installation inside the sandbox folder (aka make the Vagrantfile). (You can modify the Vagrantfile and look at it after this step.)::
+
+    $ vagrant init precise64 
+    
+Start the Ubuntu server via Vagrant by typing this at command line::
+
+    $ vagrant up
+    
+To login to the new server via ssh, enter the following via command line::
+
+    $ vagrant ssh
+    
+Change what you like. Mess it up if you care to. Once done poking around logout::
+
+    $ exit
+    
+To destroy the Ubuntu virtual server installation::
+
+    $ vagrant destroy
+    
+To rebuild from the OS again::
+
+    $ vagrant up
+    
+Conclusion: After the login regimen finishes, you should be inside the new server you just created, for the second time. You have built a new server, Destroyed it, and built another in less time than it takes to drink a cup of coffee.
+
+
+Footnotes:
+Homebrew installation based on the guide published here.
+http://coolestguidesontheplanet.com/installing-homebrew-os-x-yosemite-10-10-package-manager-unix-apps/
+
+Based on the Vagrant installation guide published here.     
+http://sourabhbajaj.com/mac-setup/Vagrant/README.html
diff --git a/mac-vagrant-howto.rst b/mac-vagrant-howto.rst
@@ -0,0 +1,55 @@
+NSOT engineers have built Vagrantfiles for you deploy test NSOT software (Demo) in a multitude of environments. This tutorial will prepare your computer for those demonstration servers. This tutorial prepares a Mac OS X environment with Vagrant.
+
+NSOT publishes complete installations, demos, and branch versions, in a multitude of environments. These tutorials are in addition to, not an alternative for the pip-install method. 
+
+The Goal:
+Install Brew, VirtualBox, Vagrant and  Vagrant-Manager, on a Macintosh 10.10.x system to deploy test versions of NSOT. When done we will be able to provision a variety of linux distributions with NSOT pre-configured, as virtual servers, via Vagrantfile(s).
+
+Context: We will use Vagrant and associated Virtual Server software to build Ubuntu, Debian, CentOS, and other installations of Network Server of Truth (NSOT) elsewhere in these documents. This guide is to help those unfamiliar with how to install and use Vagrant and Virtualbox in the first place 
+
+Vagrant allows us to provision complete virtual machines (Unix, Linux, Mac, or Windows) inside the Mac Operating system as virtual machines. The vagrant virtual servers are configured with a single file (called a “Vagrantfile.”) started with a single command (vagrant up), are contained within a single folder, and can be destroyed with a single command (vagrant destroy). This environment is nicely segregated from your day to day computing, and allows you to test our software in a variety of environments.
+
+Assumptions: You are running a computer with Mac OS X 10.10.x installed.
+ (The graphics are from a 10.10.5 installation).
+ Overview:
+Install Prerequisite Software (XCode)*.
+Install Brew*.
+Brew Vagrant **.
+“Hello World” Vagrant **.
+
+Install Prerequisite Software (XCode from App Store via Link):
+Click link to Get Xcode —>             https://itunes.apple.com/au/app/xcode/id497799835?mt=12
+Agree to EULA and Install.
+Install Prerequisite Software (XCode Tools from Command Line):
+Open a Terminal (Launchpad —> Other —> Terminal).
+At the command prompt run the following command to install XCode Tools.
+	 	  xcode-select —install 
+Agree to install at Prompt.
+Accept the EULA.
+Install Prerequisite Software (Homebrew from Command Line):
+Using the same terminal, now download Homebrew by copying this command.   ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 
+This will ask for your password, and install Homebrew on your Mac.
+Run this command from the terminal to update and confirm install of Homebrew.  brew doctor 
+Agree to EULA for Terminal in Mac OS X 
+From Command line run this command to bring up licenses:  sudo xcodebuild -license 
+Check that Brew is up to date.
+From Command line run this command to ensure Homebrew is up to date:  brew update  
+Install Vagrant and Virtualbox via Homebrew:
+From command line run this to download, verify, and install VirtualBox.  brew install Caskroom/cask/virtualbox 
+From command line run this to download, verify, and install VirtualBox extension pack for your version of virtualbox. brew install Caskroom/cask/virtualbox-extension-pack 
+From command line run this to download, verify, and install Vagrant.  brew install Caskroom/cask/vagrant 
+From command line run this to download, verify, and install Vagrant-Manager.  brew install Caskroom/cask/vagrant-manager
+Start a Virtual Ubuntu Server:
+Download an OS —> We’ll use Ubuntu. From Command line enter the following to make a sandbox directory, cd into it, and then download the OS:  mkdir sandbox && cd sandbox && vagrant box add precise64 http://files.vagrantup.com/precise64.box 
+Initialize the installation inside the sandbox folder (aka make the Vagrantfile). (You can modify the Vagrantfile and look at it after this step.)  vagrant init precise64 
+Start the Ubuntu server via Vagrant by typing this at command line:  vagrant up 
+To login to the new server via ssh, enter the following via command line:  vagrant ssh 
+Change what you like. Mess it up if you care to. Once done poking around, logout.  exit 
+To destroy the Ubuntu virtual server installation  vagrant destroy 
+To rebuild from the OS again…  vagrant up   Conclusion: After the login regimen finishes, you should be inside the new server you just created, for the second time. You have built a new server, Destroyed it, and built another in less time than it takes to drink a cup of coffee.    
+
+
+
+Homebrew installation based on the guide published here. http://coolestguidesontheplanet.com/installing-homebrew-os-x-yosemite-10-10-package-manager-unix-apps/
+
+** Based on the Vagrant installation guide published here.     http://sourabhbajaj.com/mac-setup/Vagrant/README.html