From 01f30d40ca1e41a01cf890f9ac3f6b7238ef56fc Mon Sep 17 00:00:00 2001
From: YAMAMOTO Takashi <yamamoto@valinux.co.jp>
Date: Fri, 2 May 2014 14:43:47 +0900
Subject: [PATCH] ofagent: port monitoring w/o ovsdb accesses

Change-Id: Id3ca698c84a4df5dd8900029fbf3e669eb87f615
---
 specs/juno/ofagent-port-monitor.rst | 119 ++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)
 create mode 100644 specs/juno/ofagent-port-monitor.rst

diff --git a/specs/juno/ofagent-port-monitor.rst b/specs/juno/ofagent-port-monitor.rst
new file mode 100644
index 000000000..545c34280
--- /dev/null
+++ b/specs/juno/ofagent-port-monitor.rst
@@ -0,0 +1,119 @@
+..
+ This work is licensed under a Creative Commons Attribution 3.0 Unported
+ License.
+
+ http://creativecommons.org/licenses/by/3.0/legalcode
+
+===========================================
+ofagent: port monitoring w/o ovsdb accesses
+===========================================
+
+https://blueprints.launchpad.net/neutron/+spec/ofagent-port-monitor
+
+Problem description
+===================
+
+ofagent currently scans ovsdb (via ovs-vsctl command) to get a list of ports.
+ovsdb is not likely available for other openflow switch implementations.
+
+Proposed change
+===============
+
+* implement the functionality using OFPMP_PORT_DESC instead of ovsdb.
+
+* (optional) use OFPT_PORT_STATUS asynchronous messages to
+  avoid periodic polling.
+
+* as there is no pure openflow equivalent for port external-ids,
+  we plan to use port name to identify devices. (as linuxbridge does)
+
+Alternatives
+------------
+
+* implement switch-specific methods for every switch implementations
+
+* use of-config
+  at a glance of the spec, it doesn't seem usable at this point, though.
+
+Data model impact
+-----------------
+
+none
+
+REST API impact
+---------------
+
+none
+
+Security impact
+---------------
+
+none
+
+Notifications impact
+--------------------
+
+none
+
+Other end user impact
+---------------------
+
+none
+
+Performance Impact
+------------------
+
+in case asyncronous messages are used, performance might be improved.
+
+Other deployer impact
+---------------------
+
+none
+
+Developer impact
+----------------
+
+none
+
+Implementation
+==============
+
+Assignee(s)
+-----------
+
+Primary assignee:
+  yamamoto
+
+Other contributors:
+  kakuma
+
+Work Items
+----------
+
+see "Proposed change" section.
+
+Dependencies
+============
+
+none
+
+but some of bug fixes need to be merged to make this useful.
+for example, https://review.openstack.org/#/c/88224/
+
+Testing
+=======
+
+ryu/ofagent third party testing would find regressions.
+
+Documentation Impact
+====================
+
+none
+
+References
+==========
+
+* https://www.opennetworking.org/sdn-resources/onf-specifications/openflow
+* OpenFlow 1.3.3 7.3.5.7 Port Description
+* OpenFlow 1.3.3 7.4.3 Port Status Message
+