summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorRene Robert <rene.robert@orange.com>2018-04-23 15:39:19 +0000
committerRene Robert <rene.robert@orange.com>2018-04-23 15:40:31 +0000
commit798e4b41b1a10368c4ed43259c9dfa5a03681d81 (patch)
tree302923e281c6487ec28e6c5395d578fd56f5e483 /docs
parentc661816c99c72716ab457ad97de87d84f8383385 (diff)
correct links and add infos
Issue-ID: EXTAPI-74 Change-Id: Ic219585f889ca9c5fb03e1452c2583753e517d39 Signed-off-by: Rene Robert <rene.robert@orange.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/architecture/architecture.rst4
-rw-r--r--docs/architecture/images/ONAP_External_ID_Beijing.jpg (renamed from docs/offeredapis/images/ONAP External ID Beijing.jpg)bin103409 -> 103409 bytes
-rw-r--r--docs/configuration/configuration.rst114
-rw-r--r--docs/consumedapis/consumedapis.rst40
-rw-r--r--docs/delivery/delivery.rst25
5 files changed, 105 insertions, 78 deletions
diff --git a/docs/architecture/architecture.rst b/docs/architecture/architecture.rst
index b777f0f..8e7b9b9 100644
--- a/docs/architecture/architecture.rst
+++ b/docs/architecture/architecture.rst
@@ -28,7 +28,7 @@ Following illustration provides a global view about nbi architecture,integration
Developer Guide
***************
-Technical information about NBI (dependancies, configuration, running & testing) could be found here: :doc:`NBI_R1_Developer_Guide <../NBI_R1_Developer_Guide>`
+Technical information about NBI (dependancies, configuration, running & testing) could be found here: :doc:`NBI_R1_Developer_Guide <NBI_R1_Developer_Guide>`
-API Flow illustration (with example messages) is described in this document: :download:`nbicallflow.pdf <pdf/nbicallflow.pdf>`
+API Flow illustration (with example messages) is described in this document: :download:`nbicallflow.pdf <../offeredapis/pdf/nbicallflow.pdf>`
diff --git a/docs/offeredapis/images/ONAP External ID Beijing.jpg b/docs/architecture/images/ONAP_External_ID_Beijing.jpg
index 8fbd4ab..8fbd4ab 100644
--- a/docs/offeredapis/images/ONAP External ID Beijing.jpg
+++ b/docs/architecture/images/ONAP_External_ID_Beijing.jpg
Binary files differ
diff --git a/docs/configuration/configuration.rst b/docs/configuration/configuration.rst
index ba586aa..fb777a5 100644
--- a/docs/configuration/configuration.rst
+++ b/docs/configuration/configuration.rst
@@ -11,68 +11,62 @@ By default, the application runs with an embedded both MongoDB and MariaDB local
This file also list configurations of all the REST interface maid from NBI to other ONAP component such as SDC, AA&I and SO.
+**************
Default values
-==============
-
-**SERVER**
-
-server.contextPath=/nbi/api/v1
-server.port = 8080
-
-**LOGGING**
-
-logging.level.=INFO
-
-**ONAP**
-
-onap.lcpCloudRegionId=RegionOne
-onap.tenantId=6e97a2bd51d74f6db5671d8dc1517d82
-onap.cloudOwner=CloudOwner
-
-**NBI**
-
-nbi.url=http://localhost:8080/nbi/api/v1
-nbi.callForVNF=false
-
-**SDC**
-
-sdc.host=http://10.0.3.1:8080
-sdc.header.ecompInstanceId=demo
-sdc.header.authorization=Basic YWFpOktwOGJKNFNYc3pNMFdYbGhhazNlSGxjc2UyZ0F3ODR2YW9HR21KdlV5MlU=
-
-**AAI**
-
-aai.host=https://10.0.1.1:8443
-aai.header.authorization=Basic QUFJOkFBSQ==
-aai.api.id=AAI
-
-**SO**
-
-so.host=http://10.0.5.1:8080
-so.header.authorization=Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==
-so.api.id=SO
-
-**MONGO**
-
-spring.data.mongodb.host=localhost
-spring.data.mongodb.port=27017
-spring.data.mongodb.database=ServiceOrderDB
-
-**MYSQL**
-
-spring.datasource.url=jdbc:mariadb://localhost:3306/nbi
-spring.datasource.username=root
-spring.datasource.password=secret
-spring.datasource.testWhileIdle=true
-spring.datasource.validationQuery=SELECT 1
-spring.datasource.driver-class-name=org.mariadb.jdbc.Driver
-spring.jpa.show-sql=false
-spring.jpa.hibernate.ddl-auto=update
-spring.jpa.hibernate.naming-strategy=org.hibernate.cfg.ImprovedNamingStrategy
-
-
+**************
+
+::
+
+ # SERVER
+ server.contextPath=/nbi/api/v1
+ server.port = 8080
+
+ # LOGGING
+ logging.level.=INFO
+
+ # ONAP
+ onap.lcpCloudRegionId=RegionOne
+ onap.tenantId=6e97a2bd51d74f6db5671d8dc1517d82
+ onap.cloudOwner=CloudOwner
+
+ # NBI
+ nbi.url=http://localhost:8080/nbi/api/v1
+ nbi.callForVNF=false
+
+ # SDC
+ sdc.host=http://10.0.3.1:8080
+ sdc.header.ecompInstanceId=demo
+ sdc.header.authorization=Basic YWFpOktwOGJKNFNYc3pNMFdYbGhhazNlSGxjc2UyZ0F3ODR2YW9HR21KdlV5MlU=
+
+ # AAI
+ aai.host=https://10.0.1.1:8443
+ aai.header.authorization=Basic QUFJOkFBSQ==
+ aai.api.id=AAI
+
+ # SO
+ so.host=http://10.0.5.1:8080
+ so.header.authorization=Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA==
+ so.api.id=SO
+
+ # MONGO
+ spring.data.mongodb.host=localhost
+ spring.data.mongodb.port=27017
+ spring.data.mongodb.database=ServiceOrderDB
+
+ # MYSQL
+ spring.datasource.url=jdbc:mariadb://localhost:3306/nbi
+ spring.datasource.username=root
+ spring.datasource.password=secret
+ spring.datasource.testWhileIdle=true
+ spring.datasource.validationQuery=SELECT 1
+ spring.datasource.driver-class-name=org.mariadb.jdbc.Driver
+ spring.jpa.show-sql=false
+ spring.jpa.hibernate.ddl-auto=update
+ spring.jpa.hibernate.naming-strategy=org.hibernate.cfg.ImprovedNamingStrategy
+
+**************
Changing values
-===============
+**************
To adapt application parameters to your context, you need to set up some environment attributes. For example :
diff --git a/docs/consumedapis/consumedapis.rst b/docs/consumedapis/consumedapis.rst
index 6962e02..8cd885a 100644
--- a/docs/consumedapis/consumedapis.rst
+++ b/docs/consumedapis/consumedapis.rst
@@ -16,9 +16,12 @@ SDC API
this API is used to provide Service Catalog information
Information are retrieved in SDC (and in Tosca "service template" file) - Only GET operation is provided - this API DID NOT UPDATE SDC
- SDC_ROOT_URL = "/sdc/v1/catalog/services/";
- SDC_GET_PATH = "/metadata";
- SDC_TOSCA_PATH = "/toscaModel";
+ SDC_ROOT_URL = "/sdc/v1/catalog/services/"
+
+ SDC_GET_PATH = "/metadata"
+
+ SDC_TOSCA_PATH = "/toscaModel"
+
***************
AAI API
@@ -27,16 +30,18 @@ AAI API
this API is used to provide Service Inventory information
This API retrieves service(s) in the AAI inventory. Only following attributes will be retrieve in service inventory: id, name and type (no state or startDate available )
- AAI_GET_TENANTS_PATH = "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/$onap.cloudOwner/$onap.lcpCloudRegionId/tenants";
- AAI_GET_CUSTOMER_PATH = "/aai/v11/business/customers/customer/";
- AAI_GET_SERVICES_FOR_CUSTOMER_PATH =
- "/aai/v11/business/customers/customer/$customerId/service-subscriptions";
- AAI_PUT_SERVICE_FOR_CUSTOMER_PATH =
- "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/";
- AAI_GET_SERVICE_FOR_CUSTOMER_PATH =
- "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/service-instance/$serviceId";
- AAI_GET_SERVICE_INSTANCES_PATH =
- "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/";
+ AAI_GET_TENANTS_PATH = "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/$onap.cloudOwner/$onap.lcpCloudRegionId/tenants"
+
+ AAI_GET_CUSTOMER_PATH = "/aai/v11/business/customers/customer/"
+
+ AAI_GET_SERVICES_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions"
+
+ AAI_PUT_SERVICE_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/
+
+ AAI_GET_SERVICE_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/service-instance/$serviceId"
+
+ AAI_GET_SERVICE_INSTANCES_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/"
+
***************
@@ -46,6 +51,9 @@ SO API
this API is used to perform Service Order and thus instantiate a service
- MSO_CREATE_SERVICE_INSTANCE_PATH = "/ecomp/mso/infra/serviceInstance/v4";
- MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v4/";
- MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/";
+ MSO_CREATE_SERVICE_INSTANCE_PATH = "/ecomp/mso/infra/serviceInstance/v4"
+
+ MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v4/"
+
+ MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/"
+
diff --git a/docs/delivery/delivery.rst b/docs/delivery/delivery.rst
index 7ef857a..ebd9874 100644
--- a/docs/delivery/delivery.rst
+++ b/docs/delivery/delivery.rst
@@ -6,4 +6,29 @@
Delivery
========
+NBI Dockers Containers Structure
+================================
+
+Below is a diagram of the ExternalAPI/NBI project docker containers and the connections between them.
+
+.. blockdiag::
+
+
+ blockdiag delivery {
+ node_width = 170;
+ orientation = portrait;
+ MongoDB[shape = flowchart.database]
+ MariaDB[shape = flowchart.database]
+ NBI -> MongoDB, MariaDB;
+ group bi_group {
+ color = yellow;
+ label = "Business Layer"
+ NBI;
+ }
+ group data_storage_group {
+ color = orange;
+ label = "Data Storage Layer"
+ MongoDB; MariaDB;
+ }
+ }