Update vCPE use case doc
Signed-off-by: Yang Xu <yang.xu@futurewei.com>
Issue-ID: INT-1108
Change-Id: I4f137fc044dc036d74c78f209d29c41a666dec59
diff --git a/docs/docs_vCPE.rst b/docs/docs_vCPE.rst
index 803c9e4..49d7d91 100644
--- a/docs/docs_vCPE.rst
+++ b/docs/docs_vCPE.rst
@@ -21,13 +21,145 @@
~~~~~~~~~~
Most part of the use case has been automated by vcpe scripts. For the details on how to run the scripts, please refer to the use case tutorial on https://wiki.onap.org/display/DW/vCPE+Use+Case+Tutorial%3A+Design+and+Deploy+based+on+ONAP.
+Here are the main steps to run the use case in Integration lab environment, where vCPE script is pre-installed on Rancher node under /root/integration/test/vcpe:
+
+1. Run Robot script from Rancher node to onboard VNFs, create and distribute models for vCPE four infrastructure services, i.e. infrastructure, brg, bng and gmux
+
+::
+
+ demo-k8s.sh onap init
+
+2. Run Robot to create and distribute for vCPE customer service. This step assumes step 1 successfully distributed the 4 models
+
+::
+
+ ete-k8s.sh onap distributevCPEResCust
+
+3. Add customer SDN-ETHERNET-INTERNET (see the use case tutorial wiki page for detail)
+
+4. Add identity-url to RegionOne data in A&AI. First use POSTMAN to GET cloud-region RegionOne data, then add identity-url and PUT back to A&AI
+
+::
+
+ GET https://{{aai}}:{{port}}/aai/v14/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne
+
+::
+
+ PUT https://{{aai}}:{{port}}/aai/v14/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne
+ {
+ "cloud-owner": "CloudOwner",
+ "cloud-region-id": "RegionOne",
+ "cloud-type": "SharedNode",
+ "owner-defined-type": "OwnerType",
+ "cloud-region-version": "v1",
+ "identity-url": "http://10.12.25.2:5000/v2.0",
+ "cloud-zone": "CloudZone",
+ "resource-version": "1559336510793",
+ "relationship-list": {
+ ... ...
+
+5. Add route on sdnc cluster VM node, which is the cluster VM node where pod sdnc-sdnc-0 is running on. This will allow ONAP SDNC to configure BRG later on.
+
+::
+
+ ip route add 10.3.0.0/24 via 10.0.101.10 dev ens3
+
+6. Initialize SDNC ip pool by running command from Rancher node
+
+::
+
+ kubectl -n onap exec -it dev-sdnc-sdnc-0 -- /opt/sdnc/bin/addIpAddresses.sh VGW 10.5.0 22 250`
+
+7. Install python and other python libraries
+
+::
+
+ integration/test/vcpe/bin/setup.sh
+
+
+8. Change the openstack env parameters and one customer service related parameter in vcpecommon.py
+
+::
+
+ cloud = {
+ '--os-auth-url': 'http://10.12.25.2:5000',
+ '--os-username': 'xxxxxxxxxx',
+ '--os-user-domain-id': 'default',
+ '--os-project-domain-id': 'default',
+ '--os-tenant-id': 'xxxxxxxxxxxxxxxx' if oom_mode else '1e097c6713e74fd7ac8e4295e605ee1e',
+ '--os-region-name': 'RegionOne',
+ '--os-password': 'xxxxxxxxxxx',
+ '--os-project-domain-name': 'xxxxxxxxx' if oom_mode else 'Integration-SB-07',
+ '--os-identity-api-version': '3'
+ }
+
+ common_preload_config = {
+ 'oam_onap_net': 'xxxxxxxx' if oom_mode else 'oam_onap_lAky',
+ 'oam_onap_subnet': 'xxxxxxxxxx' if oom_mode else 'oam_onap_lAky',
+ 'public_net': 'xxxxxxxxx',
+ 'public_net_id': 'xxxxxxxxxxxxx'
+ }
+
+::
+
+ # CHANGEME: vgw_VfModuleModelInvariantUuid is in rescust service csar, open service template with filename like service-VcpesvcRescust1118-template.yml and look for vfModuleModelInvariantUUID under groups vgw module metadata.
+ self.vgw_VfModuleModelInvariantUuid = 'xxxxxxxxxxxxxxx'
+
+9. Initialize vcpe
+
+::
+
+ vcpe.py init
+
+9. Run the command from Rancher node to insert vcpe customer service workflow entry in SO catalogdb. You should be able to see the following command printed out from the above step output
+
+::
+
+ kubectl exec dev-mariadb-galera-mariadb-galera-0 -- mysql -uroot -psecretpassword -e "INSERT INTO catalogdb.service_recipe (ACTION, VERSION_STR, DESCRIPTION, ORCHESTRATION_URI, SERVICE_PARAM_XSD, RECIPE_TIMEOUT, SERVICE_TIMEOUT_INTERIM, CREATION_TIMESTAMP, SERVICE_MODEL_UUID) VALUES ('createInstance','1','vCPEResCust 2019-06-03 _04ba','/mso/async/services/CreateVcpeResCustService',NULL,181,NULL, NOW(),'6c4a469d-ca2c-4b02-8cf1-bd02e9c5a7ce')"
+
+10. Instantiate vCPE infra services
+
+::
+
+ vcpe.py infra
+
+11. Install curl command inside sdnc-sdnc-0 container
+
+12. From Rancher node run command to check connectivity from sdnc to brg and gmux, and the configuration of brg and gmux
+
+::
+
+ healthcheck-k8s.py onap
+
+13. Update libevel.so in vGMUX VM. See tutorial wiki for details
+
+14. Run heatbridge. The heatbridge command usage: demo-k8s.sh <namespace> heatbridge <stack_name> <service_instance_id> <service> <oam-ip-address>. See an example as following:
+
+::
+
+ ~/integration/test/vcpe# ~/oom/kubernetes/robot/demo-k8s.sh onap heatbridge vcpe_vfmodule_e2744f48729e4072b20b_201811262136 d8914ef3-3fdb-4401-adfe-823ee75dc604 vCPEvGMUX 10.0.101.21
+
+15. Push new Policy. Download the policy files and follow steps in JIRA INT-1089 - Create vCPE closed loop policy and push to policy engine
+
+::
+
+ curl -k --silent --user 'healthcheck:zb!XztG34' -X POST "https://policy-api:6969/policy/api/v1/policytypes/onap.policies.controlloop.Operational/versions/1.0.0/policies" -H "Accept: application/json" -H "Content-Type: application/json" -d @operational.vcpe.json.txt
+ curl --silent -k --user 'healthcheck:zb!XztG34' -X POST "https://policy-pap:6969/policy/pap/v1/pdps/policies" -H "Accept: application/json" -H "Content-Type: application/json" -d @operational.vcpe.pap.json.txt
+
+16. Start closeloop by triggering packet drop VES event. You may need to run the command twice if the first run fails
+
+::
+
+ vcpe.py loop
+
+
Test Status
~~~~~~~~~~~~~~~~~~~~~
-The use case has been tested for Casablanca release, the test report can be found on https://wiki.onap.org/display/DW/vCPE+-+Test+Status
+The use case has been tested for Dublin release, the test report can be found on https://wiki.onap.org/display/DW/vCPE+%28Heat%29+-+Dublin+Test+Status
Known Issues and Workaround
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-1) Firewalls are installed on BRG and vBNG. In order to allow SDNC to send BRG configuration message through vBNG, SDNC host VM IP address is preloaded on BRG and vBNG, and provisioned into the firewalls. If SDNC changes its host VM, SDNC host VM IP changes and we need to manually update the IP in /opt/config/sdnc_ip.txt. Then run:
+1) NATs are installed on BRG and vBNG. In order to allow SDNC to send BRG configuration message through vBNG, SDNC host VM IP address is preloaded on BRG and vBNG, and provisioned into the firewalls. If SDNC changes its host VM, SDNC host VM IP changes and we need to manually update the IP in /opt/config/sdnc_ip.txt. Then run:
::
@@ -36,7 +168,4 @@
root>/opt/nat_service.sh
root>vppctl restart
-2) APPC has a bug which prevents DG from reading AAI info. We needs an DG update. See the JIRA on https://jira.onap.org/browse/APPC-1249
-
-3) In closed loop, APPC fails to send response back to Policy via an DMAAP message. Policy will keep sending reboot action request until timed out or ABATED message is received. User may see 3 or 4 vGMUX reboots before service returns normal. See the JIRA on https://jira.onap.org/browse/APPC-1247