This install guide will walk you through the steps required to launch a NetFoundry Gateway instance in your Azure Stack.
Launching a Gateway Instance
Installing a NetFoundry Gateway into your Azure VNET is very straight forward. NetFoundry includes a CloudFormation Template to launch a new gateway instance with only a few steps:
Step 1: Create an Azure Stack Gateway in the NetFoundry Console
- Sign in to your NetFoundry organization;
- Navigate to the Gateways page, and create a new Azure Stack gateway. Give it a name and location, then click the Create button;
- Take note of the registration key. You will need it to register the gateway in step 3.
Step 2: Launch a NetFoundry Gateway Instance Inside of Your Azure Stack
- 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 Azure Application Connection Gateway". 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. "NetFoundryGW";
- VMdisk type, both are supported. PremiumSSD is default;
- Enter the Username as "nfadmin". The username must be "nfadmin" to gain access to this gateway;
- Enter your SSH Public Key, if you don't already have a global key or, provide a password;
- Select your subscription;
- Create a new resource group or select an existing one;
- Choose a location in which to launch the gateway;
Click on "OK" to continue.
Enter Sizing information. Select a size and click on "Select".
See Edge Gateway Sizing Guide for information on sizing.
Click on "Create" to launch the gateway.
Step 3: Register the gateway with your NetFoundry Network
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.
Using an SSH client, log in to the machine using its public IP address as the user "nfadmin", using the SSH key or password specified earlier.
NOTE: It has been discovered that when using the latest version of Azure Stack (1.1908.0.20) that after launching the VM, the user must reset the SSH key via the Azure console.
This is accomplished by selecting the newly created VM and clicking "reset password" in the bottom left hand corner of the console.
Here, you will find two fields to fill in; the first being the username (nfadmin), followed by the ssh key field where the user will enter the contents of their public ssh key.
Once the fields are populated properly, select "update".
ssh-i <path/to/private/key> nfadmin@<public_ip_address>
> sudo /opt/dispersive/dvn/nfnreg [registration key]
> 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. See Troubleshoot Client and Gateway Registration Errors for more information.
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.
Recommended Next Steps
1. Update the YUM package management system
> sudo yum clean metadata && sudo yum update
2. Ensure you change the password for the "nfadmin" user account, per your company guidelines.
> sudo passwd nfadmin
Should you require RADIUS, please contact NetFoundry.