Skip to content

Releases: cablelabs/micronets-gw

Release 1.0.62 (for Raspbian 10/Ubuntu 18.04 LTS)

23 Jul 20:22
@craigpratt craigpratt
1.0.62-u18.04
31a81d8
Compare
Choose a tag to compare
Release 1.0.62 (for Raspbian 10/Ubuntu 18.04 LTS) Pre-release
Pre-release

Notes on this release

This release contains the following changes:

  • A fix for DHCP clients that use the "broadcast" flag in DHCP DISCOVER messages

  • The websocket control/notification connection is disabled by default (and the test cert/key is removed from the release)

  • The configurations are cleaned up. Specifically the following configurations are currently defined:
    * LocalWirelessTestingConfig
    * LocalWirelessProductionConfig
    * WirelessTestingConfigWithWebsocket (replaces "DnsmasqTestingConfig")
    * WirelessProductionConfigWithWebsocket (replaces "DnsmasqProductionConfig")
    * LocalWiredTestingConfig
    * LocalWirelessProductionConfig
    * WiredTestingConfigWithWebsocket
    * WirelessProductionConfigWithWebsocket
    * DefaultConfig (which refers to "LocalWirelessProductionConfig")

    The systemctl service file new refers to "DefaultConfig" (this can be changed as well if desired).

Installation

If Micronets is already installed and running, you should stop the services first using:

sudo systemctl stop micronets-gw.service 
sudo systemctl stop micronets-hostapd.service

You might also want to save /opt/micronets-gw/config.py if you've made changes to this file.

Installing Dependent Packages

On Ubuntu 18.04, most of the dependancies are provided by the distribution.

To install the required distribution-provided packages, perform the following steps:

sudo apt-get update
sudo apt-get -y install dnsmasq openvswitch openvswitch-switch libopenvswitch python3.6 python3-virtualenv python3.6-pip

Installing micronets hostapd (to support wireless micronets)

Go to the Micronets hostapd release page to download and install a hostapd that supports micronets.

Installing the Micronets Gateway Service on Ubuntu 18.04:

The Micronets Gateway Service is architecture-neutral. But the Debian package dependancies vary by release. The Debian installer included in this release is authored for Ubuntu 18.04. To install it run the following bash commands:

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.62-u18.04/micronets-gw-1.0.62-U18.04.deb
sudo dpkg -i micronets-gw-1.0.62-U18.04.deb

Installing the micronets-gw package will:

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample ifupdown "interfaces" file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install a systemd micronets-gw-service service control file

Configuration

If this is the first install of the Micronets gateway, copy /opt/micronets-gw/doc/micronets.sample to /etc/network/interfaces.d/micronets and modify to suit your system.

If you have one wired and one wireless interface you want to enable for micronets, this should just be a matter of replacing interface names. e.g. If you want to enable interface eth1 as a wired micronet, and wlan0 for wireless micronets, lines in the interfaces file would appear respectively as:

#
# A wired interface managed by the Micronets gateway
#
allow-brmn001 eth1 
iface eth1inet manual
  ovs_type OVSPort
  ovs_bridge brmn001
  ovs_port_req 4
  ovs_port_initial_state blocked

#
# A wireless interface managed by the Micronets gateway
#
allow-brmn001 wlan0
iface wlan0 inet manual
  ovs_type OVSPort
  ovs_bridge brmn001
  ovs_port_req 3
  ovs_port_initial_state blocked

and ensure the bridge entry contains a ovs_ports line referring to the micronet interfaces. e.g.

and the bridge defintion would include the line:

auto brmn001
allow-ovs brmn001
iface brmn001 inet manual
  ovs_type OVSBridge
  ...
  # the ovs_ports should list all wired and wireless interfaces under Micronets management
  ovs_ports diagout1 eth1 wlan0
  ...

Note that more than one wired interface can be setup for micronets. Each needs to have a discreet "ovs_port_req" number and needs to be included in the bridge entry's "ovs_ports" line.

To setup the uplink interface (the interface used to connect to the internet), ensure the entry in the interfaces file for that interface is setup correctly for the network. e.g. if the uplink interface is eth0 and get its address via DHCP, the definition would be:

#
# The uplink port
#
auto eth0
iface eth0inet dhcp

