Skip to content

Latest commit

 

History

History
29 lines (26 loc) · 1.98 KB

HyperVLinuxVMSetup.md

File metadata and controls

29 lines (26 loc) · 1.98 KB
Raw

Setting up a Linux Hyper-V VM on Windows with SGX Support

Note: Hyper-V support for SGX is not yet fully supported, but can be used as a "Preview" with the limitations mentioned below.

To set up a Linux VM on your Windows machine, do the following:

  1. Download an ISO for Ubuntu 20.04. A "Server install image" is sufficient.
  2. Create a VM as follows. Open "Hyper-V Manager", and do Action -> New -> Virtual Machine....
    • On the Specify Generation screen, choose Generation 2.
    • On the Configure Networking screen, choose Default Switch to ensure you can connect to it with a debugger.
    • On the Installation Options screen, choose the ISO file you downloaded.
    • All other options can be either left as the defaults or changed as desired.
  3. Disable Secure Boot as follows. In Hyper-V Manager, right click on the VM you created while it is stopped, and select Settings... -> Security and uncheck Enable Secure Boot.
  4. Uncheck "Enable checkpoints" under the VM's Settings -> Checkpoints, since SGX will not work with checkpoints.
  5. If using an SGX-capable machine, enable SGX for the VM as follows (this cannot be done from Hyper-V Manager):
    • Download VirtualMachineSgxSettings.psm1
    • Open an elevated PowerShell window (e.g., type "powershell" and click Run as Administrator)
    • Invoke the following commands, using the path to where you downloaded the file, and replacing MyVM with your VM name:
    Set-ExecutionPolicy Bypass -Scope Process
Import-Module Drive:\Path\to\VirtualMachineSgxSettings.psm1
Set-VMSgx -VmName MyVM -SgxEnabled $True -SgxSize 32
  6. Start the VM and connect to it (right click, Connect...), finish the initial setup, reboot, and login.
    • Enable OpenSSH server installation when given the choice during setup.
    • All other options are sufficient to leave as the defaults or changed as desired.