Avi Vantage Installation on Nutanix Acropolis Hypervisor


Avi Vantage supports running in the Nutanix Acropolis hypervisor orchestrated by Prism. This guide walks through the steps required to install Avi Vantage in this environment.

Hardware Requirements for Virtual Machine

The resources suggested in this installation guide are minimum recommendations for a proof of concept. See also the hardware requirements KB for more sizing help.

  • Avi Controller: The Avi Controller needs at least 8 vCPUs and 24 GB memory. Also needed is a NIC for the management network. This is the network used for accessing the web interface. The Controller also uses this network to communicate with the Avi Service Engines (SEs).
  • SEs: Each SE needs at least 2 vCPUs and 2 GB memory. Also needed is a NIC for the management network as the first interface, and additional NICs for the data networks.

Software Requirement

  • Nutanix Acropolis 4.6+:  Prism is required for creating the Avi VMs. For more information on creating VMs on Nutanix, refer to Creating VMs.

Deploying Avi Controller

  1. Upload the Avi Controller image to the Prism Image Service. Select the Settings button at the top right and go to Image Configuration to upload the files. Provide the following information as shown below.
    • Name: Set the desired name
    • Image Type: Disk

    Nutanix Acropolis Avi Networks

  2. Create a virtual machine (VM) instance for Avi Controller from Prism. Provide the following details:
    • Name: Desired name
    • vCPUs: 1
    • Number of Cores per vCPU: 8 (or more)
    • Memory: 24 GB
    • Disks:
      • Remove CD-ROM
      • Add new Disk
      • Operation: Clone from Image Service
      • Image: Select the name of the image created in the previous steps
      • Size: Default to 64 GB
    • NIC > VLAN Name: Select a network that will be used for management.

    This network will be used for the access to the Controller by administrators and for Controller-to-Service Engine communication. For production environments this should be a static address.

    Note: For configuring networks and IP addresses for the Controller and SEs, usually, networks should be created beforehand (refer to step 8 in the Nutanix Acropolis 101: Creating VMs tutorial).

    Select that network when adding a vNIC to a Controller or SE. Based on how the network was originally set up, the IP address will be static or picked up via DHCP and assigned to the vNIC

  3. Power on the Controller VM. During the initial boot-up, the Controller will initialize databases and run through internal setup tasks (may take several minutes).

  4. Connect to the web interface of the Controller via https://[IP Address].
  5. Set up the Controller. From the GUI setup wizard, perform the initial configuration of the Controller. Provide a password, DNS, and set the Infrastructure Type to No-Orchestrator.

Deploying Avi Service Engine

  1. From the Avi UI, navigate to Infrastructure&& > **Clouds. Click the download icon shown on the right. A small prompt asks which type of SE image is desired, select qcow2. The Avi Controller creates the new SE image, which may take several minutes, depending on disk performance. Once the image is created it will automatically download to your browser.

  2. Upload the SE image to Prism > Image Creation > Upload Image Navigate to Image Creation > Upload Image to upload the SE image to the Prism. Provide the following information, while uploading the SE image.
    • Name
    • Image Type: Disk
    • Image Source: select the upload file option.


  3. Copy the authentication token: The new SE will be required to authenticate to the Controller by presenting a valid token that is generated by the Controller and placed on the SE. This token may be used only once, and expires if not used within one hour. Navigate to Infrastructure > Clouds. Click the key icon to generate a new token. Copy the token, which will be used at the end of the next step.

  4. Create the SE VM</strong> from Prism.See Illustration 4
  • Name
  • vCPUs: 1
  • Cores per vCPU: 2
  • Memory: 2 GB
  • Disks:
    • Remove CD-ROM
    • Add Disk:
      • Operation: Clone from Image Service
      • Image: Select the SE image name
      • Size: 10 GB
  • Network Adapters:
    • Create one NIC in the management network used by the Controller. This NIC is reserved for management.
    • Create additional NICs as necessary for access to client and server networks for load balancing traffic. Note that while the management network may be used for load-balanced traffic, it will require a second NIC configured for that network.
  • Custom Scripts: Paste the following information into this section. This info is used to tell the Service Engine about the Controller IP address and the auth token it should present. The auth token should have already been generated in step 3. See the graphic for an example.
    AVICNTRL: [Controller IP address]
    AVICNTRL_AUTHTOKEN: [Auth token]


Starting with Avi Vantage release 18.2.3, no-access cloud is supported for Nutanix Acropolis. Provide value for the following attributes in addition to the Avi Controller IP address and the authentication token. <ul>

  • Service Engine (SE) default gateway
  • SE management IP address
  • Subnet mask for SE's management IP address
  • </ul>
    AVICNTRL: [Controller IP address]
    AVICNTRL_AUTHTOKEN: [Auth token]
    avi.default-gw.SE: [SE Default Gateway]
    avi.mgmt-ip.SE:  [SE Management IP]
    avi.mgmt-mask.SE:  [SE Management IP mask]
  • Verify connectivity between the SE and Controller. Power on the SE VM. From the Controller, navigate to Infrastructure > Dashboard. The SE icon should be present and green.
  • Repeat as necessary to create any additional Service Engines.
  • </ol> </ol>

      Note: This document is based on Avi Vantage version 18.2.3 and Nutanix AHV version 2018.05.01