kaoscoach/actiontec-utils

ActionTec Utilities

This is collection of tools for interacting with your ActionTec MI424WR (Verizon FIOS) router via the command line.

NOTE: Only the conf and exec subcommands are fully implemented at this time.

Synopsis

usage: actiontec [-h] [--debug] [--quiet] [--password PASSWORD]
                 [--username USERNAME] [--ip IP] [--timeout TIMEOUT]
                 [--config CONFIG]
                 {fw,exec,conf} ...

optional arguments:
  -h, --help            show this help message and exit
  --debug
  --quiet, -q
  --password PASSWORD, -p PASSWORD
  --username USERNAME, -u USERNAME
  --ip IP, -i IP
  --timeout TIMEOUT, -t TIMEOUT
  --config CONFIG, -f CONFIG

Configuration

The actiontec command needs a configuration file to provide authentication credentials for your router. The file is a YAML file that should look something like this:

actiontec:
  ip: 192.168.1.1
  username: admin
  password: secret

You can specify the location of this file using the --config (-f) command line option:

actiontec -f router.conf ...

Or by setting the ACTIONTEC_CONFIG environment variable:

export ACTIONTEC_CONFIG=$HOME/.actiontec
actiontec ...

Commands

Shell commands

You can use the exec subcommand to execute commands in the router command shell.

• exec <command>

Examples

Display a process listing:

$ actiontec exec system ps

Configuration commands

The conf command provides the following subcommands:

• conf show [ --keys-only ] [ --prefix <prefix> ] <path> [ <path> ... ]
• conf del [ --prefix <prefix> ] <path> [ <path> ... ]
• conf set [ --prefix <prefix> ] <path> <value> [ <path> <value> ... ]
• conf commit

Examples

Show the name of the active firewall policy:

$ actiontec -q conf show fw/policy/active
default

Show the access control blacklist:

actiontec -q conf show fw/policy/0/chain/access_ctrl_block
{'access_ctrl_block': {'description': 'Access Control - Block',
                       'output': '0',
                       'rule': {},
                       'type': '4'}}

Create a new routing entry:

$ actiontec -q conf set --prefix route/static/0 \
  addr 192.168.100.0 \
  netmask 255.255.255.0 \
  dev br0 \
  gateway 192.168.1.21 \
  metric 0

Show static routes:

$ actiontec -q conf show route/static
{'static': {'0': {'addr': '192.168.100.0',
                  'dev': 'br0',
                  'gateway': '192.168.1.21',
                  'metric': '0',
                  'netmask': '255.255.255.0'}}}

Get information about DHCP leases:

$ actiontec -q conf show dev/br0/dhcps/lease -k |
  xargs -iID actiontec -q conf show dev/br0/dhcps/lease/ID/hardware_mac
22:53:10:a3:d5:32
14:01:d2:5d:2f:03
88:b3:e5:1a:00:36

Firewall commands

• fw enable

  Add rules to the chain named by fw_chain_out in your configuration that will use the actiontec-utils maintained firewall configuration.

• fw disable

  Remove rules from fw_chain_out chain so that the actiontec-utils maintained firewall is no longer used.

• fw list

  Display your blacklist entries.

• fw clear

  Clear all entries from the blacklist.

• fw block ( --out | --in ) <ip>

  Add <ip> to the appropriate blacklist based on the direction (--in or --out) and the setting of the blacklist option in your configuration.

• fw unblock ( --out | --in ) <ip>

  Remove <ip> from the appropriate blacklist.

DNS commands

• dns add <host> <addr>
• dns del <host>

DHCP server commands

• dhcp show [ ( --host <host> | --mac <mac> | --ip <ip> ) ]
• dhcp del ( --host <host> | --mac <mac> | --ip <ip> )
• dhcp set ( --host <host> | --mac <mac> | --ip <ip> ) <attr> <val>

Routing commands

• route show
• route add <dest> <mask> <gw> [ <metric> ]
• route del <dest> <mask> <gw>