Migrate USecPlugin user docs to rst 12/45312/2
authorColin Dixon <colin@colindixon.com>
Wed, 7 Sep 2016 15:10:00 +0000 (11:10 -0400)
committerColin Dixon <colin@colindixon.com>
Wed, 7 Sep 2016 15:27:35 +0000 (11:27 -0400)
Change-Id: If60f95754ca5497af0f3f4c45888466dc477f726
Signed-off-by: Colin Dixon <colin@colindixon.com>
docs/user-guide/index.rst
docs/user-guide/usecplugin-aaa-user-guide.rst [new file with mode: 0644]
docs/user-guide/usecplugin-openflow-user-guide.rst [new file with mode: 0644]
manuals/user-guide/src/main/asciidoc/usecplugin/odl-usecplugin-aaa-user.adoc
manuals/user-guide/src/main/asciidoc/usecplugin/odl-usecplugin-openflow-user.adoc

index 49bbdde18bcaa4df7a8ad18f9e3d675135a6fe8e..5fcd94920066a55096c7c1618d016849f8c64fd1 100644 (file)
@@ -59,6 +59,8 @@ Project-specific User Guides
    ttp-cli-tools-user-guide
    uni-manager-plug-in-project
    unified-secure-channel
+   usecplugin-aaa-user-guide
+   usecplugin-openflow-user-guide
    virtual-tenant-network-(vtn)
    yang-ide-user-guide
    yang-push
