Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
120 lines (83 sloc) 5.5 KB

Migration from AWS Marketplace Licensing Model to Metered/BYOL Licensing Model


Many customers start by trying our AWS Marketplace image that allows you to deploy 10 VPN Users or 5 Peering Tunnels. Those images are not flexible and cannot be extended beyond it's initial license. In order to exceed this limitations, the customer needs to move to a Metered AMI or BYOL License model. This document outlines all the steps necessary to execute the migration.

Note: This document also applies to migrating from an old controller to a new controller AMI within the same BYOL or Metered subscription.


  1. Existing Aviatrix AWS Marketplace instance deployed.
  2. We highly recommend migrating to Metered AMI as it is more flexible and scalable as your business needs change over time.
  3. For migration to a BYOL license model, please contact your Aviatrix Sales Account Manager to acquire the appropriate BYOL License.
  4. All Aviatrix controller should be running 3.2 (or later).

Step 1 - Enable Backup

On the existing Aviatrix Marketplace Controller, go to Settings-->Maintenance-->Upgrade tab and make sure you are running the latest version. If it is not the latest version, please perform Dry Run and upgrade the controller by following our Inline Software Upgrade.


Next, go to Settings--> Maintenance and select the Backup & Restore tab. Create an S3 bucket in your AWS account and copy the name on the corresponding field. Click Enable.


Note: If you already have Backup enabled, click Backup Now or disable and re-enable to make sure the backup is executed.
Confirm in your S3 bucket that the backup file has been updated with the latest timestamp.

Step 2 - Stop the Marketplace instance

Note: If the Controller has HA enabled, you must first disable the Controller HA

On the AWS console proceed to STOP the existing Aviatrix AWS Marketplace controller instance.

Step 3 - Disassociate EIP

On the AWS console, go to EC2-->Network & Security --> Elastic IPs, and disassociate the EIP from the existing Aviatrix AWS Marketplace controller instance.

Note: Make sure browser cache is cleared before the next Step,
to avoid connecting to an old stale session.

Step 4 - Launch Metered/BYOL Controller

Launch new Aviatrix Controller using the Metered AMI or BYOL License. Please refer to our AWS Startup Guide to subscribe to the Aviatrix AMI.

  1. Go to AWS Marketplace and search for the Aviatrix for Cloud Interconnect, Cloud Peering and VPN (BYOL) AMI.
  2. Launch the selected BYOL AMI in the same VPC and subnet as the existing controller.
  3. Select t2.large instance type (minimum requirement)
  • Auto-assign Public IP set to disable.
  • Storage = 20GB
  • IAM role = aviatrix-role-ec2
  • Enable termination protection = checked
  • T2/T3 unlimited = Enable
  1. Assign the same Security Group on the existing controller to this NEW controller.

Step 5 - Attach EIP

On the AWS console, go to EC2-->Network & Security --> Elastic IPs, associate the same EIP from step 3 to the new Aviatrix Metered/BYOL Controller.

Step 6 - Upgrade Controller

Make sure your new Aviatrix Controller is upgraded to same version (latest) by validating it at Settings-->Maintenance-->Upgrade tab. Please note that Aviatrix only supports controller backup and restore within the same software version. In this example, the previous controller is upgraded to the latest 3.3.402 at the time of this writing. The following screenshot shows that the new controller is running the latest 3.3.402 as well.


Step 7 - Restore

On the new Aviatrix Controller, go to Settings--> Maintenance and select the Backup & Restore tab. Insert the right S3 bucket name and execute a restore.


Step 8 - Install License

On the on-boarding page, enter the customer id provided by your Aviatrix Sales Account Manager.


Note: You may need to re-enter your BYOL Customer ID after controller restore operation. We also suggest that you backup the latest configuration by clicking the Backup Now button at Settings-->Maintenance-->Backup & Restore tab.

Step 9 - Enjoy your new controller

Optional: After confirming everything is running correctly,
delete the previous Aviatrix AWS Marketplace controller instance.

For support, send email to

.. disqus::