and ensure the bridge entry contains a ovs_bridge_uplink_port line referring to the uplink interface. e.g.

auto brmn001
allow-ovs brmn001
iface brmn001 inet manual
  ovs_type OVSBridge
  ...
  # This is the port that's connected to the Internet
  ovs_bridge_uplink_port eth0
  ...

The default configuration of the Micronets Gateway Service presumes the Micronets hostapd will be installed and running. If you're only running Micronets for wired networks, remove any wireless interface definitions from the /etc/network/interfaces.d/micronets file and change the following setting at the end of /opt/micronets-gw/config.py:

class DefaultConfig (LocalWirelessTestingConfig):
    pass

and change it to:

class DefaultConfig (LocalWiredTestingConfig):
    pass

Finally, to enable the Micronets gateway service to be started using systemctl, run the following bash commands:

sudo systemctl enable micronets-gw.service 
sudo systemctl start micronets-gw.service

Ensure that the file /etc/network/interfaces contains the line:

source-directory interfaces.d

And reboot the gateway to apply the changes to the /etc/network/interfaces.d/micronets file

Operation

Micronets can be defined on the local gateway using the local Micronets Gateway REST API.

Defining Wireless Micronets

To create a micronet on the wireless interface (e.g. wlan0), you can use:

curl -X POST -H "Content-Type: application/json" -d '{
        "micronet": {
            "micronetId": "micronet-1",
            "vlan": 1001,
            "ipv4Network": {
                "network": "10.135.1.0",
                "mask": "255.255.255.0",
                "gateway":"10.135.1.1"
            },
            "interface": "wlan0"
        }
    }' http://localhost:5000/micronets/v1/gateway/micronets

Multiple micronets can be defined on a wireless interface. The networkAddress elements needs to be compatible with the addresses defined for the micronets bridge in the /etc/network/interfaces.d/micronets file. e.g. This definition would allow for 5 micronets to be defined:

iface brmn001 inet static
  address 10.135.1.1/24

iface brmn001 inet static
  address 10.135.2.1/24

iface brmn001 inet static
  address 10.135.3.1/24

iface brmn001 inet static
  address 10.135.4.1/24

iface brmn001 inet static
  address 10.135.5.1/24

And to provision a device in the new wireless micronet defined above (using a PSK):

curl -X POST -H "Content-Type: application/json" -d '{
       "device": {
           "deviceId": "mydevice-001",
           "macAddress": {
               "eui48": "00:00:11:11:22:22"
           },
           "networkAddress": {
               "ipv4": "10.135.1.100"
           },
           "psk": "abcd1234"
       }
}' http://localhost:5000/micronets/v1/gateway/micronets/micronet-1/devices

Devices can also be provisioned for wireless Micronets using DPP. This isn't covered in this brief introduction.

Defining Wired Micronets

A wired micronet can be defined similar to a wireless micronets. But only one wired micronet can be defined on a wired interface. e.g.

curl -X POST -H "Content-Type: application/json" -d '{
        "micronet": {
            "micronetId": "micronet-5",
            "ipv4Network": {
                "network": "10.135.5.0",
                "mask": "255.255.255.0",
                "gateway":"10.135.5.1"
            },
            "interface": "eth1"
        }
    }' http://localhost:5000/micronets/v1/gateway/micronets

Adding a device to this wired Micronet is similar to adding a device to a wireless micronet. e.g.

curl -X POST -H "Content-Type: application/json" -d '{
       "device": {
           "deviceId": "mydevice-002",
           "macAddress": {
               "eui48": "00:00:11:11:22:33"
           },
           "networkAddress": {
               "ipv4": "10.135.5.100"
           }
       }
}' http://localhost:5000/micronets/v1/gateway/micronets/micronet-5/devices

Retrieving Micronet and device definitions

The list of currently defined Micronets can be retrieved using:

curl http://localhost:5000/micronets/v1/gateway/micronets

and the list of devices provisioned for a Micronet (e.g. "micronet-1") can be retrieved using:

curl http://localhost:5000/micronets/v1/gateway/micronets/micronet-1/devices

Checking the operation of the Micronets Gateway:

The status of the Micronets bridge and various settings can be checked by running:

