FireBrick FB2500 V1.45.000 configuration objects

Top level config

The top level config element contains all of the FireBrick configuration data.

config: Attributes
Attribute	Type	Description	Default
patch	integer	Internal use, for s/w updates that change config syntax
timestamp	dateTime	Config store time, set automatically when config is saved

config: Elements
Element	Type	Instances	Description
bgp	bgp	Optional, up to 100	BGP config
bgp-filter	namedbgpmap	Optional, unlimited	Mapping and filtering rules for use with BGP peers
blackhole	blackhole	Optional, unlimited	Black hole (dropped packets) networks
cqm	cqm	Optional	Constant Quality Monitoring config
dhcp-relay	dhcp-relay	Optional, unlimited	DHCP server settings for remote / relayed requests
eap	eap	Optional, unlimited	User access control via EAP
ethernet	ethernet	Optional, unlimited	Ethernet port settings
etun	etun	Optional, unlimited	Ether tunnel (RFC3378)
fb105	fb105	Optional, up to 255	FB105 tunnel settings
interface	interface	Optional, up to 8192	Ethernet interface (port-group/vlan) and subnets
ip-group	ip-group	Optional, unlimited	Named IP groups
ipsec-ike	ipsec-ike	Optional	IPsec connection settings
l2tp	l2tp	Optional	L2TP settings
log	log	Optional, up to 50	Log target controls
loopback	loopback	Optional, unlimited	Extra local addresses
network	network	Optional, unlimited	Locally originated networks
nowhere	blackhole	Optional, unlimited	Dead end (icmp error) networks
ospf	ospf	Optional, unlimited	OSPF config
ping	ping	Optional, up to 100	Base ping graph settings
port	portdef	Optional, up to 4	Port grouping and naming
ppp	pppoe	Optional, up to 10	PPPoE settings
profile	profile	Optional, unlimited	Control profiles
route	route	Optional, unlimited	Static routes
route-override	route-override	Optional, unlimited	Routing override rules
rule-set	rule-set	Optional, unlimited	Firewall/mapping rules
sampling	sampling	Optional	Sampling parameters
services	services	Optional	General system services
shaper	shaper	Optional, unlimited	Named traffic shapers
system	system	Optional	System settings
user	user	Optional, unlimited	Admin users
voip	voip	Optional	VoIP config

System settings

The system settings are the top level attributes of the system which apply globally.

system: Attributes
Attribute	Type	Description	Default
comment	string	Comment
contact	string	Contact name
eth-rx-cpu	unsignedInt	Min percentage of CPU earmarked for eth rx processing	75
eth-rx-qsize	unsignedInt	Size of eth driver Rx queue	256
eth-tx-qsize	unsignedInt	Size of eth driver Tx queue	512
intro	string	Home page text
location	string	Location description
log	NMTOKEN	Log system events	Web/console
log-config	NMTOKEN	Log config load	Web/Flash/console
log-debug	NMTOKEN	Log system debug messages	Not logging
log-error	NMTOKEN	Log system errors	Web/Flash/console
log-eth	NMTOKEN	Log Ethernet messages	Web/console
log-eth-debug	NMTOKEN	Log Ethernet debug	Not logging
log-eth-error	NMTOKEN	Log Ethernet errors	Web/Flash/console
log-panic	NMTOKEN	Log system panic messages	Web logs
log-route-nexthop	NMTOKEN	Log next hop changes	Not logged
log-stats	NMTOKEN	Log one second stats	Not logging
log-tcp-debug	NMTOKEN	Log TCP stack debug messages	Not logging
name	string	System hostname
nat64	IP6Prefix	IPv6 NAT6/4 mapping prefix
nat64-source	IP4Addr	IPv6 NAT6/4 return IPv4
pre-reboot-url	string	URL to GET prior to s/w reboot (typically to warn nagios)
soft-watchdog	boolean	Debug - use only if advised; do not use on an unattended FireBrick	false
source	string	Source of data, used in automated config management
sw-update	autoloadtype	Load new software automatically	factory
sw-update-profile	NMTOKEN	Profile name for when to load new s/w
table	routetable 0-99	Routing table number for system functions (s/w updates, etc)	0

system: Elements
Element	Type	Instances	Description
link	link	Optional, unlimited	Home page links

Web links

Links to other web pages

link: Attributes
Attribute	Type	Description
comment	string	Comment
name	string	Link name
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
text	string	Link text
url	string	Link address

Admin users

User names, passwords and abilities for admin users

user: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	Restrict logins to be from specific IP addresses
comment	string	Comment
config	config-access	Config access level	full
full-name	string	Full name
level	user-level	Login level	ADMIN
name	username (NMTOKEN)	User name	Not optional
otp-seed	OTP	OTP seed (do not edit by hand) Also works as otp, which is deprecated
password	Password	User password	Not optional
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Restrict login to specific routing table	0
timeout	duration	Login idle timeout (zero to stay logged in)	5:00

User access controlled by EAP

Identities, passwords and access methods for access controlled with EAP

eap: Attributes
Attribute	Type	Description	Default
comment	string	Comment
full-name	string	Full name
methods	Set of eap-method	Allowed methods	Not optional
name	string	User or account name	Not optional
password	Secret	User password	Not optional
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
subsystem	eap-subsystem	Access controlled subsystem	Not optional

Log target controls

Named logging target

log: Attributes
Attribute	Type	Description	Default
colour	Colour	Colour used in web display
comment	string	Comment
console	boolean	Log immediately to console
flash	boolean	Log immediately to slow flash memory (use with care)
jtag	boolean	Log immediately jtag (development use only)
name	NMTOKEN	Log target name	Not optional
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management

log: Elements
Element	Type	Instances	Description
email	log-email	Optional, unlimited	Email settings
syslog	log-syslog	Optional, unlimited	Syslog settings

Syslog logger settings

Logging to a syslog server

log-syslog: Attributes
Attribute	Type	Description	Default
comment	string	Comment
facility	syslog-facility	Facility setting	LOCAL0
port	unsignedShort	Server port	514
profile	NMTOKEN	Profile name
server	IPNameAddr	Syslog server	Not optional
severity	syslog-severity	Severity setting	NOTICE
source	string	Source of data, used in automated config management
source-ip	IPAddr	Use specific source IP
system-logs	boolean	Include generic system log messages as well
table	routetable 0-99	Routing table number for sending syslogs	0

Email logger settings

Logging to email

log-email: Attributes
Attribute	Type	Description	Default
comment	string	Comment
delay	duration	Delay before sending, since first event to send	1:00
from	string	Source email address	One made up using serial number
hold-off	duration	Delay before sending, since last email	1:00:00
log	NMTOKEN	Log emailing process	Not logging
log-debug	NMTOKEN	Log emailing debug	Not logging
log-error	NMTOKEN	Log emailing errors	Not logging
port	unsignedShort	Server port	25
profile	NMTOKEN	Profile name
retry	duration	Delay before sending, since failed send	10:00
server	IPNameAddr	Smart host to use rather than MX
source	string	Source of data, used in automated config management
subject	string	Subject	From first line being logged
table	routetable 0-99	Routing table number for sending email	0
to	string	Target email address	Not optional

System services are various generic services that the system provides, and allows access controls and settings for these to be specified. The service is only active if the corresponding element is included in services, otherwise it is disabled.

services: Elements
Element	Type	Instances	Description
dns	dns-service	Optional	DNS service settings
http	http-service	Optional	HTTP server settings
ntp	ntp-service	Optional	NTP client settings (server not implemented yet)
radius	radius-service	Optional	RADIUS server/proxy settings
snmp	snmp-service	Optional	SNMP server settings
telnet	telnet-service	Optional	Telnet server settings

SNMP service settings

The SNMP service has general service settings and also specific attributes for SNMP such as community

snmp-service: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which service can be accessed	Allow from anywhere
comment	string	Comment
community	string	Community string	public
local-only	boolean	Restrict access to locally connected Ethernet subnets only	false
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
port	unsignedShort	Service port	161
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0

NTP service settings

The NTP settings define how the system clock is set, from what servers, and controls for daylight saving (summer time). The defaults are those that apply to the EU

ntp-service: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which service can be accessed	Allow from anywhere
comment	string	Comment
fast-retry	boolean	Aggressive re-try until clock first set
local-only	boolean	Restrict access to locally connected Ethernet subnets only	true
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
ntpserver	List of IPNameAddr	List of time servers (IP or hostname) from which time may be set by ntp	ntp.firebrick.ltd.uk
poll	duration	NTP poll rate	1:00:00
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0
tz1-name	string	Timezone 1 name	GMT
tz1-offset	duration	Timezone 1 offset from UTC	0
tz12-date	datenum 1-31	Timezone 1 to 2 earliest date in month	25
tz12-day	day	Timezone 1 to 2 day of week of change	Sun
tz12-month	month	Timezone 1 to 2 month	Mar
tz12-time	time	Timezone 1 to 2 local time of change	01:00:00
tz2-name	string	Timezone 2 name	BST
tz2-offset	duration	Timezone 2 offset from UTC	1:00:00
tz21-date	datenum 1-31	Timezone 2 to 1 earliest date in month	25
tz21-day	day	Timezone 2 to 1 day of week of change	Sun
tz21-month	month	Timezone 2 to 1 month	Oct
tz21-time	time	Timezone 2 to 1 local time of change	02:00:00

Telnet service settings

Telnet control interface

telnet-service: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which service can be accessed	Allow from anywhere
comment	string	Comment
local-only	boolean	Restrict access to locally connected Ethernet subnets only	true
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
port	unsignedShort	Service port	23
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0

HTTP service settings

Web management pages

http-service: Attributes
Attribute	Type	Description	Default
access-control-allow-origin	string	Additional header for cross site javascript
allow	List of IPNameRange	List of IP ranges from which service can be accessed	Allow from anywhere
comment	string	Comment
css-url	string	Additional CSS for web control pages
local-only	boolean	Restrict access to locally connected Ethernet subnets only	true
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
port	unsignedShort	Service port	80
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0
trusted	List of IPNameRange	List of allowed IP ranges from which additional access to certain functions is available

DNS service settings

DNS forwarding resolver service

dns-service: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which service can be accessed	Allow from anywhere
auto-dhcp	boolean	Forward and reverse DNS for names in DHCP using this domain
comment	string	Comment
domain	string	Our domain
fallback	boolean	For incoming requests, if no server in required table, relay to any DNS available	true
local-only	boolean	Restrict access to locally connected Ethernet subnets only	true
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
profile	NMTOKEN	Profile name
resolvers	List of IPAddr	Recursive DNS resolvers to use
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0

dns-service: Elements
Element	Type	Instances	Description
block	dns-block	Optional, unlimited	Fixed local DNS host blocks
host	dns-host	Optional, unlimited	Fixed local DNS host entries

Fixed local DNS host settings

DNS forwarding resolver service

dns-host: Attributes
Attribute	Type	Description	Default
comment	string	Comment
ip	List of IPAddr	IP addresses to serve (or our IP if omitted)	Our IP
name	List of string	Host names (can use * as a part of a domain)	Not optional
profile	NMTOKEN	Profile name
restrict-interface	List of NMTOKEN	Only apply on certain interface(s)
restrict-to	List of IPNameRange	List of IP ranges to which this is served Also works as restrict, which is deprecated
reverse	boolean	Map reverse DNS as well
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table applicable	any
ttl	unsignedInt	Time to live	60

Fixed local DNS blocks

DNS forwarding resolver service

