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"
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
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
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"
in the new powershell window, enter
Set-ExecutionPolicy -ExecutionPolicy Unrestricted
close the admin window.
from the other powershell session, enter
Get-ExecutionPolicy
hint: use up / down keys
it should be set to unrestricted now
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
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
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
your labbuildr window should start.
the actual version(s) will be displayed ( labdefaults )
If OpenWRT is not Available, it will be loaded and started
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
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
once this will start you OpenWRT vm.
in the vm´s console, enter
ifconfig eth1
this will show you the dhcp address received by your host
use this ip address ( or MySubnet.4) with your browser to connect to the admin interface
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