Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Install Apstra on Hyper-V

These instructions are for installing Apstra 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 software is delivered pre-installed on a single VM. The same Apstra VM image is used for installing both the Apstra controller and Apstra workers. As a registered support user, download the Apstra VM VHDX Image for Microsoft Hyper-V from Juniper Support Downloads.
    Juniper Networks download page with instructions to download a file using a link or URL. Includes a copy button for the URL.
  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.
    Hyper-V Manager interface with Action menu open and New submenu showing options: Virtual Machine, Hard Disk, Floppy Disk. No virtual machines listed.
  6. Specify a VM name and location, then click Next.
    Specify Name and Location step in Hyper-V Manager's New Virtual Machine Wizard with name "Apstra" entered. Warning: Ensure sufficient storage for checkpoints.
  7. Specify Generation 1, then click Next.
    New Virtual Machine Wizard in Hyper-V Manager showing Specify Generation step with options Generation 1 and Generation 2. Warning: Once created, generation cannot be changed.
  8. Specify required memory based on your environment, then click Next.
    New Virtual Machine Wizard on Assign Memory step with startup memory set to 65536 MB and dynamic memory option available.
  9. Configure the virtual switch as required for your deployment environment, then click Next.
    Configure Networking section in New Virtual Machine Wizard showing Intel Ethernet Connection X722 for 10GBASE-T - Virtual Switch selected.
  10. Select Use an existing virtual hard disk and browse to the extracted file, then click Finish.
    Connect Virtual Hard Disk screen in New Virtual Machine Wizard for Hyper-V. User selects Use an existing virtual hard disk with location set to C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks\
  11. Click Settings (right panel), click Processor (left panel), specify the number of virtual processors based on required VM resources, then click OK.
    Virtual machine settings interface for Apstra showing processor configuration with 8 virtual processors and resource control options.

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