ramanjiusa · November 10, 2023 02:22 · Jul 24, 2019 · Oct 17, 2018 · Oct 10, 2018 · Oct 10, 2018
diff --git a/install.md b/install.md
@@ -9,8 +9,8 @@ Ensure your laptop has Virtualization Extensions (Intel VT or AMD-V) **enabled**
 
 **Software to be Installed**
 * Git (optional)
-* kubernetes-cli (kubectl) version v1.12.0
-* minikube version v0.30.0
+* kubernetes-cli (kubectl) version v1.15.1
+* minikube version v1.2.0
 * Virtualbox version 5.2+ ([or other minikube compatible hypervisors][minikube-hypervisors])
 
 
@@ -100,7 +100,7 @@ Once done, [verify your Install](#verifying-install).
 
 With the software installed you can verify it is working correctly by executing:
 ```
-minikube start --kubernetes-version v1.12.1
+minikube start --kubernetes-version v1.15.1
 ```
 
 This will take a little bit of time the first time it is run as it will download its needed dependencies and starts the
@@ -111,8 +111,8 @@ kubectl version
 
 You should get output similar to the following:
 ```
-Client Version: version.Info{Major:"1", Minor:"12", GitVersion:"v1.12.0", GitCommit:"0ed33881dc4355495f623c6f22e7dd0b7632b7c0", GitTreeState:"clean", BuildDate:"2018-09-28T15:20:58Z", GoVersion:"go1.11", Compiler:"gc", Platform:"darwin/amd64"}
-Server Version: version.Info{Major:"1", Minor:"12", GitVersion:"v1.12.1", GitCommit:"4ed3216f3ec431b140b1d899130a69fc671678f4", GitTreeState:"clean", BuildDate:"2018-10-05T16:36:14Z", GoVersion:"go1.10.4", Compiler:"gc", Platform:"linux/amd64"}
+Client Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1", GitCommit:"4485c6f18cee9a5d3c3b4e523bd27972b1b53892", GitTreeState:"clean", BuildDate:"2019-07-18T14:25:20Z", GoVersion:"go1.12.7", Compiler:"gc", Platform:"darwin/amd64"}
+Server Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1", GitCommit:"4485c6f18cee9a5d3c3b4e523bd27972b1b53892", GitTreeState:"clean", BuildDate:"2019-07-18T09:09:21Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}
 ```
 
 After that you may stop the virtualmachine with:
@@ -153,14 +153,14 @@ This can be caused by a variety of issues. However the solution is the same.
 First try deleting and recreating the minikube instance
 ```
 minikube delete
-minikube start --kubernetes-version v1.12.1
+minikube start --kubernetes-version v1.15.1
 ```
 
 If that does not resolve the issue, delete the local minikube configs and try starting it again
 ```
 minikube delete
 rm -rf ~/.minikube
-minikube start --kubernetes-version v1.12.1
+minikube start --kubernetes-version v1.15.1
 ```
 That should hopefully resolve the kubeadm init error.
 

diff --git a/install.md b/install.md
@@ -11,45 +11,92 @@ Ensure your laptop has Virtualization Extensions (Intel VT or AMD-V) **enabled**
 * Git (optional)
 * kubernetes-cli (kubectl) version v1.12.0
 * minikube version v0.30.0
-* Virtualbox version 5.2+ ([or other minikube compatible hypervisors](https://github.com/kubernetes/minikube#requirements))
+* Virtualbox version 5.2+ ([or other minikube compatible hypervisors][minikube-hypervisors])
 
 
-## Mac OSX Users:
-The easiest way to install all the requirements is to use [brew](https://brew.sh/), and can be done with the following
-commands:
+## Installation Guides
+
+The Installation guides are centered around using the Virtualbox Hypervisor. [Others are available][minikube-hypervisors],
+but their installation and use have not been tested. 
+
+* [OSX](#osx-installation-guide)
+* [Windows](#windows-installation-guide)
+* [Linux](#linux)
+* [Verifying Install](#verifying-install)
+* [Troubleshooting Install Problems](#troubleshooting-install-problems)
+
+---
+
+## OSX Installation Guide
+
+Installation on OSX is done with [Homebrew][brew], an OSX package manager. If you have not installed it previously,
+please see their [installation guide][brew] before continuing.
+
+**WARNING:** If you have previously installed virtualbox manually, do not try and upgrade it or reinstall it via brew.
+Upgrade it by manually by [downloading it from the virtualbox site][vbox-dl] or by uninstalling it then reinstalling
+via brew.
+
+**Note to High Sierra (10.13)+ Users:** High Sierra introduced stricter security settings over the area in which brew
+installs some of its binaries. If you had brew previously installed (pre High Sierra) and have not done anything with it
+in some time, it should be reinstalled. For details regarding this issue,
+[see this stackoverflow thread][so-osx-brew-bug].
+
+
+Install `git`, `kubectl`, `minikube` and `virtualbox`.
 ```
 brew install git kubernetes-cli
 brew cask install minikube virtualbox
-```
+````
+
+Once done, [verify your Install](#verifying-install).
 
-Then [verify your install](#verify-install).
+**Optional:** You can improve the general user experience of working with `kubectl` by installing
+[command-completion][osx-completion]
 
 ---
 
-## Windows Users:
-**NOTE:** The Windows 10 Fall Creators Update enabled HyperV by default on supported hardware; however, it prevents the
-use of any other virtualization software like Virtualbox and must be disabled. To do this execute the following command
-and reboot:
-```
-dism.exe /Online /Disable-Feature:Microsoft-Hyper-V
-```
+## Windows Installation Guide
 
-HyperV can be re-enabled after the labs by executing:
+Installation on Windows is done with [chocolatey][choco], a Windows Package Manager. If you have not
+installed it previously, please see their [installation guide][choco-install] before continuing.
+
+**NOTE:** The Windows 10 Fall Creators Update enabled HyperV by default on supported hardware. This tutorial has
+**NOT** been tested against HyperV, but should theoretically work. If you wish to use HyperV, you may skip disabling
+it and the installation of Virtualbox. However minikube must be
+[configured and started in a different manner][minikube-hyperv].
+
+Disable HyperV (will require restart). HyperV unfortunately prevents Virtualbox from functioning properly and must
+be disabled.
 ```
-dism.exe /Online /Enable-Feature:Microsoft-Hyper-V /All
+dism.exe /Online /Disable-Feature:Microsoft-Hyper-V
 ```
 
-With HyperV disabled the easiest way of installing the requirements is to use [chocolatey](https://chocolatey.org/) and
-can be done with the following command:
+Install `git`, `kubectl`, `minikube` and `virtualbox`.
 ```
 choco install git kubernetes-cli minikube virtualbox
 ```
 
-Then [verify your install](#verify-install).
+Once done, [verify your Install](#verifying-install).
+
+---
+
+## Linux
+
+Linux installation is different for each distro. General install information is linked below:
+
+* [git][linux-git]
+* [kubectl][linux-kubectl]
+* [minikube][linux-minikube]
+* [virtualbox][linux-vbox]
+
+Once done, [verify your Install](#verifying-install).
+
+**Optional:** You can improve the general user experience of working with `kubectl` by installing
+[command-completion][linux-completion]
 
 ---
 
-## Verify Install
+## Verifying Install
 
 With the software installed you can verify it is working correctly by executing:
 ```
@@ -71,4 +118,66 @@ Server Version: version.Info{Major:"1", Minor:"12", GitVersion:"v1.12.1", GitCom
 After that you may stop the virtualmachine with:
 ```
 minikube stop
-```
+```
+
+---
+
+## Troubleshooting Install Problems
+
+### OSX: Virtualbox fails to install via brew
+
+Error Message:
+```
+installer: The install failed (The Installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance.)
+==> Purging files for version 5.2.18,124319 of Cask virtualbox
+Error: Failure while executing; `/usr/bin/sudo -E -- env LOGNAME=bob USER=bob USERNAME=bob /usr/sbin/installer -pkg /usr/local/Caskroom/virtualbox/5.2.18,124319/VirtualBox.pkg -target /` exited with 1. Here's the output:
+installer: Package name is Oracle VM VirtualBox
+installer: Installing at base path /
+installer: The install failed (The Installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance.)
+```
+
+This occurs on High Sierra if you had brew previously installed before upgrading OSX. High Sierra introduced stricter security settings over the area in which brew
+installs some of its binaries. 
+
+To fix the issue, simply reinstall brew following the directions on the [brew site][brew]. Then proceed with installing
+virtualbox.
+
+ For details regarding this issue, [see this stackoverflow thread][so-osx-brew-bug].
+
+---
+
+### All Platforms: Minikube fails to start with a "kubeadm init error"
+
+This can be caused by a variety of issues. However the solution is the same. 
+
+First try deleting and recreating the minikube instance
+```
+minikube delete
+minikube start --kubernetes-version v1.12.1
+```
+
+If that does not resolve the issue, delete the local minikube configs and try starting it again
+```
+minikube delete
+rm -rf ~/.minikube
+minikube start --kubernetes-version v1.12.1
+```
+That should hopefully resolve the kubeadm init error.
+
+
+
+ [intro-slides]: https://docs.google.com/presentation/d/1zrfVlE5r61ZNQrmXKx5gJmBcXnoa_WerHEnTxu5SMco/edit?usp=sharing
+ [minikube]: https://github.com/kubernetes/minikube
+ [minikube-hypervisors]: https://github.com/kubernetes/minikube#requirements
+ [brew]: https://brew.sh/
+ [vbox-dl]: https://www.virtualbox.org/wiki/Downloads
+ [so-osx-brew-bug]: https://stackoverflow.com/questions/46459152/cant-chown-usr-local-for-homebrew-in-osx-10-13-high-sierra
+ [osx-completion]: https://kubernetes.io/docs/tasks/tools/install-kubectl/#on-macos-using-bash
+ [choco]: https://chocolatey.org/
+ [choco-install]: https://chocolatey.org/install
+ [minikube-hyperv]: https://github.com/kubernetes/minikube/blob/master/docs/drivers.md#hyperv-driver
+ [linux-git]: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
+ [linux-kubectl]: https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-kubectl
+ [linux-minikube]: https://github.com/kubernetes/minikube#linux
+ [linux-vbox]: https://www.virtualbox.org/wiki/Linux_Downloads
+ [linux-completion]: https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion
diff --git a/install.md b/install.md
@@ -8,7 +8,7 @@ Ensure your laptop has Virtualization Extensions (Intel VT or AMD-V) **enabled**
 **2 core, 2GB RAM Virtual Machine**.
 
 **Software to be Installed**
-* Git (not required)
+* Git (optional)
 * kubernetes-cli (kubectl) version v1.12.0
 * minikube version v0.30.0
 * Virtualbox version 5.2+ ([or other minikube compatible hypervisors](https://github.com/kubernetes/minikube#requirements))

diff --git a/install.md b/install.md
@@ -56,7 +56,7 @@ With the software installed you can verify it is working correctly by executing:
 minikube start --kubernetes-version v1.12.1
 ```
 
-This will take a little bit of time the first time it is run as it downloads its needed dependencies and starts the
+This will take a little bit of time the first time it is run as it will download its needed dependencies and starts the
 virtual machine. When it completes, you can verify it is working correctly by executing:
 ```
 kubectl version

diff --git a/install.md b/install.md
@@ -1,5 +1,6 @@
 # Kubernetes Tutorial Install Instructions
 
+If you have any questions or run into any problems, please don't hesitate to contact me here: [email protected]
 
 ## All Platforms
 
@@ -10,7 +11,7 @@ Ensure your laptop has Virtualization Extensions (Intel VT or AMD-V) **enabled**
 * Git (not required)
 * kubernetes-cli (kubectl) version v1.12.0
 * minikube version v0.30.0
-* Virtualbox version 5.2+
+* Virtualbox version 5.2+ ([or other minikube compatible hypervisors](https://github.com/kubernetes/minikube#requirements))
 
 
 ## Mac OSX Users:

diff --git a/readme.md → install.md b/readme.md → install.md
diff --git a/readme.md b/readme.md
@@ -0,0 +1,73 @@
+# Kubernetes Tutorial Install Instructions
+
+
+## All Platforms
+
+Ensure your laptop has Virtualization Extensions (Intel VT or AMD-V) **enabled** and is capable of running a 
+**2 core, 2GB RAM Virtual Machine**.
+
+**Software to be Installed**
+* Git (not required)
+* kubernetes-cli (kubectl) version v1.12.0
+* minikube version v0.30.0
+* Virtualbox version 5.2+
+
+
+## Mac OSX Users:
+The easiest way to install all the requirements is to use [brew](https://brew.sh/), and can be done with the following
+commands:
+```
+brew install git kubernetes-cli
+brew cask install minikube virtualbox
+```
+
+Then [verify your install](#verify-install).
+
+---
+
+## Windows Users:
+**NOTE:** The Windows 10 Fall Creators Update enabled HyperV by default on supported hardware; however, it prevents the
+use of any other virtualization software like Virtualbox and must be disabled. To do this execute the following command
+and reboot:
+```
+dism.exe /Online /Disable-Feature:Microsoft-Hyper-V
+```
+
+HyperV can be re-enabled after the labs by executing:
+```
+dism.exe /Online /Enable-Feature:Microsoft-Hyper-V /All
+```
+
+With HyperV disabled the easiest way of installing the requirements is to use [chocolatey](https://chocolatey.org/) and
+can be done with the following command:
+```
+choco install git kubernetes-cli minikube virtualbox
+```
+
+Then [verify your install](#verify-install).
+
+---
+
+## Verify Install
+
+With the software installed you can verify it is working correctly by executing:
+```
+minikube start --kubernetes-version v1.12.1
+```
+
+This will take a little bit of time the first time it is run as it downloads its needed dependencies and starts the
+virtual machine. When it completes, you can verify it is working correctly by executing:
+```
+kubectl version
+```
+
+You should get output similar to the following:
+```
+Client Version: version.Info{Major:"1", Minor:"12", GitVersion:"v1.12.0", GitCommit:"0ed33881dc4355495f623c6f22e7dd0b7632b7c0", GitTreeState:"clean", BuildDate:"2018-09-28T15:20:58Z", GoVersion:"go1.11", Compiler:"gc", Platform:"darwin/amd64"}
+Server Version: version.Info{Major:"1", Minor:"12", GitVersion:"v1.12.1", GitCommit:"4ed3216f3ec431b140b1d899130a69fc671678f4", GitTreeState:"clean", BuildDate:"2018-10-05T16:36:14Z", GoVersion:"go1.10.4", Compiler:"gc", Platform:"linux/amd64"}
+```
+
+After that you may stop the virtualmachine with:
+```
+minikube stop
+```
No results found