Provisioning Gateway Installation Procedure

The steps to install and configure Provisioning Gateway are as follows:

Take one Linux system that has Openstack Client installed on it. If a system does not have Openstack client, then install it through CLI.
1. The steps to install OpenStack Client are:
  1. Login as a root user and execute the following command:
    yum install python-devel
  2. Install OpenStack client using following command:
    pip install python-openstackclient
  3. The above command does not import heatclient plugin. Execute the following command to install this plugin.
    pip install python-heatclient
Identify an OpenStack instance. The steps to identify an OpenStack instance are:

Note:
This identified OpenStack instance must meet the Provisioning Gateway OpenStack Prerequisites.
1. Download the OpenStack API credential file from OpenStack.
2. Download the OpenStack RC file. The steps are:
  1. Login to OpenStack application.
  2. Go to API Access section tab.
  3. Click the Download Openstack RC File option and download the Identity API v3 file.
3. Execute the following command to source the downloaded OpenStack API RC file into the Linux system where openstack client is installed.
  source openrc.sh
  
  Example:source openstack_API.rc where, openstack_API.rc is the API RC file name.
  
  Note:
  When system prompts for password, you have to enter OpenStack Controller password.
Download the HEAT templates for Provisioning Gateway installation.

Note:
Download the provgateway (x.x.x.x) HEAT template to your local system from Oracle Help Center (OHC).
Upload the image file to OpenStack. The steps to upload the image file to OpenStack are:
1. From the OpenStack GUI, navigate to Projects > Compute-Image.
2. Click Create Image.
3. In the Create Image dialog box, select an appropriate options for the following fields:
  1. Select an Image File from the Image Source field.
  2. Select the Provgateway-x.x.x.x image from the Image File. The ProvGateway Image can be obtained from Oracle Software Delivery Cloud (OSDC) Portal.
    Image name:
    
    ProvGateway-x_x_x_x.qcow2
  3. The Minimum Disk and Minimum RAM fields can be left blank.
  4. The ProvGateway flavors must be provided with the appropriate values (4-8-60).

Modify the input parameters. The steps to modify the input parameters are:

Edit the HEAT template file, 'provGwParams.yaml'.
Note:
- The input parameters are given as key/value pairs. Only modify the values (the part to the right side of the colon).
- The formatting is very important in a YAML file. Do not remove any leading spaces or add any line to the file.
Edit the values as per the guidelines provided in below table and save the file.

Table 2-2 provGwParams.yaml File Parameters

Parameter	Description	Value
index	Index in the lists of VM names.	0
vmNames	Provisioning Gateway Server Name.	VMNames to identify Provisioning Gateway in the network. Example: ProvGatewayServers
image	The VM image for the Provisioning gateway.	Provisioning gateway Image name. Example: UDR-PrvGwy-12.6.0.0.0_18.4.0-dev.qcow2
flavor	The flavor that defines the VM size for the Provisioning Gateway.	The provisioning gateway flavor name loaded onto the openstack.
xmiPublicNetwork	Network to communicate with external devices.	Xmi network type name. Example: xmi
xmiNetworkName	Network name to communicate with users and MMI clients.	Only one XMI network Name. Example: xmi_net, EXT_NET
xmiIps	IP to communicate with external devices.	Default: []. If fixed Ips if are present: [IP1, IP2]
xmiSubnetName	Subnet name for XMI	[{"subnet": "ext-net-subnet"}]
provGatewayVMName	Name of ProvGateway VM on which config XML was loaded	VM Name for this Instance. Example: ProvGateway_01
isFixedIps	True, if the VM is created by fixed Ips	Default: false
configDrive	Config drive enable condition	false

Execute the following command to deploy Provisioning Gateway using the OpenStack CLI:
openstack stack create -t ProvGatewayVm.yaml -e ProvGatewayParams.yaml < stackName >