Bare-metal and Virtualization¶
Installing flexiWAN can be done in just a few minutes. The following steps are covered in this guide:
Add flexiWAN repository and installing flexiEdge software
Running system checker to verify that hardware is supported and to prepare the OS for flexiWAN.
This guide applies to bare metal installation and virtualization. Supported hypervisors are VMware, Proxmox, KVM and VirtualBox.
flexiWAN software is tested on many hardware configurations and with multiple hypervisors. Make sure to install flexiWAN on supported hardware as described on the system requirements page. In case you’re having troubles or questions, visit our Users Forum or contact us for assistance at email@example.com.
flexiWAN requires Ubuntu 18.04.5 LTS, where Ubuntu Server version is recommended. We offer a single line command which installs flexiWAN and starts system checker:
sudo curl -sL https://deb.flexiwan.com/setup | sudo bash - && sudo apt-get install -y flexiwan-router && sudo fwsystem_checker
It is also possible to do it step by step, simply execute the following commands as root on your Ubuntu 18.04 shell.
sudo curl -sL https://deb.flexiwan.com/setup | sudo bash -
sudo apt-get install -y flexiwan-router
The first command will add the flexiWAN key to the apt-key local database and flexiWAN repository to the apt-get.
Second command installs the flexiWAN software itself, turning your device into flexiEdge device.
Upon completing these two simple steps, flexiWAN is installed and flexiEdge is running. Next step is to run fwsystem_checker utility to fix software configuration issues and prepare the system for flexiEdge operation.
The device can connect to flexiManage only after your organization token is installed. Token can be installed using local flexiEdge UI or via command line:
Refer to the Management section. section to learn how to connect a device to the management system.
When using VMware we highly recommend vmxnet3 adapter or PCI Passthrough / SR-IOV interfaces. flexiWAN supports virtio-net interfaces, PCI Passthrough and SR-IOV Virtual Functions.
Check your system configuration¶
We offer a post-installation system check utility. In the latest versions system checker is integrated to and available from the flexiEdge UI, a local web interface for initial configuration and troubleshooting. To access it, simply navigate to the device IP and port 8080.
After opening the flexiEdge UI page, enter username and password from Linux.
After logging in, 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 proceed to the Device Mangement section, starting with token creation and installation steps as described in the following flexiManage section.
Running System Checker from the command line¶
System checker is also available from the command line for a faster deployment or for advanced configuration.
fwsystem_checker tool to pass system requirements and fix software configuration errors.
After installing the flexiEdge software, execute the following as root:
The system checker utility will analyze your system hardware, host OS software configuration and output the results. For flexiEdge software to work properly, it’s important to pass all hardware related checkes, while most of soft-fail checks are fixed easily.
After running system checker there will likely be a few soft configuration fails, which can be fixed in automated or interactive way. System checker offers an automated way to fix all soft fails and prepare the system for flexiWAN operation. It also offers an interactive mode where each setting can be manually configured by the user.
Running system checker with default settings
To fix software configuration issues silently and automatically using defaults, run the
fwsystem_checker utility and select the following options:
2. Configure system silently - to configure system without interaction using defaults
1. Check system configuration - to verify issues are resolved
0. Quit and use fixed parameters - to save the settings and exit utility.
Running system checker interactively
An interactive system configuration is also available, chosing this option will allow detailed configuration and enable advanced features such as multi-core support and CPU power saving. If your device has multiple WAN interfaces and gateways, selecting this option will allow choosing the default gateway, among other options.
To fix software configuration manually and interactively, choose the following:
3. Configure system interactively follow the wizard to configure every step manually.
Last option in system checker, under number 4 is - “Restore system checker settings to default”. Use this option if you wish to remove all configuration done with silent or interactive steps. Reboot is required after restoring system to factory defaults.
After passing all hard and soft checkes, proceed to Device Mangement section, starting with token creation and installation steps as described in the following flexiManage section. In order to access flexiManage, please create an account.