Warning
NOTICE: THIS DOCUMENTATION SITE HAS BEEN SUPERSEDED.
For the current documentation site goto: http://docs.cloudstack.apache.org
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.
For a smoother installation, gather the following information before you start:
Hyper-V Requiremen ts | Value | Description |
---|---|---|
Server Roles | Hyper-V | After the Windows Server 2012 R2 installation, ensure that Hyper-V is selected from Server Roles. For more information, see Installing Hyper-V. |
Share Location | New folders in the /Share director y | Ensure that folders are created for Primary and Secondary storage. The SMB share and the hosts should be part of the same domain. If you are using Windows SMB share, the location of the file share for the Hyper-V deployment will be the new folder created in the \Shares on the selected volume. You can create sub-folders for both PRODUCT Primary and Secondary storage within the share location. When you select the profile for the file shares, ensure that you select SMB Share -Applications. This creates the file shares with settings appropriate for Hyper-V. |
Domain and Hosts | Hosts should be part of the same Active Directory domain. | |
Hyper-V Users | Full control | Full control on the SMB file share. |
Virtual Switch | If you are using Hyper-V 2012 R2, manually create an external virtual switch before adding the host to PRODUCT. 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. |
|
Virtual Switch Name | Take a note of the name of the virtual switch. You need to specify that when configuring PRODUCT physical network labels. | |
Hyper-V Domain Users |
|
|
Migration | Migratio n | Enable Migration. |
Migration | Delegati on | If you want to use Live Migration, enable Delegation. Enable the following services of other hosts participating in Live Migration: CIFS and Microsoft Virtual System Migration Service. |
Migration | Kerberos | Enable Kerberos for Live Migration. |
Network Access Permission for Dial-in | Allow access | Allow access for Dial-in connections. |
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.
Note
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.
Create and add a self-signed SSL certificate on port 8250:
Create A self-signed SSL certificate:
# New-SelfSignedCertificate -DnsName apachecloudstack -CertStoreLocation Cert:\LocalMachine\My
This command creates the self-signed certificate and add that to
the certificate store LocalMachine\My
.
Add the created certificate to port 8250 for https communication:
netsh http add sslcert ipport=0.0.0.0:8250 certhash=<thumbprint> appid="{727beb1c-6e7c-49b2-8fbd-f03dbe481b08}"
Thumbprint is the thumbprint of the certificate you created.
Build the CloudStack Agent for Hyper-V as given in Building CloudStack Hyper-V Agent.
As an administrator, run the installer.
Provide the Hyper-V admin credentials when prompted.
When the agent installation is finished, the agent runs as a service on the host machine.
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.
CloudStack allows administrators to set up shared Primary Storage and Secondary Storage that uses SMB.
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.
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.
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.