This install guide will walk you through the steps required to launch a NetFoundry gateway instance in your Azure VNET.
Launching a gateway instance
Installing a NetFoundry gateway into your AWS VPC is very straight forward. NetFoundry includes a CloudFormation template to launch a new gateway instance with only a few steps:
- Create a gateway in the NetFoundry console
- Launch a NetFoundry gateway instance inside of your AWS VPC
- Confirm the gateway registers with your NetFoundry network from the console
Step 1: Create an Azure Cloud gateway in the NetFoundry Console
- Sign in to your NetFoundry organization.
- Navigate to the Gateways page, and create a new Azure Cloud gateway. Give it a name and location, then click the Create button.
Step 2: Launch a NetFoundry gateway instance inside of your Azure VNET
1. Sign in to your account on the Azure portal.
2. Go to → Resource groups.
3. If you haven't already created a resource group "NetFoundry", do so now.
4. Once inside the resource group, Click the "+ Add" button on the toolbar.
5. Search for "NetFoundry Cloud Gateway".
6. Click on the result, the description should be shown.
7. Click the "Create" button to launch the wizard
- Fill in the "Name", Example: NetFoundryGW
- VMdisk type, both are supported. PremiumSSD is default
- Select the required availability option
- Fill in the Username as "nfadmin"
- 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 to launch.
- Click on "OK" to continue
The username must be "nfadmin" to gain access to this gateway.
8. Select a size and click on "Select"
9. Finalize the details, and click "Ok" to continue.
10. Click on "Create" to launch the gateway
11. Once the resource is created, go to the resource group & click on the virtual machine name to view the details. Locate the machine's public IP address
12. Using an SSH client, log in to the machine using its public IP address as the user "nfadmin", using the SSH key specified earlier.
ssh -i private_key nfadmin@<public IP address>
13. Once you have are logged in to the gateway, run these commands to register it to your NetFoundry Network. Look for errors in the registration process output, or "Success" if registration completes successfully.
> sudo /opt/dispersive/dvn/nfnreg [registration key]
> sudo systemctl status dvn.service
14. Validate that the VM is now active on the NetFoundry Network with "
sudo systemctl status dvn.service". The output should report "ACTIVE".
Most common causes for registration to fail are: Not having an IP assigned (correctly), Not having a working default gateway for Internet access, Not having a valid DNS resolver.
Step 3: Confirm the gateway registers with your NetFoundry Network from the console
It may take up to 5 minutes to register and come online. Once the gateway instance has started up, switch back to the NetFoundry Console and locate the gateway endpoint.
Confirm that the status indicator is green, which means that it has successfully registered and is online. If the status indicator remains grey, then the gateway has failed to register. If it is red, the gateway has registered, but is offline.