Merge "Add Heat deployment docs"

2 files changed, 106 insertions, 0 deletions

diff --git a/docs/MuliCloud-Heat-Deployment-Guide.rst b/docs/MuliCloud-Heat-Deployment-Guide.rst
new file mode 100644
index 0000000..d33ab47
--- /dev/null
+++ b/docs/MuliCloud-Heat-Deployment-Guide.rst
@@ -0,0 +1,105 @@
+=====================================
+ONAP MultiCloud Heat Deployment Guide
+=====================================
+
+Prerequisites
+~~~~~~~~~~~~~
+
+1. A VIO platofrom install with nova,keystone,horizon,image,
+,neutron and heat service, make sure  floating ip is work.
+
+2  A local host as openstackclient cloud access opentack platform,
+install python,python-pip,vietualenv, python-openstackclient,
+python-heatclient.
+
+
+
+
+Export os enviroment
+~~~~~~~~~~~~~~~~~~~~
+
+we'll need to create a file call admin.rc with following content
+
+keystone version 2.0 Example:
+
+export OS_AUTH_URL=https://identity.api.opentack.com/v2.0/
+export OS_USERNAME=UserName
+export OS_TENANT_ID=TenantID
+export OS_REGION_NAME=RegionID
+export OS_PASSWORD=Password
+export OS_IDENTITY_API_VERSION=2
+
+keystone version 3.0 Example:
+
+export OS_AUTH_URL=https://identiy.api.openstack.com/v3/
+export OS_PROJECT_ID=ProjectID
+export OS_PROJECT_NAME=ProjectName
+export OS_USER_DOMAIN_NAME=DomainName
+export OS_USERNAME=UserName
+export OS_PASSWORD=Password
+if [ -z "$OS_USER_DOMAIN_NAME" ]; then unset OS_USER_DOMAIN_NAME; fi
+
+# unset v2.0 items in case set
+unset OS_TENANT_ID
+unset OS_TENANT_NAME
+
+
+export OS_IDENTITY_API_VERSION=3
+
+
+
+
+Get VIO  pem
+~~~~~~~~~~~~~
+
+Get a copy of vio.pem in load balancer vms(/etc/ssl/vio.pem) in local
+host, then add the following line to your  admin.rc file:
+export OS_CACERT=/your/path/vio.pem
+
+
+
+
+Deploy the ONAP
+~~~~~~~~~~~~~~~~
+
+get onap heat files from git repo:
+git clone http://<your-account>@gerrit.onap.org/r/a/demo
+
+we will use onap_opentack_float.yaml and onap_openstack_float.env  heat templates
+at ./demo/heat/ONAP/ dirctory.
+
+Set env options in onap_openstack_float.env according to  VIO platform env,
+Finally, heat enviroment contains correct parameters.
+
+Next source the  admin.rc file to create shell environment variables we nedd.
+
+source  admin.rc
+
+Then create heat stack
+
+openstack stack create -t onap_openstack_float.yaml -e onap_openstack_float.env  ONAP
+
+This process will take several minutes to spin up
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/index.rst b/docs/index.rst
index 7d3fc7e..56a95a5 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,3 +8,4 @@ MultiCloud Documentation Repository
    MultiCloud-Deployment-Guide
    MultiCloud-API-Specification-V1
    Multicloud-Fake_Cloud-Guide
+   MUlticloud-Heat-Deploymnet-Guide