sudo /opt/micronets-gw/bin/status

and to examine the flow of packets through the micronets bridge:

sudo /opt/micronets-gw/bin/watch-ovsrules
Assets 3
Loading

Release 1.0.62 (for Ubuntu 16.04)

23 Jul 19:50
@craigpratt craigpratt
1.0.62-u16.04
d67df2c
Compare
Choose a tag to compare
Release 1.0.62 (for Ubuntu 16.04) Pre-release
Pre-release

Notes on this release

This release contains the following changes:

  • A fix for DHCP clients that use the "broadcast" flag in DHCP DISCOVER messages

  • The websocket control/notification connection is disabled by default (and the test cert/key is removed from the release)

  • The configurations are cleaned up. Specifically the following configurations are currently defined:
    * LocalWirelessTestingConfig
    * LocalWirelessProductionConfig
    * WirelessTestingConfigWithWebsocket (replaces "DnsmasqTestingConfig")
    * WirelessProductionConfigWithWebsocket (replaces "DnsmasqProductionConfig")
    * LocalWiredTestingConfig
    * LocalWirelessProductionConfig
    * WiredTestingConfigWithWebsocket
    * WirelessProductionConfigWithWebsocket
    * DefaultConfig (which refers to "LocalWirelessProductionConfig")

    The systemctl service file new refers to "DefaultConfig" (this can be changed as well if desired).

Installation

If Micronets is already installed and running, you should stop the services first using:

sudo systemctl stop micronets-gw.service 
sudo systemctl stop micronets-hostapd.service

You might also want to save /opt/micronets-gw/config.py if you've made changes to this file.

Installing Dependent Packages

On Ubuntu 16.04, a number of packages need to be installed that aren't supplied in this (older) distribution. The IA64 version of these packages are supplied in this release.

To install the required distribution-provided packages, perform the following steps:

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

To install the IA64-compatible version of OpenVSwitch provided in this release. run the following bash commands:

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.62-u16.04/${package};
sudo dpkg -i ${package} ;
done

To install the IA64-compatible version of Python 3.6 provided in this release. run the following bash commands:

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.62-u16.04/${package};
sudo dpkg -i ${package} ;
done

Installing micronets hostapd (to support wireless micronets)

Go to the Micronets hostapd release page to download and install a hostapd that supports micronets.

Installing the Micronets Gateway Service on Ubuntu 16.04:

The Micronets Gateway Service is architecture-neutral. But the Debian package dependancies vary by release. The Debian installer included in this release is authored for Ubuntu 16.04. To install it run the following bash commands:

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.62-u16.04/micronets-gw-1.0.62-U16.04.deb
sudo dpkg -i micronets-gw-1.0.62-U16.04.deb

Installing the micronets-gw package will:

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample ifupdown "interfaces" file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install a systemd micronets-gw-service service control file

Configuration

If this is the first install of the Micronets gateway, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces.d/micronets and modify to suit your system.

If you have one wired and one wireless interface you want to enable for micronets, this should just be a matter of replacing interface names. e.g. If you want to enable interface eth1 as a wired micronet, and wlan0 for wireless micronets, lines in the interfaces file would appear respectively as:

#
# A wired interface managed by the Micronets gateway
#
allow-brmn001 eth1 
iface eth1inet manual
  ovs_type OVSPort
  ovs_bridge brmn001
  ovs_port_req 4
  ovs_port_initial_state blocked

#
# A wireless interface managed by the Micronets gateway
#
allow-brmn001 wlan0
iface wlan0 inet manual
  ovs_type OVSPort
  ovs_bridge brmn001
  ovs_port_req 3
  ovs_port_initial_state blocked

and ensure the bridge entry contains a ovs_ports line referring to the micronet interfaces. e.g.

and the bridge defintion would include the line:

auto brmn001
allow-ovs brmn001
iface brmn001 inet manual
  ovs_type OVSBridge
  ...
  # the ovs_ports should list all wired and wireless interfaces under Micronets management
  ovs_ports diagout1 eth1 wlan0
  ...

Note that more than one wired interface can be setup for micronets. Each needs to have a discreet "ovs_port_req" number and needs to be included in the bridge entry's "ovs_ports" line.

