Azure Getting Started Guide

​

Prerequisites

​

Azure Simple Product Launch Overview

• Creation of a VNet for Controller and CoPilot (or you can select an existing VNet)
• Deployment and configuration of IAM
• Deployment of Controller and CoPilot into an existing or newly created VNet
• Creation of network security groups securing platform access to only your IP
• Initialization of Controller and CoPilot to current version
• Configuration and integration between Controller and CoPilot

​

Required Aviatrix License and Marketplace Offers

​

Launch Step Details

​

Step 1: Register an Aviatrix License

1. In the Launch Aviatrix licensing window, do one of the following:
   • If you need a license, click your preferred CSP Marketplace to open the Marketplace listing in a separate tab and continue to the next step.
   • If you already have a license, enter the key in the License Key field and skip to Platform Subscription.
   You received the key in an email when you originally registered. The key is not retained anywhere else. If you do not have the key, contact your account manager.
2. On the Aviatrix Enterprise Contract page, review the Plans + Pricing and click Get It Now. All plans start with a 30-day free trial.
3. Read and accept the acknowledgment notice and click Continue.
4. On the Aviatrix Enterprise Contract page, select the Plan you want and click Subscribe.
5. On Subscribe To Aviatrix Enterprise Contract, enter the name for a new resource group and verify the resource group location.
6. Enter a descriptive name for the SaaS subscription and click Review + Subscribe.
7. Review the subscription details and click Subscribe.
8. When the subscription process completes, click Configure account now. You will be redirected back to Launch Aviatrix.
9. Enter your business email address and click Verify Email. An email is sent to you from [email protected] that contains a verification code.
10. Copy the code from the email, enter it in the field in Launch Aviatrix, and then click Next. A success page displays and shows your unique license key. This key and a subscription ID are also emailed to you.
11. Click Next.

​

Step 2: Platform Subscription

1. Click Next.

​

Step 3: Configuration

1. Select the Azure region for deployment.
2. Confirm that the IP address you are currently using is displayed in the IP field. Your IP address populates automatically based on your client IP. The /32 is appended to the address to ensure that only the IP that initiated provisioning can initially access the Controller and CoPilot UIs. If needed, you can change the IP address after provisioning is complete.
3. Click Next.
4. Select whether an existing VNet or a new VNet should be used for deployment. If you choose an existing VNet, then during deployment you will be able to select which VNet and subnet to use. If you choose a new VNet, the VNet and Resource Group are automatically created for you during deployment.

​

Step 4: Deployment

• Installed the Azure CLI.
• Installed a minimum version of Python3.
• Installed a minimum version of Terraform 0.13.

• Name of the target resource group in your target region
• Name of the VNet in the resource group
• Name of the subnet in the VNet
• Subnet ID of the subnet
  If you need assistance locating the required VNet information in the Azure portal, see Information Required for Azure Deployment to an Existing VNet.

1. Click Download Terraform Configuration File to download aviatrix-launch.tf.
2. Modify the following lines in the aviatrix-launch.tf file and save the file:
   Copy

   Ask AI

   resource_group_name = "CHANGEME"  # Put your resource group name
   vnet_name           = "CHANGEME"  # Put your VNet name
   subnet_name         = "CHANGEME"  # Put your Subnet name
   subnet_id           = "CHANGEME"  # Put your subnet ID
   
   For steps to get this information in the Azure portal, see Information Required for Azure Deployment to an Existing VNet.
3. In a terminal window, run the following commands in the directory in which you saved the TF file:
   1. Log in to Azure.
      Copy

      Ask AI

      az login
      
      In the terminal output, you will need to select the Azure subscription to associate with the Aviatrix account.
   2. Initialize Terraform.
      Copy

      Ask AI

      terraform init
      
   3. Preview a list of the changes (execution plan) Terraform will implement.
      Copy

      Ask AI

      terraform plan
      
      If you get a message about the -out option, you can safely ignore it and continue.
   4. Apply the changes and enter Yes when requested.
      Copy

      Ask AI

      terraform apply
      
      The terraform apply command previews the execution plan again. You can use the —auto-approve option to apply the execution plan without a second confirmation.
      It takes about 14 minutes for the Terraform process to complete.
4. Copy and save the output that results from the Terraform execution. Example: "Copilot_management_login" = <"https://172.31.255.255/"> "password" = <";a1wkE:P#mad3,*f"> "username" = "admin" You will use this information to log in to the Aviatrix Platform.

​

Access the CoPilot UI

1. In a browser window, enter the IP address for Copilot_management_login that you copied from the Terraform output. Example: “Copilot_management_login” = <“https://172.31.255.255/”\>
2. In the CoPilot login window, enter your credentials:
   • Username: The default is admin.
   • Password: Use the password from the Terraform output.
   Example: “password” = <“;a1wkE:P#mad3,*f”>

​

Next Steps