GR Installation - OpenStack
The examples given in the steps is for your reference only. You need to modify them based on your GR deployments.
Important |
Copying YAML and environment files from this document is not recommended. The files are provided for your reference only. |
Before you begin
-
Download the latest ISO build.
-
Create CPS VMs using Heat template or Nova boot commands on all GR sites. In the following section, heat template has been considered as an example to deploy GR (here examples are site1, site2 and arbiter) sites.
For more information, refer to CPS Installation Guide for OpenStack
Procedure
Step 1 |
Create instances for site1, site2 and Arbiter. Wait till they are cluman ready. Check the
readiness status of the Cluster Manager VM on all the sites using the API:
External replication VLAN information should be added for each VM in the hot-cps.env and hot-cps.yaml for communication between GR sites. Refer to Sample Heat Environment File and Sample Heat Template File for sample configuration of site1. For site2 similar files need to be created by modifying hostname, IP addresses and so on. For Arbiter, refer to Arbiter Installation on OpenStack. |
||
Step 2 |
Load CPS configuration files on each site: Refer to /api/system/config/ section in CPS Installation Guide for OpenStack. In CPS_system_config.yaml file, give consideration to the following mentioned items:
For sample configurations, refer to Sample YAML Configuration File - site1 and Sample YAML Configuration File - site2.
|
||
Step 3 |
(Optional) To confirm the configuration was loaded properly onto the Cluster Manager VM on each site, perform a GET with the API:
|
||
Step 4 |
Apply the configuration using the following API on each site:
Refer to Apply the Loaded Configuration section in CPS Installation Guide for OpenStack for more information. This API applies the CPS configuration file, triggers the Cluster Manager VM to deploy and bring up all CPS VMs on each site, and performs all post-installation steps.
|
||
Step 5 |
In your mongo YAML file, add other site members as secondary-members and local site members as primary members for respective databases depending on your GR deployment. For sample configuration, refer to Sample Mongo Configuration File - site1 and Sample Mongo Configuration File - site2. |
||
Step 6 |
After updating the mongo YAML files, apply them using the /api/system/mongo/config API on each site with their YAML file. Refer to /api/system/mongo/config section in CPS Installation Guide for OpenStack.
|
||
Step 7 |
Add remote site pcrfclient IPs in respective gr_cluster.yaml files. For sample configuration, refer to Sample GR Cluster Configuration File - site1 and Sample GR Cluster Configuration File - site2. |
||
Step 8 |
Execute below APIs from respective sites to update the GR cluster information and populate respective ADMIN host database. For example:
For sample configuration, refer to Sample GR Cluster Configuration File - site1 and Sample GR Cluster Configuration File - site2. Verify whether:
|
||
Step 9 |
If all sites are deployed and configured, then create geo replica-sets between site1 and site2: |
||
Step 10 |
Create appropriate clusters in Policy Builder such as, 'Cluster-SITE1' for site1 and 'Cluster-SITE2' for site2 and update Primary Database IP Address, Secondary Database IP Address and Database port number based on mongo configuration and publish to the respective sites depending on your GR deployment. For more information, refer to Policy Builder Configuration. |
||
Step 11 |
Run
|
||
Step 12 |
Modify/add shard on respective sites. It contains each site session replication sets with backup database. For example:
For sample configuration, refer to Sample Shard Configuration File - site1 and Sample Shard Configuration File - site2. |
||
Step 13 |
Modify/add ring: It contains only session replica-sets and not backup database. This API needs to be executed from primary site. For example:
For sample configuration, refer to Sample Ring Configuration File. |
||
Step 14 |
Add geo-site lookup for both sites. For example:
For sample configuration, refer to Sample Geo Site Lookup Configuration File - site1 and Sample Geo Site Lookup Configuration File - site2.
|
||
Step 15 |
Add geo tags in replica-sets for both sites. For example:
For more information, refer to Sample Geo-tagging Configuration File - site1 and Sample Geo-tagging Configuration File - site2. |
||
Step 16 |
Add monitor database for both sites. For example:
For sample configuration, refer to Sample Monitor Database Configuration File - site1 and Sample Monitor Database Configuration File - site2. |