dns-block: Attributes
Attribute	Type	Description	Default
comment	string	Comment
name	List of string	Host names (can use * as a part of a domain)	Not optional
profile	NMTOKEN	Profile name
restrict-interface	List of NMTOKEN	Only apply on certain interface(s)
restrict-to	List of IPNameRange	List of IP ranges to which this is served Also works as restrict, which is deprecated
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table applicable	any
ttl	unsignedInt	Time to live	60

RADIUS service definition

RADIUS server and proxy definitions

radius-service: Attributes
Attribute	Type	Description	Default
acct-port	unsignedShort	Accounting UDP port	1813
auth-port	unsignedShort	Authentication UDP port	1812
authenticator	boolean	Require message authenticator
backup-ip	List of IPNameAddr	Target IP(s) or hostname for backup L2TP connection
class	string	Class field to send
comment	string	Comment
context-name	string	Juniper Context-Name (SIN502)
control-port	unsignedShort	Control UDP port (CoA/DM)	3799
dummy-ip	boolean	Send dummy framed IP response	true
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug
log-error	NMTOKEN	Log errors	Log as event
nsn-conditional	boolean	Only send NSN settings if username is not same as calling station id
nsn-tunnel-override-username	unsignedByte	Additional response for GGSN usage
nsn-tunnel-user-auth-method	unsignedInt	Additional response for GGSN usage
order	radiuspriority	Priority tagging of endpoints sent
profile	NMTOKEN	Profile name
relay-ip	List of IPAddr	Address to copy RADIUS request
relay-port	unsignedShort	Authentication UDP port for copy RADIUS request	1812
relay-table	routetable 0-99	Routing table number for copy of RADIUS request
secret	Secret	Shared secret for RADIUS requests (needed for replies)
source	string	Source of data, used in automated config management
tagged	boolean	Tag all attributes that can be
target-hostname	string	Hostname for L2TP connection
target-ip	List of IPNameAddr	Target IP(s) or hostname for primary L2TP connection
target-secret	Secret	Shared secret for L2TP connection
test	List of IPAddr	List of IPs that must have routing for this target to be valid (deprecated)
tunnel-assignment-id	string	Tunnel Assignment ID to send
tunnel-client-return	boolean	Return tunnel client as radius IP

radius-service: Elements
Element	Type	Instances	Description
match	radius-service-match	Optional, unlimited	Matching rules for specific responses
server	radius-server	Optional, unlimited	RADIUS server settings

Matching rules for RADIUS service

Rules for matching incoming RADIUS requests

radius-service-match: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	Match source IP address of RADIUS request
authenticator	boolean	Require message authenticator
backup-ip	List of IPNameAddr	Target IP(s) or hostname for backup L2TP connection
called-station-id	List of string	One or more patterns to match called-station-id
calling-station-id	List of string	One or more patterns to match calling-station-id
class	string	Class field to send
comment	string	Comment
context-name	string	Juniper Context-Name (SIN502)
dummy-ip	boolean	Send dummy framed IP response	true
ip	List of IPNameRange	Match target IP address of RADIUS request
name	string	Name
nsn-conditional	boolean	Only send NSN settings if username is not same as calling station id
nsn-tunnel-override-username	unsignedByte	Additional response for GGSN usage
nsn-tunnel-user-auth-method	unsignedInt	Additional response for GGSN usage
order	radiuspriority	Priority tagging of endpoints sent
profile	NMTOKEN	Profile name
relay-ip	List of IPAddr	Address to copy RADIUS request
relay-port	unsignedShort	Authentication UDP port for copy RADIUS request	1812
relay-table	routetable 0-99	Routing table number for copy of RADIUS request
secret	Secret	Shared secret for RADIUS requests (needed for replies)
source	string	Source of data, used in automated config management
tagged	boolean	Tag all attributes that can be
target-hostname	string	Hostname for L2TP connection
target-ip	List of IPNameAddr	Target IP(s) or hostname for primary L2TP connection
target-secret	Secret	Shared secret for L2TP connection
test	List of IPAddr	List of IPs that must have routing for this target to be valid (deprecated)
tunnel-assignment-id	string	Tunnel Assignment ID to send
tunnel-client-return	boolean	Return tunnel client as radius IP
username	List of string	One or more patterns to match username

RADIUS server settings

Server settings for outgoing RADIUS

radius-server: Attributes
Attribute	Type	Description	Default
comment	string	Comment
host	List of IPNameAddr	One or more hostname/IPs of RADIUS servers	Not optional
max-timeout	duration	Maximum final timeout	20
min-timeout	duration	Minimum final timeout	5
name	string	Name
port	unsignedShort	UDP port	From services/radius settings
profile	NMTOKEN	Profile name
queue	unsignedInt	Concurrent requests over all of these servers (per type)
scale-timeout	unsignedByte	Timeout scaling factor	2
secret	Secret	Shared secret for RADIUS requests	Not optional
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number
type	Set of radiustype	Server type	All

Physical port controls

Physical port attributes

ethernet: Attributes
Attribute	Type	Description	Default
autoneg	boolean	Perform link auto-negotiation	auto negotiate unless manual 10/100 speed and duplex are set
clocking	LinkClock	Gigabit clock setting	prefer-slave
crossover	Crossover	Port crossover configuration	auto
duplex	LinkDuplex	Duplex setting for this port	auto
flow	LinkFlow	Flow control setting	none
green	LinkLED	Green LED setting	Link/Activity
lacp	boolean	Sent LACP packets	Auto
lldp	boolean	Sent LLDP packets	true
optimise	boolean	enable PHY optimisations	true
port	port	Physical port	Not optional
power-saving	LinkPower	enable PHY power saving	full
profile	NMTOKEN	Profile name
send-fault	LinkFault	Send fault status
speed	LinkSpeed	Speed setting for this port	auto
yellow	LinkLED	Yellow LED setting	Tx

Packet sampling configuration

sampling: Attributes
Attribute	Type	Description	Default
agent-ip	IPAddr	IP address used to identify this agent	use source-ip
collector-ip	IPAddr	IP address of collector	Not optional
collector-port	unsignedShort	UDP port which collector listens on	6343 for sFlow, 4739 for IPFIX
comment	string	Comment
mtu	mtu 576-2000		1500
name	string	Name
profile	NMTOKEN	Profile name
protocol	sampling-protocol	Protocol used to export sampling data	sflow
sample-flush	duration	Sample max cache time	1 sec for sFlow; 30 for IPFIX
sample-rate	sample-rate 100-10000	Sample rate (uniform random prob 1/N)	1000
snap-length	unsignedShort	Packet header snap length	64
source	string	Source of data, used in automated config management
source-ip	IPAddr	Source IP address to use
source-port	unsignedShort	UDP source port	Use collector-port
stats-interval	duration	Stats export interval	60
table	routetable 0-99	Routing table number for sample data	0
template-refresh	duration	Template resend interval	600

Port grouping and naming

portdef: Attributes
Attribute	Type	Description	Default
comment	string	Comment
name	NMTOKEN	Name	Not optional
ports	Set of port	Physical port(s)	Not optional
source	string	Source of data, used in automated config management
trunk	trunk-mode	Trunk ports	false

Port-group/VLAN interface settings

The interface definition relates to a specific physical port group and VLAN. It includes subnets and VRRP that apply to that interface.

interface: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
cug	cug 1-32767	Closed user group ID
cug-restrict	boolean	Closed user group restricted traffic (only to/from same CUG ID)
dhcp-relay	IP4Addr	Relay any unresolved requests to external server
graph	graphname (token)	Graph name
link	NMTOKEN	Interface to which this is linked at layer 2
log	NMTOKEN	Log events including DHCP and related events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
mtu	mtu 576-2000	MTU for this interface	1500
name	NMTOKEN	Name
ospf	boolean	OSPF announce mode for route	true
ospf-cost	unsignedShort	Outbound link cost	1
ping	IPAddr	Ping address to add loss/latency to graph for interface
port	NMTOKEN	Port group name	Not optional
profile	NMTOKEN	Profile name
ra-client	boolean	Accept IPv6 RA and create auto config subnets and routes	true
restrict-mac	boolean	Use only one MAC on this interface
sampling	sampling-mode	Perform sampling	off
source	string	Source of data, used in automated config management
source-filter	sfoption	Source filter traffic received via this interface
source-filter-table	routetable 0-99	Routing table to use for source filtering checks	interface table
table	routetable 0-99	Routing table applicable	0
vlan	vlan 0-4095	VLAN ID (0=untagged)	0

interface: Elements
Element	Type	Instances	Description
dhcp	dhcps	Optional, unlimited	DHCP server settings
subnet	subnet	Optional, unlimited	IP subnet on the interface
vrrp	vrrp	Optional, unlimited	VRRP settings

Subnet settings

Subnet settings define the IP address(es) of the FireBrick, and also allow default routes to be set.

subnet: Attributes
Attribute	Type	Description	Default
accept-dns	boolean	Accept DNS servers specified by DHCP	true
arp-timeout	unsignedShort	Max lifetime on ARP and ND	60
bgp	bgpmode	BGP announce mode for routes	Not announced
broadcast	boolean	If broadcast address allowed	false
comment	string	Comment
gateway	List of IPAddr	One or more gateways to install
ip	List of IPSubnet	One or more IP/len	Automatic by DHCP
localpref	unsignedInt	Localpref for subnet (highest wins)	4294967295
mtu	mtu 576-2000	MTU for subnet	As interface
name	string	Name
nat	boolean	Short cut to set nat default mode on all IPv4 traffic from subnet (can be overridden by firewall rules)	false
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
proxy-arp	boolean	Answer ARP/ND by proxy if we have routing	false
ra	ramode	If to announce IPv6 RA for this subnet	false
ra-dns	List of IP6Addr	List of recursive DNS servers in route announcements
ra-managed	dhcpv6control	RA 'M' (managed) flag
ra-max	ra-max 4-1800	Max RA send interval	600
ra-min	ra-min 3-1350	Min RA send interval
ra-mtu	unsignedShort	MTU to use on RA	As subnet
ra-other	dhcpv6control	RA 'O' (other) flag
ra-profile	NMTOKEN	Profile, if inactive then forces low priority RA
source	string	Source of data, used in automated config management
test	IPAddr	Test link state using ARP/ND for this IP
ttl	unsignedByte	TTL for originating traffic via subnet	64

VRRP settings

VRRP settings provide virtual router redundancy for the FireBrick. Profile inactive does not disable vrrp but forces vrrp low priority. Use different VRID on different VLANs.

vrrp: Attributes
Attribute	Type	Description	Default
answer-ping	boolean	Whether to answer PING to VRRP IPs when master	true
comment	string	Comment
delay	unsignedInt	Delay after routing established before priority returns to normal	60
interval	unsignedShort	Transit interval (centiseconds)	100
ip	List of IPAddr	One or more IP addresses to announce	Not optional
log	NMTOKEN	Log events	Not logging
log-error	NMTOKEN	Log errors	log as event
low-priority	unsignedByte	Lower priority applicable until routing established	1
name	NMTOKEN	Name
preempt	boolean	Whether pre-empt allowed	true
priority	unsignedByte	Normal priority	100
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
test	List of IPAddr	List of IPs to which routing must exist else low priority (deprecated)
use-vmac	boolean	Whether to use the special VMAC or use normal MAC	true
version3	boolean	Use only version 3	v2 for IPv4, v3 for IPv6
vrid	unsignedByte	VRID	42

DHCP server settings

Settings for DHCP server

