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 .. code-block:: console
  30
  31     export OS_AUTH_URL=https://identity.api.opentack.com/v2.0/
  32     export OS_USERNAME=UserName
  33     export OS_TENANT_ID=TenantID
  34     export OS_REGION_NAME=RegionID
  35     export OS_PASSWORD=Password
  36     export OS_IDENTITY_API_VERSION=2
  37
  38 keystone version 3.0 Example:
  39
  40 .. code-block:: console
  41
  42     export OS_AUTH_URL=https://identiy.api.openstack.com/v3/
  43     export OS_PROJECT_ID=ProjectID
  44     export OS_PROJECT_NAME=ProjectName
  45     export OS_USER_DOMAIN_NAME=DomainName
  46     export OS_USERNAME=UserName
  47     export OS_PASSWORD=Password
  48     if [ -z "$OS_USER_DOMAIN_NAME" ]; then unset OS_USER_DOMAIN_NAME; fi
  49
  50     # unset v2.0 items in case set
  51     unset OS_TENANT_ID
  52     unset OS_TENANT_NAME
  53
  54
  55     export OS_IDENTITY_API_VERSION=3
  56
  57
  58
  59
  60 Get VIO  pem
  61 ~~~~~~~~~~~~~
  62
  63 Get a copy of vio.pem in load balancer vms(/etc/ssl/vio.pem) in local
  64 host, then add the following line to your  admin.rc file:
  65
  66 .. code-block:: console
  67
  68     export OS_CACERT=/your/path/vio.pem
  69
  70
  71
  72
  73 Deploy the ONAP
  74 ~~~~~~~~~~~~~~~~
  75
  76 get onap heat files from git repo::
  77
  78     git clone http://<your-account>@gerrit.onap.org/r/a/demo
  79
  80 we will use onap_opentack_float.yaml and onap_openstack_float.env  heat
  81 templates at ./demo/heat/ONAP/ dirctory.
  82
  83 Set env options in onap_openstack_float.env according to  VIO platform env,
  84 Finally, heat enviroment contains correct parameters.
  85
  86 Next source the  admin.rc file to create shell environment variables we nedd.
  87
  88 .. code-block:: console
  89
  90     source  admin.rc
  91
  92 Then create heat stack
  93
  94 .. code-block:: console
  95
  96     openstack stack create -t onap_openstack_float.yaml -e onap_openstack_float.env  ONAP
  97
  98 This process will take several minutes to spin up
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114
 115
 116
 117
 118
 119
 120
 121