Host Hyper-V Installation

If you want to use Hyper-V hypervisor to run guest virtual machines, install Hyper-V on the hosts in your cloud. The instructions in this section doesn’t duplicate Hyper-V Installation documentation. It provides the CloudStack-specific steps that are needed to prepare a Hyper-V host to work with CloudStack.

System Requirements for Hyper-V Hypervisor Hosts

Supported Operating Systems for Hyper-V Hosts

  • Windows Server 2012 R2 Standard
  • Windows Server 2012 R2 Datacenter
  • Hyper-V 2012 R2

Minimum System Requirements for Hyper-V Hosts

  • 1.4 GHz 64-bit processor with hardware-assisted virtualization.
  • 800 MB of RAM
  • 32 GB of disk space
  • Gigabit (10/100/1000baseT) Ethernet adapter

Supported Storage

  • Primary Storage: Server Message Block (SMB) Version 3, Local
  • Secondary Storage: SMB

Preparation Checklist for Hyper-V

For a smoother installation, gather the following information before you start:

Hyper-V Installation Steps

  1. Download the operating system from Windows Server 2012 R2.
  2. Install it on the host as given in Install and Deploy Windows Server 2012 R2.
  3. Post installation, ensure that you enable Hyper-V role in the server.
  4. If no Active Directory domain exists in your deployment, create one and add users to the domain.
  5. In the Active Directory domain, ensure that all the Hyper-v hosts are added so that all the hosts are part of the domain.
  6. Add the domain user to the following groups on the Hyper-V host: Hyper-V Administrators and Local Administrators.

Installing the CloudStack Agent on a Hyper-V Host

The Hyper-V Agent helps CloudStack perform operations on the Hyper-V hosts. This Agent communicates with the Management Server and controls all the instances on the host. Each Hyper-V host must have the Hyper-V Agent installed on it for successful interaction between the host and CloudStack. The Hyper-V Agent runs as a Windows service. Install the Agent on each host using the following steps.

CloudStack Management Server communicates with Hyper-V Agent by using HTTPS. For secure communication between the Management Server and the host, install a self-signed certificate on port 8250.


The Agent installer automatically perform this operation. You have not selected this option during the Agent installation, it can also be done manually as given in step 1.

  1. Create and add a self-signed SSL certificate on port 8250:

    1. Create A self-signed SSL certificate:

      # New-SelfSignedCertificate -DnsName apachecloudstack -CertStoreLocation Cert:LocalMachineMy

      This command creates the self-signed certificate and add that to the certificate store LocalMachine\My.

    2. Add the created certificate to port 8250 for https communication:

      netsh http add sslcert ipport= certhash=<thumbprint> appid="{727beb1c-6e7c-49b2-8fbd-f03dbe481b08}"

      Thumbprint is the thumbprint of the certificate you created.

  2. Build the CloudStack Agent for Hyper-V as given in Building CloudStack Hyper-V Agent.

  3. As an administrator, run the installer.

  4. Provide the Hyper-V admin credentials when prompted.

    When the agent installation is finished, the agent runs as a service on the host machine.

Physical Network Configuration for Hyper-V

You should have a plan for how the hosts will be cabled and which physical NICs will carry what types of traffic. By default, CloudStack will use the device that is used for the default route.

If you are using Hyper-V 2012 R2, manually create an external virtual switch before adding the host to CloudStack. If the Hyper-V host is added to the Hyper-V manager, select the host, then click Virtual Switch Manager, then New Virtual Switch. In the External Network, select the desired NIC adapter and click Apply.

If you are using Windows 2012 R2, virtual switch is created automatically.

Storage Preparation for Hyper-V (Optional)

CloudStack allows administrators to set up shared Primary Storage and Secondary Storage that uses SMB.

  1. Create a SMB storage and expose it over SMB Version 3.

    For more information, see Deploying Hyper-V over SMB.

    You can also create and export SMB share using Windows. After the Windows Server 2012 R2 installation, select File and Storage Services from Server Roles to create an SMB file share. For more information, see Creating an SMB File Share Using Server Manager.

  2. Add the SMB share to the Active Directory domain.

    The SMB share and the hosts managed by CloudStack need to be in the same domain. However, the storage should be accessible from the Management Server with the domain user privileges.

  3. While adding storage to CloudStack, ensure that the correct domain, and credentials are supplied. This user should be able to access the storage from the Management Server.