dhcps: Attributes
Attribute	Type	Description	Default
boot	IP4Addr	Next/boot server
boot-file	string	Boot filename
class	string	Vendor class match
client-name	string	Client name match
comment	string	Comment
dns	List of IP4Addr	DNS resolvers	Our IP
domain	string	DNS domain	From system settings
domain-search	string	DNS domain search list (list will be truncated to fit one attribute)
force	boolean	Send all options even if not requested
gateway	IP4Subnet	Gateway	Our IP
ip	List of IP4Range	Address pool	0.0.0.0/0
lease	duration	Lease length	2:00:00
log	NMTOKEN	Log events (allocations)	Not logging
mac	List of up to 12 macprefix (hexBinary)	Partial or full MAC addresses
name	string	Name
ntp	List of IP4Addr	NTP server	From system settings
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
syslog	List of IP4Addr	Syslog server
time	List of IP4Addr	Time server	Our IP

dhcps: Elements
Element	Type	Instances	Description
send	dhcp-attr-hex	Optional, unlimited	Additional attributes to send (hex)
send-ip	dhcp-attr-ip	Optional, unlimited	Additional attributes to send (IP)
send-number	dhcp-attr-number	Optional, unlimited	Additional attributes to send (numeric)
send-string	dhcp-attr-string	Optional, unlimited	Additional attributes to send (string)

DHCP server attributes (hex)

Additional DHCP server attributes (hex)

dhcp-attr-hex: Attributes
Attribute	Type	Description	Default
comment	string	Comment
force	boolean	Send even if not requested
id	unsignedByte	Attribute type code/tag	Not optional
name	string	Name
value	hexBinary	Value	Not optional
vendor	boolean	Add as vendor specific option (under option 43)

DHCP server attributes (string)

Additional DHCP server attributes (string)

dhcp-attr-string: Attributes
Attribute	Type	Description	Default
comment	string	Comment
force	boolean	Send even if not requested
id	unsignedByte	Attribute type code/tag	Not optional
name	string	Name
value	string	Value	Not optional
vendor	boolean	Add as vendor specific option (under option 43)

DHCP server attributes (numeric)

Additional DHCP server attributes (numeric)

dhcp-attr-number: Attributes
Attribute	Type	Description	Default
comment	string	Comment
force	boolean	Send even if not requested
id	unsignedByte	Attribute type code/tag	Not optional
name	string	Name
value	unsignedInt	Value	Not optional
vendor	boolean	Add as vendor specific option (under option 43)

DHCP server attributes (IP)

Additional DHCP server attributes (IP)

dhcp-attr-ip: Attributes
Attribute	Type	Description	Default
comment	string	Comment
force	boolean	Send even if not requested
id	unsignedByte	Attribute type code/tag	Not optional
name	string	Name
value	IP4Addr	Value	Not optional
vendor	boolean	Add as vendor specific option (under option 43)

PPPoE settings

PPPoE endpoint settings

pppoe: Attributes
Attribute	Type	Description	Default
ac-name	string	Access concentrator name	Any a/c name as client, else same as 'name'
accept-dns	boolean	Accept DNS servers specified by far end	true
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
cug	cug 1-32767	Closed user group ID
cug-restrict	boolean	Closed user group restricted traffic (only to/from same CUG ID)
fast-retry	boolean	Aggressive re-connect
graph	graphname (token)	Graph name
ip-over-lcp	boolean	Sends all IP packets as LCP	auto
lcp-rate	unsignedByte	LCP interval (seconds)	10
lcp-timeout	unsignedByte	LCP timeout (seconds)	61
local	IP4Addr	Local IPv4 address
localpref	unsignedInt	Localpref for route (highest wins)	4294967295
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log as events	Not logging
mode	pppoe-mode	PPPoE server/client mode	client
mtu	mtu 576-2000	MTU for link	1492
name	NMTOKEN	Name
nat	boolean	NAT IPv4 traffic to this link unless otherwise set by rules	false
ospf	boolean	OSPF announce mode for route	true
password	Secret	User password
pd-interface	List of NMTOKEN	Interfaces for IPv6 prefix delegation	Auto
port	NMTOKEN	Port group name
profile	NMTOKEN	Profile name
remote	IP4Addr	Remote IPv4 address
routes	List of IPPrefix	Routes when link up	Default gateway
service	string	Service name	Any service
source	string	Source of data, used in automated config management
speed	unsignedInt	Default egress rate limit (b/s)
table	routetable 0-99	Routing table number for payload
tcp-mss-fix	boolean	Adjust MSS option in TCP SYN to fix session MSS	true
username	string	User name
vlan	vlan 0-4095	VLAN ID (0=untagged)	0

pppoe: Elements
Element	Type	Instances	Description
route	ppp-route	Optional, unlimited	Routes to apply when ppp link is up

PPP routes

Routes that apply when link is up

ppp-route: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
ip	List of IPPrefix	One or more network prefixes	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management

Static routes

Static routes define prefixes which are permanently in the routing table, and whether these should be announced by routing protocols or not.

route: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
gateway	List of IPAddr	One or more target gateway IPs	Not optional
graph	graphname (token)	Graph name
ip	List of IPPrefix	One or more network prefixes	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
speed	unsignedInt	Egress rate limit (b/s)
table	routetable 0-99	Routing table number	0

Locally originated networks

Network blocks that are announced but not actually added to internal routes - note that blackhole and nowhere objects can also announce but add routing.

network: Attributes
Attribute	Type	Description	Default
as-path	List of up to 10 unsignedInt	Custom AS path as if network received
bgp	bgpmode	BGP announce mode for routes	true
comment	string	Comment
ip	List of IPPrefix	One or more network prefixes	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0
tag	List of Community	List of community tags

Dead end networks

Networks that go nowhere

blackhole: Attributes
Attribute	Type	Description	Default
as-path	List of up to 10 unsignedInt	Custom AS path as if network received
bgp	bgpmode	BGP announce mode for routes	false
comment	string	Comment
ip	List of IPPrefix	One or more network prefixes	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0
tag	List of Community	List of community tags

Locally originated networks

Loopback addresses define local IP addresses

loopback: Attributes
Attribute	Type	Description	Default
as-path	List of up to 10 unsignedInt	Custom AS path as if network received
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
ip	List of IPAddr	One or more local network addresses	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0
tag	List of Community	List of community tags

Overall OSPF settings

The OSPF element defines general OSPF settings. Where interfaces/table specified, first matching OSPF config is applied. Only provides OSPF internal and AS-border router functionality.

ospf: Attributes
Attribute	Type	Description	Default
area-id	IP4Addr	Area ID	0.0.0.0
auth-algorithm	ipsec-auth-algorithm	Authentication algorithm for OSPFv3	AES-XCBC
auth-key	hexBinary	Key for OSPFv3 authentication
bgp	bgpmode	BGP announce mode for routes
comment	string	Comment
crypt-algorithm	ipsec-crypt-algorithm	Encryption algorithm for OSPFv3	null
crypt-key	hexBinary	Key for OSPFv3 encryption
dead-interval	duration	Default router dead interval	45
hello-interval	duration	Default hello interval	9
instance	unsignedByte	Instance ID for OSPFv3
interfaces	List of NMTOKEN	Ethernet interfaces to which this OSPF config applies	All
ipsec-type	ipsec-type	Encapsulation type for OSPFv3 security	ESP
key-id	integer	Key ID for OSPFv2 MD5 authentication (-1 for simple auth)	1
localpref	unsignedInt	Base localpref (highest wins)
log	NMTOKEN	Log calls	Not logging
log-debug	NMTOKEN	Log debug and SIP messages	Not logging
log-error	NMTOKEN	Log errors	Log as event
name	string	Name
password	Secret	Secret for OSPFv2 MD5 authentication
priority	unsignedByte	Default priority	1
profile	NMTOKEN	Profile name
router-id	IP4Addr	Router ID
rxmt-interval	duration	Default router retransmit interval	3
source	string	Source of data, used in automated config management
spi	ipsec-spi 256-4294967295	SPI for OSPFv3 security (unset for no security)
stub	boolean	Stub area
table	routetable 0-99	Routing table	0

Mapping and filtering rules of BGP prefixes

This defines a set of named rules for mapping and filtering of prefixes to/from a BGP peer.

namedbgpmap: Attributes
Attribute	Type	Description	Default
comment	string	Comment
name	NMTOKEN	Name	Not optional
source	string	Source of data, used in automated config management

namedbgpmap: Elements
Element	Type	Instances	Description
match	bgprule	Optional, unlimited	List rules, in order of checking

Individual mapping/filtering rule

An individual rule for BGP mapping/filtering

bgprule: Attributes
Attribute	Type	Description
comment	string	Comment
community	Community	Community that must be present to match
detag	List of Community	List of community tags to remove
drop	boolean	Do not import/export this prefix
localpref	unsignedInt	Set localpref (highest wins)
med	unsignedInt	Set MED
name	string	Name
no-community	Community	Community that must not be present to match
pad	unsignedByte	Pad (prefix stuff) our AS on export by this many, can be zero to not send our AS
prefix	List of IPFilter	Prefixes that this rule applies to
source	string	Source of data, used in automated config management
tag	List of Community	List of community tags to add

Overall BGP settings

The BGP element defines general BGP settings and a list of peer definitions for the individual BGP peers.

bgp: Attributes
Attribute	Type	Description	Default
as	unsignedInt	Our AS
blackhole-community	Community	Community tag to mark black hole routes
cluster-id	IP4Addr	Our cluster ID
comment	string	Comment
dead-end-community	Community	Community tag to mark dead end routes
id	IP4Addr	Our router ID
log	NMTOKEN	Log events	Not logging
name	string	Name
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0

bgp: Elements
Element	Type	Instances	Description
peer	bgppeer	Optional, up to 50	List of peers/neighbours

BGP peer definitions

The peer definition specifies the attributes of an individual peer. Multiple IP addresses can be specified, typically for IPv4 and IPv6 addresses for the same peer, but this can be used for a group of similar peers.

bgppeer: Attributes
Attribute	Type	Description	Default
add-own-as	boolean	Add our AS on exported routes
allow-export	boolean	Ignore no-export community and export anyway	true for customer
allow-only-their-as	boolean	Only accept routes that are solely the peers AS
allow-own-as	boolean	Allow our AS inbound
as	unsignedInt	Peer AS
blackhole-community	Community	Egress community tag to mark black hole routes	Not announced on EBGP, our blackhole-community if IBGP
capability-as4	boolean	If supporting AS4	true
capability-graceful-restart	boolean	If supporting Graceful Restart	true
capability-mpe-ipv4	boolean	If supporting MPE for IPv4	true
capability-mpe-ipv6	boolean	If supporting MPE for IPv6	true
capability-route-refresh	boolean	If supporting Route Refresh	true
clean-shutdown-wait	duration	Send peers low priority and delay on shutdown
comment	string	Comment
drop-default	boolean	Ignore default route received	false
export-filters	List of NMTOKEN	Named export filters to apply
export-med	unsignedInt	Set MED on exported routes (unless export filter sets it)
holdtime	unsignedInt	Hold time	30
ignore-bad-optional-partial	boolean	Ignore routes with a recognised badly formed optional that is flagged partial	true
import-filters	List of NMTOKEN	Named import filters to apply
import-localpref	unsignedInt	Set localpref on imported routes (unless import filter sets it)
import-tag	List of Community	List of community tags to add in addition to any import filters
in-soft	boolean	Mark received routes as soft
ip	List of IPAddr	One or more IPs of neighbours (omit to allow incoming)
log-debug	NMTOKEN	Log debug	Not logging
max-prefix	bgp-prefix-limit 1-10000	Limit prefixes (IPv4+IPv6)	10000
md5	Secret	MD5 signing secret
name	string	Name
next-hop-self	boolean	Force us as next hop outbound	false
no-fib	boolean	Don't include received routes in packet forwarding
pad	unsignedByte	Pad (prefix stuff) our AS on export by this many
profile	NMTOKEN	Profile name
same-ip-type	boolean	Only accept/send IPv4 routes to IPv4 peers and IPv6 routes to IPv6 peers	true
send-default	boolean	Send a default route to this peer	false
send-no-routes	boolean	Don't send any normal routes	false
shutdown	boolean	Shutdown this neighbour (deprecated, use profile)
source	string	Source of data, used in automated config management
timer-idle	unsignedInt	Idle time after error	60
timer-openwait	unsignedInt	Time to wait for OPEN on connection	10
timer-retry	unsignedInt	Time to retry the neighbour	10
ttl-security	byte	Enable RFC5082 TTL security (if +ve, 1 to 127), i.e. 1 for adjacent router. If -ve (-1 to -128) set forced sending TTL, i.e. -1 for TTL of 1 sending, and not checking.
type	peertype	Type of neighbour (affects some defaults)	normal
use-vrrp-as-self	boolean	Use VRRP address as self if possible	true if customer/transit type