diff --git a/docs/user-guide/usecplugin-aaa-user-guide.rst b/docs/user-guide/usecplugin-aaa-user-guide.rst
new file mode 100644 (file)
index 0000000..75d11bf
--- /dev/null
@@ -0,0 +1,47 @@
+Usecplugin-AAA User Guide
+=========================
+
+The Usecplugin User Guide contains information about configuration,
+administration, management, using and troubleshooting the feature.
+
+Overview
+--------
+
+AAA plugin provides authorization, authentication and accounting
+services to OpenDaylight. A user logs in to OpenDaylight through the
+username and password provided by AAA plugin. Usecplugin-AAA collects
+and stores information about both successful and failed login attempts
+to OpenDaylight.
+
+Usecplugin-AAA Architecture
+---------------------------
+
+AAA plugin creates log messages about successful and failed login
+attempts to OpenDaylight. Usecplugin-AAA continuously reads this log
+file and checks for either successful and failed attempt information.
+Whenever Usecpluin-AAA identifies a new attempt entry in the log file it
+is stored in YANG Data Store and its own log file.
+
+Administering or Managing Usecplugin-AAA
+----------------------------------------
+
+-  Install feature ``odl-usecplugin-aaa``
+
+-  Enable odl-aaa log using command
+   ``log:set DEBUG org.opendaylight.aaa.shiro.filters``
+
+-  Login to the RESTCONF documentation.
+
+-  Check operational datastore for login attempts.
+
+-  POST URI ::
+   http://localhost:8181/restconf/operations/usecpluginaaa:attemptFromIP
+
+   -  Sample Input :: {"usecpluginaaa:input":{"ScrIP":"10.0.0.1"}}
+
+-  POST URI ::
+   http://localhost:8181/restconf/operations/usecpluginaaa:attemptOnDateTime
+
+   -  Sample Input :: {"usecpluginaaa:input":{"dateTime":"2016-07-27
+      14:11:18"}}
+
diff --git a/docs/user-guide/usecplugin-openflow-user-guide.rst b/docs/user-guide/usecplugin-openflow-user-guide.rst
new file mode 100644 (file)
index 0000000..7f31bc0
--- /dev/null
@@ -0,0 +1,90 @@
+Usecplugin-OpenFlow User Guide
+==============================
+
+The Usecplugin-OpenFlow User Guide contains information about
+configuration, administration, management, using and troubleshooting the
+feature.
+
+Overview
+--------
+
+Usecplugin-OpenFlow collects information about potential OpenFlow
+Packet\_In attacks to OpenDaylight. A threshold (water mark) can be set
+for the Packet\_In rate which when breached will trigger Packet\_In
+message information collection.
+
+Usecplugin Architecture
+-----------------------
+
+Usecplugin listens on OpenFlow southbound interface for Packet\_In
+messages. When the rate of Packet\_In breaches the high water mark the
+application parses the message for header information which is
+subsequently stored in YANG Data Store and a log file. Usecplugin has
+PacketHandler class that implements the PacketProcessing interface to
+override the OnPacketReceived notification by which the application is
+notified of Packet\_In messages.
+
+Configuring Usecplugin-OpenFlow
+-------------------------------
+
+Install the Usecplugin-OpenFlow feautre in OpenDaylight with the
+``feature:install odl-usecplugin-openflow`` at the Karaf CLI.
+
+A user can set the low water mark and high water mark for Packet\_In
+rates as well as number of samples for checking the time interval to
+calculate Packet\_In rate.
+
+URI
+    http://localhost:8181/apidoc/explorer/index.html#!/usecplugin(2015-01-05)
+
+High Water Mark Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PUT URI
+    http://localhost:8181/restconf/config/usecplugin:sample-data-hwm/
+
+Sample Input
+    ``{"usecplugin:sample-data-hwm": { "samples":"3000","highWaterMark":"3000"}}``
+
+Low Water Mark Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PUT URI
+    http://localhost:8181/restconf/config/usecplugin:sample-data-lwm/
+
+Sample Input
+    ``{"usecplugin:sample-data-lwm": { "samples-lwm":"2000","lowWaterMark-lwm":"2000"}}``
+
+Administering or Managing Usecplugin-OpenFlow
+---------------------------------------------
+
+Use RPC POST APIs in the following format for getting the attack related
+information.
+
+attackID
+~~~~~~~~
+
+URI
+    http://localhost:8181/restconf/operations/usecplugin:attackID
+
+Sample Input
+    ``{"usecplugin:input": { "NodeID":"openflow:1"}}``
+
+attacksFromIP
+~~~~~~~~~~~~~
+
+URI
+    http://localhost:8181/restconf/operations/usecplugin:attacksFromIP
+
+Sample Input
+    ``{"usecplugin:input": { "SrcIP":"10.0.0.1"}}``
+
+attacksToIP
+~~~~~~~~~~~
+
+URI
+    http://localhost:8181/restconf/operations/usecplugin:attacksToIP
+
+Sample Input
+    ``{"usecplugin:input": { "DstIP":"10.0.0.2"}}``
+
index ba9bb66fdca4bd6221efb8d38db2d26e0fe275c0..df5e47dcd4d6218c4b55c1ebaf274aff40e0cfdd 100644 (file)
@@ -1,25 +1,3 @@
 == Usecplugin-AAA User Guide
-The Usecplugin User Guide contains information about configuration, administration,
-management, using and troubleshooting the feature.
 
-=== Overview
-AAA plugin provides authorization, authentication and accounting services to OpenDaylight. A user logs in to
-OpenDaylight through the username and password provided by AAA plugin.
-Usecplugin-AAA collects and stores information about both successful and failed login attempts to OpenDaylight.
-
-
-=== Usecplugin-AAA Architecture
-AAA plugin creates log messages about successful and failed login attempts to OpenDaylight.
-Usecplugin-AAA continuously reads this log file and checks for either successful and failed attempt information.
-Whenever Usecpluin-AAA identifies a new attempt entry in the log file it is stored
-in YANG Data Store and its own log file.
-
-=== Administering or Managing Usecplugin-AAA
-* Install feature `odl-usecplugin-aaa`
-* Enable odl-aaa log using command `log:set DEBUG org.opendaylight.aaa.shiro.filters`
-* Login to the RESTCONF documentation.
-* Check operational datastore for login attempts.
-* POST URI :: http://localhost:8181/restconf/operations/usecpluginaaa:attemptFromIP
-** Sample Input :: {"usecpluginaaa:input":{"ScrIP":"10.0.0.1"}}
-* POST URI :: http://localhost:8181/restconf/operations/usecpluginaaa:attemptOnDateTime
-** Sample Input :: {"usecpluginaaa:input":{"dateTime":"2016-07-27 14:11:18"}}
+This content has been migrated to: http://docs.opendaylight.org/en/stable-boron/user-guide/usecplugin-aaa-user-guide.html
index 51b92eca1f36d24b513940dd4ca193710abef45c..a02ee4c4295a55a7b2a2c3a98095d275a735e08e 100644 (file)
@@ -1,45 +1,3 @@
 == Usecplugin-OpenFlow User Guide
-The Usecplugin-OpenFlow User Guide contains information about configuration, administration,
-management, using and troubleshooting the feature.
 
-=== Overview
-Usecplugin-OpenFlow collects information about potential OpenFlow Packet_In attacks to OpenDaylight.
-A threshold (water mark) can be set for the Packet_In rate which when breached will trigger Packet_In message
-information collection. 
-
-=== Usecplugin Architecture
-Usecplugin listens on OpenFlow southbound interface for Packet_In messages. When the rate of Packet_In
-breaches the high water mark the application parses the message for header information which is subsequently
-stored in YANG Data Store and a log file. Usecplugin has PacketHandler class that implements the PacketProcessing
-interface to override the OnPacketReceived notification by which the application is notified of Packet_In messages.
-
-=== Configuring Usecplugin-OpenFlow
-
-Install the Usecplugin-OpenFlow feautre in OpenDaylight with the `feature:install odl-usecplugin-openflow` at the Karaf CLI.
-
-A user can set the low water mark and high water mark for Packet_In rates as well as number of samples for checking the time interval to calculate Packet_In rate. 
-
-URI :: http://localhost:8181/apidoc/explorer/index.html#!/usecplugin(2015-01-05)
-
-==== High Water Mark Configuration 
-PUT URI :: http://localhost:8181/restconf/config/usecplugin:sample-data-hwm/
-Sample Input :: `{"usecplugin:sample-data-hwm": { "samples":"3000","highWaterMark":"3000"}}`
-
-==== Low Water Mark Configuration 
-PUT URI :: http://localhost:8181/restconf/config/usecplugin:sample-data-lwm/
-Sample Input :: `{"usecplugin:sample-data-lwm": { "samples-lwm":"2000","lowWaterMark-lwm":"2000"}}`
-
-=== Administering or Managing Usecplugin-OpenFlow
-Use RPC POST APIs in the following format for getting the attack related information.
-
-==== attackID
-URI :: http://localhost:8181/restconf/operations/usecplugin:attackID
-Sample Input :: `{"usecplugin:input": { "NodeID":"openflow:1"}}`
-
-==== attacksFromIP 
-URI :: http://localhost:8181/restconf/operations/usecplugin:attacksFromIP
-Sample Input :: `{"usecplugin:input": { "SrcIP":"10.0.0.1"}}`
-
-==== attacksToIP
-URI :: http://localhost:8181/restconf/operations/usecplugin:attacksToIP
-Sample Input :: `{"usecplugin:input": { "DstIP":"10.0.0.2"}}`
+This content has been migrated to: http://docs.opendaylight.org/en/stable-boron/user-guide/usecplugin-openflow-user-guide.html