To setup the uplink interface (the interface used to connect to the internet), ensure the entry in the interfaces file for that interface is setup correctly for the network. e.g. if the uplink interface is eth0 and get its address via DHCP, the definition would be:

#
# The uplink port
#
auto eth0
iface eth0inet dhcp

and ensure the bridge entry contains a ovs_bridge_uplink_port line referring to the uplink interface. e.g.

auto brmn001
allow-ovs brmn001
iface brmn001 inet manual
  ovs_type OVSBridge
  ...
  # This is the port that's connected to the Internet
  ovs_bridge_uplink_port eth0
  ...

The default configuration of the Micronets Gateway Service presumes the Micronets hostapd will be installed and running. If you're only running Micronets for wired networks, remove any wireless interface definitions from the /etc/network/interfaces.d/micronets file and change the following setting at the end of /opt/micronets-gw/config.py:

class DefaultConfig (LocalWirelessTestingConfig):
    pass

and change it to:

class DefaultConfig (LocalWiredTestingConfig):
    pass

Finally, to enable the Micronets gateway service to be started using systemctl, run the following bash commands:

sudo systemctl enable micronets-gw.service 
sudo systemctl start micronets-gw.service

Ensure that the file /etc/network/interfaces contains the line:

source-directory interfaces.d

And reboot the gateway to apply the changes to the /etc/network/interfaces.d/micronets file

Operation

Micronets can be defined on the local gateway using the local Micronets Gateway REST API.

Defining Wireless Micronets

To create a micronet on the wireless interface (e.g. wlan0), you can use:

curl -X POST -H "Content-Type: application/json" -d '{
        "micronet": {
            "micronetId": "micronet-1",
            "ipv4Network": {
                "network": "10.135.1.0",
                "mask": "255.255.255.0",
                "gateway":"10.135.1.1"
            },
            "interface": "wlan0"
        }
    }' http://localhost:5000/micronets/v1/gateway/micronets

Multiple micronets can be defined on a wireless interface. The networkAddress elements needs to be compatible with the addresses defined for the micronets bridge in the /etc/network/interfaces.d/micronets file. e.g. This definition would allow for 5 micronets to be defined:

iface brmn001 inet static
  address 10.135.1.1/24

iface brmn001 inet static
  address 10.135.2.1/24

iface brmn001 inet static
  address 10.135.3.1/24

iface brmn001 inet static
  address 10.135.4.1/24

iface brmn001 inet static
  address 10.135.5.1/24

And to provision a device in the new wireless micronet defined above (using a PSK):

curl -X POST -H "Content-Type: application/json" -d '{
       "device": {
           "deviceId": "mydevice-001",
           "macAddress": {
               "eui48": "00:00:11:11:22:22"
           },
           "networkAddress": {
               "ipv4": "10.135.1.100"
           },
           "psk": "abcd1234"
       }
}' http://localhost:5000/micronets/v1/gateway/micronets/micronet-1/devices

Devices can also be provisioned for wireless Micronets using DPP. This isn't covered in this brief introduction.

Defining Wired Micronets

A wired micronet can be defined similar to a wireless micronets. But only one wired micronet can be defined on a wired interface. e.g.

curl -X POST -H "Content-Type: application/json" -d '{
        "micronet": {
            "micronetId": "micronet-5",
            "ipv4Network": {
                "network": "10.135.5.0",
                "mask": "255.255.255.0",
                "gateway":"10.135.5.1"
            },
            "interface": "eth1"
        }
    }' http://localhost:5000/micronets/v1/gateway/micronets

Adding a device to this wired Micronet is similar to adding a device to a wireless micronet. e.g.

curl -X POST -H "Content-Type: application/json" -d '{
       "device": {
           "deviceId": "mydevice-002",
           "macAddress": {
               "eui48": "00:00:11:11:22:33"
           },
           "networkAddress": {
               "ipv4": "10.135.5.100"
           }
       }
}' http://localhost:5000/micronets/v1/gateway/micronets/micronet-5/devices

Retrieving Micronet and device definitions

The list of currently defined Micronets can be retrieved using:

curl http://localhost:5000/micronets/v1/gateway/micronets

and the list of devices provisioned for a Micronet (e.g. "micronet-1") can be retrieved using:

