aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSaryu Shah <ss3917@att.com>2017-10-23 18:20:49 +0000
committerSaryu Shah <ss3917@att.com>2017-10-23 18:20:49 +0000
commit4adad1fbbc7225bfb2c206d56516796ec8baf70c (patch)
treec802aa83eb065469575fb7f9be4a42d77c784d2b
parent6d8c2558bd49453eed380634053072298b3e7a6a (diff)
Policy GUI documentation
More Updates to policy GUI documentation ------------------------------------------------------------- Change-Id: If1fb04aa4282401f812f2330b9bb9c5d2b770fb7 Issue-Id: POLICY-335 Signed-off-by: Saryu Shah <ss3917@att.com>
-rwxr-xr-xdocs/platform/PolicyGUI_Access.pngbin484085 -> 484123 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Admin.pngbin172340 -> 172805 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Dashboard.pngbin368270 -> 361057 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Dictionary.pngbin497626 -> 497587 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Editor_CreatePolicy.pngbin516358 -> 516347 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Editor_PolicyActions.pngbin323485 -> 322204 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Editor_PolicyActionsDetail.pngbin520946 -> 520912 bytes
-rwxr-xr-xdocs/platform/PolicyGUI_Editor_Scope.pngbin349997 -> 354657 bytes
-rw-r--r--docs/platform/policygui.rst49
9 files changed, 20 insertions, 29 deletions
diff --git a/docs/platform/PolicyGUI_Access.png b/docs/platform/PolicyGUI_Access.png
index 04eca32b5..1df5035c5 100755
--- a/docs/platform/PolicyGUI_Access.png
+++ b/docs/platform/PolicyGUI_Access.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Admin.png b/docs/platform/PolicyGUI_Admin.png
index cd7c1e39e..624408f84 100755
--- a/docs/platform/PolicyGUI_Admin.png
+++ b/docs/platform/PolicyGUI_Admin.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Dashboard.png b/docs/platform/PolicyGUI_Dashboard.png
index 7d1f54722..1660a56b8 100755
--- a/docs/platform/PolicyGUI_Dashboard.png
+++ b/docs/platform/PolicyGUI_Dashboard.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Dictionary.png b/docs/platform/PolicyGUI_Dictionary.png
index 7c3443db6..667e5cb9a 100755
--- a/docs/platform/PolicyGUI_Dictionary.png
+++ b/docs/platform/PolicyGUI_Dictionary.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Editor_CreatePolicy.png b/docs/platform/PolicyGUI_Editor_CreatePolicy.png
index 263ae8a27..e71639702 100755
--- a/docs/platform/PolicyGUI_Editor_CreatePolicy.png
+++ b/docs/platform/PolicyGUI_Editor_CreatePolicy.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Editor_PolicyActions.png b/docs/platform/PolicyGUI_Editor_PolicyActions.png
index 35d998b21..46fb49761 100755
--- a/docs/platform/PolicyGUI_Editor_PolicyActions.png
+++ b/docs/platform/PolicyGUI_Editor_PolicyActions.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Editor_PolicyActionsDetail.png b/docs/platform/PolicyGUI_Editor_PolicyActionsDetail.png
index b9e8c20d0..c6e87dda3 100755
--- a/docs/platform/PolicyGUI_Editor_PolicyActionsDetail.png
+++ b/docs/platform/PolicyGUI_Editor_PolicyActionsDetail.png
Binary files differ
diff --git a/docs/platform/PolicyGUI_Editor_Scope.png b/docs/platform/PolicyGUI_Editor_Scope.png
index 8ee67feda..b859ad4da 100755
--- a/docs/platform/PolicyGUI_Editor_Scope.png
+++ b/docs/platform/PolicyGUI_Editor_Scope.png
Binary files differ
diff --git a/docs/platform/policygui.rst b/docs/platform/policygui.rst
index 801f6afa9..785091d65 100644
--- a/docs/platform/policygui.rst
+++ b/docs/platform/policygui.rst
@@ -8,11 +8,11 @@ Policy GUI
.. contents::
:depth: 3
-The POLICY GUI is a graphical user interface, available via web-access, for **creating and managing** policies.
-
-| The GUI consists of the **Editor, Dictionary, PDP, PUSH, Roles, Admin and Dashboard** tabs.
+| The POLICY GUI is a graphical user interface, available via web-access, for **creating and managing** policies.
+|
+| The targetted users are those responsible for creating and managing policies that control network operations, including policy based network configuration and auto-corrective actions. This typically includes network and service designers, operations engineers and security experts.
|
-| The typical targetted users are those who have the responsibility and authority to create and manage policies that control network operations including policy based network configuration and auto-corrective actions. This includes network and service designers, operations engineers and security experts. The POLICY GUI provides Users to effortlessly create, change, and manage policy rules.
+| The GUI consists of the **Editor, Dictionary, PDP, Push, Roles, Admin and Dashboard** Tabs; which provide an intuitive manner for policy rules to be created, changed, and managed.
Access to the POLICY GUI
@@ -26,8 +26,7 @@ The POLICY GUI can be accessed via the ONAP Portal.
POLICY Editor
^^^^^^^^^^^^^
-| The POLICY EDITOR tab houses **key functionality** for the POLICY application.
-| The following functionality is supported:
+The POLICY **Editor** tab supports the following **key** functionality:
• Create Policies and Scopes
• Edit, View and Describe Policies
@@ -38,17 +37,17 @@ POLICY Editor
• Export and Import Policies
• Search for Policies
-Scope
+
+Scope
-----
-The diagram below shows the POLICY Editor landing page. This page lists the existing Scopes and associated Policies.
-A scope must exist before a policy can be added. The diagram outlines how to add a new scope.
+This is the POLICY Editor landing page. Existing Scopes and their associated policies are displayed. The diagram below show the functionality available on the screen and also how to add and manage Scopes.
.. image:: PolicyGUI_Editor_Scope.png
|
-Create a Policy
+Policy Creation
---------------
The most important function of the GUI is to facilitate the creation of policies.
@@ -58,11 +57,11 @@ The figure below specifies how a policy can be created.
|
-Policy Actions (Edit, View ...)
--------------------------------
+Managing a Policy
+-----------------
-The POLICY GUI provides actions (Edit, Clone, Move, Rename, Describe, View etc) to facilitate maintaining
-the policy after it has been created. The figure below identifies how to intiated an action via the GUI.
+The GUI provides actions (Edit, Clone, Move, Rename, Describe, View etc) to support maintaining
+the policy after it has been created. The figures below specify how to initiate an action.
.. image:: PolicyGUI_Editor_PolicyActions.png
@@ -76,8 +75,8 @@ the policy after it has been created. The figure below identifies how to intiat
POLICY Dictionary
^^^^^^^^^^^^^^^^^
-| The POLICY DICTIONARY tab is used to create and manage attributes in the dictionaries.
-| Each policy type has one or more dictionaries associated with it. The dictionaries should contain all attributes that may be referenced by the policies. Policy writers have the ability to easily define attributes and add them into the dictionary via the POLICY GUI as shown below.
+| The POLICY **Dictionary** tab is used to create and manage attributes in the dictionaries.
+| Each policy type has one or more dictionaries associated with it. Policy writers have the ability to easily define and add attributes into the dictionary as shown below.
.. image:: PolicyGUI_Dictionary.png
@@ -86,7 +85,7 @@ POLICY Dictionary
POLICY PDP
^^^^^^^^^^
-| The POLICY PDP tab is used to managing **PDP Groups**.
+| The POLICY **PDP** tab is used to manage **PDP Groups**.
| This tab provides the capability to create, edit and delete PDP groups. This tab also provides the ability to check status and view policies in a PDP groups.
.. image:: PolicyGUI_PDP.png
@@ -96,7 +95,7 @@ POLICY PDP
POLICY Push
^^^^^^^^^^^
-| The POLICY PUSH tab allows policies to be selectively pushed to the all PDPs.
+| The POLICY **Push** tab allows policies to be selectively pushed to the all PDPs.
| Once pushed, the policies can be seen on the PDP tab. A Status of the PDPs indicate “UP-TO-DATE” if the policy has been pushed correctly. A Status of “LAST-UPDATE-FAILED” indicates an error occurred in pushing the policies.
.. image:: PolicyGUI_Push.png
@@ -106,7 +105,7 @@ POLICY Push
POLICY Roles
^^^^^^^^^^^^
-| The POLICY ROLES tab allows system administrators to assign roles for system access.
+| The POLICY **Roles** tab allows system administrators to assign roles for system access.
| The GUI options vary depending on the role. The roles for POLICY are:
• Policy Super Admin
@@ -120,7 +119,7 @@ POLICY Roles
POLICY Admin
^^^^^^^^^^^^
-| The POLICY ADMIN tab houses functionality that is performed by an administrator.
+| The POLICY **Admin** tab houses functionality that is performed by an administrator.
| Only super users have access to the Admin Tab. The Lockdown feature is accessed from this tab.
.. image:: PolicyGUI_Admin.png
@@ -130,15 +129,7 @@ POLICY Admin
POLICY Dashboard
^^^^^^^^^^^^^^^^
-| The POLICY DASHBOARD shows the status and health of the system through metrics logs and status update messages. The dashboard consists of two tabs, a Logging tab and a Health tab.
-|
-| The **Logging Tab** displays log entries from the Log database. This tab also supports filtering and exporting of data.
-|
-| The **Health Tab** includes:
-| • PDP Status : The PDP table shows list of PDP's and the details of them.
-| • PAP Status : The PAP table shows list of Systems and there status and count of Policies.
-| • Policy Activity : The Policy Activity Shows the list of Policies in PDP's.
-| • System Alerts : The System Alerts table shows the logs on filtering logtype with Error.
+| The POLICY **Dashboard** shows the **status** and **health** of the system through metrics logs and status update messages. The dashboard consists of two tabs, a Logging tab and a Health tab.
.. image:: PolicyGUI_Dashboard.png