Device Setup¶
The guide below covers how to complete the initial configuration in order to get flexiEdge device connected to the internet and registered with flexiManage.
Initial configuration¶
flexiEdge can be installed on a variety of supported devices or delivered pre-installed from our certified hardware vendors. After installing flexiEdge or receiving a device with flexiWAN pre-installed, initial network configuration is required in order to connect the device to internet and register with flexiManage.
flexiEdge webUI¶
Local flexiEdge UI purpuse is to provide an easy initial configuration and troubleshooting. Afterwards the device configuration is completed from flexiManage. flexiEdge UI is enabled by default on all of wired interfaces and it can be accessed using device IP via port 8080. flexiEdge UI can only be accessed if the device has an active network interface.
To access the local flexiEdge UI, open a browser and point it to the IP and port 8080 of currently active network interface on flexEdge device. Example:
HTTP://192.168.100.10:8080/
After opening the flexiEdge UI page, enter username and password used when installing flexiWAN on the device. (default: admin / flexiwan).
Upon logging in with credentials, Home page will display device information and status. From the sidebar additional options can be accessed.
The sidebar follows post-installation configuration flow:
System Checker - running system checker verifies your device can run flexiWAN
Interfaces - Configuring network interfaces for internet access
Settings - inserting token to connect the device to your flexiManage account.
After completing all three steps the device will be connected to your flexiManage account and waiting for approval.
Running system checker¶
System checker is a post-installation tool which verifies system requirements and fixes software configuration errors.
Click on System Checker page and run it to check if the system meets the requirements.
If installed on supported hardware, in most cases there will only be “soft” failures which can be fixed by clicking on “Auto-fix”:
Confirm the output now says system requirements are met and navigate to the interfaces page.
Network interfaces configuration¶
On the following page network interfaces can be viewed or configured. At this point only wired interfaces and PPPoE can be configured from flexiEdge Web UI while WiFi or LTE interfaces can be configured through flexiManage. The goal is to configure interfaces for internet connectivity so the device can be registered with flexiManage. Complete network configuration is done from flexiManage and not flexiEdge Web UI.
Note
flexiWAN relies on netplan for interfaces configuration. It is recommended to configure WAN and LAN wired interfaces prior to adding the device to flexiManage for recovery purpuses. This way the device is reachable via configured interfaces even when flexiWAN is not running.
PPPoE configuration¶
flexiWAN supports PPPoE. PPPoE can only be configured and provisioned from the flexiEdge UI interfaces page. Simply click on the settings icon next to interface name which will open PPPoE configuraton page.
From the PPPoE configuration page enable the interface and enter the credentials from PPPoE provider and click save. Optionally set custom DNS.
Once PPPoE is configured, wait for a few moments until the page shows PPPoE connection established.
Note
Please note that since PPPoE required to be provisioned before even connecting to flexiManage, it can only be provisioned from flexiEdgeUI. The configuration can be changed from flexiEdgeUI as long as the interface is not assigned in flexiManage. Detecting PPPoE provisioning may take a few moments.
VLAN configuration¶
VLAN’s are supported and can be added via flexiEdge. Unless required for internet connectivity, it’s recommended to add VLAN’s using flexiManage and not local flexiEdge UI. VLAN’s added using local edgeUI cannot be removed after the device is registered to flexiManage, because of this it is strongly advised to add VLAN’s using flexiManage whenever possible for easier management.
To configure VLAN’s, simply click on + sign from the Actions column.
Enter VLAN tag and confirm.
Added VLAN’s can be configured just as any interface.
After configuring network interfaces, follow the next steps to register device with flexiManage.
Device registration¶
Token creation¶
To register a device, first create your organization token. The organization token needs to be generated only once and is used for all the devices in a single organization. Having multiple tokens in single organization is also supported, where it introduces additional security in case of unauthorized physical access of device. From flexiManage, navigate to Inventory > Tokens and click on “New Token” button.
Provide a token name and click “Add”. A new token will be created and presented in the Tokens page.
Copy or download the token in order to add it locally on your device. Token can be added to the device in two ways:
connect to flexiEdge UI web interface
ssh or using direct console.
Adding the token through the flexiEdge UI¶
Open a browser and point it to the IP and port 8080 of currently active network interface on flexEdge device. Example:
HTTP://192.168.100.10:8080/
After opening the flexiEdge UI page, enter username and password from Linux.
Navigate to Settings section and then enter the token copied from flexiManage. Click Update Token and after that continue to flexiManage Devices page to complete the device registration.
Note
Make sure to follow flexiEdge documentation and first run and pass system checker. Check flexiEdge UI to learn more.
Adding the token using SSH or console¶
For this step connect to a direct console or ssh connection to the device is required. Insert the token using text editor such as nano or vi:
nano /etc/flexiwan/agent/token.txt
Inserting the token is the final step where local EdgeUI or direct console / ssh connection to physical device are needed. Afterwards all management is done through flexiManage.
Registering a device¶
Once the token is added, the device will appear in the Inventory > Devices page as a new and unapproved device:
Click on the newly appeared “Unknown” device name to open the device settings. Enter the device name and description, then approve it.
Click on “Update Device” at any time to apply the latest configuration. Follow the next section to complete device configuration.