Read more
Assets 10
Loading

Release 1.0.60 (for U16.04)

07 Jun 01:19
@craigpratt craigpratt
1.0.60
1fcbdc2
Compare
Choose a tag to compare
Release 1.0.60 (for U16.04) Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

Note: If Micronets is already installed and running, you should stop the services first using:

sudo systemctl stop micronets-gw.service 
sudo systemctl stop micronets-hostapd.service 

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.60/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.60/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.60/micronets-hostapd-1.0.21.deb
sudo dpkg -i micronets-hostapd-1.0.21.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.60/micronets-gw-1.0.60-U16.04.deb
sudo dpkg -i micronets-gw-1.0.60-U16.04.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes some support for querying the configured wireless interfaces via the "/micronets/v1/gateway/interfaces" endpoint. e.g.

curl http://localhost:5000/micronets/v1/gateway/interfaces?medium=wifi

{
  "interfaces": [
    {
      "interfaceId": "wlp2s0", 
      "macAddress": "c0:d9:62:ae:f0:c2", 
      "medium": "wifi", 
      "ssid": "micronets-gw"
    }
  ]
}

Also the releases are now including the target distro in the name - as we're supporting releases beyond Ubuntu 16.04. (with a more generic debian installer)

Assets 11
Loading

Release 1.0.56 - WSConnector URL lookup fix

11 May 19:26
@craigpratt craigpratt
1.0.56
7c5badb
Compare
Choose a tag to compare
Release 1.0.56 - WSConnector URL lookup fix Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

Note: If Micronets is already installed and running, you should stop the services first using:

sudo systemctl stop micronets-gw.service 
sudo systemctl stop micronets-hostapd.service 

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.56/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.56/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.56/micronets-hostapd-1.0.21.deb
sudo dpkg -i micronets-hostapd-1.0.21.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.56/micronets-gw-1.0.56.deb
sudo dpkg -i micronets-gw-1.0.56.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes a fix for looking up the websocket URI.

The WSConnector class wasn't using the WEBSOCKET_LOOKUP_URL config var. So changing it in the configuration has no effect.

Assets 11
Loading

Release 1.0.55 - Improved support for wired Micronets

17 Apr 19:55
@craigpratt craigpratt
1.0.55
1eadf2a
Compare
Choose a tag to compare
Release 1.0.55 - Improved support for wired Micronets Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

Note: If Micronets is already installed and running, you should stop the services first using:

sudo systemctl stop micronets-gw.service 
sudo systemctl stop micronets-hostapd.service 

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.55/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.55/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.55/micronets-hostapd-1.0.21.deb

sudo dpkg -i micronets-hostapd-1.0.21.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.55/micronets-gw-1.0.55.deb
sudo dpkg -i micronets-gw-1.0.55.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes improvements for supporting wired Micronets:

  1. Added OpenFlow rule generation to prevent wired Micronets from being able to reach each other (or wireless micronets) without expicit ACL rules
  2. Fixed a couple issues persisting micronets without vlan attributes and devices without psks.
  3. The default DHCP lease period is changed from 10m to 2. This should help ensure any IP address assignment issues during the movement of devices from one micronet to another will be short-lived.
Assets 11
Loading

Release 1.0.54 - DPP Multi-AKM Support and hostapd with DPP2

07 Feb 22:02
@craigpratt craigpratt
1.0.54
d341d99
Compare
Choose a tag to compare
Release 1.0.54 - DPP Multi-AKM Support and hostapd with DPP2 Latest
Latest

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.54/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.54/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.54/micronets-hostapd-1.0.21.deb

sudo dpkg -i micronets-hostapd-1.0.21.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.54/micronets-gw-1.0.54.deb
sudo dpkg -i micronets-gw-1.0.54.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes:

  1. Support for multiple APK-based DPP onboarding (with fixes for bugs in the 1.0.53)
  2. Updated hostapd with DPP and SAE enabled
  3. A couple misc fixes to the micronets-gw-service
Assets 11
Loading

Release 1.0.53

04 Jan 03:38
@craigpratt craigpratt
1.0.53
62d25e7
Compare
Choose a tag to compare
Release 1.0.53 Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.53/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.53/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.53/micronets-hostapd-1.0.20.deb

