Edge Spoke Gateway Deployment Workflow on Equinix Network Edge

This document provides instructions for deploying a primary and secondary highly available (HA) Edge Spoke Gateways on the Equinix Network Edge.

For an overview of Aviatrix Edge, see About Aviatrix Hybrid Cloud Edge.

Topology

The following diagram shows an example of network connectivity for Aviatrix Edge Spoke Gateway to Transit Gateway in AWS. This topology shows Aviatrix Edge Spoke Gateway connection to an upstream WAN router which is used to terminate CSP underlay private connections.

650

The topology below shows Aviatrix Edge Spoke Gateway used to terminate CSP underlay private connections (which does not require upstream WAN router).

650
Aviatrix Edge Spoke Gateway requires the latest versions of Aviatrix Controller 7.1 and Aviatrix Edge Image 7.1 to support BGP underlay connectivity to CSP.

Prerequisites

Before you can deploy an Aviatrix Edge Spoke Gateway on the Equinix platform, you must perform the prerequisite steps to set up an Equinix account, a Network Service Provider (NSP) platform account, and provide network access.

For instructions to perform these prerequisite steps, see Prerequisites for Edge Spoke Gateway Deployment on Equinix Network Edge.

Edge Spoke Gateway Deployment Workflow in Equinix

To deploy Aviatrix Edge Spoke Gateway, first you need to procure and onboard your edge device on the platform of your choice (see Prerequisites for Edge Spoke Gateway Deployment on Equinix Network Edge). Next, you deploy the Aviatrix Edge Gateway on the edge device and attach the Edge Gateway to the Aviatrix Transit Gateway for cloud connectivity. Then, configure the Edge Gateway for LAN-side connectivity.

This workflow provides the steps to create a primary and secondary (HA) Edge Gateway in Equinix Network Edge. It also provides the steps to attach the Edge Gateways to a Transit Gateway and connect the Edge Gateways to an external device, such as a LAN BGP router.

  1. Create and deploy the primary Edge Gateway.

  2. Create and deploy the secondary HA Edge Gateway.

  3. Attach the primary Edge Gateway to the Transit Gateway.

  4. Connect the primary Edge Gateway to the external device.

Creating the ZTP Cloud-Init for the Primary Edge Spoke Gateway (Equinix)

The Edge Gateway cloud-init ZTP file is used to provision the Edge Gateway virtual machine and create the Edge Gateway in Equinix Fabric.

To create the primary Edge Spoke Gateway, follow these steps.

Step 1: Gateway Configuration

  1. In CoPilot, go to Cloud Fabric > Hybrid Cloud > Edge Gateways tab.

  2. Click Spoke Gateways, then click + Spoke Gateway and provide the following information.

    Field

    Description

    Name

    Name for the Edge Gateway.

    The name must start with a letter and contain only letters, numbers, and dashes (no special characters or spaces) and it can be up to 50 characters long.

    Platform

    The platform account where you want to deploy the Edge Gateway.

    You can create and edit platform accounts in CoPilot by going to Cloud Fabric > Hybrid Cloud > Platforms tab.

    See Set Up the Aviatrix Edge Platform Account.

    Site

    Identifies the edge location.

    You can select an existing name or enter a new name for the edge location.

    See Edge site.

    ZTP File Type

    This is set to cloud-init.

    High Availability

    High Availability is set to Off for the primary Edge Gateway.

    You can turn High Availability to On after the primary Edge Gateway is created.

    See Edge Spoke Gateway High Availability.

  3. Click Next to configure the edge gateway interfaces.

Step 2: Interface Configuration

By default, an Edge Spoke Gateway has three interfaces: one WAN interface, one LAN interface, and one Management interface. You can configure multiple WAN interfaces on the Edge Gateway, as needed. You will need these configuration information to configure the interfaces.

In the Interface Configuration section, configure the WAN, LAN, and Management interfaces for the Edge Gateway.

Configuring the WAN Interface

