From: Hong Hui Xiao <honghui_xiao@yeah.net>
Date: Thu, 2 Nov 2017 06:25:01 +0000 (+0800)
Subject: Add Multicloud Configuration and Administration
X-Git-Tag: v1.0.0~4
X-Git-Url: https://gerrit.onap.org/r/gitweb?p=multicloud%2Fframework.git;a=commitdiff_plain;h=91bc52bba3bace2acbcc3740a80c34af0c0f00c3

Add Multicloud Configuration and Administration

Document for end user.

Change-Id: I785aa47122797a035efde0d69af62b1deba378de
issue-id: MULTICLOUD-86
Signed-off-by: HongHui Xiao <honghui_xiao@yeah.net>
---

diff --git a/docs/MultiCloud-Administrator-Guide.rst b/docs/MultiCloud-Administrator-Guide.rst
new file mode 100644
index 0000000..2f4a871
--- /dev/null
+++ b/docs/MultiCloud-Administrator-Guide.rst
@@ -0,0 +1,72 @@
+===================================
+ONAP MultiCloud Administrator Guide
+===================================
+
+The guide for MultiCloud Administrator.
+
+
+Configuration
+=============
+
+Multicloud doesn’t have any configuration file for now.
+
+Administration
+==============
+
+From MSB
+--------
+
+After Multicloud is up and running, administrator can check Multicloud
+services from MSB. Go to MSB UI page, administrator should see several icons
+with name that starts with multicloud.
+
+.. image:: ./images/msb-icons.png
+    :alt: Multicloud icons in MSB
+    :width: 975
+    :height: 293
+    :align: center
+
+The icon named Multicloud is the main framework of Multicloud services. And
+other icons are the plugin for corresponding backend cloud. For example,
+multilcloud-vio is the plugin for VMware Integrated OpenStack.
+
+Administrator can manage Multicloud from MSB UI page. By clicking the icon
+named multicloud, there will be available api URL in the bottom of MSB UI
+page. After filling required fields, and clicking `Try it out!`, administrator
+can perform GET/POST/PUT/DELETE over Multicloud.
+
+From CLI
+--------
+
+Besides the MSB UI page, Administrator could manage Multicloud from command
+line interface(CLI). Multicloud’s CLI is the same as OpenStack’s CLI, and
+therefore, administrator can use OpenStack Client to manage Multicloud.
+To make OpenStack Client work with Multicloud, administrator needs to set the
+environment variables of operation system. An example of environment variables
+is list as below:
+
+::
+
+    OS_AUTH_URL=http://<msb-ip>:80/api/multicloud/v0/<vim_info>/identity/v3
+    OS_PROJECT_ID=<project id in backend OpenStack>
+    OS_PROJECT_NAME=<project name in backend OpenStack>
+    OS_USER_DOMAIN_NAME=<domain name in backend OpenStack>
+    OS_USERNAME=<administrator username in backend OpenStack>
+    OS_PASSWORD=<password of administrator in backend OpenStack>
+    OS_REGION_NAME=<region name in backend OpenStack>
+    OS_INTERFACE=internal
+    OS_IDENTITY_API_VERSION=3
+
+<msb-ip> in OS_AUTH_URL is the IP address of MSB. <vim-info> is composed of
+cloud_type and cloud_region_id. These two attributes are information of cloud
+from A&AI. Other environment variables listed above are some information from
+Multicloud’s backend OpenStack.
+After exporting above variables into operation system, administrator can use
+OpenStack Client to mange Multicloud. For example:
+
+::
+
+    nova list
+
+will list the virtual machine in Multicloud’s backend OpenStack.
+
diff --git a/docs/images/msb-icons.png b/docs/images/msb-icons.png
new file mode 100644
index 0000000..17e2996
Binary files /dev/null and b/docs/images/msb-icons.png differ
diff --git a/docs/index.rst b/docs/index.rst
index 25804de..d5357b9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -10,3 +10,4 @@ MultiCloud Documentation Repository
    MultiCloud-API-Specification-V1
    Multicloud-Fake_Cloud-Guide
    MultiCloud-Heat-Deployment-Guide
+   MultiCloud-Administrator-Guide