sudo dpkg -i micronets-hostapd-1.0.20.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/1.0.53/micronets-gw-1.0.53.deb
sudo dpkg -i micronets-gw-1.0.53.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes:

  1. Support for multiple APK-based DPP onboarding
Assets 11
Loading

Release 1.0.52

11 Dec 21:46
@craigpratt craigpratt
v1.0.52
62d25e7
Compare
Choose a tag to compare
Release 1.0.52 Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.52/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb
python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.52/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.52/micronets-hostapd-1.0.18.deb
sudo dpkg -i micronets-hostapd-1.0.18.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.52/micronets-gw-1.0.52.deb
sudo dpkg -i micronets-gw-1.0.52.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes:

  1. Support for passphrase-based DPP onboarding
Assets 11
Loading

Release v1.0.51

10 Dec 09:38
@craigpratt craigpratt
v1.0.51
042b671
Compare
Choose a tag to compare
Release v1.0.51 Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.51/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb
python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.51/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.51/micronets-hostapd-1.0.18.deb
sudo dpkg -i micronets-hostapd-1.0.18.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.51/micronets-gw-1.0.51.deb
sudo dpkg -i micronets-gw-1.0.51.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes:

  1. Support for performing onboarding off-channel (DPPAuthInit neg_chan support)
  2. A fix to commit pending micronet/devices changes when DPP onboarding is initiated - ensuring that onboarding won't be performed using stale representations.
  3. Fix for the hostapd systemctl service to fix the syslog prefix and facility
Assets 11
Loading

Release v1.0.50

01 Nov 07:37
@craigpratt craigpratt
v1.0.50
4fd04c6
Compare
Choose a tag to compare
Release v1.0.50 Pre-release
Pre-release

Installation

Installation of the micronets gateway components can be performed using the following bash commands:

echo "INSTALLING PREREQUISITE PACKAGES"

sudo apt-get update
sudo apt-get -y install python-pip virtualenv dnsmasq python-six libnl-route-3-200

echo "INSTALLING OPENVSWITCH 2.9.2"

for package in libopenvswitch_2.9.2-1_amd64.deb openvswitch-common_2.9.2-1_amd64.deb openvswitch-switch_2.9.2-1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.50/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING PYTHON 3.6"

for package in libpython3.6-minimal_3.6.5-5.16.04.york1_amd64.deb libpython3.6-stdlib_3.6.5-5.16.04.york1_amd64.deb
python3.6-minimal_3.6.5-5.16.04.york1_amd64.deb python3.6_3.6.5-5.16.04.york1_amd64.deb ;
do curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.50/${package};
sudo dpkg -i ${package} ;
done

echo "INSTALLING MICRONETS HOSTAPD"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.50/micronets-hostapd-1.0.16.deb
sudo dpkg -i micronets-hostapd-1.0.16.deb 

echo "INSTALLING MICRONETS GATEWAY COMPONENTS"

curl -L -O https://github.com/cablelabs/micronets-gw/releases/download/v1.0.50/micronets-gw-1.0.50.deb
sudo dpkg -i micronets-gw-1.0.50.deb 

echo "SETTING MICRONETS COMPONENTS FOR AUTOSTART"
sudo systemctl enable micronets-hostapd.service 
sudo systemctl enable micronets-gw.service 

echo "STARTING MICRONETS COMPONENTS"
sudo systemctl start micronets-hostapd.service 
sudo systemctl start micronets-gw.service

Installing the micronets-gw package should

  1. install the micronets gateway service in the /opt/micronets-gw directory,
  2. install the ifup/down and dnsmasq extension scripts for the configuration of openvswitch and the micronets-gw service via /etc/network/interfaces,
  3. install a sample/etc/network/interfaces file in /opt/micronets-gw/doc/interfaces.sample, and
  4. install and start the micronets-gw-service systemd service.

Configuration

If this is the first install, copy /opt/micronets-gw/doc/interfaces.sample to /etc/network/interfaces and modify to suit your system.

Notes on this release

This release includes support for interfacing with hostapd, dpp onboarding support, and more advanced ACL rules (with backward compatibility for allowHosts/denyHosts).

Assets 11
Loading