Skip to content

HyperV

This guide is for Hyper V Manager 10.

Installation of PPA should take around 5 minutes.

You will:

  • Create a new virtual machine
  • Power it on and note down the appliance's IP address

Download the EFI enabled ISO

Before you begin, download the latest EFI enabled ISO here:

https://supportdesk.osirium.com/a/solutions/articles/9000173922

You will need this later in the installation process.

Creating the Virtual Machine

Select Action, then New in Hyper V Manager. Choose the Virtual Machine option.

Actions menu

A Before You Begin page in the wizard may show. If so, click Next.

Specify name and location

Provide a meaningful name for the virtual machine and specify the location (optional).

New Virtual Machine Wizard - Specify Name and Location

Click Next.

Specify generation

Specify the generation of the virtual machine as Generation 2.

New Virtual Machine Wizard - Specify Generation

Warning

Failure to set Generation 2 may prevent the appliance from installing correctly.

Click Next.

Assign memory

Specify the memory that you would like allocated to the virtual machine.

New Virtual Machine Wizard - Assign Memory

Tip

For proof of concepts and small deployments, we recommend allocating 16GB.

You may need to allocate more memory for production deployments.

If in doubt, please contact support@osirium.com for help and guidance.

Click Next.

Configure networking

Select a network connection for the virtual machine to use.

New Virtual Machine Wizard - Configure Network

Click Next.

Connect virtual hard disk

Specify the name, location, and size of the virtual hard disk allocated to the virtual machine.

New Virtual Machine Wizard - Virtual Hard Disk

Tip

For proof of concepts and small deployments, we recommend a disk size of 80GB.

You may need to increase the persistent storage disk size for a production deployment.

If in doubt, please contact support@osirium.com for help and guidance.

Click Next.

Installation options

Select Install an operating system from a bootable image file and browse to the EFI enabled ISO file that you downloaded earlier.

New Virtual Machine Wizard - Installation options

Warning

Do not detach the ISO from the virtual machine at any point, even after the VM has been deployed.

The ISO contains the system OS, and PPA will break if it is detached.

Click Next.

Summary

Review and accept the settings.

New Virtual Machine Wizard - Summary

Virtual Machine Settings

Right click on the Virtual Machine and select Settings:

Actions menu

This will open the Settings dialog for the virtual machine.

Disable secure boot

Select Security from the Hardware pane. Uncheck Enable Secure Boot.

Info

PPA is built using Linuxkit which is architected to be secure by default. Since Linuxkit does not currently support secure EFI boot it must be disabled in Hyper V Manager. Read more about Linuxkit secure design.

HyperV Settings - Disable Secure Boot

Click Apply.

Virtual processors

Select Processor from the Hardware pane. Ensure that at least 4 virtual processors are assigned.

Tip

For proof of concepts and small deployments, we recommend allocating 2 virtual processors.

You may need to allocate more virtual processors for a production deployment.

If in doubt, please contact support@osirium.com for help and guidance.

HyperV Settings - Virtual Processors

Click Apply and then Ok.

First Boot

Powering on

The virtual machine will be in the powered off state by default. Right click on the Virtual Machine and select Start.

Start Virtual Machine

Next steps

The next step is configuration.