summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHong Hui Xiao <honghui_xiao@yeah.net>2017-11-02 14:25:01 +0800
committerHong Hui Xiao <honghui_xiao@yeah.net>2017-11-02 16:42:44 +0800
commit91bc52bba3bace2acbcc3740a80c34af0c0f00c3 (patch)
tree1c5e7ceccbff49828761fb2c2add8b89638497be
parente53ea1c3b750ff36a7dc356ab3f745a81abfaf9a (diff)
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>
-rw-r--r--docs/MultiCloud-Administrator-Guide.rst72
-rw-r--r--docs/images/msb-icons.pngbin0 -> 67402 bytes
-rw-r--r--docs/index.rst1
3 files changed, 73 insertions, 0 deletions
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
--- /dev/null
+++ b/docs/images/msb-icons.png
Binary files 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