Manual Installation¶
flexiWAN can be installed manually from packages, however for best experience we recommend using flexiWAN image instead. 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.
flexiWAN requires the latest Ubuntu Server 20.04 LTS version. This guide assumes Ubuntu Server 20.4 LTS is installed and running.
Adding repository & Installation¶
In order to install flexiWAN, simply add the flexiWAN repository and install the flexiWAN package by executing 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.
Note
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:
/etc/flexiwan/agent/token.txt
Refer to the Management section. section to learn how to connect a device to the management system.
Check your system configuration¶
System checker is a post installation system check utility. It makes sure system requirements are met and prepares the device for flexiWAN operation.
System Checker from flexiEdge UI¶
With 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.
Example: HTTP://192.168.100.10: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.
System Checker from the command line¶
System checker is also available from the command line for a faster deployment or for advanced configuration.
Run the fwsystem_checker
tool to pass system requirements and fix software configuration errors.
After installing the flexiEdge software, execute the following as root:
fwsystem_checker
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.
Uninstalling flexiWAN¶
Uninstalling flexiWAN is done with a single command, executed from the command line. Make sure to first stop the vRouter from flexiManage, then delete the device from your Inventory.
Execute as root on your device (via console or ssh):
dpkg -P flexiwan-router
After executing the command above, flexiWAN will be uninstalled.
Warning
Make sure the vRouter is stopped before uninstalling the flexiEdge software.