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.

  1. sudo curl -sL https://deb.flexiwan.com/setup | sudo bash -

  2. 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.

Repo added

Second command installs the flexiWAN software itself, turning your device into flexiEdge device.

Install complete

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.

EdgeUI

After logging in, click on System Checker page and run it to check if the system meets the requirements.

system checker

If installed on supported hardware, in most cases there will only be “soft” failures which can be fixed by clicking on “Auto-fix”:

system checker

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.

System checker

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.

System checker

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.

System checker 2

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.

System checker 3

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.

Removing device

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.