You can configure multiple WAN interfaces on the Edge Gateway. While up to 8 WAN interfaces is supported, Aviatrix recommends a maximum of 4 WAN interfaces per Edge Gateway.

  1. Click + WAN Interface, then provide the following information.

    Field

    Description

    Interface

    This is set to the Edge Gateway’s logical interface.

    Adding multiple WAN interfaces is applicable when the Edge Gateway is set up for BGP underlay to cloud service provider (CSP).

    Add an interface per CSP underlay (such as Direct Connect or Express Route).

    When Edge Gateway is not terminating CSP underlay, use one interface per Edge Gateway to connect to upstream router.

    Interface Labels

    Name to identify the WAN interface.

    BGP

    Enables BGP underlay connection to cloud service provider (CSP) on the WAN interface.

    Set BGP toggle On to set up BGP connection to cloud routers such as VGW, VNG, and Google cloud router.

    Edge Gateway WAN support for BGP underlay to CSP is supported for AWS, Azure, and GCP.

    Interface Primary CIDR

    The CIDR for the WAN interface.

    DHCP for dynamic IP address assignment is not supported.

    Interface CIDR must be in the format interface_ip/netmask (for example, 192.18.20.1/24).

    Interface CIDR cannot be link-local CIDR.

    If you need to create a BGP underlay connection to cloud service provider (CSP) with a link-local IP address, you must enter the link-local IP address in the Link-local Underlay CIDR setting of the WAN interface.

    Default Gateway IP

    The Default Gateway IP address for the WAN interface.

    For CSP underlay, this is the remote side IP address of the BGP session on CSP VNG or VGW.

    Public IP

    The public IP for the WAN interface.

    The public IP of the WAN interface is used for peering connections over the public network.

  2. If BGP is turned On, provide the following information:

    Field

    Description

    Link-Local Underlay CIDR (GCP only)

    The Link-Local Underlay CIDR is used for BGP underlay connections to cloud service provider (CSP).

    If you need to create a BGP underlay connection to CSP with a link-local IP address, you must provide the Link-Local Underlay CIDR for the WAN interface in the format of link_local_underlay_ip/netmask (for example 169.254.100.3/24).

    This is required for GCP. If terminating GCP Interconnect and using BGP underlay on Edge, provide the WAN Default Gateway of the peer IP address.

    If Link-Local Underlay CIDR is configured, the Default Gateway IP should be in the same subnet as the Link-Local Underlay CIDR, otherwise, it should be in the same subnet as the WAN Interface CIDR.

    Remote ASN

    The AS Number of the CSP side peering connection such as private VIF on VGW (AWS) and VNG ASN (Azure).

    Local LAN IP

    The IP address of the Edge Gateway. This is the local peering PTP IP for BGP.

    Remote LAN IP

    The IP address of the CSP VNG or VGW peering PTP IP. (GCP is not supported).

    Password (optional)

    The MD5 authentication key.

  3. If BGP is turned On, in Gateway Configuration, enter the Local AS Number of the Edge Gateway.

  4. To add another WAN interface, click + WAN again and provide the required information.

    To change or update the Edge Gateway WAN connectivity to Transit Gateway, you will need to first detach the Edge-to-Transit gateway attachment, if there is an attachment.

Configuring the LAN Interface

To configure the Edge Gateway LAN interface, click + LAN Interface, then provide the following information.

Field

Description

Interface

The Edge Gateway’s logical interface name.

Interface Labels

Name to identify the LAN interface.

Interface CIDR

The CIDR for the LAN interface.

DHCP for dynamic IP address assignment is not supported.

Default Gateway IP

(Optional) The Default Gateway IP address for the LAN interface.

Configuring the MGMT Interface

To configure the Edge Gateway Management interface:

  1. Click MGMT, then click + MGMT Interface.

  2. Leave the default settings and click Save.

    Leave the Private Network setting to Off. In the Equinix Platform, the Management interface of the Edge Gateway is assigned the public IP address that is allocated by Equinix.

  3. To create the ZTP cloud-init image file, click Done.

    CoPilot downloads the ZTP cloud-init file to your downloads folder.

    Next, log in to your Equinix Portal and deploy the Edge Gateway VM instance and attach the cloud-init image file to complete the Edge Gateway creation and authentication with the Aviatrix Controller.

    The cloud-init file is valid for 24 hours after you create it, so you must launch an Edge VM and deploy the Edge Gateway on the Equinix platform within that time. You will not be able to download the file again and will have to repeat the steps to recreate a new cloud-init file.

Step 3: Deploy the Edge Gateway in Equinix Network Edge

See, Deploying the Edge Gateway in Equinix Network Edge.

Step 4: Verify the Edge Gateway Creation

See, Verifying the Edge Gateway Creation.

Creating the ZTP Cloud-Init for the Secondary Edge Gateway (Equinix)

  • Before you can create the secondary highly available (HA) Edge Gateway, the primary Edge Gateway must be deployed and its status must be Up.

  • When creating the HA Edge Gateway, the primary Edge Gateway cannot have BGP underlay or BGP over LAN external connections. This does not apply when multiple Edge Gateways are created in the same site without HA configuration.

  • Edge Gateway high availability on the Equinix Platform is supported on the latest Aviatrix Controller release version.

