Introduction
This install guide will walk you through the steps required to launch a NetFoundry Edge Router VM in your Azure Cloud VNet and assumes you have already created the Edge Router in your NetFoundry network and captured the registration one-time key.
Alternatively, you may be seeking
Video guide for Azure ER provisioning:
Launching an Azure Cloud VM
Sign in to your account on the Azure portal and go to → Resource groups.
- If you haven't already created a resource group "NetFoundry," do so now;
- Once inside the resource group, Click the "+ Add" button on the toolbar;
- Search for "NetFoundry Edge Router". Click on the result, the description should be shown.
Click the "Create" button to launch the wizard.
Enter basics information:
- Fill in the "Name", e.g. "NetFoundryEdgeRouter";
- VMdisk type, both are supported. PremiumSSD is default;
- Select your required availability options;
- Fill in the Username as "ziggy". The username can be of your choice.
- Fill in the SSH Public Key, if you don't already have a global key, or provide a password;
- Select your subscription;
- You can create a new resource group or select an existing one;
- Choose a location in which to launch the VM;
- On the "Advanced" tab in the field "Custom Data" enter this script, substituting the registration key from your clipboard
#!/bin/bash
/opt/netfoundry/router-registration registration key - In the NetFoundry console, confirm the Edge Router is REGISTERED within ten minutes.
Enter Sizing information. Select a size and click on "Select".
See Edge Router Sizing Guide for information on sizing.
Click on "Create" to launch the VM.
Advanced Registration Parameters
In the above example we used the most simple form of the router-registration command. Know more about the registration command and the parameters available for special cases such as configuring transit link listeners in How to Register the Edge Router VM.
Troubleshooting Registration
Most common causes for registration to fail in Azure are:
- Not having an IP assigned (correctly),
- not having a default IP route for internet access,
- not having a valid nameserver.
It may take up to 5 minutes to register and come online. Once the VM Instance has started up, switch back to the NetFoundry Console and locate the status of the associated Edge Router.
Confirm that the status indicator is green, which means that it has successfully registered and is online. If the status indicator is not "REGISTERED" then the VM failed to register.