Hyper-V virtualization platform¶

Local storage considerations¶

The Hyper-V compute node needs to have ample storage for storing the virtual machine images running on the compute nodes. You may use a single volume for all, or partition it into an OS volume and VM volume.

Configure NTP¶

Network time services must be configured to ensure proper operation of the OpenStack nodes. To set network time on your Windows host you must run the following commands:

C:\>net stop w32time
C:\>w32tm /config /manualpeerlist:pool.ntp.org,0x8 /syncfromflags:MANUAL
C:\>net start w32time

Keep in mind that the node will have to be time synchronized with the other nodes of your OpenStack environment, so it is important to use the same NTP server. Note that in case of an Active Directory environment, you may do this only for the AD Domain Controller.

Configure Hyper-V virtual switching¶

Information regarding the Hyper-V virtual Switch can be located here: Hyper-V Virtual Switch Overview.

To quickly enable an interface to be used as a Virtual Interface the following PowerShell may be used:

PS C:\> $if = Get-NetIPAddress -IPAddress 192* | Get-NetIPInterface
PS C:\> New-VMSwitch -NetAdapterName $if.ifAlias -Name YOUR_BRIDGE_NAME -AllowManagementOS $false

Enable iSCSI initiator service¶

To prepare the Hyper-V node to be able to attach to volumes provided by cinder you must first make sure the Windows iSCSI initiator service is running and started automatically.

PS C:\> Set-Service -Name MSiSCSI -StartupType Automatic
PS C:\> Start-Service MSiSCSI

Configure shared nothing live migration¶

Detailed information on the configuration of live migration can be found here: Use live migration without Failover Clustering to move a virtual machine.

The following outlines the steps of shared nothing live migration.

1. The target host ensures that live migration is enabled and properly configured in Hyper-V.
2. The target host checks if the image to be migrated requires a base VHD and pulls it from the Image service if not already available on the target host.
3. The source host ensures that live migration is enabled and properly configured in Hyper-V.
4. The source host initiates a Hyper-V live migration.
5. The source host communicates to the manager the outcome of the operation.

The following three configuration options are needed in order to support Hyper-V live migration and must be added to your nova.conf on the Hyper-V compute node:

• This is needed to support shared nothing Hyper-V live migrations. It is used in nova/compute/manager.py.

  instances_shared_storage = False
  

• This flag is needed to support live migration to hosts with different CPU features. This flag is checked during instance creation in order to limit the CPU features used by the VM.

  limit_cpu_features = True
  

• This option is used to specify where instances are stored on disk.

  instances_path = DRIVELETTER:\PATH\TO\YOUR\INSTANCES
  

Additional Requirements:

• Hyper-V 2012 R2 or Windows Server 2012 R2 with Hyper-V role enabled
• A Windows domain controller with the Hyper-V compute nodes as domain members
• The instances_path command-line option/flag needs to be the same on all hosts
• The openstack-compute service deployed with the setup must run with domain credentials. You can set the service credentials with:

C:\>sc config openstack-compute obj="DOMAIN\username" password="password"

How to setup live migration on Hyper-V¶

To enable ‘shared nothing live’ migration, run the 3 instructions below on each Hyper-V host:

PS C:\> Enable-VMMigration
PS C:\> Set-VMMigrationNetwork IP_ADDRESS
PS C:\> Set-VMHost -VirtualMachineMigrationAuthenticationTypeKerberos

Additional Reading¶

This article clarifies the various live migration options in Hyper-V:

Hyper-V Live Migration of Yesterday

Python¶

Python 2.7 32bit must be installed as most of the libraries are not working properly on the 64bit version.

Setting up Python prerequisites

1. Download and install Python 2.7 using the MSI installer from here:

   python-2.7.3.msi download

   PS C:\> $src = "https://www.python.org/ftp/python/2.7.3/python-2.7.3.msi"
   PS C:\> $dest = "$env:temp\python-2.7.3.msi"
   PS C:\> Invoke-WebRequest –Uri $src –OutFile $dest
   PS C:\> Unblock-File $dest
   PS C:\> Start-Process $dest
   

