Issue-ID: DOC-506
Portal Doc migrated from DevWiki to RTD; splitted into User and Admin parts
Signed-off-by: Thomas Kulik <thomas.kulik@telekom.de>
Change-Id: I24874f876865a377f7efe49b2d6519d6f0d1b66b
diff --git a/docs/guides/onap-operator/index.rst b/docs/guides/onap-operator/index.rst
index e464c24..ed11438 100644
--- a/docs/guides/onap-operator/index.rst
+++ b/docs/guides/onap-operator/index.rst
@@ -16,3 +16,4 @@
settingup/index.rst
platformoperations.rst
cloud_site/index.rst
+ onap-portal-admin/onap-portal-admin.rst
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/1018906_ep_home_editwidget.png b/docs/guides/onap-operator/onap-portal-admin/attachments/1018906_ep_home_editwidget.png
new file mode 100644
index 0000000..6490e9c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/1018906_ep_home_editwidget.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/1018932_ep_trash_icon.png b/docs/guides/onap-operator/onap-portal-admin/attachments/1018932_ep_trash_icon.png
new file mode 100644
index 0000000..77ce4ad
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/1018932_ep_trash_icon.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/1018942_ep_editmenu_edit.png b/docs/guides/onap-operator/onap-portal-admin/attachments/1018942_ep_editmenu_edit.png
new file mode 100644
index 0000000..c628abe
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/1018942_ep_editmenu_edit.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004284_image2017-10-27_14-14-37.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004284_image2017-10-27_14-14-37.png
new file mode 100644
index 0000000..1178279
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004284_image2017-10-27_14-14-37.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004288_image2017-10-27_14-17-0.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004288_image2017-10-27_14-17-0.png
new file mode 100644
index 0000000..317f1e7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004288_image2017-10-27_14-17-0.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004295_image2017-10-27_14-23-38.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004295_image2017-10-27_14-23-38.png
new file mode 100644
index 0000000..a68086f
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004295_image2017-10-27_14-23-38.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004297_image2017-10-27_14-26-38.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004297_image2017-10-27_14-26-38.png
new file mode 100644
index 0000000..dc5ede8
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004297_image2017-10-27_14-26-38.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004301_image2017-10-27_14-30-33.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004301_image2017-10-27_14-30-33.png
new file mode 100644
index 0000000..17f40be
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004301_image2017-10-27_14-30-33.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004303_image2017-10-27_14-30-51.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004303_image2017-10-27_14-30-51.png
new file mode 100644
index 0000000..17f40be
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004303_image2017-10-27_14-30-51.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004306_image2017-10-27_14-35-46.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004306_image2017-10-27_14-35-46.png
new file mode 100644
index 0000000..c02a775
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004306_image2017-10-27_14-35-46.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004309_image2017-10-27_14-41-13.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004309_image2017-10-27_14-41-13.png
new file mode 100644
index 0000000..50cf6e7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004309_image2017-10-27_14-41-13.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004321_image2017-10-27_15-21-13.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004321_image2017-10-27_15-21-13.png
new file mode 100644
index 0000000..2f5e756
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004321_image2017-10-27_15-21-13.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004324_image2017-10-27_15-24-5.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004324_image2017-10-27_15-24-5.png
new file mode 100644
index 0000000..e08ea6b
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004324_image2017-10-27_15-24-5.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004327_image2017-10-27_15-27-1.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004327_image2017-10-27_15-27-1.png
new file mode 100644
index 0000000..fa976c7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004327_image2017-10-27_15-27-1.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004329_image2017-10-27_15-28-31.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004329_image2017-10-27_15-28-31.png
new file mode 100644
index 0000000..ea17b5c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004329_image2017-10-27_15-28-31.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004338_image2017-10-27_15-51-18.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004338_image2017-10-27_15-51-18.png
new file mode 100644
index 0000000..90de6ee
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004338_image2017-10-27_15-51-18.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004340_image2017-10-27_15-52-28.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004340_image2017-10-27_15-52-28.png
new file mode 100644
index 0000000..9d181e8
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004340_image2017-10-27_15-52-28.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004343_image2017-10-27_15-56-53.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004343_image2017-10-27_15-56-53.png
new file mode 100644
index 0000000..4e89725
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004343_image2017-10-27_15-56-53.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004915_image2017-10-31_10-49-27.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004915_image2017-10-31_10-49-27.png
new file mode 100644
index 0000000..5d9240c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004915_image2017-10-31_10-49-27.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004934_image2017-10-31_11-12-22.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004934_image2017-10-31_11-12-22.png
new file mode 100644
index 0000000..5bbd737
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004934_image2017-10-31_11-12-22.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004936_image2017-10-31_11-16-14.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004936_image2017-10-31_11-16-14.png
new file mode 100644
index 0000000..45b76fa
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004936_image2017-10-31_11-16-14.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004943_image2017-10-31_11-21-2.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004943_image2017-10-31_11-21-2.png
new file mode 100644
index 0000000..06f476d
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004943_image2017-10-31_11-21-2.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004944_image2017-10-31_11-23-15.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004944_image2017-10-31_11-23-15.png
new file mode 100644
index 0000000..c3f2c3c
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004944_image2017-10-31_11-23-15.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004954_image2017-10-31_11-29-12.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004954_image2017-10-31_11-29-12.png
new file mode 100644
index 0000000..7d3bae6
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004954_image2017-10-31_11-29-12.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004962_image2017-10-31_11-34-8.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004962_image2017-10-31_11-34-8.png
new file mode 100644
index 0000000..05bf69d
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004962_image2017-10-31_11-34-8.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/16004980_image2017-10-31_12-21-53.png b/docs/guides/onap-operator/onap-portal-admin/attachments/16004980_image2017-10-31_12-21-53.png
new file mode 100644
index 0000000..454c6b9
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/16004980_image2017-10-31_12-21-53.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086818_image2017-12-5_14-53-43.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086818_image2017-12-5_14-53-43.png
new file mode 100644
index 0000000..e7b808d
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086818_image2017-12-5_14-53-43.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086819_image2017-12-5_14-57-22.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086819_image2017-12-5_14-57-22.png
new file mode 100644
index 0000000..977808e
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086819_image2017-12-5_14-57-22.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086820_image2017-12-5_15-8-37.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086820_image2017-12-5_15-8-37.png
new file mode 100644
index 0000000..88626ea
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086820_image2017-12-5_15-8-37.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086821_image2017-12-5_15-9-27.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086821_image2017-12-5_15-9-27.png
new file mode 100644
index 0000000..516adc7
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086821_image2017-12-5_15-9-27.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086839_image2017-12-5_16-52-40.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086839_image2017-12-5_16-52-40.png
new file mode 100644
index 0000000..1662438
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086839_image2017-12-5_16-52-40.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/attachments/20086846_image2017-12-5_16-57-24.png b/docs/guides/onap-operator/onap-portal-admin/attachments/20086846_image2017-12-5_16-57-24.png
new file mode 100644
index 0000000..c2c361f
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/attachments/20086846_image2017-12-5_16-57-24.png
Binary files differ
diff --git a/docs/guides/onap-operator/onap-portal-admin/onap-portal-admin.rst b/docs/guides/onap-operator/onap-portal-admin/onap-portal-admin.rst
new file mode 100644
index 0000000..81d42f6
--- /dev/null
+++ b/docs/guides/onap-operator/onap-portal-admin/onap-portal-admin.rst
@@ -0,0 +1,664 @@
+|image2017-10-27_15-56-53.png|
+
+ONAP Portal for Administrators
+==============================
+
+General
+-------
+
+The ONAP Portal platform integrates different ONAP applications into a
+central core. The Portal platform provides common management services
+and connectivity, while the applications run separately.
+
+From the Portal, users access applications. Administrators onboard and
+manage applications and widgets, and manage user access.
+
+The Portal SDK for application developers includes bundled tools,
+technologies, and built-in capabilities such as services, APIs, and UI
+controls. Existing applications can migrate to the Portal with the
+provided APIs and libraries. See `ONAP Portal SDK
+Documentation <http://onap.readthedocs.io/en/latest/submodules/portal.git/docs/tutorials/index.html>`__\.
+
+Access
+------
+
+Access the ONAP Portal using Mozilla Firefox or Google Chrome(win/mac)
+at the provided URL. For example: `https://<hostname:port>/ONAPPORTAL/login.html`.
+
+Access the ONAP portal via the 8989 LoadBalancer documented `here <https://onap.readthedocs.io/en/latest/submodules/oom.git/docs/oom_user_guide.html#accessing-the-onap-portal-using-oom-and-a-kubernetes-cluster>`__
+
+From the Portal, users access applications directly or by function using
+the `Manage menu`.
+
+See also:
+
+- `Applications in the Portal`
+
+- `Application Catalog`
+
+Roles
+-----
+
+The Portal displays different menus for the following functions:
+
+- Users
+
+- Portal Admins
+
+- Application Admins
+
+- Governor
+
+- Operator
+
+Each application also defines a distinct set of user roles. See *Users* .
+
+
+Admin Tasks
+-----------
+
+From the ONAP Portal, administrators:
+
+- access the same functionality accessible to users (see `ONAP Portal
+ for users <#PAGE_1018759>`__)
+
+- manage users and application admins
+
+- onboard applications and widgets
+
+- edit the functional menu
+
+Administrators see the following menu when accessing the ONAP Portal:
+
+|image2017-10-27_14-14-37.png|
+
+Left menu descriptions:
+
+.. _PAGE_1018764:
+
+Admins Menu
+-----------
+
+Use the Admins section to:
+
+|image2017-10-27_14-17-0.png|
+
+View or search for application admins
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. View or search for admins:
+
+- The Admins table shows all admins in alphabetical order by first
+ name. Select an application from the dropdown list to view admins for
+ a single application.
+
+- Search for an admin by entering a full or partial search term in the
+ search box. Search by first name, last name, or user ID. Searches are
+ not case-sensitive.
+
+- Filter further using a combination of the applications dropdown and
+ the search box.
+
+Add an application admin
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. Click Add Admin.The New Admin window displays.
+
+#. Enter any combination of the user's first name, last name in the
+ search field and click Search.Note: A minimum of three characters is
+ required to search.
+
+#. Select the user from the results and click Next.
+
+|image2017-10-27_14-23-38.png|
+
+#. Select an application from the dropdown list.
+
+|image2017-10-27_14-26-38.png|
+
+#. Click Save.
+
+The user can administer and manage users for the applications listed in
+the Admins table.
+
+Modify application admin privileges
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. Search for an admin and then select one by clicking the row in the
+ Admins table (see `View or search for application admins`.
+
+#. Modify the admin's application privileges:
+
+- Add an application to the Administrates list by selecting it from the
+ dropdown list
+
+- Delete an application from the Administrates list by clicking the
+ trash icon
+
+|image2017-10-27_14-30-33.png| .
+
+#. Click Save.
+
+Delete an application admin
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To delete an application admin completely, first remove access for each
+application.
+
+#. From the ONAP Portal Home, click Admins in the left menu.
+
+#. Search for a name and then select one by clicking the row in the
+ Admins table (see `View or search for application admins`.
+
+#. Click the trash icon
+
+|image2017-10-27_14-30-51.png| and click OK to confirm for each
+application in the Administrates list.
+
+#. Click Save.
+
+The application Admin is removed from the table. The Admin is only
+removed from the Admins table when they have no application access.
+
+
+Users Menu
+----------
+
+Use the Users section to:
+
+|image2017-10-27_14-35-46.png|
+
+View or search for users
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Users in the left menu.
+
+#. Select an application from the dropdown list.
+
+#. Enter a full or partial first name, last, name, user ID, or role in
+ the search box; or click the column header to sort that column in
+ alphabetical or reverse alphabetical order.
+
+Add a user
+~~~~~~~~~~
+
+Portal admins can add or manage users for any application. Application
+admins can only add and manage users for their specific applications.
+
+#. From ONAP Portal Home, click Users in the left menu.
+
+#. Click Add User.
+
+#. The New User window displays.
+
+#. Search for or add a new user:
+
+- To search for a user, enter the user's complete first name, last
+ name, or user ID and click search.
+
+- To add a new user, click New User, fill in the user details, and
+ click Add New User. The new user appears in the results list.
+
+#. Select the user from the results and click Next.
+
+|image2017-10-27_14-41-13.png|
+
+#. Select a role from the dropdown lists for each application required
+ by the user.
+
+#. Click Save.
+
+The user can access the applications with the roles listed in the Users
+table.
+
+Modify users and roles
+~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Users in the left menu.
+
+#. Select an application from the dropdown, search for a user, and
+ select one by clicking the row in the Users table. The user's access
+ and roles display.
+
+|image2017-10-27_15-21-13.png|
+
+#. Modify the user's role for each application:
+
+- Add or change a user role by selecting or clearing the role from the
+ dropdown list.
+
+- Remove all the user's roles for an application by clicking the trash
+ icon
+
+|ep_trash_icon.png| .
+
+#. Click Save.
+
+Delete a user
+~~~~~~~~~~~~~
+
+To delete a user completely, remove access for each application.
+
+#. From the ONAP Portal Home, click Users in the left menu.
+
+#. Select an application from the dropdown, search for a user, then
+ click the row in the Users table to select (see `View or search for
+ users`.
+ The user's access and roles display.
+
+#. Click the trash icon
+
+|ep_trash_icon.png| beside an application and click OK to confirm.
+
+#. Click Save.
+
+The User is removed from the applications. The User is only removed from
+the Users table when they have no application access.
+
+Portal Admins
+-------------
+
+Use the Portal Admins section to:
+
+|image2017-10-27_15-24-5.png|
+
+View or search for Portal Admins
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Portal Admins in the left menu.
+
+#. Enter a full or partial first name, last, name, or ATTUID in the
+ search box, or click the sorting arrows in any column to sort that
+ column in alphabetical or reverse alphabetical order.
+
+Add a Portal Admin
+~~~~~~~~~~~~~~~~~~
+
+Only Portal Admins can add or delete other Portal Admins.
+
+#. From the ONAP Portal Home, click Portal Admins in the left menu.
+
+#. Click Add Portal Admin. The Add New Portal Admin window displays.
+
+#. Search for or add a new user:
+
+- To search for a user, enter the user's complete first name, last
+ name, or user ID and click search.
+
+- To add a new user, click New User, fill in the user details, and
+ click Add New User. The new user appears in the results list.
+
+#. Select the user from the results and click Save.
+
+The user is listed in the Portal Admins table and can manage users and
+admins.
+
+Delete a Portal Admin
+~~~~~~~~~~~~~~~~~~~~~
+
+Only Portal Admins can add or delete other Portal Admins.
+
+#. From ONAP Portal Home, click Portal Admins in the left menu.
+
+#. Search for or scroll to a name in the Portal Admins table and click
+ the trash icon in the Delete column.
+
+#. Click OK to confirm.
+
+The Portal Admin is removed from the table.
+
+Application Onboarding
+----------------------
+
+Use the Application Onboarding section to:
+
+|image2017-10-27_15-27-1.png|
+
+Add an application to the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Application Onboarding in the left
+ menu.
+
+#. Click Add App.
+
+#. The Application Details window displays.
+
+|image2017-10-27_15-28-31.png|
+
+4. Fill out the fields as described in the table:
+
++---------------------------+------------------------------------------+
+| **Hyperlink only | Select to add an application with a URL |
+| application** | only. |
++===========================+==========================================+
+| **Application name** | Application name to display in the |
+| | Portal. |
++---------------------------+------------------------------------------+
+| **URL** | Application landing page for |
+| | hyperlink-only applications. |
++---------------------------+------------------------------------------+
+| **REST API URL** | [Optional] The endpoint for RESTful API |
+| | calls. |
++---------------------------+------------------------------------------+
+| **Username** | The username for the RESTful API calls. |
+| | Default = Default |
++---------------------------+------------------------------------------+
+| **Password** | Password for the RESTful API call. |
+| | Default = AppPassword!1 |
++---------------------------+------------------------------------------+
+| **Name Space** | Namespace value when Application |
+| | registered in AAF. |
++---------------------------+------------------------------------------+
+| **Communication Inbox** | Do not fill out. Populated by the |
+| | application. |
++---------------------------+------------------------------------------+
+| **Communication Key** | Do not fill out. Populated by the |
+| | application. |
++---------------------------+------------------------------------------+
+| **Communication Secret** | Do not fill out. Populated by the |
+| | application. |
++---------------------------+------------------------------------------+
+| **Upload image** | Click Browse to select the application |
+| | image to display in the ONAP Portal. |
++---------------------------+------------------------------------------+
+| **Allow guest access** | Select to allow access for users not |
+| | listed as Users or Admins. |
++---------------------------+------------------------------------------+
+| **Active** | Select to make the application active. |
++---------------------------+------------------------------------------+
+| **Centralized** | Indicate this application is using AAF |
+| | for centralized role management. |
++---------------------------+------------------------------------------+
+
+5. Click Save.
+
+The application appears in the Applications section and in the
+Application Onboarding table. The Portal Admin receives an email with
+Communications details.
+
+6. Add the application URL to the appropriate Manage menu items:
+
+#. Click Edit Functional Menu in the left menu.
+
+#. Expand the Manage menu to find the correct items.
+
+#. Right-click an item and select Edit.
+
+|ep_editmenu_edit.png|
+
+#. In the URL field, enter the server URL of the new application and
+ click Save.
+
+Collect and forward application communication details
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Portal administrator forwards communications details and a list of
+servers to the application developer. The application developer adds the
+details to the portal-properties file located in \\<app web
+directory>/WEB-INF/classes.
+
+**Prerequisites:** *Add an application to the Portal*
+
+#. Collect the following details and send them to the application
+ developer.
+
++----------------------------------------+-----------------------------+
+| Key-value pair | Obtain from |
++========================================+=============================+
+| redirect_url = ** /** | The redirect URL defined |
+| /process_csp | as ** /** /process_csp. |
++----------------------------------------+-----------------------------+
+
+#. Request that the application developer:
+
+#. Add the key-value pairs above to the portal.properties file located
+ in ** /WEB-INF/classes.
+
+#. Add the key-value pair shared_context_rest_url = ** to the
+ system.properties file located in the ** /WEB-INF/conf directory.
+
+#. Restart the application
+
+Delete an application from the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Widget Onboarding in the left menu.
+
+#. Search for or scroll to an application in the table and click the
+ trash icon
+
+|ep_trash_icon.png| in the Delete column.
+
+#. Click OK to confirm.
+
+The application is removed from the Portal.
+
+Widget Onboarding
+-----------------
+
+Use the Widget Onboarding section to:
+
+|image2017-10-27_15-51-18.png|
+
+Add an application widget to the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Widget Onboarding in the left menu.
+
+#. Click Add Widget.
+
+The Widget Details window displays.
+
+|image2017-10-27_15-52-28.png|
+
+3. Fill out the fields as described in the following table.
+
++------------------+---------------------------------------------------+
+| **Application | Select from a dropdown list of onboarded |
+| Name** | applications. |
++==================+===================================================+
+| **Widget Name** | The name for the widget that appears in the |
+| | Widgets section of the Portal. |
++------------------+---------------------------------------------------+
+| **Width, | Automatically populated fields. |
+| Height** | |
++------------------+---------------------------------------------------+
+| **URL** | Widget landing page. |
++------------------+---------------------------------------------------+
+
+4. Click Save.
+
+The widget appears in the Widgets section of the Portal. Users with
+permissions to the widget's application can access the widget.
+
+Remove a widget from the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Widget Onboarding in the left menu.
+
+#. Search for or scroll to a widget in the table and click the trash
+ icon
+
+|ep_trash_icon.png| in the Delete column.
+
+#. Click OK to confirm.
+
+The widget is removed from the Portal.
+
+Edit Functional Menu
+--------------------
+
+Edit or rearrange the ONAP Portal functional menus in the Edit
+Functional Menu section.
+
+|image2017-10-31_11-12-22.png|
+
+ONAP Portal menus have 4 levels. The menu levels correspond to how and
+where the menu items appear in the Portal UI.
+
+|image2017-10-31_10-49-27.png|
+
+Use the Edit Functional Menu section to:
+
+Add a menu item
+~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Edit Functional Menu in the left menu.
+
+#. Use the arrows to expand the menu, then right-click on the intended
+ parent menu item and select Add.
+
+|image2017-10-31_11-16-14.png|
+
+#. Enter a title for the menu item, then enter a URL or select the
+ application to link to from the App dropdown list.
+
+#. Click Save.
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+Edit a menu item
+~~~~~~~~~~~~~~~~
+
+#. From the ONAP Portal Home, click Edit Functional Menu in the left
+ menu.
+
+#. Use the arrows to expand the menu, then right-click on the menu item
+ and select Edit.
+
+#. Make changes to the title, URL, or application and click Continue.
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+|image2017-10-31_11-21-2.png|
+
+Move a menu item
+~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Edit Functional Menu in the left menu.
+
+#. Use the arrows to expand the menu.
+
+#. Click and drag a menu item to move it.A blue line appears to indicate
+ where the menu item will move. A blue box indicates the moved item
+ will be a child of that item.
+
+|image2017-10-31_11-23-15.png|
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+Delete a menu item
+~~~~~~~~~~~~~~~~~~
+
+A menu item with children cannot be deleted. Delete all child menu items
+first.
+
+#. From ONAP Portal Home, click Edit Functional Menu in the left menu.
+
+#. Use the arrows to expand the menu, then right-click on the menu item
+ and select Delete.
+
+#. Click OK
+
+#. Click Regenerate Menu to finalize the changes and update the menu.
+
+Portal Microservices Onboarding
+-------------------------------
+
+From left menu Microservice Onboarding section:
+
+|image2017-10-31_11-29-12.png|
+
+Add a microservice widget to the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Microservice Onboarding in the left
+ menu.
+
+#. Click Add Microservice.
+
+The Microservice Details window displays.
+
+|image2017-10-31_11-34-8.png|
+
+3. Fill out the fields as described in the following table.
+
++---------------------------------+------------------------------------+
+| **Field** | Explanation |
++=================================+====================================+
+| **Microservice Name** | The name for the microservice that |
+| | appears in the Microservice |
+| | section of the Portal. |
++---------------------------------+------------------------------------+
+| **Microservice Description** | Describe what the microservice |
+| | does |
++---------------------------------+------------------------------------+
+| **Application Name** | Select from a dropdown list of |
+| | onboarded applications. |
++---------------------------------+------------------------------------+
+| **Microservice End Point URL** | Enter Microservice URL |
++---------------------------------+------------------------------------+
+| **Security Type** | Select from dropdown for |
+| | Authentication Method |
++---------------------------------+------------------------------------+
+| **Add User Parameter** | Enter parameter key and value if |
+| | applicable to microservice end |
+| | point URL |
++---------------------------------+------------------------------------+
+| **Active** | Active check/uncheck to show/hide |
+| | the microservice |
++---------------------------------+------------------------------------+
+
+4. Click Save.
+
+The microservice appears in the Microservices section of the Portal.
+Users with permissions to the Microservice application can access the
+microservice.
+
+Remove a microservice from the Portal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. From ONAP Portal Home, click Microservice Onboarding in the left
+ menu.
+
+#. Search for or scroll to a microservice in the table and click the
+ trash icon
+
+|ep_trash_icon.png| in the Delete column.
+
+#. Click OK to confirm.
+
+The mocroservice is removed from the Portal.
+
+.. |image2017-10-27_15-56-53.png| image:: attachments/16004343_image2017-10-27_15-56-53.png
+.. |image2017-12-5_15-8-37.png| image:: attachments/20086820_image2017-12-5_15-8-37.png
+.. |image2017-10-27_14-14-37.png| image:: attachments/16004284_image2017-10-27_14-14-37.png
+.. |image2017-10-27_14-17-0.png| image:: attachments/16004288_image2017-10-27_14-17-0.png
+.. |image2017-10-27_14-23-38.png| image:: attachments/16004295_image2017-10-27_14-23-38.png
+.. |image2017-10-27_14-26-38.png| image:: attachments/16004297_image2017-10-27_14-26-38.png
+.. |image2017-10-27_14-30-33.png| image:: attachments/16004301_image2017-10-27_14-30-33.png
+.. |image2017-10-27_14-30-51.png| image:: attachments/16004303_image2017-10-27_14-30-51.png
+.. |image2017-10-27_14-35-46.png| image:: attachments/16004306_image2017-10-27_14-35-46.png
+.. |image2017-10-27_14-41-13.png| image:: attachments/16004309_image2017-10-27_14-41-13.png
+.. |image2017-10-27_15-21-13.png| image:: attachments/16004321_image2017-10-27_15-21-13.png
+.. |ep_trash_icon.png| image:: attachments/1018932_ep_trash_icon.png
+.. |image2017-10-27_15-24-5.png| image:: attachments/16004324_image2017-10-27_15-24-5.png
+.. |image2017-10-27_15-27-1.png| image:: attachments/16004327_image2017-10-27_15-27-1.png
+.. |image2017-10-27_15-28-31.png| image:: attachments/16004329_image2017-10-27_15-28-31.png
+.. |ep_editmenu_edit.png| image:: attachments/1018942_ep_editmenu_edit.png
+.. |image2017-10-27_15-51-18.png| image:: attachments/16004338_image2017-10-27_15-51-18.png
+.. |image2017-10-27_15-52-28.png| image:: attachments/16004340_image2017-10-27_15-52-28.png
+.. |image2017-10-31_11-12-22.png| image:: attachments/16004934_image2017-10-31_11-12-22.png
+.. |image2017-10-31_10-49-27.png| image:: attachments/16004915_image2017-10-31_10-49-27.png
+.. |image2017-10-31_11-16-14.png| image:: attachments/16004936_image2017-10-31_11-16-14.png
+.. |image2017-10-31_11-21-2.png| image:: attachments/16004943_image2017-10-31_11-21-2.png
+.. |image2017-10-31_11-23-15.png| image:: attachments/16004944_image2017-10-31_11-23-15.png
+.. |image2017-10-31_11-29-12.png| image:: attachments/16004954_image2017-10-31_11-29-12.png
+.. |image2017-10-31_11-34-8.png| image:: attachments/16004962_image2017-10-31_11-34-8.png
diff --git a/docs/guides/onap-user/index.rst b/docs/guides/onap-user/index.rst
index c431b31..f8ca1eb 100644
--- a/docs/guides/onap-user/index.rst
+++ b/docs/guides/onap-user/index.rst
@@ -13,7 +13,7 @@
.. toctree::
:maxdepth: 1
- onapportal.rst
+ onap-portal-user/onap-portal-user.rst
design/index.rst
instantiate/index.rst
configure/index.rst
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/1018906_ep_home_editwidget.png b/docs/guides/onap-user/onap-portal-user/attachments/1018906_ep_home_editwidget.png
new file mode 100644
index 0000000..6490e9c
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/1018906_ep_home_editwidget.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/16004284_image2017-10-27_14-14-37.png b/docs/guides/onap-user/onap-portal-user/attachments/16004284_image2017-10-27_14-14-37.png
new file mode 100644
index 0000000..1178279
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/16004284_image2017-10-27_14-14-37.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/16004343_image2017-10-27_15-56-53.png b/docs/guides/onap-user/onap-portal-user/attachments/16004343_image2017-10-27_15-56-53.png
new file mode 100644
index 0000000..4e89725
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/16004343_image2017-10-27_15-56-53.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/16004980_image2017-10-31_12-21-53.png b/docs/guides/onap-user/onap-portal-user/attachments/16004980_image2017-10-31_12-21-53.png
new file mode 100644
index 0000000..454c6b9
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/16004980_image2017-10-31_12-21-53.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086818_image2017-12-5_14-53-43.png b/docs/guides/onap-user/onap-portal-user/attachments/20086818_image2017-12-5_14-53-43.png
new file mode 100644
index 0000000..e7b808d
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086818_image2017-12-5_14-53-43.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086819_image2017-12-5_14-57-22.png b/docs/guides/onap-user/onap-portal-user/attachments/20086819_image2017-12-5_14-57-22.png
new file mode 100644
index 0000000..977808e
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086819_image2017-12-5_14-57-22.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086820_image2017-12-5_15-8-37.png b/docs/guides/onap-user/onap-portal-user/attachments/20086820_image2017-12-5_15-8-37.png
new file mode 100644
index 0000000..88626ea
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086820_image2017-12-5_15-8-37.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086821_image2017-12-5_15-9-27.png b/docs/guides/onap-user/onap-portal-user/attachments/20086821_image2017-12-5_15-9-27.png
new file mode 100644
index 0000000..516adc7
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086821_image2017-12-5_15-9-27.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086839_image2017-12-5_16-52-40.png b/docs/guides/onap-user/onap-portal-user/attachments/20086839_image2017-12-5_16-52-40.png
new file mode 100644
index 0000000..1662438
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086839_image2017-12-5_16-52-40.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/attachments/20086846_image2017-12-5_16-57-24.png b/docs/guides/onap-user/onap-portal-user/attachments/20086846_image2017-12-5_16-57-24.png
new file mode 100644
index 0000000..c2c361f
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/attachments/20086846_image2017-12-5_16-57-24.png
Binary files differ
diff --git a/docs/guides/onap-user/onap-portal-user/onap-portal-user.rst b/docs/guides/onap-user/onap-portal-user/onap-portal-user.rst
new file mode 100644
index 0000000..7ce2f3a
--- /dev/null
+++ b/docs/guides/onap-user/onap-portal-user/onap-portal-user.rst
@@ -0,0 +1,172 @@
+|image2017-10-27_15-56-53.png|
+
+ONAP Portal for Users
+=====================
+
+General
+-------
+
+The ONAP Portal platform integrates different ONAP applications into a
+central core. The Portal platform provides common management services
+and connectivity, while the applications run separately.
+
+From the Portal, users access applications. Administrators onboard and
+manage applications and widgets, and manage user access.
+
+The Portal SDK for application developers includes bundled tools,
+technologies, and built-in capabilities such as services, APIs, and UI
+controls. Existing applications can migrate to the Portal with the
+provided APIs and libraries. See `ONAP Portal SDK
+Documentation <http://onap.readthedocs.io/en/latest/submodules/portal.git/docs/tutorials/index.html>`__\.
+
+Access
+------
+
+Access the ONAP Portal using Mozilla Firefox or Google Chrome(win/mac)
+at the provided URL. For example: `https://<hostname:port>/ONAPPORTAL/login.html`.
+
+Access the ONAP portal via the 8989 LoadBalancer documented `here <https://onap.readthedocs.io/en/latest/submodules/oom.git/docs/oom_user_guide.html#accessing-the-onap-portal-using-oom-and-a-kubernetes-cluster>`__
+
+From the Portal, users access applications directly or by function using
+the `Manage menu`.
+
+See also:
+
+- `Applications in the Portal`
+
+- `Application Catalog`
+
+Roles
+-----
+
+The Portal displays different menus for the following functions:
+
+- Users
+
+- Portal Admins
+
+- Application Admins
+
+- Governor
+
+- Operator
+
+Each application also defines a distinct set of user roles. See *Users* .
+
+Portal personalization and features
+-----------------------------------
+
+Show and hide the left menu
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To hide the left menu, click the menu icon. Click the menu icon again to
+show the menu.
+
+|image2017-10-31_12-21-53.png|
+
+Applications
+~~~~~~~~~~~~
+
+Access applications in the Portal directly from the `Application Catalog`
+or using the `Manage menu`.
+All the default applications in the ONAP Portal are integrated, but
+applications may also be onboarded as hyperlink-only. Integrated
+applications open in tabs below the header in the Portal; linked
+applications open in a new browser window. To close an integrated
+application, click the x in the tab.
+
+|image2017-12-5_14-53-43.png|
+
+A maximum of six applications (tabs) can be open at once in the ONAP
+Portal.
+
+Manage menu
+-----------
+
+The Manage menu provides links to applications by function. Choose from
+a list of functional or management tasks for each area. This example
+shows the options in the top-level functional Design category:
+
+|image2017-12-5_14-57-22.png|
+
+Favorites
+~~~~~~~~~
+
+Hover over a menu item and click the star beside it to add it to
+Favorites. Click the star again to remove the item from Favorites.
+
+Editing the Menu
+~~~~~~~~~~~~~~~~
+
+Portal Admins edit and manage the menu. See `Edit Functional Menu`
+
+Support Menu
+------------
+
+The Support menu provides Contact Us and Get Access links. Portal admins
+can add contact details and also edit Support menu. See `Edit Functional Menu`.
+
+Home
+----
+
+Home is the default view after login.
+
+|image2017-12-5_16-52-40.png|
+
+Personalize the Home Page
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Add or remove applications using the `Application Catalog`.
+Sort applications or widgets by clicking the drag handle to drag and
+drop the application or widget to a new location.
+
+|image2017-12-5_16-57-24.png| Add, manage, and edit what appears in the
+widgets by clicking the settings icon and selecting Edit.
+
+|ep_home_editwidget.png|
+
+Application Catalog
+-------------------
+
+Use the Application Catalog to select which application should appear on
+your Home page. Applications with a check mark already appear on the
+Home page.
+
+- To select an application to appear on the Home page, click the check
+ box in the top right corner of the application tile.
+
+- To remove an application from the Home page, click the check box
+ again.
+
+- Use the Filter to view specific applications: All applications,
+ Accessible (currently available) applications, or applications On
+ Home Page.
+
+- Click the drag handle to sort application tiles in the Application
+ Catalog.
+
+|image2017-12-5_15-8-37.png|
+
+Widget Catalog
+--------------
+
+Widgets are small applications that interact with their host application
+and each other to provide quick access for certain tasks. Use the
+Widgets section to view and interact with widgets.
+
+- Click a widget tile to open the widget.
+
+- Click the drag handle to sort widget tiles.
+
+|image2017-12-5_15-9-27.png|
+
+
+.. |image2017-10-27_15-56-53.png| image:: attachments/16004343_image2017-10-27_15-56-53.png
+.. |image2017-10-31_12-21-53.png| image:: attachments/16004980_image2017-10-31_12-21-53.png
+.. |image2017-12-5_14-53-43.png| image:: attachments/20086818_image2017-12-5_14-53-43.png
+.. |image2017-12-5_14-57-22.png| image:: attachments/20086819_image2017-12-5_14-57-22.png
+.. |image2017-12-5_16-52-40.png| image:: attachments/20086839_image2017-12-5_16-52-40.png
+.. |image2017-12-5_16-57-24.png| image:: attachments/20086846_image2017-12-5_16-57-24.png
+.. |ep_home_editwidget.png| image:: attachments/1018906_ep_home_editwidget.png
+.. |image2017-12-5_15-8-37.png| image:: attachments/20086820_image2017-12-5_15-8-37.png
+.. |image2017-12-5_15-9-27.png| image:: attachments/20086821_image2017-12-5_15-9-27.png
