Install Apstra DCD on Hyper-V

These instructions are for installing Apstra DCD software on a Microsoft Hyper-V hypervisor. For information about using Hyper-V in general, refer to Microsoft's Hyper-V documentation.

  1. Confirm that you're running one of the Supported Hypervisors and Versions.
  2. Make sure that you allocate enough resources for your network. For example, if you're using more than 25 offbox agents, you'll need to add another VM. See Required Server Resources for more details.
    CAUTION:

    If you allocate insufficient CPU and RAM allocations for your network you'll probably experience issues such as slow response times, system errors and a critical "segmentation fault" (core dump). If this happens, you'll need to delete the VM and redeploy it with additional resources.
  3. Apstra DCD software is delivered pre-installed on a single VM. The same Apstra DCD VM image is used for installing both the Apstra DCD controller and Apstra DCD workers. As a registered support user, download the Apstra DCD VM VHDX Image for Microsoft Hyper-V from the Support Downloads page.
  4. Uncompress the disk image and move it to where it will run.
  5. Start Hyper-V Manager, select the server for the VM and navigate to Actions > New > Virtual Machine. The New Virtual Machine Wizard opens.
  6. Specify a VM name and location, then click Next.
  7. Specify Generation 1, then click Next.
  8. Specify required memory based on your environment, then click Next.
  9. Configure the virtual switch as required for your deployment environment, then click Next.
  10. Select Use an existing virtual hard disk and browse to the extracted file, then click Finish.
  11. Click Settings (right panel), click Processor (left panel), specify the number of virtual processors based on required VM resources, then click OK.

You're ready to configure the Apstra DCD server. (When the Apstra DCD server is configured, the Docker daemon runs properly.)