The following are the list of ONOS CLI commands. As the ONOS CLI builds upon Karaf's CLI, this list is not comprehensive to the full set of commands available in the CLI. Please refer to the {html}<a href="http://karaf.apache.org/manual/latest/commands/commands.html">karaf commands documentation</a>{html} for further information.
DESCRIPTION
onos:add-flows
Installs a flow rules
SYNTAX
onos:add-flows [options] flowPerDevice numOfRuns
ARGUMENTS
flowPerDevice
Number of flows to add per device
numOfRuns
Number of iterations
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:add-host-intent
Installs host-to-host connectivity intent
SYNTAX
onos:add-host-intent [options] one two
ARGUMENTS
one
One host ID
two
Another host ID
OPTIONS
-j, --json
Output JSON
-b, --bandwidth
Bandwidth
(defaults to )
-t, --ethType
Ethernet Type
(defaults to )
-d, --ethDst
Destination MAC Address
--setEthSrc
Rewrite Source MAC Address
-s, --ethSrc
Source MAC Address
--setEthDst
Rewrite Destination MAC Address
--tcpSrc
Source TCP Port
-l, --lambda
Lambda
--ipProto
IP Protocol
--ipSrc
Source IP Address
--tcpDst
Destination TCP Port
--ipDst
Destination IP Address
--help
Display this help message
DESCRIPTION
onos:add-multi-to-single-intent
Installs point-to-point connectivity intent
SYNTAX
onos:add-multi-to-single-intent [options] ingressDevices
ARGUMENTS
ingressDevices
Ingress Device/Port Description
OPTIONS
-j, --json
Output JSON
-b, --bandwidth
Bandwidth
(defaults to )
-t, --ethType
Ethernet Type
(defaults to )
-d, --ethDst
Destination MAC Address
--setEthSrc
Rewrite Source MAC Address
-s, --ethSrc
Source MAC Address
--setEthDst
Rewrite Destination MAC Address
--tcpSrc
Source TCP Port
-l, --lambda
Lambda
--ipProto
IP Protocol
--ipSrc
Source IP Address
--tcpDst
Destination TCP Port
--ipDst
Destination IP Address
--help
Display this help message
DESCRIPTION
onos:add-optical-intent
Installs optical connectivity intent
SYNTAX
onos:add-optical-intent [options] ingressDevice egressDevice
ARGUMENTS
ingressDevice
Ingress Device/Port Description
egressDevice
Egress Device/Port Description
OPTIONS
-j, --json
Output JSON
-b, --bandwidth
Bandwidth
(defaults to )
-t, --ethType
Ethernet Type
(defaults to )
-d, --ethDst
Destination MAC Address
--setEthSrc
Rewrite Source MAC Address
-s, --ethSrc
Source MAC Address
--setEthDst
Rewrite Destination MAC Address
--tcpSrc
Source TCP Port
-l, --lambda
Lambda
--ipProto
IP Protocol
--ipSrc
Source IP Address
--tcpDst
Destination TCP Port
--ipDst
Destination IP Address
--help
Display this help message
DESCRIPTION
onos:add-point-intent
Installs point-to-point connectivity intent
SYNTAX
onos:add-point-intent [options] ingressDevice egressDevice
ARGUMENTS
ingressDevice
Ingress Device/Port Description
egressDevice
Egress Device/Port Description
OPTIONS
-j, --json
Output JSON
-b, --bandwidth
Bandwidth
(defaults to )
-t, --ethType
Ethernet Type
(defaults to )
-d, --ethDst
Destination MAC Address
--setEthSrc
Rewrite Source MAC Address
-s, --ethSrc
Source MAC Address
--setEthDst
Rewrite Destination MAC Address
--tcpSrc
Source TCP Port
-l, --lambda
Lambda
--ipProto
IP Protocol
--ipSrc
Source IP Address
--tcpDst
Destination TCP Port
--ipDst
Destination IP Address
--help
Display this help message
DESCRIPTION
onos:add-single-to-multi-intent
Installs connectivity intent between multiple egress devices and a single ingress device
SYNTAX
onos:add-single-to-multi-intent [options] egressDevices ingressDevice
ARGUMENTS
egressDevices ingressDevice
egress Device/Port...egress Device/Port ingressDevice/port
OPTIONS
-j, --json
Output JSON
-b, --bandwidth
Bandwidth
(defaults to )
-t, --ethType
Ethernet Type
(defaults to )
-d, --ethDst
Destination MAC Address
--setEthSrc
Rewrite Source MAC Address
-s, --ethSrc
Source MAC Address
--setEthDst
Rewrite Destination MAC Address
--tcpSrc
Source TCP Port
-l, --lambda
Lambda
--ipProto
IP Protocol
--ipSrc
Source IP Address
--tcpDst
Destination TCP Port
--ipDst
Destination IP Address
--help
Display this help message
DESCRIPTION
onos:address-bindings
Lists all configured address port bindings.
SYNTAX
onos:address-bindings [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:apps
Lists application ID information
SYNTAX
onos:apps [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:balance-masters
Forces device mastership rebalancing
SYNTAX
onos:balance-masters [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:cluster-devices
Lists devices of the specified topology cluster in the current topology
SYNTAX
onos:cluster-devices [options] [id]
ARGUMENTS
id
Cluster ID
OPTIONS
-r, --recompute
Trigger topology re-computation
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:cluster-links
Lists links of the specified topology cluster in the current topology
SYNTAX
onos:cluster-links [options] id
ARGUMENTS
id
Cluster ID
OPTIONS
-r, --recompute
Trigger topology re-computation
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:clusters
Lists all clusters in the current topology
SYNTAX
onos:clusters [options]
OPTIONS
-r, --recompute
Trigger topology re-computation
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:device-remove
Removes an infrastructure device
SYNTAX
onos:device-remove [options] uri
ARGUMENTS
uri
Device ID
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:device-role
Sets role of the controller node for the given infrastructure device
SYNTAX
onos:device-role [options] uri node role
ARGUMENTS
uri
Device ID
node
Node ID
role
Mastership role
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:devices
Lists all infrastructure devices
SYNTAX
onos:devices [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:flows
Lists all currently-known flows.
SYNTAX
onos:flows [options] [state] [uri]
ARGUMENTS
state
Flow Rule state
uri
Device ID
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:get-stats
Fetches stats for a connection point
SYNTAX
onos:get-stats [options] connectPoint
ARGUMENTS
connectPoint
Device/Port Description
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:host-remove
Removes an end-station host
SYNTAX
onos:host-remove [options] id
ARGUMENTS
id
Host ID
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:hosts
Lists all currently-known hosts.
SYNTAX
onos:hosts [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:intents
Lists the inventory of intents and their states
SYNTAX
onos:intents [options]
OPTIONS
-i, --installable
Output Installable Intents
-j, --json
Output JSON
-s, --summary
Intents summary
--help
Display this help message
DESCRIPTION
onos:leaders
Finds the leader for particular topic.
SYNTAX
onos:leaders [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:links
Lists all infrastructure links
SYNTAX
onos:links [options] [uri]
ARGUMENTS
uri
Device ID
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:masters
Lists device mastership information
SYNTAX
onos:masters [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:metrics
Prints metrics in the system
SYNTAX
onos:metrics [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:nodes
Lists all controller cluster nodes
SYNTAX
onos:nodes [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:paths
Lists all shortest-paths paths between the specified source and destination devices
SYNTAX
onos:paths [options] src dst
ARGUMENTS
src
Source device ID
dst
Destination device ID
OPTIONS
-r, --recompute
Trigger topology re-computation
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:ports
Lists all ports or all ports of a device
SYNTAX
onos:ports [options] [uri]
ARGUMENTS
uri
Device ID
OPTIONS
-j, --json
Output JSON
-d, --disabled
Show only disabled ports
-e, --enabled
Show only enabled ports
--help
Display this help message
DESCRIPTION
onos:push-random-intents
Installs random intents to test throughput
SYNTAX
onos:push-random-intents [options] count
ARGUMENTS
count
Number of intents to push
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:push-test-intents
Installs random intents to test throughput
SYNTAX
onos:push-test-intents [options] ingressDevice egressDevice Intents per appId [apps] [appIdBase]
ARGUMENTS
ingressDevice
Ingress Device/Port Description
egressDevice
Egress Device/Port Description
Intents per appId
Number of intents per appId
apps
Number of appIds
appIdBase
Base Value for Application IDs
OPTIONS
-i, --install
Install intents
-j, --json
Output JSON
-w, --withdraw
Withdraw intents
--help
Display this help message
DESCRIPTION
onos:remove-intent
Removes the specified intent
SYNTAX
onos:remove-intent [options] id
ARGUMENTS
id
Intent ID
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:resource-allocations
Lists allocations by link
SYNTAX
onos:resource-allocations [options] [srcString] [dstString]
ARGUMENTS
srcString
Link source
dstString
Link destination
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:resource-available
Lists available resources by link
SYNTAX
onos:resource-available [options] [srcString] [dstString]
ARGUMENTS
srcString
Link source
dstString
Link destination
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:roles
Lists mastership roles of nodes for each device.
SYNTAX
onos:roles [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:summary
Provides summary of ONOS model
SYNTAX
onos:summary [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:tablet-leader
Prints the current leader of a tablet.
SYNTAX
onos:tablet-leader [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:tablet-member
Lists all member nodes
SYNTAX
onos:tablet-member [options]
OPTIONS
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:topology
Lists summary of the current topology
SYNTAX
onos:topology [options]
OPTIONS
-r, --recompute
Trigger topology re-computation
-j, --json
Output JSON
--help
Display this help message
DESCRIPTION
onos:wipe-out
Wipes-out the entire network information base, i.e. devices, links, hosts
SYNTAX
onos:wipe-out [options] [please]
ARGUMENTS
please
Confirmation phrase
OPTIONS
-r, --recompute
Trigger topology re-computation
-j, --json
Output JSON
--help
Display this help message