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 logo with options to download aos_server_5.1.0-117.vhdx.gz file via localhost link or direct URL with copy button.
  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 expanded showing options to create Virtual Machine Hard Disk and Floppy Disk.
  6. Specify a VM name and location, then click Next.
    Step in New Virtual Machine Wizard in Hyper-V Manager titled Specify Name and Location; "Apstra" entered as name; option to store files in different location; warning about storage space for checkpoints; navigation buttons: Previous, Next, Finish.
  7. Specify Generation 1, then click Next.
    New Virtual Machine Wizard in Hyper-V Manager showing Specify Generation step with options for Generation 1 and Generation 2. Warning: VM generation cannot be changed later.
  8. Specify required memory based on your environment, then click Next.
    Assign Memory step in New Virtual Machine Wizard. Startup memory set to 65536 MB. Dynamic Memory option unchecked.
  9. Configure the virtual switch as required for your deployment environment, then click Next.
    Configure Networking step in New Virtual Machine Wizard in Hyper-V Manager. Network adapter connected to Intel Ethernet Connection X722 for 10GBASE-T Virtual Switch.
  10. Select Use an existing virtual hard disk and browse to the extracted file, then click Finish.
    New Virtual Machine Wizard at Connect Virtual Hard Disk step with Use an existing virtual hard disk option selected
  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 Apstra settings in Hyper-V Manager with 8 virtual processors selected.

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