diff --git a/docs/images/hyper-v/hyper_v_0.png b/docs/images/hyper-v/hyper_v_0.png new file mode 100644 index 00000000..0c20f2bb Binary files /dev/null and b/docs/images/hyper-v/hyper_v_0.png differ diff --git a/docs/images/hyper-v/hyper_v_1.png b/docs/images/hyper-v/hyper_v_1.png new file mode 100644 index 00000000..afda1a92 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_1.png differ diff --git a/docs/images/hyper-v/hyper_v_2.png b/docs/images/hyper-v/hyper_v_2.png new file mode 100644 index 00000000..ceeb53d3 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_2.png differ diff --git a/docs/images/hyper-v/hyper_v_3.png b/docs/images/hyper-v/hyper_v_3.png new file mode 100644 index 00000000..07221465 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_3.png differ diff --git a/docs/images/hyper-v/hyper_v_4.png b/docs/images/hyper-v/hyper_v_4.png new file mode 100644 index 00000000..27dbac65 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_4.png differ diff --git a/docs/images/hyper-v/hyper_v_5.png b/docs/images/hyper-v/hyper_v_5.png new file mode 100644 index 00000000..fed92f43 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_5.png differ diff --git a/docs/images/hyper-v/hyper_v_6.png b/docs/images/hyper-v/hyper_v_6.png new file mode 100644 index 00000000..7d80a7a6 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_6.png differ diff --git a/docs/images/hyper-v/hyper_v_7.png b/docs/images/hyper-v/hyper_v_7.png new file mode 100644 index 00000000..665ce811 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_7.png differ diff --git a/docs/images/hyper-v/hyper_v_8.png b/docs/images/hyper-v/hyper_v_8.png new file mode 100644 index 00000000..81833027 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_8.png differ diff --git a/docs/images/hyper-v/hyper_v_ubuntu_0.png b/docs/images/hyper-v/hyper_v_ubuntu_0.png new file mode 100644 index 00000000..35c6e308 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_ubuntu_0.png differ diff --git a/docs/images/hyper-v/hyper_v_ubuntu_1.png b/docs/images/hyper-v/hyper_v_ubuntu_1.png new file mode 100644 index 00000000..352853c1 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_ubuntu_1.png differ diff --git a/docs/images/hyper-v/hyper_v_ubuntu_2.png b/docs/images/hyper-v/hyper_v_ubuntu_2.png new file mode 100644 index 00000000..e55cced2 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_ubuntu_2.png differ diff --git a/docs/images/hyper-v/hyper_v_ubuntu_3.png b/docs/images/hyper-v/hyper_v_ubuntu_3.png new file mode 100644 index 00000000..5ba7126b Binary files /dev/null and b/docs/images/hyper-v/hyper_v_ubuntu_3.png differ diff --git a/docs/images/hyper-v/hyper_v_ubuntu_4.png b/docs/images/hyper-v/hyper_v_ubuntu_4.png new file mode 100644 index 00000000..a0888c1d Binary files /dev/null and b/docs/images/hyper-v/hyper_v_ubuntu_4.png differ diff --git a/docs/images/hyper-v/hyper_v_ubuntu_5.png b/docs/images/hyper-v/hyper_v_ubuntu_5.png new file mode 100644 index 00000000..399abbe0 Binary files /dev/null and b/docs/images/hyper-v/hyper_v_ubuntu_5.png differ diff --git a/docs/setup-hyper-v-vm.md b/docs/setup-hyper-v-vm.md new file mode 100644 index 00000000..33ec459e --- /dev/null +++ b/docs/setup-hyper-v-vm.md @@ -0,0 +1,108 @@ +# Setting up a Hyper-V Virtual Machine + +#### Prequisites + +This guide is written for Hyper-V running on MS Windows Server, in this case Windows Server Datacenter 2019. + +--- + +#### Create a Hyper V VM + +Launch the Hyper V Manager app and select 'New' -> 'Virtual Machine...' option (as shown below) + +![](./images/hyper-v/hyper_v_0.png) + +--- + +You will be presented with the first Wizard screen. Select 'Next' for a custom installation (as shown below) + +![](./images/hyper-v/hyper_v_1.png) + +--- + +At the next screen specify the name and location for the VM . In this example we have used a dedicated directory for our VMs (see below). + + +![](./images/hyper-v/hyper_v_2.png) + +--- + +At the next screen specify the Generation. As this is not a legacy application we can choose the latest generation (see below). + +![](./images/hyper-v/hyper_v_3.png) + +--- + +At the next screen assign the amount of RAM to allocate to the VM. This value can be changed later, so the value is not critical but the final value chosen is obviously dependent on the available machine RAM (see below). + +![](./images/hyper-v/hyper_v_4.png) + +--- + + +At the next screen configure the network adapter. This will typically be a Ethernet - Virtual Switch, but the actual name will be hardware dependent (see below). + +![](./images/hyper-v/hyper_v_5.png) + +--- + +At the next screen configure the virtual hard disk. It makes sense to create a dedicated virtual hard disk and to store it in a sensible location. The size choosen *is important* as (unlike the RAM value) it is not trivial to change this later (see diagram below). + +![](./images/hyper-v/hyper_v_6.png) + +--- + +Finally, at the next screen choose the 'Install an operating system later' option and select the '**Finish**' button + +![](./images/hyper-v/hyper_v_7.png) + +--- + +The newly created VM should now show up in the Hyper-V Manager's list of VMs (see below) + +![](./images/hyper-v/hyper_v_8.png) + +--- + + +#### Installing Ubuntu + +Prepare a suitable bootable media file. For this application we will need an `Ubuntu_18.04_server_amd64.iso` file. This could be hosted on a USB drive or copied over to a suitable location on the Windows Server file system. + +In Hyper-V Manager, from the list of VMs, right click on the new created VM and select the 'Settings' option as shown below. + +![](./images/hyper-v/hyper_v_ubuntu_0.png) + +--- + +From the Settings screen select 'Security' in the left hand panel. In the right hand panel uncheck the 'Enable Secure Boot' checkbox as we are not booting into Windows. Click the 'Apply'. + +![](./images/hyper-v/hyper_v_ubuntu_1.png) + +--- + +From the Settings screen select 'SCSI Controller' in the left hand panel. In the right hand panel select 'DVD' and select the 'Add' button (as shown below). + +![](./images/hyper-v/hyper_v_ubuntu_2.png) + +--- + + +Now select the 'Image file' radio button and browse to the location of the ISO file. Now click the 'Apply' button. + +![](./images/hyper-v/hyper_v_ubuntu_3.png) + +--- + +From the Settings screen select 'Firmware' in the left hand panel, then in the right hand panel use the 'Move Up' button to move the 'DVD Drive' hosting the ISO up to the top of the list so that it is the first boot entry. Now click the 'Apply' button and then the 'OK' button to finish the boot set up. + +![](./images/hyper-v/hyper_v_ubuntu_4.png) + +--- + +You can now start the newly created VM which should boot off the ISO file to enable you to install Ubuntu in the normal manner. + +![](./images/hyper-v/hyper_v_ubuntu_5.png) + +--- +