VM/Bare Metal Installation

The flexiWAN sofwtare was tested on muliple hardware and hypervisor configurations. However there might be systems that are missing some configurations or drivers. If that happens, do not hesitate to contact us for assistance at email yourfriends@flexiwan.com, or for any general issue please use our Google User Group

Software Installation

Execute as root on your Ubuntu shell the following commands. The first command adds the flexiWAN key to the apt-key local database and the flexiWAN repository to apt-get. The second command installs the flexiWAN edge devcie software.

curl -sL https://deb.flexiwan.com/setup | bash -
apt-get install flexiwan-router

This completes the installation of the flexiWAN edge device software.

Note

For VMware it is highly recommended to use the vmxnet3 adaptor. This is done by creating a network adapter for your VM and specify its adapter type as VMXNET3.

Note

The device can only connect to the management system after installing your organization token in:

/etc/fwagent/token.txt

Follow the device management section on how to connect a device to the management system.

Check your system configuration

It is worth to check your system configuration before starting the edge device. If the system is not configured properly, the router might fail to work. The below are standard Linux configurations to verify the system for.

  1. Make sure there are configured WAN and LAN interfaces

    ip addr
    

    Check the LAN and WAN interfaces are up and configured with an IP address. Check that your WAN interface is connected to the internet.

  2. Make sure there is one default gateway configured

    ip route list match default
    

    Check that default gateway route exist and point to the WAN interface

  3. Check that a DNS server is configured persistently

    cat /etc/resolv.conf
    

    Hint

    You can use resolvconf to configure a persistent DNS server:

    sudo apt install resolvconf
    sudo nano /etc/resolvconf/resolv.conf.d/tail
    Add: nameserver <server such as 8.8.8.8>
    sudo service resolvconf restart
    
  4. Check that the system hostname is configured on /etc/hosts

    hostname
    cat /etc/hosts
    

    Check that your hostname is added for 127.0.0.1 address

  5. Prevent Linux auto upgrade

    cat /etc/apt/apt.conf.d/20auto-upgrades
    

    Make sure that both values are configured to 0:

    APT::Periodic::Update-Package-Lists "0";
    APT::Periodic::Unattended-Upgrade "0";