docs/MultiCloud-Heat-Deployment-Guide.rst

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