Prerequisites

In order to have a pleasant experience during Rancher Workshop, please ensure the followings are already done BEFORE the workshop begins (ideally, at least 1 day before):

1. Good connection to internet, since we're going to pull some Docker images!
2. Latest version of Oracle Virtualbox (v5.1.26 at the time of writing)
   1. https://www.virtualbox.org/wiki/Downloads
      In case you are using Windows 10 Pro with Hyper-V, please remove this hypervisor before installing Virtualbox.
3. Latest version of Docker Machine (v0.12.2 at the time of writing)
   1. https://docs.docker.com/machine/install-machine/
      Do not touch your current Docker installation, if you have one.
4. Once you have these in place, please run the following commands in a terminal of your choice to validate your setup:

   # Create a VM named "rs", running Rancher OS v1.0.4 with Docker v17.0.3.1-ce
   # using docker-machine and VirtualBox provider (2 CPU cores, 2 GB RAM and 10 GB disk space)
   docker-machine create -d virtualbox --virtualbox-boot2docker-url https://releases.rancher.com/os/v1.0. /rancheros.iso --virtualbox-cpu-count 2 --virtualbox-memory 2048 --virtualbox-disk-size 10000 rs

   # Once the above command completes successfully, display the newly created VM
   docker-machine ls
   
   ## Command output (or something similar, in case you have other VMs created using docker-machine)
   # NAME   ACTIVE   DRIVER       STATE     URL                         SWARM   DOCKER    ERRORS
   # rs     -        virtualbox   Running   tcp://192.168.99.100:2376           Unknown   Unable to query docker version: Cannot connect to the docker engine endpoint

   # Enter the newly created VM
   docker-machine ssh rs

   # Once inside the VM, display Docker version
   docker version
   
   ## Command output
   # Client:
   #  Version:      17.03.1-ce
   #  API version:  1.27
   #  Go version:   go1.7.5
   #  Git commit:   c6d412e
   #  Built:        Tue Mar 28 00:40:02 2017
   #  OS/Arch:      linux/amd64
   #
   # Server:
   #  Version:      17.03.1-ce
   #  API version:  1.27 (minimum version 1.12)
   #  Go version:   go1.7.5
   #  Git commit:   c6d412e
   #  Built:        Tue Mar 28 00:40:02 2017
   #  OS/Arch:      linux/amd64
   #  Experimental: false

   # To ensure you have a working version of Docker, run the hello-world container
   docker container run hello-world
   
   ## Command output
   # Unable to find image 'hello-world:latest' locally
   # latest: Pulling from library/hello-world
   # b04784fba78d: Pull complete
   # Digest: sha256:f3b3b28a45160805bb16542c9531888519430e9e6d6ffc09d72261b0d26ff74f
   # Status: Downloaded newer image for hello-world:latest
   #
   # Hello from Docker!
   # This message shows that your installation appears to be working correctly.
   #
   # To generate this message, Docker took the following steps:
   # 1. The Docker client contacted the Docker daemon.
   # 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
   # 3. The Docker daemon created a new container from that image which runs the
   #    executable that produces the output you are currently reading.
   # 4. The Docker daemon streamed that output to the Docker client, which sent it
   #    to your terminal.
   #
   # To try something more ambitious, you can run an Ubuntu container with:
   # $ docker run -it ubuntu bash
   #
   # Share images, automate workflows, and more with a free Docker ID:
   #  https://cloud.docker.com/
   #
   # For more examples and ideas, visit:
   #  https://docs.docker.com/engine/userguide/

5. If all of the above completed successfully, congrats! You are good to go for the Rancher Workshop!