2. Make sure that the Python and Python\Scripts paths are set up in the PATH environment variable.

   PS C:\> $oldPath = [System.Environment]::GetEnvironmentVariable("Path")
   PS C:\> $newPath = $oldPath + ";C:\python27\;C:\python27\Scripts\"
   PS C:\> [System.Environment]::SetEnvironmentVariable("Path", $newPath, [System.EnvironmentVariableTarget]::User
   

Python dependencies¶

The following packages need to be downloaded and manually installed:

setuptools

http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe

pip

https://pip.pypa.io/en/latest/installing/

PyMySQL

http://codegood.com/download/10/

PyWin32

http://sourceforge.net/projects/pywin32/files/pywin32/Build%20217/pywin32-217.win32-py2.7.exe

Greenlet

http://www.lfd.uci.edu/~gohlke/pythonlibs/#greenlet

PyCryto

http://www.voidspace.org.uk/downloads/pycrypto26/pycrypto-2.6.win32-py2.7.exe

The following packages must be installed with pip:

• ecdsa
• amqp
• wmi

PS C:\> pip install ecdsa
PS C:\> pip install amqp
PS C:\> pip install wmi

Other dependencies¶

qemu-img is required for some of the image related operations. You can get it from here: http://qemu.weilnetz.de/. You must make sure that the qemu-img path is set in the PATH environment variable.

Some Python packages need to be compiled, so you may use MinGW or Visual Studio. You can get MinGW from here: http://sourceforge.net/projects/mingw/. You must configure which compiler is to be used for this purpose by using the distutils.cfg file in $Python27\Lib\distutils, which can contain:

[build]
compiler = mingw32

As a last step for setting up MinGW, make sure that the MinGW binaries’ directories are set up in PATH.

Download the nova code¶

1. Use Git to download the necessary source code. The installer to run Git on Windows can be downloaded here:

   https://github.com/msysgit/msysgit/releases/download/Git-1.9.2-preview20140411/Git-1.9.2-preview20140411.exe

2. Download the installer. Once the download is complete, run the installer and follow the prompts in the installation wizard. The default should be acceptable for the purposes of this guide.

   PS C:\> $src = "https://github.com/msysgit/msysgit/releases/download/Git-1.9.2-preview20140411/Git-1.9.2-preview20140411.exe"
   PS C:\> $dest = "$env:temp\Git-1.9.2-preview20140411.exe"
   PS C:\> Invoke-WebRequest –Uri $src –OutFile $dest
   PS C:\> Unblock-File $dest
   PS C:\> Start-Process $dest
   

3. Run the following to clone the nova code.

   PS C:\> git.exe clone https://git.openstack.org/openstack/nova
   

Install nova-compute service¶

To install nova-compute, run:

PS C:\> cd c:\nova
PS C:\> python setup.py install

Configure nova-compute¶

The nova.conf file must be placed in C:\etc\nova for running OpenStack on Hyper-V. Below is a sample nova.conf for Windows:

[DEFAULT]
auth_strategy = keystone
image_service = nova.image.glance.GlanceImageService
compute_driver = nova.virt.hyperv.driver.HyperVDriver
volume_api_class = nova.volume.cinder.API
fake_network = true
instances_path = C:\Program Files (x86)\OpenStack\Instances
glance_api_servers = IP_ADDRESS:9292
use_cow_images = true
force_config_drive = false
injected_network_template = C:\Program Files (x86)\OpenStack\Nova\etc\interfaces.template
policy_file = C:\Program Files (x86)\OpenStack\Nova\etc\policy.json
mkisofs_cmd = C:\Program Files (x86)\OpenStack\Nova\bin\mkisofs.exe
allow_resize_to_same_host = true
running_deleted_instance_action = reap
running_deleted_instance_poll_interval = 120
resize_confirm_window = 5
resume_guests_state_on_host_boot = true
rpc_response_timeout = 1800
lock_path = C:\Program Files (x86)\OpenStack\Log\
rpc_backend = nova.openstack.common.rpc.impl_kombu
rabbit_host = IP_ADDRESS
rabbit_port = 5672
rabbit_userid = guest
rabbit_password = Passw0rd
logdir = C:\Program Files (x86)\OpenStack\Log\
logfile = nova-compute.log
instance_usage_audit = true
instance_usage_audit_period = hour
use_neutron = True
[neutron]
url = http://IP_ADDRESS:9696
auth_strategy = keystone
admin_tenant_name = service
admin_username = neutron
admin_password = Passw0rd
admin_auth_url = http://IP_ADDRESS:35357/v2.0
[hyperv]
vswitch_name = newVSwitch0
limit_cpu_features = false
config_drive_inject_password = false
qemu_img_cmd = C:\Program Files (x86)\OpenStack\Nova\bin\qemu-img.exe
config_drive_cdrom = true
dynamic_memory_ratio = 1
enable_instance_metrics_collection = true
[rdp]
enabled = true
html5_proxy_base_url = https://IP_ADDRESS:4430

The table Description of hyperv configuration options contains a reference of all options for hyper-v.

Prepare images for use with Hyper-V¶

Hyper-V currently supports only the VHD and VHDX file format for virtual machine instances. Detailed instructions for installing virtual machines on Hyper-V can be found here:

Create Virtual Machines

Once you have successfully created a virtual machine, you can then upload the image to glance using the openstack-client:

PS C:\> openstack image create --name "VM_IMAGE_NAME" --property hypervisor_type=hyperv --public \
          --container-format bare --disk-format vhd

PS C:\> New-VHD DISK_NAME.vhd -SizeBytes VHD_SIZE

Inject interfaces and routes¶

The interfaces.template file describes the network interfaces and routes available on your system and how to activate them. You can specify the location of the file with the injected_network_template configuration option in /etc/nova/nova.conf.

injected_network_template = PATH_TO_FILE

A default template exists in nova/virt/interfaces.template.

Run Compute with Hyper-V¶

To start the nova-compute service, run this command from a console in the Windows server:

PS C:\> C:\Python27\python.exe c:\Python27\Scripts\nova-compute --config-file c:\etc\nova\nova.conf