aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorPérez Caparrós David, INI-INO-ECO-HCT <David.PerezCaparros@swisscom.com>2019-06-28 14:07:44 +0200
committerDavid Perez Caparros <david.perezcaparros@swisscom.com>2019-06-28 12:14:09 +0000
commit6d986ee80c43da2098b3bb8da5a04dab8da696bd (patch)
tree5f032f745b6b4067885ffaa0efeb0c75aad518de /docs
parentd15450419ab00cb77af96f57252012edc5276b98 (diff)
Add BBS installation documentation
Detailed installation and configuration steps Issue-ID: DOC-448 Signed-off-by: Pérez Caparrós David, INI-INO-ECO-HCT <David.PerezCaparros@swisscom.com> Change-Id: I12584072cf63a95c057762022753251e2195b571
Diffstat (limited to 'docs')
-rw-r--r--docs/docs_BBS.rst234
1 files changed, 232 insertions, 2 deletions
diff --git a/docs/docs_BBS.rst b/docs/docs_BBS.rst
index 1b348be96..81af17294 100644
--- a/docs/docs_BBS.rst
+++ b/docs/docs_BBS.rst
@@ -46,8 +46,238 @@ RESTCONF collector) and SDNC
System Set Up and configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Please refer to the following wiki page for detailed set up and configuration
-instructions: `BBS Documentation <https://wiki.onap.org/display/DW/BBS+Documentation>`_
+SO: Custom Workflow Configuration
+=================================
+
+::
+
+ ~/oom/kubernetes# kubectl edit cm dev-so-so-bpmn-infra-app-configmap
+
+ mso:
+ ...
+ workflow:
+ custom:
+ BBS_E2E_Service:
+ sdnc:
+ need: true
+ ...
+
+ ## Restart the pod
+ ~/oom/kubernetes# kubectl delete po dev-so-so-bpmn-infra-7556d7f6bc-8fthk
+
+
+As shown below, new entries need to be inserted manually in SO database (mariadb-galera) in order to map a given resource model to a specific BPMN recipe. For instance, the CPE is modeled in SDC as a VF but it is treated as PNF resource by SO by using the handlePNF BPMN recipe. Those entries need to be inserted in catalogdb database > vnf_recipe table.
+
+IMPORTANT: make sure vnf_recipe.NF_ROLE matches vnf_resource.MODEL_NAME, and vnf_recipe.VERSION_STR matches vnf_resource.MODEL_VERSION.
+
+::
+
+ root@onap-rancher-daily:/home/ubuntu# kubectl exec -ti dev-mariadb-galera-mariadb-galera-0 sh
+ sh-4.2$ mysql -u root -p
+ MariaDB [(none)]> use catalogdb;
+ MariaDB [catalogdb]> select * from vnf_recipe;
+ ...
+ +-------+---------------------+-----------------------+--------------+-------------+--------------------------------------------------------------------------------+-----------------------------------------------+---------------+----------------+---------------------+--------------------------------------+
+ | id | NF_ROLE | ACTION | SERVICE_TYPE | VERSION_STR | DESCRIPTION | ORCHESTRATION_URI | VNF_PARAM_XSD | RECIPE_TIMEOUT | CREATION_TIMESTAMP | VF_MODULE_ID |
+ +-------+---------------------+-----------------------+--------------+-------------+--------------------------------------------------------------------------------+-----------------------------------------------+---------------+----------------+---------------------+--------------------------------------+
+ | 10043 | InternetProfile | createInstance | NF | 1.0 | create InternetProfile | /mso/async/services/CreateSDNCNetworkResource | NULL | 180000 | 2019-02-18 08:34:39 | NULL |
+ | 10044 | AccessConnectivity | createInstance | NF | 1.0 | create AccessConnectivity | /mso/async/services/CreateSDNCNetworkResource | NULL | 180000 | 2019-02-18 08:34:39 | NULL |
+ | 10045 | CPE | createInstance | NF | 1.0 | create CPE | /mso/async/services/HandlePNF | NULL | 180000 | 2019-02-18 08:34:39 | NULL |
+ +-------+---------------------+-----------------------+--------------+-------------+--------------------------------------------------------------------------------+-----------------------------------------------+---------------+----------------+---------------------+--------------------------------------+
+ ...
+ MariaDB [catalogdb]> select * from vnf_resource;
+ +--------------------+-----------------------+---------------------+--------------------------------------+-----------------+-----------------+--------------------------------------+---------------+--------------------+----------------------------------------------+-----------------------------+-------------------+-----------------------+
+ | ORCHESTRATION_MODE | DESCRIPTION | CREATION_TIMESTAMP | MODEL_UUID | AIC_VERSION_MIN | AIC_VERSION_MAX | MODEL_INVARIANT_UUID | MODEL_VERSION | MODEL_NAME | TOSCA_NODE_TYPE | HEAT_TEMPLATE_ARTIFACT_UUID | RESOURCE_CATEGORY | RESOURCE_SUB_CATEGORY |
+ +--------------------+-----------------------+---------------------+--------------------------------------+-----------------+-----------------+--------------------------------------+---------------+--------------------+----------------------------------------------+-----------------------------+-------------------+-----------------------+
+ | HEAT | CPE VF | 2019-05-15 22:11:07 | 8f5fe623-c5e3-4ab3-90f9-3a28daea6601 | NULL | NULL | 0ee07fe6-a156-4e59-9dee-09a775d02bca | 1.0 | CPE | org.openecomp.resource.vf.Cpe | NULL | Generic | Infrastructure |
+ | HEAT | InternetProfile VF | 2019-05-15 22:11:11 | a8de16d8-0d1a-4a19-80ac-2bcb2790e9a6 | NULL | NULL | acbe6358-6ce4-43a9-9385-111fe5cadad3 | 1.0 | InternetProfile | org.openecomp.resource.vf.Internetprofile | NULL | Generic | Infrastructure |
+ | HEAT | AccessConnectivity VF | 2019-05-15 22:11:13 | b464fd87-3663-46c9-adc5-6f7d9e98ff26 | NULL | NULL | 53018dba-c934-415d-b4b1-0b1cae9553b8 | 1.0 | AccessConnectivity | org.openecomp.resource.vf.Accessconnectivity | NULL | Generic | Infrastructure |
+ +--------------------+-----------------------+---------------------+--------------------------------------+-----------------+-----------------+--------------------------------------+---------------+--------------------+----------------------------------------------+-----------------------------+-------------------+-----------------------+
+
+Modify the MODEL_UUID and MODEL_INVARIANT_UUID for each resource in the SQL query below accordingly to your environment.
+
+::
+
+ INSERT INTO `vnf_resource` (`ORCHESTRATION_MODE`, `DESCRIPTION`, `CREATION_TIMESTAMP`, `MODEL_UUID`, `AIC_VERSION_MIN`, `AIC_VERSION_MAX`, `MODEL_INVARIANT_UUID`, `MODEL_VERSION`, `MODEL_NAME`, `TOSCA_NODE_TYPE`, `HEAT_TEMPLATE_ARTIFACT_UUID`, `RESOURCE_CATEGORY`, `RESOURCE_SUB_CATEGORY`)
+ VALUES
+ ('HEAT', 'CPE VF', '2019-05-15 22:11:07', '8f5fe623-c5e3-4ab3-90f9-3a28daea6601', NULL, NULL, '0ee07fe6-a156-4e59-9dee-09a775d02bca', '1.0', 'CPE', 'org.openecomp.resource.vf.Cpe', NULL, 'Generic', 'Infrastructure'),
+ ('HEAT', 'InternetProfile VF', '2019-05-15 22:11:11', 'a8de16d8-0d1a-4a19-80ac-2bcb2790e9a6', NULL, NULL, 'acbe6358-6ce4-43a9-9385-111fe5cadad3', '1.0', 'InternetProfile', 'org.openecomp.resource.vf.Internetprofile', NULL, 'Generic', 'Infrastructure'),
+ ('HEAT', 'AccessConnectivity VF', '2019-05-15 22:11:13', 'b464fd87-3663-46c9-adc5-6f7d9e98ff26', NULL, NULL, '53018dba-c934-415d-b4b1-0b1cae9553b8', '1.0', 'AccessConnectivity', 'org.openecomp.resource.vf.Accessconnectivity', NULL, 'Generic', 'Infrastructure');
+
+Adding is_pnf flag to CPE resource input in catalogdb database. Needed in DoCreateResource BPMN for pausing the flow until a PNF is ready
+
+::
+
+ INSERT INTO `vnf_resource_customization` (`ID`, `MODEL_CUSTOMIZATION_UUID`, `MODEL_INSTANCE_NAME`, `MIN_INSTANCES`, `MAX_INSTANCES`, `AVAILABILITY_ZONE_MAX_COUNT`, `NF_TYPE`, `NF_ROLE`, `NF_FUNCTION`, `NF_NAMING_CODE`, `MULTI_STAGE_DESIGN`, `CREATION_TIMESTAMP`, `VNF_RESOURCE_MODEL_UUID`, `SERVICE_MODEL_UUID`, `RESOURCE_INPUT`, `CDS_BLUEPRINT_NAME`, `CDS_BLUEPRINT_VERSION`, `SKIP_POST_INSTANTIATION_CONFIGURATION`)
+ VALUES
+ (16, '0cea1cea-e4e4-4c91-be41-675e183a8983', 'CPE 0', NULL, NULL, NULL, NULL, NULL, NULL, NULL, 'false', '2019-05-21 11:15:42', '8f5fe623-c5e3-4ab3-90f9-3a28daea6601', '0187be8c-8efb-4531-97fa-dbe984ed9cdb', '{\\\"nf_naming\\\":\\\"true\\\",\\\"skip_post_instantiation_configuration\\\":\\\"true\\\",\\\"multi_stage_design\\\":\\\"false\\\",\\\"availability_zone_max_count\\\":\\\"1\\\",\\\"is_pnf\\\":\\\"ont_0_is_pnf|true\\\"}', NULL, NULL, 1);
+
+We need to ensure that the order in which the resources are processed by SO engine is correct. In BBS case, the PNF resource should go right after VnfVirtualLink (NOTE: the BPMN flow waits until PNF is ready in order to create AccessConnectivity and InternetProfile resources)
+
+::
+
+ MariaDB [catalogdb]> select RESOURCE_ORDER from service where MODEL_NAME="BBS_E2E_Service";
+ +----------------------------------------------------------------------------+
+ | RESOURCE_ORDER |
+ +----------------------------------------------------------------------------+
+ | VnfVirtualLink,CPE,AccessConnectivity,InternetProfile,PonUni,OltNni,OntNni |
+ | VnfVirtualLink,CPE,AccessConnectivity,InternetProfile,PonUni,OltNni,OntNni |
+ +----------------------------------------------------------------------------+
+ 2 rows in set (0.00 sec)
+
+DMaaP Message Router
+====================
+
+Create required topics
+
+::
+
+ curl -X POST \
+ http://mr.api.simpledemo.openecomp.org:30227/topics/create \
+ -H 'Accept: application/json' \
+ -H 'Content-Type: application/json' \
+ -H 'cache-control: no-cache' \
+ -d '{
+ "topicName": "unauthenticated.DCAE_CL_OUTPUT",
+ "topicDescription": "",
+ "partitionCount": "",
+ "replicationCount": "3"
+ }'
+
+ curl -X POST \
+ http://mr.api.simpledemo.openecomp.org:30227/topics/create \
+ -H 'Accept: application/json' \
+ -H 'Content-Type: application/json' \
+ -H 'cache-control: no-cache' \
+ -d '{
+ "topicName": "unauthenticated.CPE_AUTHENTICATION",
+ "topicDescription": "",
+ "partitionCount": "",
+ "replicationCount": "3"
+ }'
+
+ curl -X POST \
+ http://mr.api.simpledemo.openecomp.org:30227/topics/create \
+ -H 'Accept: application/json' \
+ -H 'Content-Type: application/json' \
+ -H 'cache-control: no-cache' \
+ -d '{
+ "topicName": "unauthenticated.PNF_READY",
+ "topicDescription": "",
+ "partitionCount": "",
+ "replicationCount": "3"
+ }'
+
+ curl -X POST \
+ http://mr.api.simpledemo.openecomp.org:30227/topics/create \
+ -H 'Accept: application/json' \
+ -H 'Content-Type: application/json' \
+ -H 'cache-control: no-cache' \
+ -d '{
+ "topicName": "unauthenticated.PNF_UPDATE",
+ "topicDescription": "",
+ "partitionCount": "",
+ "replicationCount": "3"
+ }'
+
+DCAE: BBS Event Processor (BBS-ep)
+==================================
+
+Installation instructions: `BBS-ep <https://wiki.onap.org/pages/viewpage.action?pageId=60891185>`_
+
+Update the configuration of BBS-ep in Consul with the following version for close loop (see screenshot below) in order to match the version expected by BBS APEX policy:
+
+::
+
+ "application.clVersion": "1.0.0"
+
+DCAE: RESTCONF Collector
+========================
+
+Installation instructions: `RESTCONF Collector <https://wiki.onap.org/pages/viewpage.action?pageId=60891182>`_
+
+DCAE: VES mapper
+================
+
+Installation instructions: `VES Mapper <https://wiki.onap.org/pages/viewpage.action?pageId=60891188>`_
+
+DCAE: VES collector
+===================
+
+Configure mapping VES event domain to DMaaP topic: ves-statechange --> unauthenticated.CPE_AUTHENTICATION
+
+Access Consul UI: http://<consul_server_ui>:30270/ui/#/dc1/services
+
+Modify dcae-ves-collector configuration by adding a new VES domain to DMaaP topic mapping
+
+::
+
+ "ves-statechange": {"type": "message_router", "dmaap_info": {"topic_url": "http://message-router:3904/events/unauthenticated.CPE_AUTHENTICATION"}}
+
+SDNC: BBS DGs (Directed Graphs)
+===============================
+
+Make sure that BBS DGs in SDNC DGBuilder are in Active state
+
+http://dguser:test123@{{sdnc-dgbuilder_Node-IP}}:30203/#
+
+::
+
+ bbs-access-connectivity-network-topology-operation-create-huawei
+ bbs-access-connectivity-network-topology-operation-delete-huawei
+ bbs-internet-profile-network-topology-operation-change-huawei
+ bbs-internet-profile-network-topology-operation-common-huawei
+ bbs-internet-profile-network-topology-operation-create-huawei
+ bbs-internet-profile-network-topology-operation-delete-huawei
+ validate-bbs-network-input-parameters
+
+Policy: BBS APEX policy
+=======================
+
+Inside APEX container,
+
+1) Edit DCAEConsumer URL in `examples/config/ONAPBBS/NomadicONTPolicyModel_config.json`
+
+2) Edit AAI and SDNC URLs in `examples/config/ONAPBBS/config.txt`
+
+::
+
+ AAI_URL=aai:8443
+ AAI_USERNAME=AAI
+ AAI_PASSWORD=AAI
+ SDNC_URL=sdnc:8282
+ SDNC_USERNAME=admin
+ SDNC_PASSWORD=Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U
+ SVC_NOTIFICATION_URL=http://c1.vm1.mso.simpledemo.openecomp.org:8080
+
+3) Launch APEX BBS policy as a background process
+
+::
+
+ nohup /opt/app/policy/apex-pdp/bin/apexApps.sh engine -c examples/config/ONAPBBS/NomadicONTPolicyModel_config.json &
+
+Edge Services: vBNG+AAA+DHCP, Edge SDN M&C
+==========================================
+
+Installation and setup instructions: `Swisscom Edge SDN M&C and virtual BNG <https://wiki.onap.org/pages/viewpage.action?pageId=63996962>`_
+
+References
+==========
+
+Please refer to the following wiki page for additional set up and configuration
+instructions:
+
+- `BBS Documentation <https://wiki.onap.org/display/DW/BBS+Documentation>`_
+
+Known Issues
+------------
+
+- PNF registration timeout is limited to 60s due HTTP timeout in inter-BPMN workflow calls (`SO-1938 <https://jira.onap.org/browse/SO-1938>`_)
+
+- E2E Service deletion workflow does not delete the PNF resource in AAI (`SO-1994 <https://jira.onap.org/browse/SO-1994>`_)
+
+- Under certain circumstances, multiple attachment points (logical links) are associated to a single PNF (`DCAEGEN2-1611 <https://jira.onap.org/browse/DCAEGEN2-1611>`_)
+
.. |image1| image:: files/bbs/BBS_arch_overview.png
:width: 6.5in