bgppeer: Elements
Element	Type	Instances	Description
export	bgpmap	Optional	Mapping and filtering rules of announcing prefixes to peer
import	bgpmap	Optional	Mapping and filtering rules of accepting prefixes from peer

Mapping and filtering rules of BGP prefixes

This defines the rules for mapping and filtering of prefixes to/from a BGP peer.

bgpmap: Attributes
Attribute	Type	Description
comment	string	Comment
detag	List of Community	List of community tags to remove
drop	boolean	Do not import/export this prefix
localpref	unsignedInt	Set localpref (highest wins)
med	unsignedInt	Set MED
prefix	List of IPFilter	Drop all that are not in this prefix list
source	string	Source of data, used in automated config management
tag	List of Community	List of community tags to add

bgpmap: Elements
Element	Type	Instances	Description
match	bgprule	Optional, unlimited	List rules, in order of checking

Constant Quality Monitoring settings

Constant quality monitoring (graphs and data) have a number of settings. Most of the graphing settings can be overridden when a graph is collected so these define the defaults in many cases.

cqm: Attributes
Attribute	Type	Description	Default
ave	Colour	Colour for average latency	#08f
axis	Colour	Axis colour	black
background	Colour	Background colour	white
bottom	unsignedByte	Pixels space at bottom of graph	11
dateformat	string	Date format	%Y-%m-%d
dayformat	string	Day format	%a
fail	Colour	Colour for failed (dropped) seconds	red
fail-level	unsignedInt	Fail level not expected on low usage	1
fail-level1	unsignedByte	Loss level 1	3
fail-level2	unsignedByte	Loss level 2	50
fail-score	unsignedByte	Score for fail and low usage	200
fail-score1	unsignedByte	Score for on/above level 1	100
fail-score2	unsignedByte	Score for on/above level 2	200
fail-usage	unsignedInt	Usage below which fail is not expected	128000
fblogo	Colour	Colour for logo	#bd1220
graticule	Colour	Graticule colour	grey
heading	string	Heading of graph
hourformat	string	Hour format	%H
key	unsignedByte	Pixels space for key	90
label-ave	string	Label for average latency	Av
label-damp	string	Label for % shaper damping	Damp%
label-fail	string	Label for seconds (%) failed	%Fail
label-latency	string	Label for latency	Latency
label-max	string	Label for maximum latency	Max
label-min	string	Label for minimum latency	Min
label-off	string	Label for off line seconds	Off
label-period	string	Label for period	Period
label-poll	string	Label for polls	Polls
label-rej	string	Label for rejected seconds	%Reject
label-rx	string	Label for Rx traffic level	Rx
label-score	string	Label for score	Score
label-sent	string	Label for seconds polled	Sent
label-shaper	string	Label for shaper	Shaper
label-time	string	Label for time	Time
label-traffic	string	Label for traffic level	Traffic (bit/s)
label-tx	string	Label for Tx traffic level	Tx
latency-level	unsignedInt	Latency level not expected on low usage	100000000
latency-level1	unsignedInt	Latency level 1 (ns)	100000000
latency-level2	unsignedInt	Latency level 2 (ns)	500000000
latency-score	unsignedByte	Score for high latency and low usage	200
latency-score1	unsignedByte	Score for on/above level 1	10
latency-score2	unsignedByte	Score for on/above level 2	20
latency-usage	unsignedInt	Usage below which latency is not expected	128000
left	unsignedByte	Pixels space left of main graph	0
log	NMTOKEN	Log events	Not logging
max	Colour	Colour for maximum latency	green
min	Colour	Colour for minimum latency	#008
ms-max	positiveInteger	ms max height	500
off	Colour	Colour for off line seconds	#c8f
outside	Colour	Colour for outer border	transparent
ping-update	duration	Interval for periodic updates	1:00:00
ping-url	string	URL for ping list
rej	Colour	Colour for off line seconds	#f8c
right	unsignedByte	Pixels space right of main graph	50
rx	Colour	Colour for Rx traffic level	#800
secret	Secret	Secret for MD5 coded URLs
sent	Colour	Colour for polled seconds	#ff8
share-interface	NMTOKEN	Interface on which to broadcast data for shaper sharing
share-secret	string	Secret to validate shaper sharing
subheading	string	Subheading of graph
text	Colour	Colour for text	black
text1	string	Text line 1
text2	string	Text line 2
text3	string	Text line 3
text4	string	Text line 4
timeformat	string	Time format	%Y-%m-%d %H:%M:%S
top	unsignedByte	Pixels space at top of graph	4
tx	Colour	Colour for Tx traffic level	#080

L2TP settings

L2TP settings for incoming and outgoing L2TP connections

l2tp: Attributes
Attribute	Type	Description	Default
accounting-interval	duration	Periodic interim accounting interval	1:00:00
send-acct-delay	boolean	Send Acct-Delay as well as Event-Timestamp on accounting

l2tp: Elements
Element	Type	Instances	Description
incoming	l2tp-incoming	Optional, unlimited	Incoming L2TP connections
outgoing	l2tp-outgoing	Optional, unlimited	Outgoing L2TP connections

L2TP settings for outgoing L2TP connections

L2TP tunnel settings for outgoing L2TP connections

l2tp-outgoing: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
called	string	called-station-idi to send
calling	string	calling-station-id to send
comment	string	Comment
cug	cug 1-32767	Closed user group ID
cug-restrict	boolean	Closed user group restricted traffic (only to/from same CUG ID)
fail-lockout	unsignedByte	Interval kept in failed state	1
graph	string	Graph name
hdlc	boolean	Send HDLC header (FF03) on all PPP frames	true
hello-interval	unsignedByte	Interval between HELLO messages	10
hostname	string	The hostname we quote on tunnel connect	System name
ip	IPAddr	IP of far end	Not optional
lcp-data-len	unsignedByte	LCP data field length
lcp-rate	unsignedByte	LCP interval (seconds)	10
lcp-timeout	unsignedByte	LCP timeout (seconds)	61
local	IP4Addr	Local IPv4 address
local-ip	IPAddr	IP of our end
localpref	unsignedInt	Localpref for remote-ip/routes (highest wins)	4294967295
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
min-retry	duration	Minimum session time before retrying connection	10
mtu	mtu 576-2000	Default MTU for sessions in this tunnel
name	string	Name
open-timeout	unsignedByte	Interval before OPEN considered failed	10
ospf	boolean	OSPF announce mode for route	true
password	Secret	Password for login
payload-table	routetable 0-99	Routing table number for payload traffic	0
profile	NMTOKEN	Profile name
receive-window	unsignedShort	Receive window to advise on connection	Not sent
remote	IP4Addr	Remote IPv4 address
retry-timeout	unsignedByte	Interval to retry sending control messages before fail	10
routes	List of IPPrefix	Routes when link up	Default gateway
rx-speed	unsignedInt	Send ingress rate (b/s)
secret	Secret	Shared secret
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number for L2TP session	0
tcp-mss-fix	boolean	Adjust MSS option in TCP SYN to fix session MSS	false
tx-speed	unsignedInt	Egress rate limit (b/s)
username	string	User name for login

l2tp-outgoing: Elements
Element	Type	Instances	Description
route	ppp-route	Optional, unlimited	Routes to apply when link is up

L2TP settings for incoming L2TP connections

L2TP tunnel settings for incoming L2TP connections

l2tp-incoming: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which connects can be made
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
damping	boolean	Apply damping to sessions if limiting on shaper	false
dhcpv6dns	List of IP6Addr	List of IPv6 DNS servers
dos-limit	unsignedInt	Per second per session tx packet drop limit for DOS protection	10000
fail-lockout	unsignedByte	Interval kept in failed state	60
graph	string	Graph name
hdlc	boolean	Send HDLC header (FF03) on all PPP frames	true
hello-interval	unsignedByte	Interval between HELLO messages	60
icmp-ppp	boolean	Use PPP endpoint for ICMP	false
ipv6ep	IP4Addr	Local end IPv4 for IPv6 tunnels
lcp-data-len	unsignedByte	LCP data field length
lcp-mru-fix	boolean	Restart LCP if RAS negotiated MRU is too high	false
lcp-rate	unsignedByte	LCP interval (seconds)	1
lcp-timeout	unsignedByte	LCP timeout (seconds)	10
local-hostname	string	Hostname quoted on reply	System name
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
mtu	mtu 576-2000	Default MTU for sessions in this tunnel
name	string	Name
open-timeout	unsignedByte	Interval before OPEN considered failed	60
ospf	boolean	OSPF announce mode for route	true
payload-table	routetable 0-99	Routing table number for payload traffic	0
pppdns1	IP4Addr	PPP DNS1 IPv4 default
pppdns2	IP4Addr	PPP DNS2 IPv4 default
pppip	IP4Addr	Local end PPP IPv4
profile	NMTOKEN	Profile name
radius	string	Name for RADIUS server config to use
receive-window	unsignedShort	Receive window to advise on connection	Not sent
relay-nas-ip	boolean	Pass remote L2TP endpoint as NAS IP	true
remote-hostname	string	Hostname expected on connection
require-platform	boolean	All sessions require a platform RADIUS first	false
require-radius-acct	boolean	Close session if cannot do RADIUS accounting
retry-timeout	unsignedByte	Interval to retry sending control messages before fail	60
secret	Secret	Shared secret
shutdown	boolean	Refuse all new sessions or tunnels	false
source	string	Source of data, used in automated config management
speed	unsignedInt	Default egress rate limit (b/s)
table	routetable 0-99	Routing table number for L2TP session	Any
tcp-mss-fix	boolean	Adjust MSS option in TCP SYN to fix session MSS	false
test	List of IPAddr	List of IPs to which routing must exist else tunnel dropped (deprecated)

l2tp-incoming: Elements
Element	Type	Instances	Description
match	l2tp-relay	Optional, unlimited	Rules for relaying connections and local authentication

Relay and local authentication rules for L2TP

Rules for relaying L2TP or local authentication

