Booting

• Use Hyper-V to Boot Your ISO Installer
• Use Hyper-V to Boot Your Offline Image

The following guide walks through booting images and ISOs on Windows using Hyper-V.

Use Hyper-V to Boot Your ISO Installer

Copy ISO Image to Your VM Host Machine

Copy your binary image(s) to your VM Host Machine using your preferred technique.

Create VHD(X) Virtual Machine with Hyper-V

1. From Hyper-V Select Action->New->Virtual Machine.
2. Provide a name for your VM and press Next >.
3. Select Generation 1 (VHD) or Generation 2 (VHDX), then press Next >.
4. Change Memory size if desired, then press Next >.
5. Select a virtual switch, then press Next >.
6. Select Create a virtual hard disk, choose a location for your VHD(X) and set your desired disk Size. Then press Next >.
7. Select Install an operating system from a bootable image file and browse to your demo ISO.
8. Press Finish.

[Gen2/VHDX Only] Fix Boot Options

1. Right click your virtual machine from Hyper-V Manager
2. Select Settings...
3. Select Security and under Template: select Microsoft UEFI Certificate Authority.
4. Select Firmware and adjust the boot order so DVD is first and Hard Drive is second.
5. Select Apply to apply all changes.

Disable Secure Boot

Note: If you followed any of the previous tutorials in Working with packages, the kernel is no longer signed and secure boot must be disabled in order to boot your VHD(X) image.

1. Right click your virtual machine from Hyper-V Manager
2. Select Settings...
3. Select Security and uncheck the "Enable Secure Boot" box

Disable Dynamic Memory

Note: Having Dynamic Memory enabled may lead your app to crash due to integration with the Hyper-V Memory Ballooning driver. To avoid this, dynamic memory must be disabled.

1. Right click your virtual machine from Hyper-V Manager
2. Select Settings...
3. Select Memory and uncheck the "Enable Dynamic Memory" box

Boot ISO

1. Right click your VM and select Connect....
2. Select Start.
3. Follow the Installer Prompts to Install your image
4. When installation completes, select restart to reboot the machine. The installation ISO will be automatically ejected.
5. When prompted sign in to your CBL-Mariner system using the user name and password provisioned through the Installer.

Use Hyper-V to Boot Your Offline Image

Copy your demo VHD or VHDX image to your Windows Machine and boot it with Hyper-V.

Create VHD(X) Virtual Machine with Hyper-V

1. From Hyper-V Select Action->New->Virtual Machine.
2. Provide a name for your VM and press Next >.
3. For VHD select Generation 1. For VHDX select Generation 2, then press Next >.
4. Change Memory size if desired, then press Next >.
5. Select a virtual switch, then press Next >.
6. Select Use an existing virtual hard disk, then browse and select your VHD(X) file.
7. Press Finish.

[Gen2/VHDX Only] Fix Boot Options

1. Right click your virtual machine from Hyper-V Manager
2. Select Settings...
3. Select Security and under Template: select Microsoft UEFI Certificate Authority.

Disable Secure Boot

Note: If you followed any of the previous tutorials in Working with packages, the kernel is no longer signed and secure boot must be disabled in order to boot your VHD(X) image.

1. Right click your virtual machine from Hyper-V Manager
2. Select Settings...
3. Select Security and uncheck the "Enable Secure Boot" box

Disable Dynamic Memory**

Note: Having Dynamic Memory enabled may lead your app to crash due to integration with the Hyper-V Memory Ballooning driver. To avoid this, dynamic memory must be disabled.

1. Right click your virtual machine from Hyper-V Manager
2. Select Settings...
3. Select Memory and uncheck the "Enable Dynamic Memory" box

[Images Without Pre-Set Users Only] Build and Mount the Meta-User-Data.Iso Image

Note: If you followed any of the previous tutorials to build custom images in Working with packages, your image will have a user provisioned. This step is only needed if you are booting an image without a pre-defined user.

1. Build the meta-user.iso file via the instructions for using the meta-user.iso cloud init image
2. Right click your virtual machine from Hyper-V Manager
3. Select Settings.... choose DVD Drive and press Add.
4. Select the DVD Drive. For Gen1/VHD Images, this is nested under IDE Controller 1. For Gen2/VHDX Images, this is nested under SCSI Controller.
5. Select Image File: and browse to the meta-user-data.iso file.
6. Select Apply to apply all changes.

Boot and Sign-In to Your VHD(X) Image

1. Right click your VM and select Connect....
2. Select Start.
3. Wait for CBL-Mariner to boot to the login prompt, then sign in with the credentials you provisioned in the meta-user-data.iso file (username/password or username/sshkey pair).