Add support for Airos in OpenWISP2

.travis.yml

@@ -2,6 +2,11 @@ language: python
 sudo: false
 cache: pip
 
+addons:
+  apt:
+    packages:
+      - graphviz
+
 python:
   - "3.5"
   - "3.4"

bin/netjsonconfig

@@ -5,6 +5,7 @@ import sys
 import six
 import argparse
 import netjsonconfig
+import traceback
 
 description = """
 Converts a NetJSON DeviceConfiguration object to native router configurations.
@@ -56,10 +57,10 @@ output = parser.add_argument_group('output')
 
 output.add_argument('--backend', '-b',
                     required=True,
-                    choices=['openwrt', 'openwisp', 'openvpn'],
+                    choices=['openwrt', 'openwisp', 'openvpn', 'airos'],
                     action='store',
                     type=str,
-                    help='Configuration backend')
+                    help='Configuration backend: openwrt, openwisp or airos')
 
 output.add_argument('--method', '-m',
                     required=True,
@@ -169,7 +170,8 @@ method_arguments = parse_method_arguments(args.args)
 backends = {
     'openwrt': netjsonconfig.OpenWrt,
     'openwisp': netjsonconfig.OpenWisp,
-    'openvpn': netjsonconfig.OpenVpn
+    'openvpn': netjsonconfig.OpenVpn,
+    'airos': netjsonconfig.AirOs,
 }
 
 backend_class = backends[args.backend]
@@ -197,5 +199,8 @@ except netjsonconfig.exceptions.ValidationError as e:
     print(message + info)
     sys.exit(4)
 except TypeError as e:
+    if args.verbose:
+        traceback.print_exc()
+
     print('netjsonconfig: {0}'.format(e))
     sys.exit(5)

docs/source/backends/airos-upgrade.rst

@@ -0,0 +1,47 @@
+.. _airos-configuration-upgrade:
+
+Tools
+-----
+
+AirOS is shipped with proprietary tools that can parse the configuration file and upgrade the antenna.
+
+cfgmtd
+^^^^^^
+
+This tool can write and read data to the memory that persist between reboots.
+
+ubntcfg
+^^^^^^^
+
+This tool can parse the configuration and creates the init scripts that configure the device
+
+rc scripts
+^^^^^^^^^^
+
+This are not commands but a collection of scripts that orchestrate the configuration process. As they are stored on the antenna they can be modified to obtain different behaviours.
+
+* update scripts are stored in `/usr/local/rc.d`
+* module list is stored in `/etc/startup.list`
+
+The update process is orchestrated by the `/usr/local/rc.d/rc.do.softrestart` script. 
+
+Process
+-------
+
+AirOS mantains the device configuration in two files, both can be found in `/tmp`.
+
+* `/tmp/system.cfg` the target configuration
+* `/tmp/running.cfg` the running configuration
+
+If we want to upgrade the device configuration with our file we can overwrite the target configuration and runt the commands `cfgmtd -w` and `/usr/local/rc.d/rc.do.softrestart save`
+
+
+Full transcript of the update processs
+
+.. code-block:: bash
+
+    cp /path/to/my/config.cfg /tmp/system.cfg
+    # writes the configuration to the persistent memory
+    cfgmtd -w /tmp/system.cfg
+    # initiate the configuration update
+    /usr/local/rc.d/rc.do.softrestart save