l2tp-relay: Attributes
Attribute	Type	Description	Default
called-station-id	List of string	One or more patterns to match called-station-id
calling-station-id	List of string	One or more patterns to match calling-station-id
comment	string	Comment
graph	graphname (token)	Graph name
ip-over-lcp	boolean	Send IP over LCP (local auth)
lcp-echo-mim	boolean	Handle LCP echos in the middle on relayed connection
localpref	unsignedInt	Localpref for remote-ip/routes (highest wins)	4294967295
name	string	Name
password	Secret	Password check
profile	NMTOKEN	Profile name
relay-hostname	string	Hostname for L2TP connection
relay-ip	List of IPAddr	Target IP(s) for L2TP connection
relay-pick	boolean	If set, try one of the relay IPs at random first
relay-secret	Secret	Shared secret for L2TP connection
remote-ip	IP4Addr	Remote end PPP IPv4 (local auth)
remote-netmask	IP4Addr	Remote end PPP Netmask (local auth)
routes	List of IPPrefix	Additional routes when link up (local auth)
source	string	Source of data, used in automated config management
test	List of IPAddr	List of IPs that must have routing for this target to be valid (deprecated)
username	List of string	One or more patterns to match username

FB105 tunnel definition

fb105: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
fast-udp	boolean	Send UDP packets marked not to be reordered	true
graph	graphname (token)	Graph name
internal-ip	IP4Addr	Internal IP for traffic originated and sent down tunnel	local-ip
ip	IP4Addr	Far end IP	dynamic tunnel
keep-alive	boolean	Constantly send keep alive packets	true if ip set
local-id	unsignedByte	Unique local end tunnel ID	Not optional
local-ip	IP4Addr	Force specific local end IP
localpref	unsignedInt	Localpref for route (highest wins)	4294967295
log	NMTOKEN	Log events	Not logging
log-error	NMTOKEN	Log errors	Log as event
mtu	unsignedShort	MTU for wrapped packets	1500
name	NMTOKEN	Name
ospf	boolean	OSPF announce mode for route	true
payload-table	routetable 0-99	Routing table number for payload traffic	0
port	unsignedShort	UDP port to use	1
profile	NMTOKEN	Profile name
remote-id	unsignedByte	Unique remote end tunnel ID	Not optional
reorder	boolean	Reorder incoming tunnel packets	false
reorder-maxq	fb105-reorder-maxq 1-100	Max queue length for out of order packets	32
reorder-timeout	fb105-reorder-timeout 10-5000	Max time to delay out of order packet (ms)	100
routes	List of IPPrefix	Routes when link up	None
satellite	boolean	Mark links that are high speed and latency for split latency bonding (experimental)
secret	Secret	Shared secret for tunnel	Unsigned
set	unsignedByte	Set ID for reorder ID tagging (create a set of tunnels together)
sign-all	boolean	All packets must be signed, not just keepalives	false
source	string	Source of data, used in automated config management
speed	unsignedInt	Egress rate limit used (b/s)	no shaping
table	routetable 0-99	Routing table number for tunnel wrappers	0
tcp-mss-fix	boolean	Adjust MSS option in TCP SYN to fix session MSS	true

fb105: Elements
Element	Type	Instances	Description
route	fb105-route	Optional, unlimited	Routes to apply to tunnel when up

FB105 routes

Routes for prefixes that are sent to the FB105 tunnel when up

fb105-route: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
ip	List of IPPrefix	One or more network prefixes	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management

IPsec configuration (IKEv2)

IPsec IKE and manually-keyed connection details

ipsec-ike: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which IKE connections are allowed	Allow from anywhere
force-NAT	List of IPNameRange	List of IP ranges of peers requiring forced NAT-T
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
trusted	List of IPNameRange	List of IP ranges given higher priority when establshing new connections
comment	string	Comment
source	string	Source of data, used in automated config management

ipsec-ike: Elements
Element	Type	Instances	Description
IKE-proposal	ike-proposal	Optional, unlimited	Proposals for IKE security association
IPsec-proposal	ipsec-proposal	Optional, unlimited	Proposals for IPsec AH/ESP security association
connection	ike-connection (ipsec-connection-common)	Optional, unlimited	IKE connections
manually-keyed	ipsec-manual (ipsec-connection-common)	Optional, unlimited	IPsec manually-keyed connections (not recommended)
roaming	ike-roaming	Optional, unlimited	IKE roaming IP pools

connection configuration

IPsec IKE connection settings

ike-connection: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
graph	graphname (token)	Graph name
internal-ipv4	IP4Addr	Internal IPv4 for traffic originated on the FireBrick and sent down tunnel	local-ip
internal-ipv6	IP6Addr	Internal IPv6 for traffic originated on the FireBrick and sent down tunnel	local-ip
local-ip	IPAddr	Local IP
localpref	unsignedInt	Localpref for route (highest wins)	4294967295
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
mtu	unsignedShort	MTU for wrapped packets	1500
name	NMTOKEN	Name
ospf	boolean	OSPF announce mode for route	true
payload-table	routetable 0-99	Routing table number for payload traffic	0
peer-ips	List of IPNameRange	peer's IP or range	Accept from anywhere
profile	NMTOKEN	Profile name
routes	List of IPPrefix	Routes when link up
source	string	Source of data, used in automated config management
speed	unsignedInt	Egress rate limit used (b/s)	no shaping
table	routetable 0-99	Routing table number for IKE traffic and tunnel wrappers	0
tcp-mss-fix	boolean	Adjust MSS option in TCP SYN to fix session MSS	true
type	ipsec-type	Encapsulation type	ESP
auth-method	ike-authmethod	method for authenticating self to peer	Not optional
blackhole	boolean	Blackhole routed traffic when tunnel is not up	false
certlist	List of NMTOKEN	Certificate(s) to be used to authenticate self	use any suitable
dead-peer-detect	duration	check peer is alive at least this often - 0 to inhibit	30
ike-proposals	List of NMTOKEN	IKE proposal list	use built-in default proposals
ipsec-proposals	List of NMTOKEN	IPsec proposal list	use built-in default proposals
lifetime	duration	max lifetime before renegotiation	1:00:00
local-ID	string	Local IKE ID
local-ts	List of IPRange	Valid outgoing-source/incoming-destination IPs for tunnelled traffic	Allow any
mode	ike-mode	ike connection setup mode	Wait
peer-ID	string	Peer IKE ID
peer-auth-method	ike-authmethod	method for authenticating peer	Use auth-method
peer-certlist	List of NMTOKEN	Certificate trust anchor(s) acceptable for authenticating peer	accept any suitable
peer-secret	Secret	shared secret used to authenticate peer	use secret
peer-ts	List of IPRange	Valid outgoing-destination/incoming-source IPs for tunnelled traffic	Allow any
peer-ts-from-routes	boolean	Send traffic selector based on routing Also works as ts-from-routes, which is deprecated	false
query-eap-id	boolean	Query client for EAP identity	true
roaming-pool	NMTOKEN	IKE roaming IP pool
secret	Secret	shared secret used to authenticate self to peer

ike-connection: Elements
Element	Type	Instances	Description
route	ipsec-route	Optional, unlimited	Routes to apply to tunnel when up

IPsec tunnel routes

Routes for prefixes that are sent to the IPsec tunnel

ipsec-route: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
ip	List of IPPrefix	One or more network prefixes	Not optional
localpref	unsignedInt	Localpref of network (highest wins)	4294967295
name	string	Name
ospf	boolean	OSPF announce mode for route	true
profile	NMTOKEN	Profile name
source	string	Source of data, used in automated config management

IKE roaming IP pools

Pool of IP addresses and associated DNS/NBNS servers for dynamic IP allocation

ike-roaming: Attributes
Attribute	Type	Description	Default
DNS	List of IPAddr	List of DNS servers available to clients
NBNS	List of IPAddr	List of NetBios name servers available to clients
comment	string	Comment
ip	List of IPRange	List of IP ranges for allocation to road-warrior clients	Not optional
name	NMTOKEN	Name	Not optional
nat	boolean	NAT incoming IPv4 traffic unless set otherwise in rules	false
source	string	Source of data, used in automated config management

IKE security proposal

Proposal for establishing the IKE security association

ike-proposal: Attributes
Attribute	Type	Description	Default
DHset	Set of ike-DH	Diffie-Hellman group for IKE negotiation	Accept any supported group
PRFset	Set of ike-PRF	Pseudo-Random function for key generation	Accept any supported function
authset	Set of ipsec-auth-algorithm	Integrity check algorithm for IKE messages	Accept any supported algorithm
cryptset	Set of ipsec-crypt-algorithm	Encryption algorithm for IKE messages	Accept any supported algorithm
name	NMTOKEN	Name	Not optional

IPsec AH/ESP proposal

Proposal for establishing the IPsec AH/ESP keying information

ipsec-proposal: Attributes
Attribute	Type	Description	Default
DHset	Set of ike-DH	Diffie-Hellman group for IPsec key negotiation	Accept any supported group
ESN	Set of ike-ESN	Support for extended sequence numbers	Accept ESN or short SN
authset	Set of ipsec-auth-algorithm	Integrity check algorithm for IPsec traffic	Accept any supported algorithm
cryptset	Set of ipsec-crypt-algorithm	Encryption algorithm for IPsec traffic	Accept any supported algorithm
name	NMTOKEN	Name	Not optional

peer configuration

IPsec manually keyed connection settings (not recommended, use IKEv2 and secrets instead)

ipsec-manual: Attributes
Attribute	Type	Description	Default
bgp	bgpmode	BGP announce mode for routes	Not announced
comment	string	Comment
graph	graphname (token)	Graph name
internal-ipv4	IP4Addr	Internal IPv4 for traffic originated on the FireBrick and sent down tunnel	local-ip
internal-ipv6	IP6Addr	Internal IPv6 for traffic originated on the FireBrick and sent down tunnel	local-ip
local-ip	IPAddr	Local IP
localpref	unsignedInt	Localpref for route (highest wins)	4294967295
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
mtu	unsignedShort	MTU for wrapped packets	1500
name	NMTOKEN	Name
ospf	boolean	OSPF announce mode for route	true
payload-table	routetable 0-99	Routing table number for payload traffic	0
peer-ips	List of IPNameRange	peer's IP or range	Accept from anywhere
profile	NMTOKEN	Profile name
routes	List of IPPrefix	Routes when link up
source	string	Source of data, used in automated config management
speed	unsignedInt	Egress rate limit used (b/s)	no shaping
table	routetable 0-99	Routing table number for IKE traffic and tunnel wrappers	0
tcp-mss-fix	boolean	Adjust MSS option in TCP SYN to fix session MSS	true
type	ipsec-type	Encapsulation type	ESP
auth-algorithm	ipsec-auth-algorithm	Manual setting for authentication algorithm	null
auth-key	hexBinary	Manual key for authentication
crypt-algorithm	ipsec-crypt-algorithm	Manual setting for encryption algorithm	null
crypt-key	hexBinary	Manual key for encryption
local-spi	ipsec-spi 256-4294967295	Local Security Parameters Index	Not optional
mode	ipsec-encapsulation	Encapsulation mode	tunnel
outer-spi	ipsec-spi 256-4294967295	Security Parameters Index for outer header
remote-spi	ipsec-spi 256-4294967295	Peer Security Parameters Index	Not optional

ipsec-manual: Elements
Element	Type	Instances	Description
route	ipsec-route	Optional, unlimited	Routes to apply to tunnel when up

Ping/graph definition

Base ping config - additional ping targets set via web API or other means

