Limitations

Configuration

Add server to a Windows domain

Add the Hyper-V server to a Windows Domain. 

Modify the Windows registry

Download the PowerShell script in the attached file change_registry.ps1

Log in the hypervisor as domain administrator (DOMAIN\USER or USER@DOMAIN) and run the PowerShell script.

This script will change some registry keys values and set their owner to the user who runs it. This allows Abiquo administer the hypervisor remotely with the domain user.

Configure WinRM

Abiquo newest versions use WinRM for some management operations. Among others:

• Clone VM template disks from VM repository during VM deploy

• Allow unmapped Samba shares to be used as datastores

To enable WinRM, use the commands below:

• Enable the WinRM service and set some basic properties

  winrm quickconfig winrm set winrm/config/service/Auth '@{Basic="true"}' winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="1024"}'

   

• Create a new certificate for the WinRM service and copy the certificate thumbprint:

  New-SelfSignedCertificate -DnsName HypervisorDNSName -CertStoreLocation Cert:\LocalMachine\My

   

• Create an HTTPS listener for WinRM using this certificate to encrypt service requests:

  winrm create winrm/config/Listener?Address=*+Transport=HTTPS '@{Hostname="HypervisorDNSName"; CertificateThumbprint="THUMBPRINT"}'

   

• The new copy disk procedure requires CredSSP to be enabled in WinRM. To that end, you’ll need to run the following in every HV added in Abiquo:
  
  

   

The WinRM configuration and requirements are detailed here:

• https://docs.xebialabs.com/

• https://github.com/xebialabs/overthere

Configure firewall

You need to open the following ports in HyperV for the RS appliance to be able to manage it remotely:

WMI uses a dynamic port range to provide WMI services on top of the DCOM service. It is possible to configure this service to use a static port, but this is out of Abiquo scope.

Check Microsoft documentation for further details on this.

Configure network

Configure the network in Hyper-V Manager by checking the MAC addressing and add a new network attached to the service network interface.

Configure VLANs

To allow Abiquo to manage VLANs in this Hyper-V server, add a new network attached to the service network interface.

The network name should use appropriate characters and can be chosen by the network administrator. 

In Hyper-V Manager, go to Virtual Switch Manager -> New virtual network switch. Use the default options with 'External' type

Click here for more details...

Open

Configure persistent iSCSI storage

Install iSCSI service

Launch a cmd command line to enable the iSCSI service and set it to start automatically:

Manually set initiator IQN

Once the iSCSI service is enabled, you must set the initiator IQN for the machine manually. Go to  Start > Administrative tools > iSCSI Initiator > Configuration and Click the Change button.

The dialog below will appear. You can accept the default value.

Click here to expand...

iSCSI firewall rule

See Configure Firewall (above) to set the iSCSI firewall rules via netsh.

SAN policy configuration

Open a command line and run the following commands to set the appropriate SAN Policy:

Abiquo properties

Edit the /opt/abiquo/config/abiquo.properties and update its contents as described below:

• Enable WinRM related properties if needed

   

• Configure the appliance library related properties

   

• If you are using unmapped Samba shares, set the abiquo.hyperv.sambaHosts property too.

Cloud init images folder

To use cloud-init, you will need to add a hyperv-iso folder to the VM repository. After the Abiquo server is up and running, check if this folder is present, for example in the default location.

 If the hyperv-iso folder is not present, then create it, and set its owner to "tomcat"

VM generation

When using HyperV, you must take Generation 1 and Generation 2 VM features, requirements and capabilities into account when dealing with VMs and VM templates.

If the VM or VM template is not using the right settings, VMs might not be deployed, or they could be unable to boot:

• Which is the VM base OS and its architecture?

• Is the VM template legacy BIOS or UEFI compatible?

• Is the VM primary disk IDE or SCSI?

• Is the VM using disks in VHD format?
  

Abiquo will deploy the VM as Gen2 if the primary disk is SCSI, otherwise, it will deploy it as Gen1. If the VM is Gen2, all the disks must be in VHDX or ISO format, and the template must be UEFI boot-capable.

Check the links below for the all the details.

• https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/plan/Should-I-create-a-generation-1-or-2-virtual-machine-in-Hyper-V

• https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/Hyper-V-feature-compatibility-by-generation-and-guest

Credentials

For Hyper-V, enter the credentials as follows:

• Domain user accounts must be introduced in UPN format (user@domain)

• Local user accounts must be specified by only typing in the user (user)

Remember that NTP is mandatory.

Features

General features

Storage features