docs/MultiCloud-Heat-Deployment-Guide.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright (c) 2017-2018 VMware, Inc.
   4
   5 =====================================
   6 ONAP MultiCloud Heat Deployment Guide
   7 =====================================
   8
   9 Prerequisites
  10 ~~~~~~~~~~~~~
  11
  12 1. A VIO platform install with nova, keystone, horizon, image,
  13 neutron and heat service, make sure floating ip is work.
  14
  15 2. A local host as OpenStack client cloud access OpenStack platform,
  16 install python, python-pip, virtualenv, python-openstackclient,
  17 python-heatclient.
  18
  19
  20
  21
  22 Export os enviroment
  23 ~~~~~~~~~~~~~~~~~~~~
  24
  25 we'll need to create a file call admin.rc with following content
  26
  27 keystone version 2.0 Example:
  28
  29 export OS_AUTH_URL=https://identity.api.opentack.com/v2.0/
  30 export OS_USERNAME=UserName
  31 export OS_TENANT_ID=TenantID
  32 export OS_REGION_NAME=RegionID
  33 export OS_PASSWORD=Password
  34 export OS_IDENTITY_API_VERSION=2
  35
  36 keystone version 3.0 Example:
  37
  38 export OS_AUTH_URL=https://identiy.api.openstack.com/v3/
  39 export OS_PROJECT_ID=ProjectID
  40 export OS_PROJECT_NAME=ProjectName
  41 export OS_USER_DOMAIN_NAME=DomainName
  42 export OS_USERNAME=UserName
  43 export OS_PASSWORD=Password
  44 if [ -z "$OS_USER_DOMAIN_NAME" ]; then unset OS_USER_DOMAIN_NAME; fi
  45
  46 # unset v2.0 items in case set
  47 unset OS_TENANT_ID
  48 unset OS_TENANT_NAME
  49
  50
  51 export OS_IDENTITY_API_VERSION=3
  52
  53
  54
  55
  56 Get VIO  pem
  57 ~~~~~~~~~~~~~
  58
  59 Get a copy of vio.pem in load balancer vms(/etc/ssl/vio.pem) in local
  60 host, then add the following line to your  admin.rc file:
  61 export OS_CACERT=/your/path/vio.pem
  62
  63
  64
  65
  66 Deploy the ONAP
  67 ~~~~~~~~~~~~~~~~
  68
  69 get onap heat files from git repo:
  70 git clone http://<your-account>@gerrit.onap.org/r/a/demo
  71
  72 we will use onap_opentack_float.yaml and onap_openstack_float.env  heat templates
  73 at ./demo/heat/ONAP/ dirctory.
  74
  75 Set env options in onap_openstack_float.env according to  VIO platform env,
  76 Finally, heat enviroment contains correct parameters.
  77
  78 Next source the  admin.rc file to create shell environment variables we nedd.
  79
  80 source  admin.rc
  81
  82 Then create heat stack
  83
  84 openstack stack create -t onap_openstack_float.yaml -e onap_openstack_float.env  ONAP
  85
  86 This process will take several minutes to spin up
  87
  88
  89
  90
  91
  92
  93
  94
  95
  96
  97
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109