ping: Attributes
Attribute	Type	Description	Default
comment	string	Comment
graph	graphname (token)	Graph name	Not optional
ip	IPNameAddr	Far end IP	Not optional
name	string	Name
profile	NMTOKEN	Profile name
size	ping-size 0-1472	Payload size	0
slow	boolean	Slow polling	Auto
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number for sending pings	0

Control profile

General on/off control profile used in various places in the config.

profile: Attributes
Attribute	Type	Description	Default
and	List of NMTOKEN	Active if all specified profiles are active as well as all other tests passing, including 'not'
comment	string	Comment
control-switch-users	List of NMTOKEN	Restrict users that have access to control switch	Any users
expect	boolean	Defines state considered 'Good' and shown green on status page	true
fb105	List of NMTOKEN	FB105 tunnel state (any of these active)
initial	boolean	Defines state at system startup if not using set, or initial state of a new control switch	true
interval	duration	Time between tests	1
invert	boolean	Invert final result of testing
log	NMTOKEN	Log target	Not logging
log-debug	NMTOKEN	Log additional information	Not logging
name	NMTOKEN	Profile name	Not optional
not	NMTOKEN	Active if specified profile is inactive as well as all other tests passing, including 'and'
or	List of NMTOKEN	Active if any of these other profiles are active regardless of other tests (including 'not' or 'and')
ports	Set of port	Test passes if any of these physical ports are up
ppp	List of NMTOKEN	PPP link state (any of these are up)
recover	duration	Time before recover (i.e. how long test has been passing)	1
route	List of IPAddr	Test passes if all specified addresses are routeable
set	switch	Manual override. Test settings ignored; Control switches can use and/or/not/invert
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table for ping/route
timeout	duration	Time before timeout (i.e. how long test has been failing)	10
vrrp	List of NMTOKEN	VRRP state (any of these is master)

profile: Elements
Element	Type	Instances	Description
date	profile-date	Optional, unlimited	Test passes if within any date range specified
ping	profile-ping	Optional	Test passes if address is answering pings
time	profile-time	Optional, unlimited	Test passes if within any time range specified

Test passes if within any of the time ranges specified

Time range test in profiles

profile-date: Attributes
Attribute	Type	Description
comment	string	Comment
start	dateTime	Start (YYYY-MM-DDTHH:MM:SS)
stop	dateTime	End (YYYY-MM-DDTHH:MM:SS)

Test passes if within any of the date/time ranges specified

Time range test in profiles

profile-time: Attributes
Attribute	Type	Description
comment	string	Comment
days	Set of day	Which days of week apply, default all
start	time	Start (HH:MM:SS)
stop	time	End (HH:MM:SS)

Test passes if any addresses are pingable

Ping targets

profile-ping: Attributes
Attribute	Type	Description	Default
flow	unsignedShort	Flow label (IPv6)
gateway	IPAddr	Ping via specific gateway (bypasses session tracking if set)
ip	IPAddr	Target IP	Not optional
source-ip	IPAddr	Source IP
ttl	unsignedByte	Time to live / Hop limit

Traffic shaper

Settings for a named traffic shaper

shaper: Attributes
Attribute	Type	Description	Default
comment	string	Comment
name	graphname (token)	Graph name	Not optional
rx	unsignedInt	Rx rate limit/target (b/s)
rx-max	unsignedInt	Rx rate limit max
rx-min	unsignedInt	Rx rate limit min
rx-min-burst	duration	Rx minimum allowed burst time
rx-step	unsignedInt	Rx rate reduction per hour
share	boolean	If shaper is shared with other devices
source	string	Source of data, used in automated config management
tx	unsignedInt	Tx rate limit/target (b/s)
tx-max	unsignedInt	Tx rate limit max
tx-min	unsignedInt	Tx rate limit min
tx-min-burst	duration	Tx minimum allowed burst time
tx-step	unsignedInt	Tx rate reduction per hour

shaper: Elements
Element	Type	Instances	Description
override	shaper-override	Optional, unlimited	Profile specific variations on main settings

Traffic shaper override based on profile

Settings for a named traffic shaper

shaper-override: Attributes
Attribute	Type	Description	Default
comment	string	Comment
profile	NMTOKEN	Profile name	Not optional
rx	unsignedInt	Rx rate limit/target (b/s)
rx-max	unsignedInt	Rx rate limit max
rx-min	unsignedInt	Rx rate limit min
rx-min-burst	duration	Rx minimum allowed burst time
rx-step	unsignedInt	Rx rate reduction per hour
source	string	Source of data, used in automated config management
tx	unsignedInt	Tx rate limit/target (b/s)
tx-max	unsignedInt	Tx rate limit max
tx-min	unsignedInt	Tx rate limit min
tx-min-burst	duration	Tx minimum allowed burst time
tx-step	unsignedInt	Tx rate reduction per hour

IP Group

Named IP group

ip-group: Attributes
Attribute	Type	Description	Default
comment	string	Comment
ip	List of IPRange	One or more IP ranges or IP/len
name	string	Name	Not optional
source	string	Source of data, used in automated config management
users	List of NMTOKEN	Include IP of (time limited) logged in web users

Routing override rules

route-override: Attributes
Attribute	Type	Description	Default
comment	string	Comment
name	string	Name
source	string	Source of data, used in automated config management
table	routetable 0-99	Applicable routing table	0

route-override: Elements
Element	Type	Instances	Description
rule	session-route-rule	Optional, unlimited	Individual rules, first match applies

Routing override rule

session-route-rule: Attributes
Attribute	Type	Description
comment	string	Comment
cug	List of PortRange	Closed user group ID(s)
hash	boolean	Use hash of IPs for load sharing
name	string	Name
profile	NMTOKEN	Profile name
protocol	List of unsignedByte	Protocol(s) [1=ICMP, 6=TCP, 17=UDP]
set-gateway	IPAddr	New gateway
set-graph	string	Graph name for shaping/logging (if not set by rule-set)
set-nat	boolean	Changed source IP and port to local for NAT
source	string	Source of data, used in automated config management
source-interface	List of NMTOKEN	Source interface(s)
source-ip	List of IPNameRange	Source IP address range(s)
source-port	List of PortRange	Source port(s)
target-interface	List of NMTOKEN	Target interface(s)
target-ip	List of IPNameRange	Target IP address range(s)
target-port	List of PortRange	Target port(s)

session-route-rule: Elements
Element	Type	Instances	Description
share	session-route-share	Optional, unlimited	Load shared actions

Route override load sharing

Route override setting for load sharing

session-route-share: Attributes
Attribute	Type	Description	Default
comment	string	Comment
profile	NMTOKEN	Profile name
set-gateway	IPAddr	New gateway
set-graph	string	Graph name for shaping/logging (if not set by rule-set)
set-nat	boolean	Changed source IP and port to local for NAT
weight	positiveInteger	Weighting of load share	1

Firewall/mapping rule set

Firewalling rule set with entry criteria and default actions

rule-set: Attributes
Attribute	Type	Description	Default
comment	string	Comment
cug	List of PortRange	Closed user group ID(s)
interface	List of NMTOKEN	Source or target interface(s)
ip	List of IPNameRange	Source or target IP address range(s)
log	NMTOKEN	Log session start	Not logging
log-end	NMTOKEN	Log session end	Not logging
log-no-match	NMTOKEN	Log if no match	log-start
name	string	Name
no-match-action	firewall-action	Default if no rule matches	Not optional
profile	NMTOKEN	Profile name
protocol	List of unsignedByte	Protocol(s) [1=ICMP, 6=TCP, 17=UDP]
source	string	Source of data, used in automated config management
source-interface	List of NMTOKEN	Source interface(s)
source-ip	List of IPNameRange	Source IP address range(s)
source-port	List of PortRange	Source port(s)
startup-delay	duration	Startup interval to use ignore instead of reject/drop	1:00
table	routetable 0-99	Applicable routing table	0
target-interface	List of NMTOKEN	Target interface(s)
target-ip	List of IPNameRange	Target IP address range(s)
target-port	List of PortRange	Target port(s)

rule-set: Elements
Element	Type	Instances	Description
ip-group	ip-group	Optional, unlimited	Named IP groups
rule	session-rule	Optional, unlimited	Individual rules, first match applies

Firewall rules

Firewall rule

The individual firewall rules are checked in order within the rule-set, and the first match applied. The default action for a rule is continue, so once matched the next rule-set is considered.

session-rule: Attributes
Attribute	Type	Description	Default
action	firewall-action	Action taken on match	continue
comment	string	Comment
cug	List of PortRange	Closed user group ID(s)
hash	boolean	Use hash of IPs for load sharing
interface	List of NMTOKEN	Source or target interface(s)
ip	List of IPNameRange	Source or target IP address range(s)
log	NMTOKEN	Log session start	As rule-set
log-end	NMTOKEN	Log session end	As rule-set
name	string	Name
profile	NMTOKEN	Profile name
protocol	List of unsignedByte	Protocol(s) [1=ICMP, 6=TCP, 17=UDP]
set-gateway	IPAddr	New gateway
set-graph	string	Graph name for shaping/logging
set-graph-dynamic	dynamic-graph	Dynamically create graph
set-initial-timeout	duration	Initial time-out
set-nat	boolean	Changed source IP and port to local for NAT
set-ongoing-timeout	duration	Ongoing time-out
set-reverse-graph	string	Graph name for shaping/logging (far side of session)
set-source-ip	IPAddr	New source IP
set-source-port	unsignedShort	New source port
set-table	routetable 0-99	Set new routing table
set-target-ip	IPAddr	New target IP
set-target-port	unsignedShort	New target port
source	string	Source of data, used in automated config management
source-interface	List of NMTOKEN	Source interface(s)
source-ip	List of IPNameRange	Source IP address range(s)
source-mac	List of up to 12 macprefix (hexBinary)	Source MAC check if from Ethernet
source-port	List of PortRange	Source port(s)
target-interface	List of NMTOKEN	Target interface(s)
target-ip	List of IPNameRange	Target IP address range(s)
target-port	List of PortRange	Target port(s)

session-rule: Elements
Element	Type	Instances	Description
share	session-share	Optional, unlimited	Load shared actions

Firewall load sharing

Firewall actions for load sharing

session-share: Attributes
Attribute	Type	Description	Default
comment	string	Comment
profile	NMTOKEN	Profile name
set-gateway	IPAddr	New gateway
set-graph	string	Graph name for shaping/logging
set-nat	boolean	Changed source IP and port to local for NAT
set-reverse-graph	string	Graph name for shaping/logging (far side of session)
set-source-ip	IPAddr	New source IP
set-source-port	unsignedShort	New source port
set-table	routetable 0-99	Set new routing table
set-target-ip	IPAddr	New target IP
set-target-port	unsignedShort	New target port
weight	positiveInteger	Weighting of load share	1

Voice over IP config

