tree: 03bdd8a8f5d90ccb1b275be0b5fc9d5182391671 [path history] [tgz]
  1. BUILD
  2. README.md
  3. src/
apps/ofagent/README.md

OFAgent : OpenFlow agent for virtual subsystem

What is OFAgent?

OFAgent is an OpenFlow agent which exposes virtual network to the external OpenFlow controllers.

Top-Level Features

  • TODO: add features.

OFAgent Tracer how-to

Builtin OFAgent tracer enables filtering of OFAgent logs per specific OFAgent tenant. Tracer is not enabled by default. Steps required for its activation are:

  1. Create Karaf alias ofagent_tracer by executing CLI command: onos>ofagent_tracer = { log:display | grep "OFAGENT_tenantId:" | grep "$1" }

  2. Use ofagent_tracer in form: onos>ofagent_tracer <tenant_id>

Default log level is INFO. Optionally, OFAgent log level can be changed with CLI command: log:set <log_level> org.onosproject.ofagent where <log_level> can be TRACE, DEBUG, INFO, WARN, ERROR, FATAL.

Note 1.: Useful Karaf CLI commands for changing log configuration are (reference: Apache Karaf Container 3.x - Documentation):

  • log:clear - clear the log entries

  • log:display - displays the log entries of the rootLogger

  • log:tail - exactly the same as log:display but it continuously displays the log entries

  • log:display <logger> - displays the log entries of the <logger>

  • log:exception-display - displays the last occurred exception

  • log:get - shows the current log level of a ROOT logger

  • log:get ALL - shows the current log level of all loggers

  • log:get <logger> - show the current log level of a <logger>

  • log:set <log_level> - sets <log_level> for ROOT logger

  • log:set <log_level> <logger> - sets <log_level> for <logger>

Note 2.: Karaf log4j configuration is in file $ONOS_INSTALL_DIR/apache-karaf-3.0.8/etc/org.ops4j.pax.logging.cfg and it can be changed on the fly.

More documentation is available in vBrigade wiki and vBrigade weekly scrum notes.