To create a highly available secondary (HA) Edge Gateway, follow these steps.

Step 1: Gateway Configuration

  1. Go to Cloud Fabric > Hybrid Cloud > Edge Gateways tab.

  2. Click Spoke Gateways

  3. In the table, locate the primary Edge Gateway for which you want to create the HA gateway and click its Edit icon.

  4. In Edit Edge Gateway, from the High Availability dropdown menu, select Active-Active or Active-Standby mode.

  5. Click Next to configure the edge gateway interfaces.

Step 2: Interface Configuration

In Interface Configuration, configure the WAN, LAN, and Management interfaces of the secondary (HA) Edge Gateway.

Configuring the WAN Interface

To configure the WAN interface, click + WAN Interface, then provide the following information.

Field

Description

Interface

This is set to the Edge Gateway’s logical interface.

Adding multiple WAN interfaces is applicable when the Edge Gateway is set up for BGP underlay to cloud service provider (CSP).

Add an interface per CSP underlay (such as Direct Connect or Express Route).

When Edge Gateway is not terminating CSP underlay, use one interface per Edge Gateway to connect to upstream router.

Interface Labels

Name to identify the WAN interface.

BGP

Enables BGP underlay connection to cloud service provider (CSP) on the WAN interface.

Set BGP toggle On to set up BGP connection to cloud routers such as VGW, VNG, and Google cloud router.

Edge Gateway WAN support for BGP underlay to CSP is supported for AWS, Azure, and GCP.

Interface Primary CIDR

The CIDR for the WAN interface.

DHCP for dynamic IP address assignment is not supported.

Interface CIDR must be in the format interface_ip/netmask (for example, 192.18.20.1/24).

Interface CIDR cannot be link-local CIDR.

If you need to create a BGP underlay connection to cloud service provider (CSP) with a link-local IP address, you must enter the link-local IP address in the Link-local Underlay CIDR setting of the WAN interface.

Default Gateway IP

The Default Gateway IP address for the WAN interface.

For CSP underlay, this is the remote side IP address of the BGP session on CSP VNG or VGW.

Public IP

The public IP for the WAN interface.

The public IP of the WAN interface is used for peering connections over the public network.

If BGP is turned On, provide the following information:

Field

Description

Link-Local Underlay CIDR (GCP only)

The Link-Local Underlay CIDR is used for BGP underlay connections to cloud service provider (CSP).

If you need to create a BGP underlay connection to CSP with a link-local IP address, you must provide the Link-Local Underlay CIDR for the WAN interface in the format of link_local_underlay_ip/netmask (for example 169.254.100.3/24).

This is required for GCP. If terminating GCP Interconnect and using BGP underlay on Edge, provide the WAN Default Gateway of the peer IP address.

If Link-Local Underlay CIDR is configured, the Default Gateway IP should be in the same subnet as the Link-Local Underlay CIDR, otherwise, it should be in the same subnet as the WAN Interface CIDR.

Remote ASN

The AS Number of the CSP side peering connection such as private VIF on VGW (AWS) and VNG ASN (Azure).

Local LAN IP

The IP address of the Edge Gateway. This is the local peering PTP IP for BGP.

Remote LAN IP

The IP address of the CSP VNG or VGW peering PTP IP. (GCP is not supported).

Password (optional)

The MD5 authentication key.
To change or update the Edge Gateway WAN connectivity to Transit Gateway, you will need to first detach the Edge-to-Transit gateway attachment, if there is an attachment.

Configuring the LAN Interface

To configure the LAN interface, click LAN, then provide the following information.

Field

Description

Interface

The Edge Gateway’s logical interface name.

Interface Labels

Name to identify the LAN interface.

Interface CIDR

The CIDR for the LAN interface.

DHCP for dynamic IP address assignment is not supported.

Default Gateway IP

(Optional) The Default Gateway IP address for the LAN interface.

Configuring the Management Interface

To configure the Edge Gateway Management interface:

  1. Click MGMT, then click + MGMT Interface.

  2. Leave the default settings and click Save.

    Leave the Private Network setting to Off. In the Equinix Platform, the Management interface of the Edge Gateway is assigned the public IP address that is allocated by Equinix.

  3. To create the ZTP cloud-init image file, click Done.

    CoPilot downloads the ZTP cloud-init file to your downloads folder.

    Next, log in to your Equinix Portal and deploy the Edge Gateway VM instance and attach the cloud-init image file to complete the Edge Gateway creation and authentication with the Aviatrix Controller.

    The cloud-init file is valid for 24 hours after you create it, so you must launch an Edge VM and deploy the Edge Gateway on the Equinix platform within that time. You will not be able to download the file again and will have to repeat the steps to recreate a new cloud-init file.