voip: Attributes
Attribute	Type	Description	Default
area-code	string	Local area code (without national prefix)
auth-source-ip4	IP4Addr	Default IPv4 source address to use when sending authenticated messages
auth-source-ip6	IP6Addr	Default IPv6 source address to use when sending authenticated messages
backup-carrier	NMTOKEN	Backup carrier to use for external calls
call-progress	boolean	Send call progress at 3 seconds	true
comment	string	Comment
country	string	Local country code	44
default-carrier	NMTOKEN	Default carrier to use for external calls
domain	string	Domain to use for us on outgoing SIP connections
emergency	List of string	Emergency numbers	112 999
emergency-uri	string	SIP URI for emergency calls	Use outbound carrier
international	string	International dialling prefix	00
local-digits	string	Local numbers start with these digits	23456789
local-min-len	unsignedByte	Local numbers min length	5
log	NMTOKEN	Log calls	Not logging
log-cdr	NMTOKEN	Log CDR records	Not logged
log-debug	NMTOKEN	Log debug and SIP messages	Not logging
log-error	NMTOKEN	Log errors	Log as event
log-sip-blf	NMTOKEN	SUBSCRIBE, NOTIFY, PUBLISH	Not logged
log-sip-call	NMTOKEN	INVITE, ACK, CANCEL, BYE, REFER	Not logged
log-sip-other	NMTOKEN	OPTIONS, INFO, etc	Not logged
log-sip-register	NMTOKEN	REGISTER	Not logged
long-headers	boolean	Send long SIP headers	false
max-ring	duration	Max time limit on call setup	5:00
national	string	National dialling prefix	0
pabx	boolean	Operate as office PABX	true
pickup	string	Call pickup/steal prefix	*
radius-call	string	Name for RADIUS server config to use call routing
radius-cdr	string	Name for RADIUS server config to use for CDRs
radius-challenge	boolean	Send RADIUS auth to get challenge response
radius-register	string	Name for RADIUS server config to use for registrations
realm	string	Default realm	FireBrick
record-beep	record-beep-option	Send beep at start of recording	true
record-mandatory	boolean	Drop call if recording fails
record-server	string	Call recording server hostname or address
release	string	CLI release prefix	1470
security-replies	boolean	Don't challenge or error reply to unrecognised non local IP request	true
send-pre-auth	boolean	Send Auth header with username before receiving challenge	true
source	string	Source of data, used in automated config management
source-ip4	IP4Addr	Default IPv4 source address to use when sending messages
source-ip6	IP6Addr	Default IPv6 source address to use when sending messages
user-agent	string	User-Agent to send	Version specific
withhold	string	CLI withhold prefix	141

voip: Elements
Element	Type	Instances	Description
carrier	carrier	Optional, up to 250	VoIP carriers
group	ringgroup	Optional, up to 50	Ring groups
telephone	telephone	Optional, up to 250	VoIP users
tone	tone	Optional, up to 25	Defined tones

VoIP carrier details

carrier: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which invite accepted	Allow from anywhere
cli-format	voip-format	CLI number format for outgoing calls	national
comment	string	Comment
cui	string	Chargeable user identity for call accounting of incoming calls
display-name	string	Text name to use
expires	duration	Registration expiry time	1:00:00
extn	string	Local number assumed for incoming call, use X for digits from end of called numbers
force-dtmf	boolean	Always send DTMF in-band
from	string	From SIP address for outbound registration and invites
hold-tone	boolean	Send hold tones to carrier	true
incoming-format	voip-format	Dialled number format for incoming calls	national
map-404	sip-error 400-699	Map SIP error 404 to an alternative
max-calls	unsignedInt	Maximum simultaneous calls allowed
name	NMTOKEN	Carrier name	Not optional
outgoing-format	voip-format	Dialled number format for outgoing calls	national
password	Secret	Carrier password for outbound registration or inbound authenticated calls
profile	NMTOKEN	Profile name
proxy	string	Carrier proxy hostname or address for registration and calls
registrar	string	Carrier hostname for registration
send-hold	boolean	Pass hold state to carrier	true
send-pre-auth	boolean	Send Auth header with username before receiving challenge	As general config
source	string	Source of data, used in automated config management
source-ip	IPAddr	Source IP to use
table	routetable 0-99	Routing table number	0
to	List of string	To SIP request address for inbound invites, may be @domain for any at a domain
tone-hold	string	Name of tone to generate for hold with no media
tone-progress	string	Name of tone to generate for progress with no media
tone-queue	string	Name of tone to generate for queue with no media
tone-ring	string	Name of tone to generate for ring with no media
tone-wait	string	Name of tone to generate for wait with no media
trust-cli	boolean	Trust inbound calling line identity	true
username	string	Carrier username for outbound registration or inbound authenticated calls
withhold	string	Mark withheld outbound calls using this dial prefix and send CLI in remote party id

VoIP telephone authentication user details

VoIP telephone details

telephone: Attributes
Attribute	Type	Description	Default
allow	List of IPNameRange	List of IP ranges from which registration accepted	Allow from anywhere
allow-pickup	List of string	Only allow pickup from these extensions	Allow all if PABX mode
allow-subscribe	List of string	Only allow subscribe (Busy Lamp Field) from these extensions
anon-numeric	boolean	Mark anonymous calls just using withhold prefix, and leave display name
area-code	string	Local area code (without national prefix) for use from this phone
carrier	NMTOKEN	Carrier to use for outbound calls
cli-format	voip-format	CLI number format passed to telephone	auto
comment	string	Comment
cui	string	Chargeable user identity for call accounting
ddi	string	Full telephone number (international format starting +)
display-name	string	Text name to use
email	string	Email address (sent to call recording server)
expires	duration	Registration expiry time	1:00:00
extn	string	Local extension number
force-dtmf	boolean	Always send DTMF in-band
local-only	boolean	Restrict access to registrations from Ethernet subnets only	true
max-calls	unsignedInt	Maximum simultaneous calls allowed
name	NMTOKEN	User name (local part of 'from')	Not optional
password	Secret	Authentication password
profile	NMTOKEN	Profile name
realm	string	Realm
record	recordoption	Automatically record calls
source	string	Source of data, used in automated config management
table	routetable 0-99	Routing table number	0
uk-cli-text	uknumberformat	Send display name as UK formatted number	Auto
uri	string	Direct URI for extn
username	string	Authentication username
wrap-up	duration	Wrap up time before new call

Tone definitions

Definition of tones used

tone: Attributes
Attribute	Type	Description	Default
name	NMTOKEN	Tone name	Not optional
plan	string	Plan for frequency and duration, e.g. 400ms@400Hz-3dB+450Hz-3dB	Not optional

Ring groups

ringgroup: Attributes
Attribute	Type	Description	Default
allow-pickup	List of string	Only allow pickup from these extensions
allow-subscribe	List of string	Only allow subscribe (Busy Lamp Field) from these extensions
answer-time	duration	Answer caller if ringing this long	30
carrier	NMTOKEN	Carrier to use for external calls
comment	string	Comment
cui	string	Chargeable user identity for call accounting
ddi	List of string	Full telephone number (international format starting +)
display-name	string	Text name to use
email	string	Email address (sent to call recording server)
extn	List of string	Local extension number
initial-time	duration	Don't progress to second number until this time
limit	unsignedByte	Number allowed to queue
name	NMTOKEN	Group name	Not optional
order	ring-group-order	Order of ring	strict
out-of-hours-group	NMTOKEN	Alternative group if this is out of profile (cascades)
out-of-hours-ring	List of string	Numbers to ring if out of profile and no out-of-hours-group set Also works as out-of-hours, which is deprecated
overflow	List of string	Numbers to ring when more than one call in queue
overflow-time	duration	Include overflow after this time at head of queue	30
profile	NMTOKEN	Profile name
progress-time	duration	Time between each target called	6
redirect	boolean	Allow calls to be diverted before ringing
ring	List of string	Numbers to ring
ringall-time	duration	Switch to ring all after this time at head of queue
source	string	Source of data, used in automated config management
type	ring-group-type	Type of ring when one call in queue	all

Ether tunnel

etun: Attributes
Attribute	Type	Description	Default
eth-port	NMTOKEN	Port group name	Not optional
ip	IPAddr	Far end IP address	Not optional
log	NMTOKEN	Log events	Not logging
log-debug	NMTOKEN	Log debug	Not logging
log-error	NMTOKEN	Log errors	Log as event
name	string	Name
profile	NMTOKEN	Profile name
source-ip	IPAddr	Our IP address
table	routetable 0-99	Routing table number	0

DHCP server settings for remote / relayed requests

Settings for DHCP server for relayed connections

dhcp-relay: Attributes
Attribute	Type	Description	Default
allocation-table	routetable 0-99	Routing table for allocations - suggest using separate tables for remote DHCP	Allocate same as request table
allow	List of IPNameRange	IPs allowed (e.g. allocated IPs for renewal)	Allow from anywhere
relay	List of IPNameRange	Relay server IP(s)	Any relay
table	routetable 0-99	Routing table applicable	Allow any

dhcp-relay: Elements
Element	Type	Instances	Description
dhcp	dhcps	Optional, unlimited	DHCP server settings

Type of s/w auto load

Tag	Description
false	Do no auto load
factory	Load factory releases
beta	Load beta test releases
alpha	Load test releases

Type of access user has to config

Tag	Description
none	No access unless explicitly listed
view	View only access (no passwords)
read	Read only access (with passwords)
full	Full view and edit access

User login level

User login level - commands available are restricted according to assigned level.

Tag	Description
NOBODY	Unknown or not logged in user
GUEST	Guest user
USER	Normal unprivileged user
ADMIN	System administrator
DEBUG	System debugger

Subsystem with EAP access control

Tag	Description
IPsec	IPsec/IKEv2 VPN

EAP access method

Tag	Description
MD5	MD5 Challenge
MSChapV2	MS Challenge

Syslog severity

Log severity - different loggable events log at different levels.

Tag	Description
EMERG	System is unstable
ALERT	Action must be taken immediately
CRIT	Critical conditions
ERR	Error conditions
WARNING	Warning conditions
NOTICE	Normal but significant events
INFO	Informational
DEBUG	Debug level messages
NO-LOGGING	No logging

Syslog facility

Syslog facility, usually used to control which log file the syslog is written to.

Tag	Description
KERN	Kernel messages
USER	User level messges
MAIL	Mail system
DAEMON	System Daemons
AUTH	Security/auth
SYSLOG	Internal to syslogd
LPR	Printer
NEWS	News
UUCP	UUCP
CRON	Cron deamon
AUTHPRIV	private security/auth
FTP	File transfer
12	Unused
13	Unused
14	Unused
15	Unused
LOCAL0	Local 0
LOCAL1	Local 1
LOCAL2	Local 2
LOCAL3	Local 3
LOCAL4	Local 4
LOCAL5	Local 5
LOCAL6	Local 6
LOCAL7	Local 7

Month name (3 letter)

Tag	Description
Jan	January
Feb	February
Mar	March
Apr	April
May	May
Jun	June
Jul	July
Aug	August
Sep	September
Oct	October
Nov	November
Dec	December

Day name (3 letter)

Tag	Description
Sun	Sunday
Mon	Monday
Tue	Tuesday
Wed	Wednesday
Thu	Thursday
Fri	Friday
Sat	Saturday

Options for controlling platform RADIUS response priority tagging

Tag	Description
equal	All the same priority
strict	In order specified
random	Random order
calling	Hashed on calling station id
called	Hashed on called station id
username	Hashed on full username
user	Hashed on username before @
realm	Hashed on username after @
prefix	Hashed on username initial letters and numbers only

Type of RADIUS server

Tag	Description
authentication	Authentication server
accounting	Accounting server
control	Allowed to send control (CoA/DM)

Physical port

Tag	Description
0	Port 0 (not valid) (deprecated)
1	Port 1
2	Port 2
3	Port 3
4	Port 4

Crossover configuration

Physical port crossover configuration.

Tag	Description
auto	Crossover is determined automatically
MDI	Force no crossover

Physical port speed

Tag	Description
10M	10Mbit/sec
100M	100Mbit/sec
1G	1Gbit/sec
auto	Speed determined by autonegotiation

Physical port duplex setting

Tag	Description
half	Half-duplex
full	Full-duplex
auto	Duplex determined by autonegotiation

