s Student Guide is used to run labbuildr classes.
Manadatory in each class is the preparation of Student Laptops/pc´s For Windows 10 users, please make sure no not use edge browser for copy paste operations

This Guide is divided in Multiple Chapters Prerequirements install and run labbuildr
defaults Running VM´s

0.1 Prerequirements

In this part, students check / install the required software requirements are VMware Workstationversion 12 Powershell Version 3.0 or greater ( 4 gets installed in this guide ) * Virtualization enbled in Bios
Check that VT Bit and virtualization is enabled in you Computers Bios
For Lenovo:
Press enter to interrupt Startup, the F1 for BIOS
In Security enable both, Intel Virtualization Technology and VT-d Feature

0.1.0 VMware Workstation 12

VMware Workstation 12 is recommended for the class. get you eval copy here VMware 12 eval EMCer can get their Licence Key here: EMC VMware eval Keys ( login required )

0.1.1 Check Powershell Version

labbuildr uses powershell for all automation tasks. A minimum Version of 3.0 is required.
to check the powershell version, use keyboard shortcut [WIN+R] to open a run prompt, and enter "powershell.exe" image a new powershell window opens. at the prompt, enter

($PSVersionTable).PSVersion -ge "3.0"

if the answer is "true", skip to 0.1.4 Execution Policy image

0.1.2 Check .Net Framework

Prereq for Powershell 3.0/4.0 is Net Framework 4.5

(Get-ItemProperty -Path 'HKLM:\Software\Microsoft\NET Framework Setup\NDP\v4\Full' -ErrorAction SilentlyContinue).Version -ge '4.5*'

if the answer is true, skip to step 0.1.3 Install Powershell for any other answers, download and run .Net 4.5.2 Installer

0.1.3 install Powershell 4.0

Powershell (4.0) is part of Windows Management Framework (WMF) 4.0.
Download and run WMF 4.0 from here WMF 4.0 x64

0.1.4 Execution Policy

Powershell resticts the execution of scripts with Execution Policy´s. Depending on your Version of OS, this might be a different setting. We need an unrestricted setting for labbuildr, to allow for run the downloaded code from GitHub. If you do not have a Powershell Windows Open, do so now with [WIN+R] powershell.exe enter

 Get-ExecutionPolicy

image
If the answer is not unrestricted, we have to set the execution policy. this can only be done as administrator. from the taskbar, right-click on your powershell session and select "Run as Administrator" image
in the new powershell window, enter

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

image
close the admin window.
from the other powershell session, enter

Get-ExecutionPolicy

hint: use up / down keys
it should be set to unrestricted now image

0.1.5 sign into labbuildr slack channel

register yourself at http://community.emccode.com/ to get access to the emccode slack. once registered, join the labbuildr slack channel at https://codecommunity.slack.com/messages/labbuildr/ that way i can check students completed the prework. we will use slack during the class for shareing of snippets etc

image

0.1.6 Optional

create your github account to be able to submit issues and
do not Forget to star labbuildr :-)

1.0 install and run labbuildr

In this section Studends wll install labbuildr, review basic settings and get introduced to some basic commands

1.1 installation

Install

labbuildr can be installed using PowershellGet. If you are note running Windows 10, install PowershellGet from Powershell Gallery

Installation via Powershell Get

Fully automated Installation Using Powershell Get Method

Install-Script install-labbuildr -Force -Scope CurrentUser
install-labbuildr.ps1 -branch master

Fully automated Installation from powershell Using Download Method

1.2 run labbuildr

double click on the labbuildr icon on your desktop
image

your labbuildr window should start.
the actual version(s) will be displayed ( labdefaults ) If OpenWRT is not Available, it will be loaded and started

image

some defaults can now be adjusted to your needs

1.2 adjusting defaults

1.2.1 Masterpath

a central part of labbuildr are MASTER images, wich represent the Base for OS installations. to be space effective, linked clones are used.
the MASTERS are stored in a Central repo. the default is c:\sharedmaster you can adjust the setting with

Set-LABMasterpath -Masterpath [your path]

Note: use a fast ssd drive, and do NOT use usb, as disconnects will fail you VM.

1.2.2 Sources

sources are the place where software for add on installations like SQL, Sharepoint, ScaleIO, Networker etc are downloaded to. Should be on a drive with enough space, USB Stick etc. UNC currently not tested.
Default is c:\sources
create the desired Directory with

New-Item -ItemType Directory C:\sources

if you choose another path // stick, adjust with

create the desired Directory with

Set-LABSources d:\sources

1.2.3 MySubnet

192.168.2.0 is default for all Machines Subnet

1.2.4 vmnet

Virtual net used by labbuildr machines. doess not need to exist unless you want to connect to your machines from your host
for host connection, add the netwwok using the vmware virtual network editor. Create vmnet2 with
dhcp disabled connect host virtual adapter * subnet ip 192.168.2.0
image

1.3 running vm´s

in this chapter students will run / download their first vm(s)

1.3.1 OpenWRT

OpenWRT is used as a tiny NAT gateway. it routes traffic from your vm´s subnet to the internet and allows VM´s to register ( windows 180 days license ) or download packages ( mainly linux ) to manually download an unzip OpenWRT use

Receive-LABOpenWRT -start

imageonce this will start you OpenWRT vm. image
in the vm´s console, enter

ifconfig eth1

this will show you the dhcp address received by your host
image use this ip address ( or MySubnet.4) with your browser to connect to the admin interface image
Login to the ui an be done with your Webbrowser with user root/Password123!

1.3.2 Build a domain controller

to build the domain controller, follow ./Build-lab.ps1 -DConly

2.0 Managing VM´s

get a list of all all labbuildr commands

get-command -module labtools

getting a list of running vm´s

get-vmx | where state -Match running  | ft