Step 3: Deploy the Edge Gateway in Equinix Network Edge

See, Deploying the Edge Gateway in Equinix Network Edge.

Step 4: Verify the Edge Gateway Creation

See, Verifying the Edge Gateway Creation.

Next, attach the Edge Gateway to the Transit Gateway.

Attaching Edge Spoke Gateway to Transit Gateway

To attach an Edge Spoke Gateway to a Transit Gateway, perform the prerequisites then create the attachment.

Prerequisites

Before you create the attachment:

  1. Ensure Local ASN Number is configured on Edge and Transit Gateway.

  2. If the Edge to Transit Gateway attachment is over public network, you need to update the WAN Public IP on the Edge Gateway.

    1. Go to Cloud Fabric > Hybrid Cloud > Edge Gateways tab.

    2. Click Spoke Gateways.

    3. Locate the Edge Gateway, and click its Edit icon on the right.

    4. In Edit Edge Gateway, go to Interface Configuration and click WAN.

    5. In Public IP, click Discover.

      edge discover public ip

    6. Verify the WAN Public IP and click Save.

Attach Edge Spoke Gateway to Transit Gateway

  • To create a High Performance Encryption mode attachment, make sure the Transit Gateway is created with High Performance Encryption enabled.

  • If you want Jumbo Frame enabled on the Edge Gateway, make sure to enable Jumbo Frame on the Edge Gateway before you attach it to the Transit Gateway.

To create the attachment:

  1. In Aviatrix CoPilot, go to Cloud Fabric > Hybrid Cloud > Edge Gateways tab.

  2. Click Spoke Gateways.

  3. Locate the Edge Gateway, and click Manage Gateway Attachments icon on the right side of the row.

  4. In Manage Gateway Attachments > Transit Gateway tab, click +Attachment and provide the following information.

    Field

    Description

    Transit Gateway

    From the dropdown menu, select the Transit Gateway you want to attach to the Edge Transit Gateway.

    Local Edge Gateway Interface

    From the dropdown menu, select the WAN interface of the local Edge Gateway.

    Attach Over

    From the dropdown menu, select whether the connection between the Edge Gateways is over a Private Network or the Public Network.

    Jumbo Frame

    If you want to use Jumbo Frames for the connection between the Edge Gateways, set Jumbo Frame toggle to On.

    Jumbo Frame option is applicable when the attachment is over a private network.

    High Performance Encryption

    If you want to enable High Performance Encryption (HPE) for the connection between the Edge Gateways, set High Performance Encryption toggle to On.

    Number of Tunnels

    From the dropdown menu, select the number of HPE tunnels to create.

    • Max Tunnels creates the maximum tunnels based on the gateway sizes and the number of interface IPs on the peering gateway.

      This option is available only for connection over a private network.

    • Custom allows you to specify the number of tunnels to create.

  5. To attach the Edge Gateway to another Transit Gateway, click + Attachment again and provide the required information.

    You can attach an Edge Gateway to multiple Transit Gateways. Each attachment can be configured with different parameters, such as connecting interfaces, connection over private or public network, high-performance encryption, and Jumbo Frame.

  6. Click Save.

Connecting Edge Spoke Gateway to an External Device (BGP over LAN)

For LAN-side connectivity, you can connect the Edge Spoke Gateway to an external device, such as a LAN BGP router.

To connect the Edge Gateway to the LAN BGP router, follow these steps.

  1. In CoPilot, navigate to Networking > Connectivity > External Connections (S2C) tab.

  2. From + External Connection To dropdown menu, select External Device, then provide the following information.

    Field

    Description

    Name

    Name to identify the connection to the LAN router.

    Connect Using

    Select BGP.

    Type

    Select LAN.

    Local Gateway

    The Edge Gateway that you want to connect to the LAN router.

    Local ASN

    The Local AS number that the Edge Gateway will use to exchange routes with the LAN router.

    This is automatically populated if the Edge Gateway is assigned an ASN already.

  3. In LAN Configuration, provide the following information.

    Field

    Description

    Remote ASN

    The BGP AS number that is configured on the LAN router.

    Remote LAN IP

    The IP address of the LAN router.

    Local LAN IP

    This is automatically populated with the Edge Gateway’s LAN interface IP address.

  4. Click Save.