Physical port flow control setting

Tag	Description
none	No flow control
symmetric	Can support two-way flow control
send-pauses	Can send pauses but does not support pause reception
any	Can receive pauses and may send pauses if required

Physical port Gigabit clock master/slave setting

Tag	Description
prefer-master	Master status negotiated; preference for master
prefer-slave	Master status negotiated; preference for slave
force-master	Master status forced
force-slave	Slave status forced

LED settings

Tag	Description
Link/Activity	On when link up; blink when Tx or Rx activity
Link1000/Activity	On when link up at 1G; blink when Tx or Rx activity
Link100/Activity	On when link up at 100M; blink when Tx or Rx activity
Link10/Activity	On when link up at 10M; blink when Tx or Rx activity
Link100-1000/Activity	On when link up at 100M or 1G; blink when Tx or Rx activity
Link10-1000/Activity	On when link up at 10M or 1G; blink when Tx or Rx activity
Link10-100/Activity	On when link up at 10M or 100M; blink when Tx or Rx activity
Duplex/Collision	On when full-duplex; blink when half-duplex and collisions detected
Collision	Blink when collisions detected
Tx	Blink when Tx activity
Rx	Blink when Rx activity
Off	Permanently off
On	Permanently on
Link	On when link up
Link1000	On when link up at 1G
Link100	On when link up at 100M
Link10	On when link up at 10M
Link100-1000	On when link up at 100M or 1G
Link10-1000	On when link up at 10M or 1G
Link10-100	On when link up at 10M or 100M
Duplex	On when full-duplex

PHY power saving options

Tag	Description
none	No power saving
link-down	Power save only when link is down
link-up	Power save only when link is up
full	Full power saving

Link fault type to send

Tag	Description
false	No fault
true	Send fault
off-line	Send offline fault (1G)
ane	Send ANE fault (1G)

Sampling protocol

Tag	Description
sflow	Use sFlow protocol
ipfix-psamp	Use IPFIX/PSAMP protocol
ipfix-legacy	Use legacy (Cisco-style) IPFIX

Trunk port more

Tag	Description
false	Not trunking
random	Random trunking
l2-hash	L2 hashed trunking
l23-hash	L2 and L3 hashed trunking
l3-hash	L3 hashed trunking

IPv6 route announce level

IPv6 route announcement mode and level

Tag	Description
false	Do not announce
low	Announce as low priority
medium	Announce as medium priority
high	Announce as high priority
true	Announce as default (medium) priority

Control for RA and DHCPv6 bits

Tag	Description
false	Don't set bit or answer on DHCPv6
true	Set bit but do not answer on DHCPv6
dhcpv6	Set bit and do answer on DHCPv6

BGP announcement mode

BGP mode defines the default advertisement mode for prefixes, based on well-known community tags

Tag	Description
false	Not included in BGP at all
no-advertise	Not included in BGP, not advertised at all
no-export	Not normally exported from local AS/confederation
local-as	Not exported from local AS
no-peer	Exported with no-peer community tag
true	Exported as normal with no special tags added

Sampling mode

Tag	Description
off	Don't perform sampling
ingress	Sample incoming traffic
egress	Sample outgoing traffic
both	Sample incoming and outgoing traffic

Source filter option

Tag	Description
false	No source filter checks
blackhole	Check replies have any valid route
true	Check replies down same port/vlan

Type of PPPoE connection

Tag	Description
client	Normal PPPoE client connects to access controller
bras-l2tp	PPPoE server mode linked to L2TP operation

IPsec encapsulation type

Tag	Description
AH	Authentication Header
ESP	Encapsulating Security Payload

IPsec authentication algorithm

Tag	Description
null	No authentication
HMAC-MD5	HMAC-MD5-96 (RFC 2403)
HMAC-SHA1	HMAC-SHA1-96 (RFC 2404)
AES-XCBC	AES-XCBC-MAC-96 (RFC 3566)
HMAC-SHA256	HMAC-SHA-256-128 (RFC 4868)

IPsec encryption algorithm

Tag	Description
null	No encryption (RFC 2410)
3DES-CBC	3DES-CBC (RFC 2451)
blowfish	Blowfish CBC (RFC 2451) with 16-byte key
blowfish-192	Blowfish CBC (RFC 2451) with 24-byte key
blowfish-256	Blowfish CBC (RFC 2451) with 32-byte key
AES-CBC	AES-CBC (Rijndael) (RFC 3602) with 16-byte key
AES-192-CBC	AES-CBC (Rijndael) (RFC 3602) with 24-byte key
AES-256-CBC	AES-CBC (Rijndael) (RFC 3602) with 32-byte key

BGP peer type

Peer type controls many of the defaults for a peer setting. It allows typical settings to be defined with one attribute that reflects the type of peer.

Tag	Description
normal	Normal BGP operation
transit	EBGP Mark received as no-export
peer	EBGP Mark received as no-export, only accept peer AS
customer	EBGP Allow export as if confederate, only accept peer AS
internal	IBGP allowing own AS
reflector	IBGP allowing own AS and working in route reflector mode
confederate	EBGP confederate
ixp	Internet exchange point peer on route server

authentication method

Tag	Description
Secret	Shared Secret
Certificate	X.509 certificate
EAP	Use EAP for authentication

connection setup mode

Tag	Description
Wait	Wait for peer to initiate the connection
On-demand	Bring up when needed for traffic
Immediate	Always attempt to bring up connection

IKE Pseudo-Random Function

Tag	Description
HMAC-MD5	HMAC-MD5
HMAC-SHA1	HMAC-SHA1
AES-XCBC-128	AES-XCBC with 128-bit key
HMAC-SHA256	PRF-HMAC-SHA-256 (rfc4868)

IKE Diffie-Hellman group

Tag	Description
none	No D-H negotiation (only used with AH/ESP)
MODP-1024	1024-bit Sophie Germain Prime MODP Group
MODP-2048	2048-bit Sophie Germain Prime MODP Group

IKE Sequence Number support

Tag	Description
ALLOW-ESN	Allow Extended Sequence Numbers (64 bits)
ALLOW-SHORT-SN	Allow short sequence numbers (32 bits)

Manually keyed IPsec encapsulation mode

Tag	Description
tunnel	IPsec tunnel
transport	IPsec transport

Profile manual setting

Manual setting control for profile

Tag	Description
false	Profile set to OFF
true	Profile set to ON
control-switch	Profile set based on control switch on home page

Type of dynamic graph

Tag	Description
false	No dynamic graph
ip	Use source IP address
mac	Use source MAC address

Firewall action

Tag	Description
continue	Continue rule-set checking
accept	Allow but no more rule-set checking
reject	End all rule checking now and set to send ICMP reject
drop	End all rule checking now and set to drop
ignore	End all rule checking and ignore (drop) just this packet, not making a session

Number presentation format

Tag	Description
international	Full international number
int-no-plus	International without leading plus
national	With nat/int prefix
local	Local number/extension
transparent	Unchanged
block	Do not use for calls

Number formatting option

Tag	Description
false	Don't format numbers for display
true	Format numbers for display with spacing
replace-zero	Format numbers for display with spacing and replacing zeros - may look clearer on some CLI devices

Recording option

Tag	Description
false	Don't automatically record calls
in-only	Automatically record incoming calls
out-only	Automatically record outgoing calls
true	Automatically record all calls

Order of ring

Tag	Description
strict	Order in config
random	Random order
cyclic	Cycling from last call
oldest	Oldest used phone first

Type of ring when one call in queue

Tag	Description
all	All phones
cascade	Increasing number of phones
sequence	One phone at a time

Record beep option

Tag	Description
false	No beep
button	Beep on record button press
true	Beep on start of record

Basic types

Type	Description
string	text string
token	text string
hexBinary	hex coded binary data
integer	integer (-2147483648-2147483647)
positiveInteger	positive integer (1-4294967295)
unsignedInt	unsigned integer (0-4294967295)
unsignedShort	unsigned short integer (0-65535)
byte	byte integer (-128-127)
unsignedByte	unsigned byte integer (0-255)
boolean	Boolean
dateTime	YYYY-MM-DDTHH:MM:SS date/time
time	HH:MM:SS time
NMTOKEN	String with no spaces
void	Internal use
IPAddr	IP address
IPNameAddr	IP address or name
IP4Addr	IPv4 address
IP6Addr	IPv6 address
IPPrefix	IP address / bitlen
IPRange	IP address / bitlen or range
IPNameRange	IP address / bitlen or range or name
IP4Range	IPv4 address / bitlen or range
IP4Prefix	IPv4 address / bitlen
IP6Prefix	IPv6 address / bitlen
IPSubnet	IP address / bitlen
IP4Subnet	IPv4 address / bitlen
IPFilter	Route filter
Password	Password
OTP	OTP
Community	xxx:xxx community
PortRange	xxx-xxx port range
Colour	#rgb #rrggbb #rgba #rrggbbaa colour
Secret	Secret/passphrase
duration	Period [[HH:]MM:]SS
routetable	[unsignedByte] Route table number (0-99)
username	[NMTOKEN] Login name
ipnamerangelist	[IPNameRange] List of IPranges or ip groups
ipnamelist	[IPNameAddr] List of IP addresses or domain names
datenum	[unsignedByte] Day number in month (1-31)
stringlist	[string] List of strings
iplist	[IPAddr] List of IP addresses
nmtokenlist	[NMTOKEN] List of NMTOKEN
sample-rate	[unsignedShort] Sampling rate (100-10000)
mtu	[unsignedShort] Max transmission unit (576-2000)
subnetlist	[IPSubnet] List of subnets
ra-max	[unsignedShort] Route announcement max interval (seconds) (4-1800)
ra-min	[unsignedShort] Route announcement min interval (seconds) (3-1350)
ip6list	[IP6Addr] List of IPv6 addresses
vlan	[unsignedShort] VLAN ID (0=untagged) (0-4095)
ip4rangelist	[IP4Range] List of IP4ranges
macprefixlist	[macprefix] List of strings
macprefix	[hexBinary] MAC prefix
ip4list	[IP4Addr] List of IPv4 addresses
graphname	[token] Graph name
cug	[unsignedShort] CUG ID (1-32767)
prefixlist	[IPPrefix] List of IP Prefixes
aslist	[unsignedIntList] List of AS numbers
unsignedIntList	[unsignedInt] List of integers
communitylist	[Community] List of BGP communities
ipsec-spi	[unsignedInt] IPsec Security Parameters Index (256-4294967295)
filterlist	[IPFilter] List of IP Prefix filters
bgp-prefix-limit	[unsignedInt] Maximum prefixes accepted on BGP session (1-10000)
fb105-reorder-timeout	[unsignedInt] Maximum time to queue out of order packet (ms) (10-5000)
fb105-reorder-maxq	[unsignedInt] Maximum size of out of order packet queue (1-100)
iprangelist	[IPRange] List of IPranges
ping-size	[unsignedInt] Data payload size to be sent in ping packet (0-1472)
portlist	[PortRange] List of protocol port ranges
protolist	[unsignedByte] List of IP protocols
sip-error	[unsignedShort] SIP error code (400-699)
userlist	[username] List of user names
prefix4list	[IP4Prefix] List of IPv4 Prefixes
routetableset	[routetable] Set of routetables
vlan-nz	[unsignedShort] VLAN ID (1-4095)
dates	[datenum] Set of dates
tun-id	[unsignedShort] Local tunnel ID (1-100)
ses-id	[unsignedShort] Local session ID (1-500)