diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml new file mode 100644 index 0000000000000000000000000000000000000000..20f28f1d47a7888b6d5bd43ca4fed20b2f6aa8a1 --- /dev/null +++ b/.gitlab-ci.yml @@ -0,0 +1,31 @@ +pages: + stage: deploy + image: python:3.9.18-slim-bullseye + variables: + PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip" + PAGES_BRANCH: gl-pages + HTTPS_REMOTE: https://gitlab-ci-token:${ACCESS_TOKEN}@${CI_SERVER_HOST}/rep/${CI_PROJECT_PATH}.git + before_script: + - pip install -q mkdocs-material mike + - apt-get update -qq && apt-get -qq install -y git > /dev/null + - git config --global --replace-all user.name $GITLAB_USER_NAME + - git config --global --replace-all user.email $GITLAB_USER_EMAIL + - git fetch origin $PAGES_BRANCH && git checkout $PAGES_BRANCH || git checkout -b $PAGES_BRANCH origin/$PAGES_BRANCH || echo "Pages branch not deployed yet." + - git checkout $CI_COMMIT_SHA + script: + - | + if [ -n "$CI_COMMIT_TAG" ]; then + mike deploy --deploy-prefix public -r $HTTPS_REMOTE -p -b $PAGES_BRANCH -u $CI_COMMIT_TAG latest + mike set-default --deploy-prefix public -r $HTTPS_REMOTE -p -b $PAGES_BRANCH latest + elif [ "$CI_COMMIT_REF_NAME" == "develop" ]; then + mike deploy --deploy-prefix public -r $HTTPS_REMOTE -p -b $PAGES_BRANCH -u $CI_COMMIT_BRANCH + fi + - git checkout $PAGES_BRANCH -- public/ + artifacts: + paths: + - public/ + rules: + - if: '$CI_COMMIT_TAG' + - if: '$CI_COMMIT_REF_NAME == "develop"' + when: always + - when: never \ No newline at end of file diff --git a/doc/alarms_actions.md b/doc/alarms_actions.md new file mode 100644 index 0000000000000000000000000000000000000000..b7715494e2c504668c69d5a690197346fdb7be4b --- /dev/null +++ b/doc/alarms_actions.md @@ -0,0 +1,113 @@ +# Alarms + +In Openslice parts of TMF642 Alarm Management API are currently implemented. Alarms can be managed through the TMF API endpoint as well as the UI. + + + +## Alarms and Actions + +Note: Actions is an experimental feature. We expect to have a more mature solution in future. The component in the architecture is the Openslcie Assurance Services + +Alarms can be automatically resolved by specific actions. Today only the following actions are offered. + +* execDay2 +* scaleServiceEqually + + +## execDay2 + +Usually used to perform a Day2 configuration (towards OSM). To use it, Create a New Action Specification Name=execDay2 as following + +[![Openslice usage](./images/alarms_actions/day2actionspec.png)](./images/alarms_actions/day2actionspec.png) + + +Now make a Service Order for your service. In this example ςε used a cirros NSD + +Create a New Action Rule for the running services as the following example: + + +[![Openslice usage](./images/alarms_actions/action_rule_exampleday2.png)](./images/alarms_actions/action_rule_exampleday2.png) + +The scope is the running cirros service. + +Params should be paramname=value;paramname2=value2;paramname3=value3 (must exist in the VNF otherwise OSM will raise an error). + +In this case should be filename=test.txt + +Primitive=touch + +ServiceId = select the service which will accept the Day2. In this case is the same + +To test it: + +Go to the Service Inventory and select the active Service. + +Note the UUID of the service (e.g. c4e7990a-e174-4cd2-9133-b10e56721e08 copy from address bar), DeploymentRequestID and NSDID from characteristics + +You can either use the UUID of the service or the DeploymentRequestID and POST to the Alarms endpoint ( /tmf-api/alarmManagement/v4/alarm) + + +If the DeploymentRequestID is used then POST: + +``` + +{ + "alarmRaisedTime": "2021-06-29T12:30:24.675Z", + "alarmReportingTime": "2021-06-29T12:30:54.675Z", + "state": "raised", + "alarmType": "qualityOfServiceAlarm", + "probableCause": "thresholdCrossed", + "ackState": "unacknowledged", + "perceivedSeverity": "major", + "sourceSystemId": "mano-client-service", + "alarmDetails": "NSID=3;DeploymentRequestID=1", + "specificProblem": "myalram raised" +} + +``` + + +If the UUID is used then POST: + +``` + +{ + "alarmRaisedTime": "2021-06-29T12:30:24.675Z", + "alarmReportingTime": "2021-06-29T12:30:54.675Z", + "state": "raised", + "alarmType": "qualityOfServiceAlarm", + "probableCause": "thresholdCrossed", + "ackState": "unacknowledged", + "perceivedSeverity": "major", + "sourceSystemId": "mano-client-service", + "alarmDetails": "analarm", + "specificProblem": "myalram raised", + "affectedService": [ + { + "id": "c4e7990a-e174-4cd2-9133-b10e56721e08" + } + ] + +} + +``` + +The Alarm to be created must have the affected Service ID equal to the running service from the scope (the cirros_ns) + +Go to service inventory you will see the notes and also the service characteristics for any EXEC_ACTION updates + +You can also adjust the alarm conditions. They must match true so the alarm to be acknowledged +So if another external service raises an Alarm (with POST) for the running service, a Day2 will be performed on another Service + + +## scaleServiceEqually + + +This action is used from getting a scaling event from OSM. Please see the next demo for details on how it works + + +### Prototype demo + +You can watch how we used the prototype on the following ETSI ZMS PoC #2 + +* ETSI ZMS PoC #2: diff --git a/doc/architecture/architecture.md b/doc/architecture/architecture.md new file mode 100644 index 0000000000000000000000000000000000000000..9181348600e7706d51ec95802c023ccc68a3982b --- /dev/null +++ b/doc/architecture/architecture.md @@ -0,0 +1,49 @@ +# Architecture + + +Openslice offers the following main functionalities: + +* Service Catalog Management: A CSP will have the ability to manage the Service Catalog Items, their attributes , organize in categories and decide what to make available to Customers +* Services Specifications: A CSP will be able to manage Service Specifications +* Service Catalog Exposure: A CSP will be able to expose catalog to customers and related parties +* Service Catalog to Service Catalog: Openslice able to consume and provide Service Catalog items to other catalogs +* Service Order: The Customer will be able to place a Service Order +* Service Inventory: The Customer and Provider will be able to view deployed Services status + + +The following figure displays the overall architecture of Openslice. + +[![Openslice architecture](../images/architecture.png)](../images/architecture.png) + + +Openslice allows Vertical Customers browsing the available offered service specifications. It consists of: + +* Web frontend UIs that consist of mainly two portals: i) a NFV portal allowing users self-service management and onboarding VNFDs/NSDs to facility’s NFVO ii) a Services Portal, which allows users to browse the Service Catalog, Service Blueprints specifications and the Service Inventory +* An API gateway that proxies the internal APIs and used by the web front end as well as any other 3rd party service +* A Message Bus where all microservices use it to exchange messages either via message queues or via publish/subscribe topics +* An authentication server implementing Oauth2 authentication scheme +* A microservice offering TMF compliant API services (eg Service Catalog API, Service Ordering APIetc) +* A microservice offering NFV API services (eg VNF/NSD onboarding etc) and allows to store VNFDs and NSDs in a catalog +* A microservice that is capable to interface to an issue management system. For example it raises an issue to all related stakeholders (CSP, NOP, CSC) that a new Service Order is requested +* Central logging microservice that is capable to log all distributed actions in to an Elasticsearch cluster +* A Service Orchestrator solution that will propagate Service Ordering requests to the equivalent SOs and NFVOs + + +The following figure depicts how Openslice microservices are deployed + +[![Openslice microservices network deployment](../images/microservices_network_deployment.png)](../images/microservices_network_deployment.png) + + + +## Deploying Openslice in multi domain scenarios + +A typical deployment across domains, involves today some typical components: i) an OSS/BSS to allow customers access the service catalog and perform service orders, ii) a Service Orchestrator (SO) component for executing the service order workflow, as well as iii) a Network Functions Virtualization Orchestrator (NFVO) for configuring the iv) network resources. + +TMF Open APIs are introduced not only for exposing catalogues and accepting service orders, but also implementing the East-West interfaces between the domains, fulfilling also the LSO requirements as introduced by MEF. + +The following figure shows how openslice could be used in such scenarios: + +[![Openslice multi-domain-architecture](../images/multi-domain-architecture.png)](../images/multi-domain-architecture.png) + + +See more [Consuming Services From External Partner Organizations](./consumingServicesFromExternalPartners.md) diff --git a/doc/architecture/centrallog.md b/doc/architecture/centrallog.md new file mode 100644 index 0000000000000000000000000000000000000000..a6cbc2b8f2572e1dabf61324306b4c7326998e13 --- /dev/null +++ b/doc/architecture/centrallog.md @@ -0,0 +1,5 @@ +# Central Logging + +Openslice follows the centralized log management concept, i.e. a type of logging solution system that consolidates the log data from different services and pushes it to a central, accessible and easy-to-use interface. + +For that reason, Elasticsearch is elected as an open-source centralized logging solution for collecting, parsing and storing logs towards a real-time data analytics tool that provides insights from any type of structured and unstructured data source. \ No newline at end of file diff --git a/doc/architecture/consumingServicesFromExternalPartners.md b/doc/architecture/consumingServicesFromExternalPartners.md new file mode 100644 index 0000000000000000000000000000000000000000..090a9f754b059ee4dd5251f9bfc7ccfcca15063f --- /dev/null +++ b/doc/architecture/consumingServicesFromExternalPartners.md @@ -0,0 +1,185 @@ +# Consuming Services From External Partner Organizations + +A typical deployment across domains, involves today some typical components: i) an OSS/BSS to allow customers access the service catalog and perform service orders, ii) a Service Orchestrator (SO) component for executing the service order workflow, as well as iii) a Network Functions Virtualization Orchestrator (NFVO) for configuring the iv) network resources. + +TMF Open APIs are introduced not only for exposing catalogues and accepting service orders, but also implementing the East-West interfaces between the domains, fulfilling also the LSO requirements as introduced by MEF. + +The following figure shows how openslice could be used in such scenarios: + +[![Openslice multi-domain-architecture](../images/multi-domain-architecture.png)](../images/multi-domain-architecture.png) + + +In Openslice we can consume services from 3rd parties via Open APIs. + +We use the TMF 632 Party Management model to specify Organizations that we can exchange items and other information such as: + +- Import Service Specifications +- Create a Service Order +- Use the Service Inventory to query the status of the service ordered to the external partner organization + +## Define an Organization as 3rd party to consume services East-West + +An organization must have the following characteristics in openslice catalog, like for example: + +"EXTERNAL_TMFAPI_BASEURL", "http://portal.openslice.io" + +"EXTERNAL_TMFAPI_CLIENTREGISTRATIONID", "authOpensliceProvider" + +"EXTERNAL_TMFAPI_OAUTH2CLIENTID", "osapiWebClientId" + +"EXTERNAL_TMFAPI_OAUTH2CLIENTSECRET", "secret" + +"EXTERNAL_TMFAPI_OAUTH2SCOPES", scopes + +"EXTERNAL_TMFAPI_OAUTH2TOKENURI", "http://portal.openslice.io/osapi-oauth-server/oauth/token" + +"EXTERNAL_TMFAPI_USERNAME", "admin" + +"EXTERNAL_TMFAPI_PASSWORD", "openslice" + +"EXTERNAL_TMFAPI_SERVICE_CATALOG_URLS" = "/tmf-api/serviceCatalogManagement/v4/serviceSpecification?type=CustomerFacingServiceSpecification" (this is optional, fetch a list of service specs it will be relative with the BASEURL. If the url is empty then no specs will be fetched, the EXTERNAL_TMFAPI_SERVICE_CATEGORY_URLS might be used) + +"EXTERNAL_TMFAPI_SERVICE_CATEGORY_URLS" = "/tmf-api/serviceCatalogManagement/v4/serviceCategory/{categoryid}" (this example will fetch all specs in a category. You may define comma separated URLs of categories API URL . This will fetch specifications of every defined category. If you want only one specific category put for example the uuid only of one category: "/tmf-api/serviceCatalogManagement/v4/serviceCategory/bda02821-bc4d-4bd6-b64b-d9c2aa5f8e6d". multiple urls should be "/tmf-api/serviceCatalogManagement/v4/serviceCategory/bda02821-bc4d-4bd6-b64b-d9c2aa5f8e6d,/tmf-api/serviceCatalogManagement/v4/serviceCategory/9b6d8bf3-abd2-43c4-8154-c8c6fe5545b2") + +"EXTERNAL_TMFAPI_SERVICE_SPEC" = "/tmf-api/serviceCatalogManagement/v4/serviceSpecification" + +"EXTERNAL_TMFAPI_SERVICE_ORDER_URLS"= "/test/v1/serviceorder" (this is optional) + + +An example Organization defined example in json: +``` + +{ + "uuid": "1a09a8b5-6bd5-444b-b0b9-a73c69eb42ae", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "Openslice.io", + "id": "1a09a8b5-6bd5-444b-b0b9-a73c69eb42ae", + "isHeadOffice": null, + "isLegalEntity": null, + "nameType": null, + "organizationType": null, + "tradingName": null, + "contactMedium": [], + "creditRating": [], + "existsDuring": null, + "externalReference": [], + "organizationChildRelationship": [], + "organizationIdentification": [], + "organizationParentRelationship": null, + "otherName": [], + "partyCharacteristic": [ + { + "uuid": "3a2f7221-e0a2-4a6b-88d1-534c8e1963f6", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_CLIENTREGISTRATIONID", + "valueType": null, + "value": { + "value": "authOpensliceProvider", + "alias": null + } + }, + { + "uuid": "c24bb527-f178-4d38-9b93-2027c1732876", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_USERNAME", + "valueType": null, + "value": { + "value": "admin", + "alias": null + } + }, + { + "uuid": "27e45df8-414b-44c6-a5d5-3f064e2cfd3b", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_PASSWORD", + "valueType": null, + "value": { + "value": "openslice", + "alias": null + } + }, + { + "uuid": "e0e470b8-6024-4014-8a18-2333e5465ce1", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_OAUTH2CLIENTSECRET", + "valueType": null, + "value": { + "value": "secret", + "alias": null + } + }, + { + "uuid": "3e0de762-ac80-4c1e-a0a1-f265ff0899b4", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_OAUTH2SCOPES", + "valueType": null, + "value": { + "value": "admin;read", + "alias": null + } + }, + { + "uuid": "0bbb8314-f7f2-420d-9fed-ba054b15f886", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_OAUTH2TOKENURI", + "valueType": null, + "value": { + "value": "http://portal.openslice.io/osapi-oauth-server/oauth/token", + "alias": null + } + }, + { + "uuid": "3a567de4-79eb-4006-a500-3e5229b44175", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_OAUTH2CLIENTID", + "valueType": null, + "value": { + "value": "osapiWebClientId", + "alias": null + } + }, + { + "uuid": "6dca729f-dbe1-46b7-89f1-5c4f9fe89d4e", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": null, + "href": null, + "name": "EXTERNAL_TMFAPI_BASEURL", + "valueType": null, + "value": { + "value": "http://portal.openslice.io", + "alias": null + } + } + ], + "relatedParty": [], + "status": null, + "taxExemptionCertificate": [] +} + +``` + \ No newline at end of file diff --git a/doc/architecture/issuemgt.md b/doc/architecture/issuemgt.md new file mode 100644 index 0000000000000000000000000000000000000000..b50f5459a186f1eff82bebcb5e805c0752d6dde8 --- /dev/null +++ b/doc/architecture/issuemgt.md @@ -0,0 +1,7 @@ +# Issue Management + +For issue management support, Openslice relies on Bugzilla. Bugzilla is a ticketing tool that allows issue reporting and tracking via tickets to all relevant stakeholders. + +The figure below displays the overall issue management service architecture integrating Bugzilla as its core and how this tool interacts with other Openslice services presenting some distinctive scenarios. It should be noted that Bugzilla tickets will not only be used for bugs/errors, but also for general requests, e.g. Service Order procedure. + +[![Issue management system](../images/issue_management.png)](../images/issue_management.png) \ No newline at end of file diff --git a/doc/architecture/messagebus.md b/doc/architecture/messagebus.md new file mode 100644 index 0000000000000000000000000000000000000000..a228afb52670b03e7036a2199cbfecd1454a2d50 --- /dev/null +++ b/doc/architecture/messagebus.md @@ -0,0 +1,816 @@ +# Message Bus and exchanged Messages + +Openslice has a Message bus which allows Openslice services to exchange messages via queues and topics. + +It is based on ActiveMQ. + +3rd party services can be attached to bus and subscribe to message topics or request resources via queues. + + +## QUEUE MESSAGES + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICEORDERS | +|**Name** | jms:queue:CATALOG.GET.SERVICEORDERS | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Description** | Return a List as String Json| + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICEORDER_BY_ID | +|**Name** | jms:queue:CATALOG.GET.SERVICEORDER_BY_ID | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | String orderid | +|**Description** | Return a ServiceOrder as String Json | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_SERVICEORDER_BY_ID | +|**Name** | jms:queue:CATALOG.UPD.SERVICEORDER_BY_ID | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | ServiceOrderUpdate serviceOrder | +|**Headers** | "orderid"= orderid | +|**Description** | Returns a ServiceOrder as String | + + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICESPEC_BY_ID | +|**Name** | jms:queue:CATALOG.GET.SERVICESPEC_BY_ID | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | specid | +|**Description** | Return a ServiceSpecification | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_ADD_SERVICESPEC | +|**Name** | jms:queue:CATALOG.ADD.SERVICESPEC | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | CRIDGE | +|**Body** | ServiceSpecCreate | +|**Description** | Creates a ServiceSpecification and returns a ServiceSpecification as String | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_SERVICESPEC | +|**Name** | jms:queue:CATALOG.UPD.SERVICESPEC | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | CRIDGE | +|**Body** | ServiceSpecUpdate | +|**Headers** | "serviceSpecid" = serviceSpecId| +|**Description** | Updates a ServiceSpecification and returns a ServiceSpecification as String. | +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPDADD_SERVICESPEC | +|**Name** | jms:queue:CATALOG.UPDADD.SERVICESPEC | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | CRIDGE | +|**Body** | ServiceSpecUpdate | +|**Headers** | "serviceSpecid" = serviceSpecId, "forceId"=forceId | +|**Description** | Updates a ServiceSpecification and returns a ServiceSpecification as String. If forceId is true then tries to assign the requested ID to the spec | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_ADD_SERVICEORDER | +|**Name** | jms:queue:CATALOG.ADD.SERVICEORDER | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | ServiceOrderCreate serviceOrder | +|**Headers** | | +|**Description** | Creates a ServiceOrder and returns a ServiceOrder as String | + +--- + + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_INITIAL_SERVICEORDERS_IDS | +|**Name** | jms:queue:CATALOG.GET.INITIAL_SERVICEORDERS | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | | +|**Body** | | +|**Description** | Return a List as String Json| + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICEORDER_IDS_BY_STATE | +|**Name** | jms:queue:CATALOG.GET.ACKNOWLEDGED_SERVICEORDERS | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Headers** | "orderstate"= orderState | +|**Description** | String Json ArrayList of ServiceOrders | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_ADD_SERVICE | +|**Name** | jms:queue:CATALOG.ADD.SERVICE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | ServiceCreate String json | +|**Headers** | "orderid"=orderid, "serviceSpecid"= specid | +|**Description** | Creates Service based an a Service Spec, Returns a Service object | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_SERVICE | +|**Name** | jms:queue:CATALOG.UPD.SERVICE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | | +|**Body** | ServiceUpdate | +|**Headers** | "serviceid" = serviceId, "propagateToSO" = true/false | +|**Description** | will update a service by id and return the service instance. If propagateToSO=true then any service change will be handled by OSOM. This is needed to be controlled in order to avoid update loops| + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICE_BY_ID | +|**Name** | jms:queue:CATALOG.GET.SERVICE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | String serviceID | +|**Description** | returns a Service instance | + +---| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICE_BY_ORDERID | +|**Name** | jms:queue:CATALOG.GET.SERVICE_BY_ORDERID | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | | +|**Body** | String serviceID | +|**Description** | returns Service IDs of a specific order given then order id | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_SERVICE_QUEUE_ITEMS_GET | +|**Name** | jms:queue:CATALOG.SERVICEQUEUEITEMS.GET | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Description** | returns a LIST OF Service Queue Items | +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_SERVICE_QUEUE_ITEM_UPD | +|**Name** | jms:queue:CATALOG.SERVICEQUEUEITEM.UPDATE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | String SERVICEQUEUEITEM | +|**Headers** | "itemid" = SERVICEQUEUEITEM id | +|**Description** | ill update a service queue item by id and return the instance | +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_SERVICE_QUEUE_ITEM_DELETE | +|**Name** | jms:queue:CATALOG.SERVICEQUEUEITEM.DELETE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Headers** | "itemid" = SERVICEQUEUEITEM id | +|**Description** | ill delete a service queue item by id | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_SERVICES_TO_TERMINATE | +|**Name** | jms:queue:CATALOG.GET.SERVICETOTERMINATE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Headers** | | +|**Description** | Get a list of ACTIVE services with END DAte in the past | +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_SERVICES_OF_PARTNERS | +|**Name** | jms:queue:CATALOG.GET.SERVICESOFPARTNERS | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Headers** | | +|**Description** | Get a list of ACTIVE services from the inventory of partners | + + + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | NFV_CATALOG_GET_NSD_BY_ID | +|**Name** | jms:queue:NFVCATALOG.GET.NSD_BY_ID | +|**Type** | queue | +|**Destination** | NFV Catalog service | +|**Producers** | TMF API, OSOM | +|**Body** | NSDid | +|**Description** | Returns a NetworkServiceDescriptor object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | NFV_CATALOG_DEPLOY_NSD_REQ | +|**Name** | jms:queue:NFVCATALOG.DEPLOY.NSD_REQ | +|**Type** | queue | +|**Destination** | NFV Catalog service | +|**Producers** | OSOM | +|**Body** | DeploymentDescriptor as Json String | +|**Headers** | NSD id | +|**Description** | Returns a DeploymentDescriptor object as json string containing deployment info| + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | NFV_CATALOG_UPD_DEPLOYMENT_BY_ID | +|**Name** | jms:queue:NFVCATALOG.UPD.DEPLOYMENT_BY_ID | +|**Type** | queue | +|**Destination** | NFV Catalog service | +|**Producers** | OSOM | +|**Body** | DeploymentDescriptor as Json String | +|**Headers** | DeploymentDescriptor id | +|**Description** | Updates and Returns a DeploymentDescriptor object as json string containing deployment info| + +--- + + + +| Message | | +| ------------- |----------------| +|**Alias** | GET_USER_BY_USERNAME | +|**Name** | jms:queue:GET.USER_BY_USERNAME | +|**Type** | queue | +|**Destination** | NFV Catalog service (this is temproary for now) | +|**Producers** | TMF API | +|**Body** | username | +|**Headers** | | +|**Description** | Returns a PortalUser object as json string containing user info| + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | NFV_CATALOG_GET_DEPLOYMENT_BY_ID | +|**Name** | jms:queue:NFVCATALOG.GET.DEPLOYMENT_BY_ID | +|**Type** | queue | +|**Destination** | NFV Catalog service | +|**Producers** | OSOM | +|**Body** | Deployment ID | +|**Description** | Returns a DeploymentDescriptor object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_EXTERNAL_SERVICE_PARTNERS | +|**Name** | jms:queue:CATALOG.GET.EXTERNALSERVICEPARTNERS | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | | +|**Headers** | | +|**Description** | As a String Json ArrayList of Organizaton objects containing the characteristic name **EXTERNAL_TMFAPI** | + +--- + + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_EXTERNAL_SERVICESPEC | +|**Name** | jms:queue:CATALOG.UPD.EXTERNAL_SERVICESPEC | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM or maybe used by others that would like to update a Service Spec | +|**Body** | A serviceSpecification as json string | +|**Headers** | servicespecification id, orgid id | +|**Description** | Updates (or inserts if does not exist in catalog) an external service specification) | + +--- + + + + +| Message | | +| ------------- |----------------| +|**Alias** | NFV_CATALOG_NSACTIONS_SCALE | +|**Name** | jms:queue:NSACTIONS.SCALE | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM or maybe used by others that would like scale a NS | +|**Body** | A ScaleDescriptor as json string | +|**Headers** | none | +|**Description** | performs a scale | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | NFV_CATALOG_NS_LCMCHANGED | +|**Name** | NFV_CATALOG_NS_LCMCHANGED | +|**Type** | topic | +|**Destination** | any | +|**Producers** | MANO client | +|**Body** | A json string | +|**Headers** | none | +|**Description** | A NFV_CATALOG_NS_LCMCHANGED message is published when LCM of a running NS is changed | + +--- + +#ALARMS + + +| Message | | +| ------------- |----------------| +|**Alias** | ALARMS_ADD_ALARM | +|**Name** | jms:queue:ALARMS.ADD.ALARM | +|**Type** | queue | +|**Publishers** | | +|**Consumers** | TMF API | +|**Body** | AlarmCreate | +|**Headers** | | +|**Description** | Add an alarm | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | ALARMS_UPDATE_ALARM | +|**Name** | jms:queue:ALARMS.UPDATE.ALARM | +|**Type** | queue | +|**Publishers** | | +|**Consumers** | TMF API | +|**Body** | AlarmUpdate | +|**Headers** | alarmid = alarm id, body (AlarmUpdate object) | +|**Description** | Update an alarm | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | ALARMS_GET_ALARM | +|**Name** | jms:queue:ALARMS.GET.ALARM | +|**Type** | queue | +|**Publishers** | | +|**Consumers** | TMF API | +|**Body** | | +|**Headers** | alarmid = alarm id | +|**Description** | get an alarm | + +--- + +## EVENT TOPICS IN Message Bus +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_CREATE | +|**Name** | jms:topic:EVENT.SERVICE.CREATE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | - | +|**Body** | Notification object | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | xx | + +--- +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_STATE_CHANGED | +|**Name** | jms:topic:EVENT.SERVICE.STATECHANGED | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | - | +|**Body** | Notification object | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | xx | + +--- +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_DELETE | +|**Name** | jms:topic:EVENT.SERVICE.DELETE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | - | +|**Body** | Notification object. Can be one of ServiceOrderCreateNotification, ServiceOrderStateChangeNotification, ServiceOrderAttributeValueChangeNotification, ServiceOrderDeleteNotification, etc | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | xx | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_ATTRIBUTE_VALUE_CHANGED | +|**Name** | jms:topic:EVENT.SERVICE.ATTRCHANGED | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | - | +|**Body** | Notification object. Can be one of ServiceOrderCreateNotification, ServiceOrderStateChangeNotification, ServiceOrderAttributeValueChangeNotification, ServiceOrderDeleteNotification, etc | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | xx | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_ORDER_CREATE | +|**Name** | jms:topic:EVENT.SERVICEORDER.CREATE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service | +|**Body** | Notification object. Can be one of ServiceOrderCreateNotification, ServiceOrderStateChangeNotification, ServiceOrderAttributeValueChangeNotification, ServiceOrderDeleteNotification, etc | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the ServiceOrder object. Bugzilla service for example uses this to create a new issue | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_ORDER_STATE_CHANGED | +|**Name** | jms:topic:EVENT.SERVICEORDER.STATECHANGED | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service | +|**Body** | Notification object. Can be one of ServiceOrderCreateNotification, ServiceOrderStateChangeNotification, ServiceOrderAttributeValueChangeNotification, ServiceOrderDeleteNotification, etc | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the ServiceOrder object. Bugzilla service for example uses this to update an issue | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_ORDER_DELETE | +|**Name** | jms:topic:EVENT.SERVICEORDER.DELETE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service | +|**Body** | Notification object. Can be one of ServiceOrderCreateNotification, ServiceOrderStateChangeNotification, ServiceOrderAttributeValueChangeNotification, ServiceOrderDeleteNotification, etc | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the ServiceOrder object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_SERVICE_ORDER_ATTRIBUTE_VALUE_CHANGED | +|**Name** | jms:topic:EVENT.SERVICEORDER.ATTRCHANGED | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service | +|**Body** | Notification object. Can be one of ServiceOrderCreateNotification, ServiceOrderStateChangeNotification, ServiceOrderAttributeValueChangeNotification, ServiceOrderDeleteNotification, etc | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the ServiceOrder object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_ALARM_CREATE | +|**Name** | jms:topic:EVENT.ALARM.CREATE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | OAS, BUGZILLA Service, CentralLog Service | +|**Body** | AlarmCreateEvent | +|**Headers** | | +|**Description** | The Event contains the Alarm object in payload | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_ADD_RESOURCE | +|**Name** | jms:queue:CATALOG.ADD.RESOURCE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | ResourceCreate | +|**Headers** | | +|**Description** | The Body contains the ResourceCreate object to add | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_RESOURCE | +|**Name** | jms:queue:CATALOG.UPD.RESOURCE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | ResourceUpdate | +|**Headers** | resourceid , propagateToSO | +|**Description** | The Body contains the ResourceCreate object to update | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_RESOURCE_BY_ID | +|**Name** | jms:queue:CATALOG.GET.RESOURCE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | resourceid | +|**Headers** | | +|**Description** | The Body contains the ResourceCreate object to update | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_RESOURCES_OF_PARTNERS | +|**Name** | jms:queue:CATALOG.GET.SERVICESOFPARTNERS | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | none | +|**Headers** | none | +|**Description** | retrieve all active services of partners | + +--- +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_ADD_RESOURCESPEC | +|**Name** | jms:queue:CATALOG.ADD.RESOURCESPEC | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | ResourceSpecificationCreate | +|**Headers** | | +|**Description** | The Body contains the ResourceSpecificationCreate object to add | + +--- +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_RESOURCESPEC | +|**Name** | jms:queue:CATALOG.UPD.RESOURCESPEC | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | ResourceSpecificationUpdate | +|**Headers** | resourceSpecId | +|**Description** | The Body contains the ResourceSpecificationCreate object to update | + + +--- +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_RESOURCESPEC_BY_ID | +|**Name** | jms:queue:CATALOG.GET.RESOURCESPEC_BY_ID | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | resourceSpecid | +|**Headers** | | +|**Description** | The Body contains the object id to find | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPDADD_RESOURCESPEC | +|**Name** | jms:queue:CATALOG.UPDADD.RESOURCESPEC | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | resourceid | +|**Headers** | | +|**Description** | The Body contains the ResourceSpecificationCreate object to update or create if not exist | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_RESOURCE_CREATE | +|**Name** | jms:topic:EVENT.RESOURCE.CREATE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service, other | +|**Body** | Notification object. | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the Resource object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_RESOURCE_STATE_CHANGED | +|**Name** | jms:topic:EVENT.RESOURCE.STATECHANGED | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service, other | +|**Body** | Notification object. | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the Resource object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_RESOURCE_DELETE | +|**Name** | jms:topic:EVENT.SERVICE.RESOURCE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service, other | +|**Body** | Notification object. | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the Resource object | + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | EVENT_RESOURCE_ATTRIBUTE_VALUE_CHANGED | +|**Name** | jms:topic:EVENT.RESOURCE.ATTRCHANGED | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | BUGZILLA Service, CentralLog Service, other | +|**Body** | Notification object. | +|**Headers** | "eventid"=eventid, "objId"= objId | +|**Description** | The Event of the Notification object contains the Resource object | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_LCMRULE_BY_ID | +|**Name** | jms:queue:CATALOG.GET.LCMRULE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | lcmid | +|**Headers** | | +|**Description** | The Body contains the LCMRuleSpec object | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_LCMRULES_BY_SPECID_PHASE | +|**Name** | jms:queue:CATALOG.GET.LCMRULES_BY_SPECID_PHASE | +|**Type** | topic | +|**Publishers** | TMF API | +|**Consumers** | any | +|**Body** | | +|**Headers** | header.servicespecid, header.phasename | +|**Description** | The Body contains the LCMRuleSpec objects of the specific Service Spec and the specific phase | + + + + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICETESTSPEC_BY_ID | +|**Name** | jms:queue:CATALOG.GET.SERVICETESTSPEC_BY_ID | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | specid | +|**Description** | Return a ServiceTestSpecification | + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_ADD_SERVICETEST | +|**Name** | jms:queue:CATALOG.ADD.SERVICETEST | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | ServiceTestCreate String json | +|**Headers** | "orderid"=orderid, "serviceTestSpecid"= specid | +|**Description** | Creates Service Test based an a Service Test Spec, Returns a ServiceTest object | + +--- + + + + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_UPD_SERVICETEST | +|**Name** | jms:queue:CATALOG.UPD.SERVICETEST | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | | +|**Body** | ServiceTestUpdate | +|**Headers** | "serviceid" = serviceId, "propagateToSO" = true/false | +|**Description** | will update a service test by id and return the service instance. If propagateToSO=true then any service change will be handled by OSOM. This is needed to be controlled in order to avoid update loops| + +--- + + +| Message | | +| ------------- |----------------| +|**Alias** | CATALOG_GET_SERVICETEST_BY_ID | +|**Name** | jms:queue:CATALOG.GET.SERVICETEST | +|**Type** | queue | +|**Destination** | TMF API service | +|**Producers** | OSOM | +|**Body** | String serviceID | +|**Description** | returns a Service TEST instance | + + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CRD_DEPLOY_CR_REQ | +|**Name** | jms:queue:CRD.DEPLOY.CR_REQ | +|**Type** | queue | +|**Destination** | CRD service | +|**Producers** | OSOM | +|**Body** | CR spec as String | +|**Headers** | related service id | +|**Description** | Returns a String object containing deployment info| + +--- + +| Message | | +| ------------- |----------------| +|**Alias** | CRD_PATCH_CR_REQ | +|**Name** | jms:queue:CRD.PATCH.CR_REQ | +|**Type** | queue | +|**Destination** | CRD service | +|**Producers** | OSOM | +|**Body** | CR as String | +|**Headers** | related service id | +|**Description** | Returns a String object containing PATCH info| + + +| Message | | +| ------------- |----------------| +|**Alias** | CRD_DELETE_CR_REQ | +|**Name** | jms:queue:CRD.DELETE.CR_REQ | +|**Type** | queue | +|**Destination** | CRD service | +|**Producers** | OSOM | +|**Body** | CR as String | +|**Headers** | related service id | +|**Description** | Returns a String object containing deletion info| \ No newline at end of file diff --git a/doc/architecture/nfvapi.md b/doc/architecture/nfvapi.md new file mode 100644 index 0000000000000000000000000000000000000000..f31f195812fda0c41cf8165c5448c32a4931884c --- /dev/null +++ b/doc/architecture/nfvapi.md @@ -0,0 +1,207 @@ +# API interaction + +## OAuth token + +See [oauth](./oauth.md) + +## Request a protected API resource + +Example: Get all vxfs (check the `Authorization:Bearer` to be correct) + +``` +curl -H "Authorization:Bearer eybGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJhZG1pbiIsInNjb3BlIjpbIm9wZW5hcGkiLCJhZG1pbiIsInJlYWQiLCJ3cml0ZSJdLCJvcmdhbml6YXRpb24iOiJteW9yZ2FuaXp0aW9uIiwiZXhwIjoxNTcxOTI0MjU2LCJhdXRob3JpdGllcyI6WyJST0xFX01FTlRPUiIsIlJPTEVfQURNSU4iXSwianRpIjoiNzNkZmIxODEtNTMwOS00MmExLThkOWUtOGM3YmQ0YTE1YmU0IiwiY2xpZW50X2lkIjoib3NhcGlXZWJDbGllbnRJZE91dCJ9.Pj_hxnyMGhFhN8avU_DiAw1-LlcaIz5Hp9HNqalw-X4" http://localhost:13000/osapi/admin/vxfs +``` +Example response: + +``` +[ + { + "id": 1, + "owner": { + "id": 1, + "organization": "ee", + "name": "Portal Administrator", + "email": "", + "username": "admin", + "createdAt": null + }, + "uuid": "a954daf2-16da-4b7e-ae42-4825936d453c", + "name": "cirros_vnfd", + "iconsrc": "/osapi/images/a954daf2-16da-4b7e-ae42-4825936d453c/cirros-64.png", + "shortDescription": "cirros_vnfd", + "longDescription": "Simple VNF example with a cirros", + "version": "1.0", + "packageLocation": "/osapi/packages/a954daf2-16da-4b7e-ae42-4825936d453c/cirros_vnf.tar.gz", + "dateCreated": 1568971426000, + "dateUpdated": 1568981107000, + "categories": [ + { + "id": 3, + "name": "Service", + "productsCount": 1, + "appscount": 0, + "vxFscount": 1 + }, + { + "id": 2, + "name": "Networking", + "productsCount": 1, + "appscount": 0, + "vxFscount": 1 + } + ], + "extensions": [], + "validationJobs": [], + "screenshots": "", + "vendor": "OSM", + "published": false, + "termsOfUse": null, + "descriptor": "vnfd-catalog:\n vnfd:\n - connection-point:\n - name: eth0\n type: VPORT\n description: Simple VNF example with a cirros\n id: cirros_vnfd\n logo: cirros-64.png\n mgmt-interface:\n cp: eth0\n name: cirros_vnfd\n short-name: cirros_vnfd\n vdu:\n - count: 1\n description: cirros_vnfd-VM\n id: cirros_vnfd-VM\n image: cirros034\n interface:\n - external-connection-point-ref: eth0\n name: eth0\n position: '1'\n type: EXTERNAL\n virtual-interface:\n bandwidth: '0'\n type: VIRTIO\n vpci: 0000:00:0a.0\n name: cirros_vnfd-VM\n vm-flavor:\n memory-mb: 512\n storage-gb: 1\n vcpu-count: 1\n vendor: OSM\n version: '1.0'\n", + "descriptorHTML": "

cirros_vnfd


Vendor: OSM
Version: 1.0
Description: Simple VNF example with a cirros
VM Count: 1
vCPU Count: 1
Memory: 512 MB
Storage: 1 GB
", + "certified": false, + "certifiedBy": null, + "validationStatus": "UNDER_REVIEW", + "packagingFormat": "OSMvFIVE", + "supportedMANOPlatforms": [ + { + "id": 1, + "name": "osm fivee", + "version": "osm fivee", + "description": "osm five" + } + ], + "vxfOnBoardedDescriptors": [], + "vfimagesVDU": [ + { + "id": 1, + "name": "cirros034", + "uuid": "d4549610-8abd-42ad-97f4-0a64e1c93977", + "shortDescription": "Automatically created during vxf cirros_vnfd submission. Owner must update.", + "packageLocation": null, + "publicURL": null, + "dateCreated": 1568971426000, + "dateUpdated": null, + "refVxFs": [ + { + "id": 1, + "name": "cirros_vnfd" + } + ], + "owner": { + "id": 1, + "organization": "ee", + "name": "Portal Administrator", + "email": "", + "username": "admin", + "active": true, + "currentSessionID": null, + "apikey": "e41c1cc4-aa56-4b7e-9f4d-64589549d768", + "createdAt": 1568711859000, + "roles": [ + "ADMIN", + "MENTOR" + ] + }, + "published": false, + "termsOfUse": null, + "deployedInfrastructures": [] + } + ] + }, + { + "id": 2, + "owner": { + "id": 1, + "organization": "ee", + "name": "Portal Administrator", + "email": "", + "username": "admin", + "createdAt": null + }, + "uuid": "4ab80095-a63e-4fe7-8598-e1c7e880706e", + "name": "cirros_sriov_vnfd", + "iconsrc": null, + "shortDescription": "cirros_sriov_vnf", + "longDescription": "Simple VNF example with a cirros SRIOV interface", + "version": "1.0", + "packageLocation": "/osapi/packages/4ab80095-a63e-4fe7-8598-e1c7e880706e/cirros_sriov.tar.gz", + "dateCreated": 1568971740000, + "dateUpdated": 1568981100000, + "categories": [ + { + "id": 4, + "name": "tyu", + "productsCount": 1, + "appscount": 0, + "vxFscount": 1 + }, + { + "id": 5, + "name": "tyi", + "productsCount": 1, + "appscount": 0, + "vxFscount": 1 + } + ], + "extensions": [], + "validationJobs": [], + "screenshots": "", + "vendor": "OSM", + "published": false, + "termsOfUse": null, + "descriptor": "vnfd:vnfd-catalog:\n vnfd:\n - connection-point:\n - name: eth0\n type: VPORT\n - name: eth1\n type: VPORT\n description: Simple VNF example with a cirros SRIOV interface\n id: cirros_sriov_vnfd\n logo: cirros-64.png\n mgmt-interface:\n cp: eth0\n name: cirros_sriov_vnf\n short-name: cirros_sriov_vnf\n vdu:\n - count: 1\n description: cirros_sriov_vnfd-VM\n guest-epa:\n cpu-pinning-policy: DEDICATED\n cpu-thread-pinning-policy: PREFER\n mempage-size: SMALL\n numa-node-policy:\n mem-policy: STRICT\n node:\n - id: '1'\n node-cnt: '1'\n id: cirros_sriov_vnfd-VM\n image: cirros-0.3.6-x86_64\n interface:\n - external-connection-point-ref: eth0\n name: eth0\n position: '1'\n type: EXTERNAL\n virtual-interface:\n bandwidth: '0'\n type: VIRTIO\n vpci: 0000:00:0a.0\n - external-connection-point-ref: eth1\n name: eth1\n position: '2'\n type: EXTERNAL\n virtual-interface:\n type: SR-IOV\n name: cirros_sriov_vnfd-VM\n vm-flavor:\n memory-mb: 4096\n storage-gb: 10\n vcpu-count: 4\n vendor: OSM\n version: '1.0'\n", + "descriptorHTML": "

cirros_sriov_vnf


Vendor: OSM
Version: 1.0
Description: Simple VNF example with a cirros SRIOV interface
VM Count: 1
vCPU Count: 1
Memory: 4096 MB
Storage: 10 GB
", + "certified": false, + "certifiedBy": null, + "validationStatus": "UNDER_REVIEW", + "packagingFormat": "OSMvFIVE", + "supportedMANOPlatforms": [ + { + "id": 1, + "name": "osm fivee", + "version": "osm fivee", + "description": "osm five" + } + ], + "vxfOnBoardedDescriptors": [], + "vfimagesVDU": [ + { + "id": 2, + "name": "cirros-0.3.6-x86_64", + "uuid": "be121176-1d62-4a1b-a3c1-7dce2e069d22", + "shortDescription": "Automatically created during vxf cirros_sriov_vnfd submission. Owner must update.", + "packageLocation": null, + "publicURL": null, + "dateCreated": 1568971740000, + "dateUpdated": null, + "refVxFs": [ + { + "id": 2, + "name": "cirros_sriov_vnfd" + } + ], + "owner": { + "id": 1, + "organization": "ee", + "name": "Portal Administrator", + "email": "", + "username": "admin", + "active": true, + "currentSessionID": null, + "apikey": "e41c1cc4-aa56-4b7e-9f4d-64589549d768", + "createdAt": 1568711859000, + "roles": [ + "ROLE_ADMIN", + "ROLE_MENTOR" + ] + }, + "published": false, + "termsOfUse": null, + "deployedInfrastructures": [] + } + ] + } +] +``` + + diff --git a/doc/architecture/nfvweb.md b/doc/architecture/nfvweb.md new file mode 100644 index 0000000000000000000000000000000000000000..b96dee34a9662e14f4c5eb3f41f507817686b094 --- /dev/null +++ b/doc/architecture/nfvweb.md @@ -0,0 +1,11 @@ +# Openslice NFV Web Portal + +The [NFV Web Portal](http://portal.openslice.io/nfvportal) offers a domain-specific UI to manage NFV Services. + +Indicatively, the portal can be used to: +- Register new a new MANO provider (e.g. OSM) +- Synchronize the onboarded VNF/NS packages, and the VIMs of the registered MANO provider +- Onboard/Delete VNF/NS packages on specific MANO provider +- Deploy a NS to a target MANO provider + +More information can be found at [NFV Services](../nfvcatalogs.md). \ No newline at end of file diff --git a/doc/architecture/oauth.md b/doc/architecture/oauth.md new file mode 100644 index 0000000000000000000000000000000000000000..e836842620424d03e68971f2406eba6d11269d7c --- /dev/null +++ b/doc/architecture/oauth.md @@ -0,0 +1,35 @@ +# Authentication Server + +Authentication is based on oAuth2. Our authentication service is a Keycloak server which is deployed with Openslice deployment + +API users needs to authenticate. +All APIs (except grant token request) must include Bearer token in request Authorization header. + + + +##OAuth token + +Get first an oauth token, using your username and password. +``` +curl -X POST http://portal.openslice.io/auth/realms/openslice/protocol/openid-connect/token -H 'Content-Type: application/x-www-form-urlencoded' -d 'username=demouser' -d 'password=demouser' -d 'grant_type=password' -d 'client_id=osapiWebClientId' +``` +response: + +``` + {"access_token":"eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJHZFRjQnpxczg2VW10NTRVZV8ybTJyWHJkV3dzaWdSZE9EUldMYm1memNvIn0.eyJleHAiOjE1ODgyNDA1NzAsImlhdCI6MTU4ODI0MDI3MCwianRpIjoiOGI2ZTU0NWUtNDIyYy00NzFiLWEwN2UtYTUzYzY1NDQ0MzZmIiwiaXNzIjoiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8vYXV0aC9yZWFsbXMvb3BlbnNsaWNlIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImExYTI3NjVhLWVjODMtNDQ1Ni1iN2IyLTIwNzMxOTg2ZTAzNSIsInR5cCI6IkJlYXJlciIsImF6cCI6Im9zYXBpV2ViQ2xpZW50SWQiLCJzZXNzaW9uX3N0YXRlIjoiMzM1MGY0OTMtNjYyNy00MzczLTg1NDQtZGVmZDI3YWQzYzc0IiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6WyJodHRwOi8vbG9jYWxob3N0OjEzMDgyIiwiaHR0cDovL2xvY2FsaG9zdCIsImh0dHA6Ly9vcGVuc2xpY2UuaW8iLCJodHRwOi8vbG9jYWxob3N0OjEzMDAwIiwiaHR0cDovL2xvY2FsaG9zdDo0MjAwIiwiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIk5GVl9ERVZFTE9QRVIiLCJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIiwiRVhQRVJJTUVOVEVSIiwiVVNFUiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoicHJvZmlsZSBlbWFpbCIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJkZW1vdXNlciJ9.TnzzpRLMD94UTKpT5_wkr1h4_3KUQmr4TGvFLpJ7cZx-Klrv8tB_eRkWnPqqzCAM9G21a1qXboL8MLMW8ECzG7HYKpobKOGr7LSczMOTdA2ZDyBCRUSOdW77pchu54tJ0ITEkFaDwSKMKKt04V_Sy4U-eIndj0XzzRlkDolWDnK4Z2lRaXAI6fMwOKx1Toa6RfOcemxtzl3pdtjPx92zo6MaKlbIqHK82lxdK0k8aQQaT6TmIrXbZKV2dU_1d3O0q0dVUEZJ_1kzwqOFkmxr9w0EnndC6ccYJlDAr_-GgUhhhNOn5v6tjYLUQdj5e4KEAsxIPzaCreK4un7mEAPmDw","expires_in":300,"refresh_expires_in":1800,"refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICIwZjUxMDk5Yy0wNTIzLTRjNGQtODM0Zi1iNDc0YzBjOTA1MzkifQ.eyJleHAiOjE1ODgyNDIwNzAsImlhdCI6MTU4ODI0MDI3MCwianRpIjoiZmViOTg5NWEtOTY5ZS00MzIzLWJjY2QtZTY2YzQ0NGE1MzJlIiwiaXNzIjoiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8vYXV0aC9yZWFsbXMvb3BlbnNsaWNlIiwiYXVkIjoiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8vYXV0aC9yZWFsbXMvb3BlbnNsaWNlIiwic3ViIjoiYTFhMjc2NWEtZWM4My00NDU2LWI3YjItMjA3MzE5ODZlMDM1IiwidHlwIjoiUmVmcmVzaCIsImF6cCI6Im9zYXBpV2ViQ2xpZW50SWQiLCJzZXNzaW9uX3N0YXRlIjoiMzM1MGY0OTMtNjYyNy00MzczLTg1NDQtZGVmZDI3YWQzYzc0Iiwic2NvcGUiOiJwcm9maWxlIGVtYWlsIn0.cDTx9BE1Df8EfGYm3VLr_MNFeymxZtJhMtlK7PVbIuk","token_type":"bearer","not-before-policy":1586797346,"session_state":"3350f493-6627-4373-8544-defd27ad3c74","scope":"profile email"} + +``` + +The `access_token` will be used next as a Bearer. + +``` +curl http://portal.openslice.io/tmf-api/serviceCatalogManagement/v4/serviceCatalog -H 'Authorization: Bearer yJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJHZFRjQnpxczg2VW10NTRVZV8ybTJyWHJkV3dzaWdSZE9EUldMYm1memNvIn0.eyJleHAiOjE1ODgyNDA1MjQsImlhdCI6MTU4ODI0MDIyNCwianRpIjoiYjg0NGYxZDAtMzk3Mi00YTMyLThiMWEtZDAxMDY3OGZjMTQ4IiwiaXNzIjoiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8vYXV0aC9yZWFsbXMvb3BlbnNsaWNlIiwic3ViIjoiYTFhMjc2NWEtZWM4My00NDU2LWI3YjItMjA3MzE5ODZlMDM1IiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiYWRtaW4tY2xpIiwic2Vzc2lvbl9zdGF0ZSI6ImFmMmMzZmY1LTE4YWQtNDFkNC1hYTAyLTFlMGJkNzNmOTM5MSIsImFjciI6IjEiLCJzY29wZSI6InByb2ZpbGUgZW1haWwiLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwicHJlZmVycmVkX3VzZXJuYW1lIjoiZGVtb3VzZXIifQ.SMtgV1E44_K_MQumGXZtWsLGVhYNaoM8Pk-DiFIZtUP4Zu-ervOsxHVQMX1frgVERR4jJidBcSshy9TnJ3UjF4l33WujHltbs-1UPy-gaIufVuEpl8RmbjOti3Up70vLfLXbzb6kN6WaahgobWXlbJsSXXwaBPQP6vSX5KigCa8TmzXcuqom14lOrlU-RB2zQTlJ30p7d9ag-a7o3I5m9GZWLJCZW2UYMl1JkskTHKgilA8HFQY4C9DYwWu8YDMyzqQSNumrTlURalBFidFbZvb1kp4dAyct8TysSWSbxxiwaL2RX1PWUqk-5Fpc1Q6BnBC8muMheiukFuoSkuADAg'^C +ubuntu@portal:~$ curl http://portal.openslice.io/tmf-api/serviceCatalogManagement/v4/serviceCatalog -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJHZFRjQnpxczg2VW10NTRVZV8ybTJyWHJkV3dzaWdSZE9EUldMYm1memNvIn0.eyJleHAiOjE1ODgyNDA1NzAsImlhdCI6MTU4ODI0MDI3MCwianRpIjoiOGI2ZTU0NWUtNDIyYy00NzFiLWEwN2UtYTUzYzY1NDQ0MzZmIiwiaXNzIjoiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8vYXV0aC9yZWFsbXMvb3BlbnNsaWNlIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImExYTI3NjVhLWVjODMtNDQ1Ni1iN2IyLTIwNzMxOTg2ZTAzNSIsInR5cCI6IkJlYXJlciIsImF6cCI6Im9zYXBpV2ViQ2xpZW50SWQiLCJzZXNzaW9uX3N0YXRlIjoiMzM1MGY0OTMtNjYyNy00MzczLTg1NDQtZGVmZDI3YWQzYzc0IiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6WyJodHRwOi8vbG9jYWxob3N0OjEzMDgyIiwiaHR0cDovL2xvY2FsaG9zdCIsImh0dHA6Ly9vcGVuc2xpY2UuaW8iLCJodHRwOi8vbG9jYWxob3N0OjEzMDAwIiwiaHR0cDovL2xvY2FsaG9zdDo0MjAwIiwiaHR0cDovL3BvcnRhbC5vcGVuc2xpY2UuaW8iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIk5GVl9ERVZFTE9QRVIiLCJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIiwiRVhQRVJJTUVOVEVSIiwiVVNFUiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoicHJvZmlsZSBlbWFpbCIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJkZW1vdXNlciJ9.TnzzpRLMD94UTKpT5_wkr1h4_3KUQmr4TGvFLpJ7cZx-Klrv8tB_eRkWnPqqzCAM9G21a1qXboL8MLMW8ECzG7HYKpobKOGr7LSczMOTdA2ZDyBCRUSOdW77pchu54tJ0ITEkFaDwSKMKKt04V_Sy4U-eIndj0XzzRlkDolWDnK4Z2lRaXAI6fMwOKx1Toa6RfOcemxtzl3pdtjPx92zo6MaKlbIqHK82lxdK0k8aQQaT6TmIrXbZKV2dU_1d3O0q0dVUEZJ_1kzwqOFkmxr9w0EnndC6ccYJlDAr_-GgUhhhNOn5v6tjYLUQdj5e4KEAsxIPzaCreK4un7mEAPmDw' + +Response: + + +[{"uuid":"9e186cd5-b2b2-4a06-b1d6-895720193bc9","lastUpdate":"2020-03-11T23:19:05Z","@baseType":"BaseEntity","@schemaLocation":null,"@type":"ServiceCatalog","href":null,"name":"Example Facility Services","description":"Example Facility Services","lifecycleStatus":"Active","version":"1.0","validFor":{"endDateTime":"2039-11-20T23:07:21Z","startDateTime":"2019-11-20T23:07:21Z"},"relatedParty":null,"id":"9e186cd5-b2b2-4a06-b1d6-895720193bc9","category":[{"@baseType":"org.etsi.osl.tmf.scm633.model.ServiceCategoryRef","@schemaLocation":null,"@type":"org.etsi.osl.tmf.scm633.model.ServiceCategoryRef","href":null,"name":"Generic Services","@referredType":null,"id":"98b9adf1-a1d6-4165-855f-153ddc2131b1"},{"@baseType":"org.etsi.osl.tmf.scm633.model.ServiceCategoryRef","@schemaLocation":null,"@type":"org.etsi.osl.tmf.scm633.model.ServiceCategoryRef","href":null,"name":"External","@referredType":null,"id":"08ffdb3c-6237-45d0-9f3a-d43b5fc5f0b6"},{"@baseType":"org.etsi.osl.tmf.scm633.model.ServiceCategoryRef","@schemaLocation":null,"@type":"org.etsi.osl.tmf.scm633.model.ServiceCategoryRef","href":null,"name":"eMBB","@referredType":null,"id":"ef2c90dd-b65e-4a9f-a9c3-427c9fb0219b"}]}] + + +``` \ No newline at end of file diff --git a/doc/architecture/osom.md b/doc/architecture/osom.md new file mode 100644 index 0000000000000000000000000000000000000000..173aa8017d603bb3854eb6b4c0e9baa905e512f6 --- /dev/null +++ b/doc/architecture/osom.md @@ -0,0 +1,137 @@ +# Openslice Service Orchestration and Order Management - OSOM + +OSOM is a service responsible for: + +* Service Order Management (SOM) +* Service Orchestration (SO) + +It uses open source Flowable Business process engine (https://www.flowable.org) . + +A Service Order follows the states as defined in TMF641 specification: + +[![Service Order state](../images/service_order_states.png)](../images/service_order_states.png) + + +## Initial state + +When a new order is created, it goes into the Initial state. It is stored in the repository and triggers an Event. + +[![Initial state](../images/service_order_initial_state.png)](../images/service_order_initial_state.png) + +Administrators are notified usually from the Ticketing System of a new order. They login to Openslice and change the State of the order either to ACKNOWLEDGED or REJECTED. If ACKNOWLEDGED they can Propose a startDate, add Notes, and add any additional service items + +## Order scheduler + +A process checks every 1 minute for ACKNOWLEDGED orders. + +[![Order scheduler BPM](../images/order_scheduler_bpm.png)](../images/order_scheduler_bpm.png) + +[![Order scheduler](../images/order_scheduler_diagram.png)](../images/order_scheduler_diagram.png) + +It retrieves all orders that are in ACKNOWLEDGED state and if the start date is in time it will initialize the process by settingn the order in IN_PROGRESS state. Finally the Start Order Process will start. + + +## Start order process + +This process for now is a draft simple prototype to make a simple orchestration via NFVO. Here the actual Services (TMF638/640 model) are created and attached to Service Order and Service Inventory. + +[![Start Order BPM](../images/start_order_process_bpm.png)](../images/start_order_process_bpm.png) + +[![Start Order interactions](../images/start_order_process_diagram.png)](../images/start_order_process_diagram.png) + +We expect here to check which tasks can be orchestrated by NFVO and which by human. We create the equivalent Services(TMF638/640 model) for this order. + +1. During check it should decide to create Service(s) for this service order O1 and send it to ServiceInventory +2. The Services(TMF638 model) are assigned to the Order O1 In supportService List +3. Each OrderItem OI1 is related to one serviceSpecification +4. Each ServiceSpecification has also related serviceSpecRelationships +5. So if we receive an order O1 for a ServiceSpec A which relates to (a bundle of) 3 specs(2 CFS, 1 RFS) we do the following: + 1. Create a Service S_A(TMF638 model) for ServiceSpec A for Order O1 + 2. We create also 3 Services S_C1, S_C2 and S_R1 equivalent to the serviceSpecRelationships (2 CFS, 1 RFS) + 3. At this point the order will have 1 Local Service Orchestration Process(S_A), 2 supportingServices refs(S_C1, S_C2) and 1 supportingResource(S_R1) + 4. The 3 supportingServices and 1 supportingResource correspond to total 4 Services in ServiceInventory + 5. Service S_A will have: + 1. startMode 1: Automatically by the managed environment + 2. State: RESERVED and the Lifecycle will be handled by OSOM + 6. Services S_C1 and S_C2 we decide that cannot be orchestrated then they have + 1. startMode: 3: Manually by the Provider of the Service + 2. State: RESERVED and the Lifecycle will be handled by OSOM + 3. If the CFS is a bundle spec it is further recursively orchestrated + 7. Service S_R1 will have + 1. startMode 1: Automatically by the managed environment. + 2. State: RESERVED + 3. IF The Service has the characteristic CharacteristicByName( "NSDID") it will be further processed by the NFVO + + +There will be two instances of task "User Task Manual Complete Service" each for Services S_C1 and S_C2. The task is Transient for now. It displays only the services that are not automated! +Here is a flow for future: + +1. We wait here for human decision. +2. From API we get a result: + a. If set to ACTIVE/TERMINATED then we complete the task + b. In any other state we stay in this task until it is resolved as in step a + c. The Status of ORDER O1 is also updated to PARTIAL + +There will be an instance of NFVODeploymentRequest process each for Service S_R1. (see later) + +1. This process is related with the NFVO orchestration +2. It will send a msg to NFVO(s?) for a specific deployment request + + +All services in "Order Complete" are in a status: + +1. Depending on the result the service S_A is either ACTIVE or INACTIVE or TERMINATED +2. The Status of ORDER O1 is also updated to COMPLETED or PARTIAL (in case we have some services running) or FAILED (in cases we have errors) + + +A Service follows the states as defined in TMF638 Service Inventory specification: + +[![Service state](../images/service_states.png)](../images/service_states.png) + + + +## NFVODeploymentRequest process + + +[![NFVODeploymentRequest BPM](../images/NFVODeploymentReq_process.png)](../images/NFVODeploymentReq_process.png) + +This process is related with the NFVO orchestration +It will send a msg to NFVO(s?) for a specific deployment request +Then it checks the deployment status. It will wait 30 secs each time until the deployment is running (or failed) + + + +## Check In Progress orders process + +Every 1 minute the "Check In Progress Orders" process is executed checking if a supported Service changed state (i.e. to ACTIVE) then the whole Order will change state (e.g. go to COMPLETED) + +[![Check In Progress BPM](../images/check_inProgress_orders.png)](../images/check_inProgress_orders.png) + + +## External Service Provider Deployment Request process + +[![External Service Provider Deployment Request process BPM](../images/externalSPDeploymentReq.png)](../images/externalSPDeploymentReq.png) + +This process contains tasks for submitting order requests to external partners. +- Submit Order To External Service Provider Task: This task creates automatically a Service Order request to a 3rd party provider SO that hosts the Service Specification +- Check external service order fulfillment task: This task Check external partner for Service creations and updates our local inventory of services the service characteristics of remote Service Inventory + + +## Fetch Partner Services Process + + +[![Fetch Partner Services Process BPM](../images/fetchPartnerServices.png)](../images/fetchPartnerServices.png) + +Every 2 minutes the "fetchPartnerServicesProcess" process is executed checking remote Partner Organizations for changes in the published catalogues. +The Fetch and Update External Partner Services Task is executed in paralle l for each Partner Organization + + +## Local Service Orchestration Process + + +[![Local Service Orchestration Process BPM](../images/LocalServiceOrchestrationProcess.png)](../images/LocalServiceOrchestrationProcess.png) + +This process handles automatically services that need to be further orchestrated or processed by OSOM. For example, for a CFS Bundled service we create such automated service instances that just aggregate the underlying services. + + + \ No newline at end of file diff --git a/doc/architecture/tmfapi.md b/doc/architecture/tmfapi.md new file mode 100644 index 0000000000000000000000000000000000000000..f7944969741681c840db830a70fc688a0224295e --- /dev/null +++ b/doc/architecture/tmfapi.md @@ -0,0 +1,65 @@ +# TMF OpenAPI specification + +PLease check the complete specification [here](http://portal.openslice.io/tmf-api/swagger-ui/index.html). + +## API interaction + +### OAuth token + +See [oauth](./oauth.md) + +### Request a protected API resource + +Example: Get all Service Catalogs (check the `Authorization:Bearer` to be correct) + +``` +curl -H "Authorization:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJhZG1pbiIsInNjb3BlIjpbIm9wZW5hcGkiLCJhZG1pbiIsInJlYWQiLCJ3cml0ZSJdLCJvcmdhbml6YXRpb24iOiJteW9yZ2FuaXp0aW9uIiwiZXhwIjoxNTc4NTA1MDcyLCJhdXRob3JpdGllcyI6WyJST0xFX01FTlRPUiIsIlJPTEVfQURNSU4iXSwianRpIjoiMTFlNGYxYTUtZDY0Ny00YzA1LWE0ZGMtYWFhYzUyMjk4YzMwIiwiY2xpZW50X2lkIjoib3NhcGlXZWJDbGllbnRJZE91dCJ9.gm7cKdusDrdMRkxEiFU5sENKGRC1xwVj2SgPRmE9xxx" -H "accept: application/json;charset=utf-8" -X GET "http://portal.openslice.io/tmf-api/serviceCatalogManagement/v4/serviceCatalog" + +``` + + +response: + + +``` +[ + { + "uuid": "9e186cd5-b2b2-4a06-b1d6-895720193bc9", + "lastUpdate": "2019-12-19T10:45:55Z", + "@baseType": "BaseEntity", + "@schemaLocation": null, + "@type": "ServiceCatalog", + "href": null, + "name": "Example Facility Services", + "description": "Example Facility Services", + "lifecycleStatus": "Active", + "version": "1.0", + "validFor": { + "endDateTime": "2039-11-20T23:07:21Z", + "startDateTime": "2019-11-20T23:07:21Z" + }, + "relatedParty": null, + "id": "9e186cd5-b2b2-4a06-b1d6-895720193bc9", + "category": [ + { + "@baseType": "org.etsi.osl.tmf.scm633.model.ServiceCategoryRef", + "@schemaLocation": null, + "@type": "org.etsi.osl.tmf.scm633.model.ServiceCategoryRef", + "href": null, + "name": "eMBB", + "@referredType": null, + "id": "ef2c90dd-b65e-4a9f-a9c3-427c9fb0219b" + }, + { + "@baseType": "org.etsi.osl.tmf.scm633.model.ServiceCategoryRef", + "@schemaLocation": null, + "@type": "org.etsi.osl.tmf.scm633.model.ServiceCategoryRef", + "href": null, + "name": "Generic Services", + "@referredType": null, + "id": "98b9adf1-a1d6-4165-855f-153ddc2131b1" + } + ] + } +] +``` \ No newline at end of file diff --git a/doc/architecture/tmfweb.md b/doc/architecture/tmfweb.md new file mode 100644 index 0000000000000000000000000000000000000000..729eed65fa1833982885623ca9108e67b44ab20c --- /dev/null +++ b/doc/architecture/tmfweb.md @@ -0,0 +1,39 @@ +# Openslice TMF Web Portal + +Openslice comprises of a [web landing page](http://portal.openslice.io/) that navigates to the respective TMF Portal. + +- [Services Portal](http://portal.openslice.io/services) +- [Products Portal](http://portal.openslice.io/products) +- [Testing Portal](http://portal.openslice.io/testing) +- [Resources Portal](http://portal.openslice.io/resources) + +The landing page and the TMF portals (Services, Products, Testing, Resources) are written in Angular and are maintained under the same Angular project. + +Following you may find the scope each portal focuses on and the main TMF APIs it supports. + +**Services Portal** is a designated portal for the: +- Service Designer - To design Customer Facing Services as bundles of Resource Facing Services that map to specific Resourses (e.g. NFV, Testing, General Resources). Then, it is charged with the designed Services' exposure to public Service Catalogs. +- Service Customer - To browse the public Service Catalogs and order the offered Services. The fulfilment process of the Service Order is also captured and the final deployed Services are exposed to the Customer. + +**Products Portal** is a designated portal for the: +- Product Designer - To design Products as bundles of available Services. Then, it is charged with the designed Products' exposure to public Product Catalogs. +- Product Customer - To browse the public Product Catalogs and navigate to the respective offered Services. + +**Testing Portal** is a designated portal for the: +- Testing Designer - To design Tests and provide the testing scripts as attachments to the latter. The Tests can be imported as Services at the Services Portal, and can be included in a Service Bundle. + +**Resources Portal** is a designated portal for the: +- Resource Administrator - To view the available Resources that are being synchronized from the underlying infrastructure. + + + + +| | TMF620 | TMF632 | TMF633 | TMF634 | TMF638 | TMF639 | TMF640 | TMF641 | TMF642 | TMF653 | TMF685 | +| ------------- |:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:| +|**Services Portal** | |x |x | |x | |x |x |x | | | +|**Products Portal** |x |x | | | | | | | | | | +|**Testing Portal** | |x | | | | | | | |x | | +|**Resources Portal** | |x | |x | |x | | | | |x | + + +From the landing page, the user can also navigate towards the NFV portal. See [NFV WEB](./nfvweb.md). \ No newline at end of file diff --git a/doc/catalogs.md b/doc/catalogs.md new file mode 100644 index 0000000000000000000000000000000000000000..3b3538d0b5dcaedf1690154bea22e70caf85551b --- /dev/null +++ b/doc/catalogs.md @@ -0,0 +1,147 @@ +# Catalogs and Templates + +The Openslice Service Catalogue (accessible through the API or Services portal) contains the representation of Service Specifications, either created from the provider defining service attributes, or by supporting the GSMA Generic Slice Templates (GST) as well as the VINNI Service Blueprint. The following scenarios are supported by the Openslice Service Catalogue. + + +## Create/Design a Service Specification + +### First Import some Resources as Resource Facing Services (RFSs) + +If you have any NSDs as NFV artifacts, import them through the UI menu (Import from NSD list). Then an NSD is imported as a resource and an RFS automatically is created. RFSs then later are used to design a Customer Facing Service Specification + +### Create/Design a Customer Facing Service Specification + +Customer Facing Service Specification are the services offered to customers. +You can create a new Service Specification from the menu. The services created through the UI are Customer Facing Services (CFS). Usually you create a CFS as a bundle and then you include Service Specification Relationships with RFSs or/and CFSs. + +Any Service Specification Characteristics from the RFS are copied to the CFS specification. A CFS can include multiple RFS or/and CFSs. +For example you can create a CFS spec called "A 5G Service" which is a bundle of two other services (include them in Service Specification Relationships) such as 5G eMBB Slice and a Customer VPN. So when the user orders "A 5G Service" services from 5G eMBB Slice and a Customer VPN will be created during the order. + +### Initial configuration for OSM deployment + +if you have an initial configuration that needs to be applied in the NSD deployment, then you go to the RFS (or CFS) and in Service Specification Characteristics go and edit the OSM_CONFIG characteristic. +You can add in the Service Characteristic Value, in the Value field something like the following example which gives a floating IP to a VNF: + +``` +{ "nsdId": "e855be91-567b-45cf-9f86-18653e7ea", "vimAccountId": "4efd8bf4-5292-4634-87b7-7b3d49108" , "vnf": [ {"member-vnf-index": "1", "vdu": [ {"id": "MyCharmedVNF-VM", "interface": [{"name": "eth0", "floating-ip-required": true }]}]}]} + +``` + +or a more complex example (beautify it first if you want to view it, but in the parameter OSM_CONFIG must be minified like the example): + +``` +{"nsdId":"e855be91-567b-45cf-9f86-18653e7","vimAccountId":"4efd8bf4-5292-4634-87b7-7b3d491","vnf":[{"member-vnf-index":"1","vdu":[{"id":"haproxy_vdu","interface":[{"name":"haproxy_vdu_eth1","floating-ip-required":true}]}]}],"vld":[{"name":"pub_net","vim-network-name":"OSMFIVE_selfservice01"},{"name":"management","vim-network-name":"OSMFIVE_selfservice01"},{"name":"lba_net","vim-network-name":"lba_net","vnfd-connection-point-ref":[{"member-vnf-index-ref":"1","vnfd-connection-point-ref":"haproxy_private","ip-address":"192.168.28.2"}]},{"name":"backend_net","vim-network-name":"backend_net","vnfd-connection-point-ref":[{"member-vnf-index-ref":"3","vnfd-connection-point-ref":"haproxy_public","ip-address":"192.168.20.2"}]},{"name":"lb_sb_net","vim-network-name":"lb_sb_net","vnfd-connection-point-ref":[{"member-vnf-index-ref":"3","vnfd-connection-point-ref":"haproxy_private","ip-address":"192.168.28.2"}]},{"name":"breaking_point_Spain","vim-network-name":"sb_repo_net"},{"name":"breaking_point_Greece","vim-network-name":"5TONICexternal"}],"additionalParamsForVnf":[{"member-vnf-index":"2","additionalParams":{"target_IP":"192.168.20.2"}},{"member-vnf-index":"4","additionalParams":{"target1_IP":"192.168.21.2","target2_IP":"10.154.252.10"}}]} +``` + +You can leave the Alias and Unit of Measure as is. Check also the is Default. + + + +### Day 2 Primitive Actions + +NFVOs like OSM allow to perform actions while a service is running, for example change attributes or make actions on a specific VNF. To design this do something similar to the following example: + +- Go to the RFS related to the NSD that contains VNFs with primitives +- create a characteristic named Primitive:: , e.g. Primitive::touch +- select Value Type: ARRAY +- add Service Characteristic Value: i) alias=primitive, value= (e.g. touch), ii) alias=member_vnf_index, value= (e.g. 1), iii) add the params that the user will change in alias the name of param and in value an initial value (e.g. alias=filename, value=myfile.txt) + +In the above example, when the service is running and the user goes to service inventory to MODIFY it, changes the value of the alias=filename, value=myfile.txt, to value =secondfile.txt. Then inside the VNF a file will be created called secondfile.txt + + + +### Generic Slice Templates (GST) +(Offered only as a design for now. THere is no direct implementation to NFV) +On October 16th 2019 GSMA published NG.116 Version 2.0 which defines the Generic Network Slice Template (GST). GST is a set of attributes that can characterise a type of network slice/service. GST is generic and is not tied to any specific network deployment. Here is a list of the various attributes of the template: + +- Availability +- Area of Service +- Delay tolerance +- Deterministic communication +- Downlink throughput per network slice +- Downlink throughput per UE +- Energy efficiency +- Group communication support +- Isolation level +- Location based message delivery +- Maximum supported packet size +- Mission critical support +- MMTel support +- NB-IoT support +- Network Slice Customer network functions +- Number of connections +- Number of terminals +- Performance monitoring +- Performance prediction +- Positioning support +- Radio spectrum +- Reliability +- Root cause investigation +- Session and Service Continuity support +- Simultaneous use of the network slice +- Slice quality of service parameters +- Support for non-IP traffic +- Supported access technologies +- Supported device velocity +- Synchronicity +- Terminal density +- Uplink throughput per network slice +- Uplink throughput per UE +- User management openness +- User data access +- V2X communication mode + +Openslice offers the GST in a format that is machine readable and aligned with the TMF SID model. Here is a tentative approach in JSON : + +Providers can clone a GST as e NEST directly in Openslice Web portal and the adjust the default attributes to their Service Specification + + +### 5G-VINNI Service Blueprint +(Offered only as a design for now. THere is no direct implementation to NFV) +5G-VINNI Service Blueprint is a special Service Specification defined by teh 5G-VINNI project. Many details can be found in document + +5G-VINNI Service Blueprint is a reusable self-contained specification of required network slice service (instances). As described in GST mapping VINNI-SB is also machine readable. + +Here is a tentative approach in JSON : + +5G-VINNI SB has many commonalities with GST as well as it offers Testing as a Service attributes. + + Next figure presents the high-level object model of a 5G-VINNI service blueprint. + +The 5G-VINNI SB as a first prototype approach is conceived as a CFS of a ‘bundle’ of services. It has some characteristics, like name, description, service type (eMBB, etc) and others. The constituent services are: + +- A “Service Topology” Service Specification which is related to a Network Service Resource topology (a Logical Resource Spec). It is considered at this stage as an RFS but is subject to change in future +- A “VINNI SB Service Requirements” Service Specification which is related to Service requirements. This is very similar to GST. It is considered at this stage a CFS. +- A “VINNI SB Service Exposure Level 1” Service Specification which contains characteristics for service exposure on level 1 ( see D3.1 for details). It is considered at this stage a CFS. +- A “VINNI SB Service Exposure Level 2” Service Specification which contains characteristics for service exposure on level 2. It is considered at this stage a CFS. +- A “VINNI SB Service Exposure Level 3” Service Specification which contains characteristics for service exposure on level 3. It is considered at this stage a CFS. +- A “VINNI SB Service Exposure Level 4” Service Specification which contains characteristics for service exposure on level 4. It is considered at this stage a CFS. +- A “VINNI SB Service 3rd part VNF” Service Specification which contains characteristics for support 3rd party VNFs to be included in the service. It is considered at this stage as an RFS but is subject to change in future +- A “VINNI SB Service 3rd part NSD” Service Specification which contains characteristics for support 3rd party NSDs to be included in the service. It is considered at this stage as an RFS but is subject to change in future +- A “VINNI SB Service Monitoring” Service Specification which contains characteristics for offering Monitoring capabilities on the requested Service. It is considered at this stage a CFS. +- A “VINNI SB Service Testing” Service Specification which contains characteristics for offering Testing capabilities on the requested Service. It is considered at this stage a CFS. + + +[![VINNI SB Template Model diagram](../images/vinni_sb_model_diagram.png)](../images/vinni_sb_model_diagram.png) + + +## Manage a Service Specification + +You can manage them though the Web UI + + +## Assign a Service Specification to Service Categories and Publish + +Just create categories and from the menu select the category and add services + + +## Retire/Remove a Service Specification + +Delete it from the category + + +## Consume and expose Service Specifications from other Service Catalogues + +See more on [Consuming Services From External Partner Organizations](./architecture/consumingServicesFromExternalPartners.md) + + diff --git a/doc/contributing/developing.md b/doc/contributing/developing.md new file mode 100644 index 0000000000000000000000000000000000000000..e8939eeca651aadf2bedef512ed8009df305b4aa --- /dev/null +++ b/doc/contributing/developing.md @@ -0,0 +1,89 @@ + +# Developing + +OpenSlice backend services are mainly implemented with Java 17 or above and Spring boot. + +OpenSlice uses various subsystems and depending on the module would you like to work, other subsystems must be present (you can disable them though in the code, e.g. at docker-compose.yaml file). + +To get the latest development branch: +```bash +wget https://labs.etsi.org/rep/osl/code/org.etsi.osl.main/-/raw/develop/compose/deploy.sh +sudo ./deploy.sh develop #[or replace develop with other branch name] +``` + +You may follow the [installation process](https://osl.etsi.org/documentation/develop/deployment/), as described at "develop" tagged documentation. + +To work on a specific subsystem e.g. org.etsi.osl.tmf.api, you must: + +1a - Deploy only the core necessary subsystems through: +```bash +sudo docker compose --profile dev down;sudo docker compose --profile dev up -d --build +``` +> Note **--profile dev** that will only deploy the core dependency subsystems, instead of the whole OpenSlice. + +1b - Or alternatively, commend out the respective container from the docker-compose.yaml file, so as to deploy the whole OpenSlice, except the subsystem you want to work on, following the provided installation steps. + +2 - Clone the respective repository, e.g. https://labs.etsi.org/rep/osl/code/org.etsi.osl.tmf.api/-/tree/develop + +3 - Code :) + +## General requirements + +- Docker should be installed in your development environment +- Run the core subsystems (see above section) + + +## Slack + +Feel free to join OpenSlice [Slack](https://openslice.slack.com) for any development oriented questions. + +## Examples of developing on specific subsystems + +### VNF/NSD Catalog Management and NSD Deployment API service + +Clone the repository: https://labs.etsi.org/rep/osl/code/org.etsi.osl.portal.api/-/tree/develop + +Check the docker-compose.yml file. Default port is 13080. Check specifically the datasource username/password, server port. + +Make sure that the core subsystems are up and running. + +Execute it with +```bash +mvn spring-boot:run +``` + +For verification, Swagger API of the service is at `http://localhost:13000/osapi/swagger-ui/index.html`. + +There, you may try there various REST actions and authenticate via the OAuth server without the use of the UI. + + +### VNF/NSD Catalog Management and NSD Deployment WEB UI service + +The Web UI is written in AngularJS. + +Clone the repository: https://labs.etsi.org/rep/osl/code/org.etsi.osl.portal.web/-/tree/develop + +By default the project org.etsi.osl.portal.api exposes the folder ../org.etsi.osl.portal.web/src/ in a folder testweb (Check class MvcConfig.java in org.etsi.osl.portal.api) for development. (In production nginx is used). Point your browser to `http://localhost:13000/osapi/testweb/index.html/` + +## Version/release management + +Check this nice article on how we develop and release versions. + +https://nvie.com/posts/a-successful-git-branching-model/ + +We develop in the develop branch and follow a issue driven development model. + +--- +## Wishlist + +Check also our wishlist of new features. You can add your own. + +See [Wishlist](./wishlist.md). + + + + + + + + diff --git a/doc/contributing/wishlist.md b/doc/contributing/wishlist.md new file mode 100644 index 0000000000000000000000000000000000000000..de91c7741f0ed1a31bf6cd0e0802c2dccdf114aa --- /dev/null +++ b/doc/contributing/wishlist.md @@ -0,0 +1,59 @@ +# TMF API + +- RBAC of API endpoints +- TMF Ticketing API support +- TMF Product +- HATEOAS integration +- Select Specs that can be exposed to partners (maybe with a characteristic?) + +## resource management + +- Resource Activation and Configuration API TMF702 (NEW) (https://projects.tmforum.org/wiki/pages/viewpage.action?pageId=128855518) + +# TMF WEB + + +# OSOM + +- Actions on service order item and acknowledge order status will define the lifecycle +- action shutdown on specific date for service order +- action edit on service order item + +## Dynamic attribute transformation + +- DTM decision tables support per Service Specification +- Schedule Termination of completed order on running services + + + +# NFVO connectivity + +## OSM Client + +- VNF/NSD config params Day 2 +- NSD Lifcecylce +- NST support + +# NFV API + + +# NFV WEB + + +# 3rd party connectivity + +## FlowOne connector + + +## Openstack connector + + +## Kubernetes connector + + +# CentralLog + +- Events from TMF to be written to Central Log + +# Authentication + diff --git a/doc/deployment.md b/doc/deployment.md new file mode 100644 index 0000000000000000000000000000000000000000..df703d7c45cd06a954bcd341db50c587f4dbf5be --- /dev/null +++ b/doc/deployment.md @@ -0,0 +1,646 @@ +## Requirements + +### Hardware requirements: + + +| **Minimum Hardware Requirements** | **Recomended Hardware Requirements** | +| --------------------------------- | ------------------------------------ | +| 4 CPU cores | 8 CPU cores | +| 8 GB RAM | 16 GB RAM | +| 20 GB storage | 40 GB storage | + +### Software Requirements: + +* Docker (Docker Compose installation) +* Kubernetes (Kubernetes installation - experimental) + + +## Preparing the environment + +> See the [Kubernetes section](#Kubernetes-installation), if you would like to deploy OpenSlice in a Kubernetes cluster. + + +### 1. Backup your previous database if necessary: +```bash +sudo docker exec amysql /usr/bin/mysqldump -u root --password=letmein ostmfdb > backup_ostmfdb.sql +``` +### 2. Install docker + +> Since July 2023 Docker Compose V1 stopped receiving updates. OpenSlice fully reverted to Compose V2, which is integrated in the Docker installation. + +### 3. Configure containers to properly resolve the DNS of your domain (optional) + +``` +sudo nano /etc/docker/daemon.json +``` + +and add: + +``` +{ + "dns": ["8.8.8.8", "8.8.4.4"] +} +``` +After editing daemon.json restart docker daemon for the changes to take place + +```bash +sudo systemctl restart docker +``` + +## Downloading the project + +### 1. Create a new folder to download the project + +```bash +mkdir openslice +``` +```bash +cd openslice +``` + +### 2. Download the deployment script + +Download the deployment / environment preparation script + +```bash +wget https://labs.etsi.org/rep/osl/code/org.etsi.osl.main/-/raw/main/compose/deploy.sh +``` +Make it executable +```bash +sudo chmod +x deploy.sh +``` + +### 3. Run the deployment script + +OpenSlice is a multi repo project. This script selects the same branch for all repositories of the project to pull from. + +After that it builds the respective jar files locally and installs all the npm packages needed for the UI. + +If you run the script without selecting a branch the the main branch is going to be selected. + +We recommend: + +* main branch for the most stable experience and +* develop branch for an experience with the latest features (for develop branch installation, it is strongly advisable that you may as well follow the [develop documentation](https://osl.etsi.org/documentation/develop/deployment/)) + +```bash +sudo ./deploy.sh main #[or replace main with other branch name] +``` + +> **We recommend running the deploy.sh script with root permissions! In other case, some directories may not be accessible by the project building tools and hinder the smooth installation.** + + +## Configure docker-compose services + +### 1. Create configuration specific Docker Compose file from the template + +```bash +cd org.etsi.osl.main/compose/ +``` +```bash +sudo cp docker-compose.yaml.configure docker-compose.yaml +``` +### 2. Configure mysql-portal container *(optional)* + +1. In folder `org.etsi.osl.main/compose/mysql-init` edit the file `01-databases.sql`. +2. In the `org.etsi.osl.main/compose/docker-compose.yaml` edit the credentials of the users that services use to connect to the databases, if you wish. + * portaluser (default is 12345) and + * keycloak (default is password) + + +### 3. Configure keycloak container *(optional)* + +1. If you made changes to keycloak's mysql credentials: + + In folder `org.etsi.osl.main/compose/` edit the file `docker-compose.yaml`. + +``` +DB_DATABASE: keycloak +DB_USER: keycloak +DB_PASSWORD: password +``` + +2. If you want to change the keycloak admin password: + + In folder `org.etsi.osl.main/compose/` edit the file `docker-compose.yaml` + +``` +KEYCLOAK_PASSWORD: Pa55w0rd +``` + +### 4. Configure bugzilla container *(optional)* + +If you want to utilise the Bugzilla connector: + +In folder `org.etsi.osl.main/compose/` edit the file `docker-compose.yaml` + +``` +SPRING_APPLICATION_JSON: '{ + "spring.activemq.brokerUrl": "tcp://anartemis:61616?jms.watchTopicAdvisories=false", + "spring.activemq.user": "artemis", + "spring.activemq.password": "artemis", + "bugzillaurl":"", + "bugzillakey":"", + "main_operations_product":"" +}' +``` + +And add the provided Bugzilla installation information: + +``` +"bugzillaurl":"bugzillaurl.xx:443/bugzilla/", +"bugzillakey":"exampleKeyeqNNwxBlgxZgMEIne0Oeq0Bz", +"main_operations_product":"Main Site Operations" // this is the default product to issue tickets +``` + +Bugzilla should have the following components under the specified product: + +* NSD Deployment Request: Component used to schedule deployment req +* Onboarding: Issues related to VNF/NSD Onboarding +* Operations Support: Default component for operations support +* Validation: Use to track validation processes of VNFs and NSDs +* VPN Credentials/Access: Used for requesting VPN Credentials/Access + +Also in the 'Main Site Operations' product, a version named 'unspecified' must be created. + +### 5. Configure osportalapi container (NFV services) *(conditional)* + +Change the respective fields: + +- If you made changes to mysql and keycloak credentials. +- If you want to change logging level (TRACE / DEBUG / INFO / WARN / ERROR). + +> ***If you are using a non-local domain, replace everywhere the http://keycloak:8080 with the respective {{protocol://domain.name}}, as well as "spring.portal.main.domain" property.*** + +In folder `org.etsi.osl.main/compose/` edit the file `docker-compose.yaml` + +``` +SPRING_APPLICATION_JSON: '{ + "spring.datasource.username":"root", + "spring.datasource.password":"letmein", + "spring-addons.issuers[0].uri": "http://keycloak:8080/auth/realms/openslice", + "spring.security.oauth2.resourceserver.jwt.issuer-uri": "http://keycloak:8080/auth/realms/openslice", + "springdoc.oAuthFlow.authorizationUrl": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/auth", + "springdoc.oAuthFlow.tokenUrl": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/token", + "spring.portal.main.domain": "http://localhost", + "logging.level.org.springframework" : "INFO" +}' +``` + +### 6. osscapi container (TMF API service) *(conditional)* + +Change the respective fields: + +- If you made changes to mysql and keycloak credentials. +- If you want to change logging level (TRACE / DEBUG / INFO / WARN / ERROR). + +> **If you are using a non-local domain, replace everywhere the http://keycloak:8080 with the respective {{protocol://domain.name}}.** + +In folder `org.etsi.osl.main/compose/` edit the file `docker-compose.yaml` + +``` +SPRING_APPLICATION_JSON: '{ + "spring.datasource.username":"root", + "spring.datasource.password":"letmein", + "spring-addons.issuers[0].uri": "http://keycloak:8080/auth/realms/openslice", + "spring.security.oauth2.resourceserver.jwt.issuer-uri": "http://keycloak:8080/auth/realms/openslice", + "springdoc.oAuthFlow.authorizationUrl": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/auth", + "springdoc.oAuthFlow.tokenUrl": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/token", + "logging.level.org.springframework" : "INFO" +}' +``` + +## Configure nginx + +In folder `org.etsi.osl.main/compose/nginx` create a configuration specific `nginx.conf` file. + + +```bash +cd org.etsi.osl.main/compose/nginx/ +``` + +```bash +sudo cp nginx.conf.default nginx.conf +``` + +If needed, in the nginx.conf file, edit the server_name for an non-local deployment. + + + +## Configure Web UI + +In folder `org.etsi.osl.portal.web/src/js/` create a configuration specific `config.js` file. + +```bash +cd org.etsi.osl.portal.web/src/js +``` + +```bash +sudo cp config.js.default config.js +``` + +Edit the `config.js` file with the information of your domain + + +``` +{ + TITLE: "OpenSlice by ETSI", + WIKI: "https://openslice.readthedocs.io/en/stable/", + BUGZILLA: "ROOTURL/bugzilla/", + STATUS: "ROOTURL/status/", + APIURL: "http://localost:13000", + WEBURL: "ROOTURL/nfvportal", + APIOAUTHURL: "ROOTURL/auth/realms/openslice", + APITMFURL: "ROOTURL/tmf-api/serviceCatalogManagement/v4" +} +``` + +## Configure TMF Web UI + +In the folder `org.etsi.osl.tmf.web/src/assets/config` there are 3 files available for configuration: + +* config.prod.json (Basic information + API configuration) +* theming.scss (CSS color palette theming) +* config.theming.json (HTML configuration - Logo, Favicon, Footer) + + +The first 2 files above (i.e. config.prod.json, theming.scss) are essential for the successful deployment of OpenSlice, thus created automatically during the initial deployment at `org.etsi.osl.tmf.web/src/assets/config` directory as a copy of the default ones from the remote repository. + +Ensure that you check the `config.prod.json` and `theming.scss` files and readjust to your deployment if needed. + +```bash +# Starting from the root project directory +cd org.etsi.osl.tmf.web/src/assets/config +``` + +E.g. Edit "TITLE", "WIKI", etc properties with your domain title. Also configure TMF's API and Keycloak's location for the web application, if needed. + + +``` +{ + "TITLE": "OpenSlice by ETSI", + "PORTALVERSION":"2024-Q2 1.0.0-SNAPSHOT", + "WIKI": "https://osl.etsi.org/documentation", + "BUGZILLA": "{BASEURL}/bugzilla/", + "STATUS": "http://status.localhost/", + "WEBURL": "{BASEURL}", + "PORTAL_REPO_APIURL": "{BASEURL}/osapi", + "ASSURANCE_SERVICE_MGMT_APIURL": "{BASEURL}/oas-api", + "APITMFURL": "{BASEURL}/tmf-api", + "OAUTH_CONFIG" : { + "issuer": "{BASEURL}/auth/realms/openslice", + "loginUrl": "{BASEURL}/auth/realms/openslice/protocol/openid-connect/auth", + "tokenEndpoint": "{BASEURL}/auth/realms/openslice/protocol/openid-connect/token", + "userinfoEndpoint": "{BASEURL}/auth/realms/openslice/protocol/openid-connect/userinfo", + "redirectUri": "{BASEURL}/redirect", + "logoutUrl": "{BASEURL}/auth/realms/openslice/protocol/openid-connect/logout", + "postLogoutRedirectUri": "{BASEURL}", + + "responseType": "code", + "oidc": false, + "clientId": "osapiWebClientId", + "dummyClientSecret": "secret", + + "requireHttps": false, + "useHttpBasicAuth": true, + "clearHashAfterLogin": false, + + "showDebugInformation": true + } +} +``` + + +> The {BASEURL} placeholder in the file automatically detects the Origin (Protocol://Domain:Port) of the deployment and applies it to every respective property. E.g. If you are attempting a local deployment of Openslice, then {BASEURL} is automatically translated to "http://localhost". Similarly, you may use {BASEURL} to translate to a public deployment configuration, e.g. "https://portal.openslice.io". + +If further customization, apart from the default provided, is needed for branding (Logo, Footer) then `config.theming.json` needs to be created in io.openslice.tmf.web/src/assets/config directory, as follows: + +```bash +# Starting from the root project directory +cd org.etsi.osl.tmf.web/src/assets/config +``` + +```bash +sudo cp config.theming.default.json config.theming.json +``` + +> ***IMPORTANT NOTE:*** +If you want to apply changes to the JSON configuration files without the need to rebuild the application, you have to apply the changes at the `org.etsi.osl.tmf.web/dist/io-openslice-portal-web/assets/config` directory. Although, it is mandatory to also apply these changes to the `org.etsi.osl.tmf.web/src/assets/config` for persistancy, as after any future rebuild of OpenSlice the `/dist` directory is being overwritten along with its contents. The OpenSlice team strongly recommends to always apply your changes to the TMF web UI configuration files at `org.etsi.osl.tmf.web/src/assets/config` and rebuild the application. + +## Deploy OpenSlice via Docker Compose + +After configuring the services, and editing the docker compose file accordingly, the docker compose instantiation command can be performed. + +```bash +# Starting from the root project directory +cd org.etsi.osl.main/compose/ +``` + +```bash +sudo docker compose --profile prod down;sudo docker compose --profile prod up -d --build +``` + +> Depending on your machine, this process might take time. if for any reason the deployment fails during first time, please rerun the above before any further measures. + + +## Validating deployments and container monitoring + +You can monitor containers' status with portainer at port 9000 (http://your-ip:9000). + +Initially, you may monitor the local machine at portainer. + +Please check that all containers are in running state. + + +## Post installation steps + +After the successful deployment of OpenSlice, to ensure the E2E user experience, **this section is mandatory**. It contains crucial configuration in regard of authentication and user creation. + +### Configure Keycloak server + +The Keycloack server is managing authentication and running on a container at port 8080. It is also proxied to your host via nginx under http://localhost/auth. + +- Navigate to http://domain.com/auth/ or https://domain.com/auth/, (http://ipaddress:8080/auth/ or https://ipaddress:8443/auth/ which are directly accessible without proxy) + +- Navigate to Administration Console + +- Login with the credentials from section [Configure keycloak container](#3-configure-keycloak-container-optional). Default values are: + - user: admin and + - password: KEYCLOAK_PASSWORD + +> if you are running in HTTP you will get a message: HTTPS required. + +To resolve this issue when running in HTTP: + +- Select the master realm from top left corner +- Go to login Tab and select "Require SSL": None +- Repeat for realm Openslice + + +> If you are running in HTTPS, then "Require SSL" can be left unchanged to external requests. + +#### 1. Configure redirects + +Navigate to realm Openslice > client > osapiWebClientId and change the Root URL to your domain. + +Also, insert your domain, e.g. http://example.org/*, at: +* Valid Redirect URIs +* Web Origins + +#### 2. Configure email + +Keycloak allows new users to register. Subsequently, this will also allow new users to register to the OpenSlice portal. + +On Tab Login > check User registration, Verify email, Forgot password etc. + +Also, enter the details on Realm > Email > Enable Authentication. + +#### 3. Add an OpenSlice admin user + +This step is mandatory so as to access the OpenSlice Web UI. To add an OpenSlice admin user you must: +- Navigate to manage/users and add an OpenSlice admin user, e.g. username=admin. +- Set a password +- Navigate to Role Mappings and add ADMIN and MENTOR to Assigned Roles. + +> That user is different from the Keycloak admin user. It is required to login and browse the OpenSlice Web UI. The Roles ADMIN and MENTOR guarantee full access through the Openslice UI, thus such a user is always required. + +### Keycloak at localhost + +> **This is an important step if you run Keycloak on localhost!** + +1 - Edit your Hosts File, adding the line below + +```127.0.0.1 keycloak``` + +Hosts File Location: + + - In Linux/Unix, the file's location is at /etc/hosts + + - In Windows, its location is at c:\Windows\System32\Drivers\etc\hosts + +2 - Replace http://localhost/auth/ with http://keycloak:8080/auth/ in your Keycloak config for AngularJS and Angular (see examples below). + + +> Explanation + +Nginx uses the http://keycloak:8080 URL, which is accessible via the internal docker system's network. +The Front-end (TS/Angular) shall also use the http://keycloak:8080. +This way, you will not get the invalid token error, as the API is acquiring the token from http://keycloak:8080 (internally) and the Front-end is getting verified by an issuer at the same URL, as well. + + + +2.1 - For the Angular configuration (TMF portal UI), navigate to org.etsi.osl.tmf.web/src/assets/config and edit config.prod.json + +```bash +# Starting from the root project directory +cd org.etsi.osl.tmf.web/src/assets/config +``` + +```bash +nano config.prod.json +``` + +After editing it should look like the example bellow: + +```yaml +{ + "TITLE": "OpenSlice by ETSI", + "PORTALVERSION":"2023-Q3 1.2.0-SNAPSHOT", + "WIKI": "https://openslice.readthedocs.io/en/stable/", + "BUGZILLA": "{BASEURL}/bugzilla/", + "STATUS": "http://status.localhost/", + "WEBURL": "{BASEURL}", + "PORTAL_REPO_APIURL": "{BASEURL}/osapi", + "ASSURANCE_SERVICE_MGMT_APIURL": "{BASEURL}/oas-api", + "APITMFURL": "{BASEURL}/tmf-api", + "OAUTH_CONFIG" : { + "issuer": "http://keycloak:8080/auth/realms/openslice", + "loginUrl": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/auth", + "tokenEndpoint": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/token", + "userinfoEndpoint": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/userinfo", + "redirectUri": "{BASEURL}/redirect", + "logoutUrl": "http://keycloak:8080/auth/realms/openslice/protocol/openid-connect/logout", + "postLogoutRedirectUri": "{BASEURL}", + + "responseType": "code", + "oidc": false, + "clientId": "osapiWebClientId", + "dummyClientSecret": "secret", + + "requireHttps": false, + "useHttpBasicAuth": true, + clearHashAfterLogin": false, + + "showDebugInformation": true + } +} +``` + +> Note the difference in changing {BASEURL} -> http://keycloak:8080 + +> If you want the changes to take place immediately without rebuilding the project, then repeat the process for org.etsi.osl.tmf.web/dist/org.etsi.osl.tmf.web/assets/config/config.prod.json + +2.2 - For the AngularJS configuration (NVF portal UI), navigate to org.etsi.osl.portal.web/src/js and edit config.js + +```bash +# Starting from the root project directory +cd org.etsi.osl.portal.web/src/js +``` + +```bash +nano config.js +``` + +after editing it should look like the example bellow: + +``` +var appConfig = angular.module('portalwebapp.config',[]); + + +appConfig.factory('APIEndPointService', function() { + return { + TITLE: "OpenSlice by ETSI", + WIKI: "https://openslice.readthedocs.io/en/stable/", + BUGZILLA: "ROOTURL/bugzilla/", + STATUS: "ROOTURL/status/", + APIURL: "http://localost:13000", + WEBURL: "ROOTURL/nfvportal", + APIOAUTHURL: "ROOTURL/auth/realms/openslice", + APITMFURL: "ROOTURL/tmf-api/serviceCatalogManagement/v4" + }; +}); +``` + +> Note the difference in "APIOAUTHURL" property + + +### NFV Orchestrator Configuration + +After successfully deploying and configuring OpenSlice, you may configure its environment (e.g. the NFVO) that will facilitate the deployment of NFV artifacts. + +See [NFV Orchestrator Configuration](./nfvoconfig.md). + + +
+ +## Kubernetes installation + +Openslice can be installed in a Kubernetes cluster. + +**This is a work in progress, and should be used for stable deployments!**. + +Please reference "develop" tagged documentation for any latest progress. + +The related scripts are inside the kubernetes folder. Follow these steps along the lines. You need to configure the ingress properly depending on how you want to expose Openslice. + +1 - Create an openslice namespace + +```bash +kubectl create namespace openslice +``` + +2 - Apply or create an ingress. Ingress exposes HTTP and HTTPS routes from outside the cluster to services within the cluster. Traffic routing is controlled by rules defined on the Ingress resource. +An Ingress may be configured to give Services externally-reachable URLs, load balance traffic, terminate SSL / TLS, and offer name-based virtual hosting. An Ingress controller is responsible for fulfilling the Ingress, usually with a load balancer, though it may also configure your edge router or additional frontends to help handle the traffic. You must have an Ingress controller to satisfy an Ingress. +You may need to deploy an Ingress controller such as ingress-nginx. + +You can also adapt it to connect to public cloud load balancers depending on your needs. + +The following will expose an ingress resource from one of your a k8s nodes on port 80. + +```bash + kubectl apply -f openslice-ingress.yaml +``` + + +Finding the ingress IP: + + +```bash + +kubectl describe -f openslice-ingress.yaml + + +Name: openslice-ingress +Namespace: openslice +Address: 10.10.10.35 +Default backend: default-http-backend:80 () +Rules: + Host Path Backends + ---- ---- -------- + * + /services tmfweb:80 () + /tmf-api osscapi:13082 () + /auth keycloak:8080 () + /osapi osportalapi:13000 () + / portalweb:80 () +Annotations: kubernetes.io/ingress.class: nginx +Events: + Type Reason Age From Message + ---- ------ ---- ---- ------- + Normal Sync 9m29s (x2 over 9m58s) nginx-ingress-controller Scheduled for sync + +``` + +From the above example, our exposed ingress is at Address: 10.10.10.35 + +3 - We need to configure the expose address and deploy openslice (IP or URL e.g. http://myopenslice.xxx) + +```bash +./k8sdeploy.sh 10.10.10.35 +``` + + +4 - Check the status of Openslice in the cluster. Should be similar to the following: + +```bash + +kubectl get pods --namespace=openslice -o wide + +NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES +activemq-59d4bfdb4b-bvjqr 1/1 Running 0 109s 192.168.43.97 kc-2 +bugzilla-client-7dd7cb47cb-8qb8m 1/1 Running 0 100s 192.168.12.114 kc-3 +centrallog-95bbf7867-k8fpt 1/1 Running 0 100s 192.168.12.107 kc-3 +consul-b5dd76b76-64dzk 1/1 Running 0 107s 192.168.43.90 kc-2 +keycloak-7c5b6bbc95-k2qfl 1/1 Running 0 105s 192.168.12.106 kc-3 +manoclient-95f68f4c9-c9t6r 1/1 Running 0 104s 192.168.12.113 kc-3 +mysql-portal-0 1/1 Running 0 107s 192.168.43.99 kc-2 +osom-6d548cf555-q8ptj 1/1 Running 0 104s 192.168.43.93 kc-2 +osportalapi-5fff744db8-5g4zs 1/1 Running 0 103s 192.168.43.98 kc-2 +osscapi-6d68b54d97-jn8tz 0/1 Running 0 102s 192.168.12.104 kc-3 +portalweb-8469d57df4-94tfj 1/1 Running 0 101s 192.168.48.44 kc-nfs +tmfweb-868f7bb9c5-x4lfh 1/1 Running 0 102s 192.168.48.43 kc-nfs +``` +```bash +kubectl get deployments --namespace=openslice -o wide + +NAME READY UP-TO-DATE AVAILABLE AGE CONTAINERS IMAGES SELECTOR +activemq 1/1 1 1 2m15s anactivemq webcenter/activemq:5.14.3 org.etsi.osl.service=activemq +bugzilla-client 1/1 1 1 2m6s bugzilla-client openslice/org.etsi.osl.bugzilla:latest org.etsi.osl.service=bugzilla-client +centrallog 1/1 1 1 2m6s centrallog openslice/org.etsi.osl.centrallog.service org.etsi.osl.service=centrallog +consul 1/1 1 1 2m13s aconsul consul org.etsi.osl.service=consul +keycloak 1/1 1 1 2m11s keycloak quay.io/keycloak/keycloak:11.0.3 org.etsi.osl.service=keycloak +manoclient 1/1 1 1 2m10s manoclient openslice/org.etsi.osl.mano:latest org.etsi.osl.service=manoclient +osom 1/1 1 1 2m10s openslice-osom openslice/org.etsi.osl.osom:latest org.etsi.osl.service=osom +osportalapi 1/1 1 1 2m9s openslice-portalapi openslice/org.etsi.osl.portal.api:latest org.etsi.osl.service=osportalapi +osscapi 1/1 1 1 2m8s openslice-scapi openslice/org.etsi.osl.tmf.api:latest org.etsi.osl.service=osscapi +portalweb 1/1 1 1 2m7s openslice-portalweb openslice/org.etsi.osl.portal.web:latest org.etsi.osl.service=portalweb +tmfweb 1/1 1 1 2m8s openslice-tmfweb openslice/org.etsi.osl.tmf.web:latest org.etsi.osl.service=tmfweb +``` +```bash +kubectl get services --namespace=openslice -o wide + +NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE SELECTOR +activemq ClusterIP 10.111.160.120 8161/TCP,61616/TCP 2m22s org.etsi.osl.service=activemq +bugzilla-client ClusterIP 10.101.43.28 13010/TCP 2m14s org.etsi.osl.service=bugzilla-client +centrallog ClusterIP 10.109.15.151 13013/TCP 2m14s org.etsi.osl.service=centrallog +consul ClusterIP 10.101.103.240 8500/TCP,8600/TCP 2m21s org.etsi.osl.service=consul +keycloak ClusterIP 10.110.216.62 8080/TCP,8443/TCP 2m19s org.etsi.osl.service=keycloak +manoclient ClusterIP 10.108.112.84 13011/TCP 2m18s org.etsi.osl.service=manoclient +mysql-portal ClusterIP None 3306/TCP 2m19s org.etsi.osl.service=mysql-portal +osom ClusterIP 10.105.173.85 13100/TCP 2m18s org.etsi.osl.service=osom +osportalapi ClusterIP 10.104.121.164 13000/TCP 2m17s org.etsi.osl.service=osportalapi +osscapi ClusterIP 10.108.6.161 13082/TCP 2m16s org.etsi.osl.service=osscapi +portalweb ClusterIP 10.97.126.98 80/TCP 2m15s org.etsi.osl.service=portalweb +tmfweb ClusterIP 10.98.56.82 80/TCP 2m15s org.etsi.osl.service=tmfweb + +``` \ No newline at end of file diff --git a/doc/eclipse-java-google-style.xml b/doc/eclipse-java-google-style.xml new file mode 100644 index 0000000000000000000000000000000000000000..7bb6804eb39f988b43f6ac997d66c203272d4969 --- /dev/null +++ b/doc/eclipse-java-google-style.xml @@ -0,0 +1,337 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/images/LocalServiceOrchestrationProcess.png b/doc/images/LocalServiceOrchestrationProcess.png new file mode 100644 index 0000000000000000000000000000000000000000..2543ac37b71faeda2bc5988ad1640aa8d4fe789c Binary files /dev/null and b/doc/images/LocalServiceOrchestrationProcess.png differ diff --git a/doc/images/NFVODeploymentReq_process.png b/doc/images/NFVODeploymentReq_process.png new file mode 100644 index 0000000000000000000000000000000000000000..860a20f797acd1c4dce1ce48cc18a14b0dfeb6ca Binary files /dev/null and b/doc/images/NFVODeploymentReq_process.png differ diff --git a/doc/images/alarms_actions/action_rule_exampleday2.png b/doc/images/alarms_actions/action_rule_exampleday2.png new file mode 100644 index 0000000000000000000000000000000000000000..073e08224a4dd92e79d8323c5ff403c81ba54b81 Binary files /dev/null and b/doc/images/alarms_actions/action_rule_exampleday2.png differ diff --git a/doc/images/alarms_actions/day2actionspec.png b/doc/images/alarms_actions/day2actionspec.png new file mode 100644 index 0000000000000000000000000000000000000000..3e95537b08a1bff2db98bf6d177ade01add62b52 Binary files /dev/null and b/doc/images/alarms_actions/day2actionspec.png differ diff --git a/doc/images/architecture.png b/doc/images/architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..adf76473931f463e46d70ce8b9a6b9c488bf9d6b Binary files /dev/null and b/doc/images/architecture.png differ diff --git a/doc/images/architecture_ 2019-10-24.png b/doc/images/architecture_ 2019-10-24.png new file mode 100644 index 0000000000000000000000000000000000000000..12445339e443a12a4f39e0185c823f79b347da7c Binary files /dev/null and b/doc/images/architecture_ 2019-10-24.png differ diff --git a/doc/images/check_inProgress_orders.png b/doc/images/check_inProgress_orders.png new file mode 100644 index 0000000000000000000000000000000000000000..5d28abf380109bdf0a7654912747f7f87cf94185 Binary files /dev/null and b/doc/images/check_inProgress_orders.png differ diff --git a/doc/images/externalSPDeploymentReq.png b/doc/images/externalSPDeploymentReq.png new file mode 100644 index 0000000000000000000000000000000000000000..5438fdd051f6acb048e33188380db5b194886cd0 Binary files /dev/null and b/doc/images/externalSPDeploymentReq.png differ diff --git a/doc/images/favicon.png b/doc/images/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..3c71ab91aa15c554b3d9a228207938182cdefa00 Binary files /dev/null and b/doc/images/favicon.png differ diff --git a/doc/images/fetchPartnerServices.png b/doc/images/fetchPartnerServices.png new file mode 100644 index 0000000000000000000000000000000000000000..3e296db37290a28e22c462dc4448cc4b17a14388 Binary files /dev/null and b/doc/images/fetchPartnerServices.png differ diff --git a/doc/images/index_intro_architecture.png b/doc/images/index_intro_architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..635912d49ddc2c3b70b283b2139a8430b6a0e210 Binary files /dev/null and b/doc/images/index_intro_architecture.png differ diff --git a/doc/images/issue_management.png b/doc/images/issue_management.png new file mode 100644 index 0000000000000000000000000000000000000000..1fd7f3ef9991cd0f79ace3a3c89d5a470d3ccca6 Binary files /dev/null and b/doc/images/issue_management.png differ diff --git a/doc/images/lcm/lcmfig1.png b/doc/images/lcm/lcmfig1.png new file mode 100644 index 0000000000000000000000000000000000000000..b92f84e1b0ed0cf3509f7330581ae692187600d5 Binary files /dev/null and b/doc/images/lcm/lcmfig1.png differ diff --git a/doc/images/lcm/lcmfig10.png b/doc/images/lcm/lcmfig10.png new file mode 100644 index 0000000000000000000000000000000000000000..cf09ef445be678e26f3c4ce6ceb3e565beb653f5 Binary files /dev/null and b/doc/images/lcm/lcmfig10.png differ diff --git a/doc/images/lcm/lcmfig11.png b/doc/images/lcm/lcmfig11.png new file mode 100644 index 0000000000000000000000000000000000000000..9d344d761c9d8fd0cc2d1404d5ab1b43ecfd1681 Binary files /dev/null and b/doc/images/lcm/lcmfig11.png differ diff --git a/doc/images/lcm/lcmfig12.png b/doc/images/lcm/lcmfig12.png new file mode 100644 index 0000000000000000000000000000000000000000..79197901027c59ebacfdefaecc49e9034ba87a44 Binary files /dev/null and b/doc/images/lcm/lcmfig12.png differ diff --git a/doc/images/lcm/lcmfig13.png b/doc/images/lcm/lcmfig13.png new file mode 100644 index 0000000000000000000000000000000000000000..809848a4c4087c8d7305adfb2c929d616c0de558 Binary files /dev/null and b/doc/images/lcm/lcmfig13.png differ diff --git a/doc/images/lcm/lcmfig14.png b/doc/images/lcm/lcmfig14.png new file mode 100644 index 0000000000000000000000000000000000000000..cb3afe1747a16838bf9b0ae4f9bf1caf1d463508 Binary files /dev/null and b/doc/images/lcm/lcmfig14.png differ diff --git a/doc/images/lcm/lcmfig1_osom.png b/doc/images/lcm/lcmfig1_osom.png new file mode 100644 index 0000000000000000000000000000000000000000..ceee5261e9da4257069be451b28e5db3fd5378e9 Binary files /dev/null and b/doc/images/lcm/lcmfig1_osom.png differ diff --git a/doc/images/lcm/lcmfig2.png b/doc/images/lcm/lcmfig2.png new file mode 100644 index 0000000000000000000000000000000000000000..a664f77fc67ed25a32245c1ae6e1081be97b7849 Binary files /dev/null and b/doc/images/lcm/lcmfig2.png differ diff --git a/doc/images/lcm/lcmfig3.png b/doc/images/lcm/lcmfig3.png new file mode 100644 index 0000000000000000000000000000000000000000..2c3d2a1fb75dca83d3f470fb095f293aeadaaf7b Binary files /dev/null and b/doc/images/lcm/lcmfig3.png differ diff --git a/doc/images/lcm/lcmfig4.png b/doc/images/lcm/lcmfig4.png new file mode 100644 index 0000000000000000000000000000000000000000..e4f1f7c1f91620b8614783ab4a5b7df674e2d75e Binary files /dev/null and b/doc/images/lcm/lcmfig4.png differ diff --git a/doc/images/lcm/lcmfig5.png b/doc/images/lcm/lcmfig5.png new file mode 100644 index 0000000000000000000000000000000000000000..e16168aaad019450fe22a1c761c952d8c47570c5 Binary files /dev/null and b/doc/images/lcm/lcmfig5.png differ diff --git a/doc/images/lcm/lcmfig6.png b/doc/images/lcm/lcmfig6.png new file mode 100644 index 0000000000000000000000000000000000000000..2d9c8a985f545c9e41643ad82a3cb2fb3704d47a Binary files /dev/null and b/doc/images/lcm/lcmfig6.png differ diff --git a/doc/images/lcm/lcmfig7.png b/doc/images/lcm/lcmfig7.png new file mode 100644 index 0000000000000000000000000000000000000000..b3554530c7e94d96191257c8ac1609fabd14584a Binary files /dev/null and b/doc/images/lcm/lcmfig7.png differ diff --git a/doc/images/lcm/lcmfig8.png b/doc/images/lcm/lcmfig8.png new file mode 100644 index 0000000000000000000000000000000000000000..d3df01871b79890d111d5a20b1a881811b4b8a29 Binary files /dev/null and b/doc/images/lcm/lcmfig8.png differ diff --git a/doc/images/lcm/lcmfig9.png b/doc/images/lcm/lcmfig9.png new file mode 100644 index 0000000000000000000000000000000000000000..10b653fe894eeab9364bd21ca95f3fc2419080c8 Binary files /dev/null and b/doc/images/lcm/lcmfig9.png differ diff --git a/doc/images/logo_osl.png b/doc/images/logo_osl.png new file mode 100644 index 0000000000000000000000000000000000000000..e6eb89a7da94edc6ea26dcb1972d9e101b0dffee Binary files /dev/null and b/doc/images/logo_osl.png differ diff --git a/doc/images/logo_osl_square.png b/doc/images/logo_osl_square.png new file mode 100644 index 0000000000000000000000000000000000000000..37cbc4ba60771e54c3ea2f18fa89a7e3af387360 Binary files /dev/null and b/doc/images/logo_osl_square.png differ diff --git a/doc/images/logo_osl_square_non_transp.png b/doc/images/logo_osl_square_non_transp.png new file mode 100644 index 0000000000000000000000000000000000000000..a7f8684e95a987b15dacb02675bd3ac9ec7ed091 Binary files /dev/null and b/doc/images/logo_osl_square_non_transp.png differ diff --git a/doc/images/microservices_network_deployment.png b/doc/images/microservices_network_deployment.png new file mode 100644 index 0000000000000000000000000000000000000000..5087c9a5ad03dad4285c515827b0ecc81e7ba7de Binary files /dev/null and b/doc/images/microservices_network_deployment.png differ diff --git a/doc/images/multi-domain-architecture.png b/doc/images/multi-domain-architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..e66685567979a2e4de8a42efb751ff5691c8c405 Binary files /dev/null and b/doc/images/multi-domain-architecture.png differ diff --git a/doc/images/multi-domain-organizations.png b/doc/images/multi-domain-organizations.png new file mode 100644 index 0000000000000000000000000000000000000000..461bffcc70c8ddea609ef594b459975f6fb2f47b Binary files /dev/null and b/doc/images/multi-domain-organizations.png differ diff --git a/doc/images/openslice_logo.png b/doc/images/openslice_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..2fa5efc135209ce66cee07ea7a76dc0a4cff9244 Binary files /dev/null and b/doc/images/openslice_logo.png differ diff --git a/doc/images/openslice_logo_old.png b/doc/images/openslice_logo_old.png new file mode 100644 index 0000000000000000000000000000000000000000..61a38a515223bb67a78da6694c34dbe08c89e942 Binary files /dev/null and b/doc/images/openslice_logo_old.png differ diff --git a/doc/images/order_scheduler_bpm.png b/doc/images/order_scheduler_bpm.png new file mode 100644 index 0000000000000000000000000000000000000000..dab22ad2ae255167795967cb74cdb26dd6191393 Binary files /dev/null and b/doc/images/order_scheduler_bpm.png differ diff --git a/doc/images/order_scheduler_diagram.png b/doc/images/order_scheduler_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..e732812b568387200832946cdfc571049de6ef64 Binary files /dev/null and b/doc/images/order_scheduler_diagram.png differ diff --git a/doc/images/osm_ecosystem_ossbss.png b/doc/images/osm_ecosystem_ossbss.png new file mode 100644 index 0000000000000000000000000000000000000000..5db4c1dead6f732348268710b116f7318424fd61 Binary files /dev/null and b/doc/images/osm_ecosystem_ossbss.png differ diff --git a/doc/images/service_order_initial_state.png b/doc/images/service_order_initial_state.png new file mode 100644 index 0000000000000000000000000000000000000000..931ec7b43cdd59a43ec8d204d99ab0ef82e2913b Binary files /dev/null and b/doc/images/service_order_initial_state.png differ diff --git a/doc/images/service_order_states.png b/doc/images/service_order_states.png new file mode 100644 index 0000000000000000000000000000000000000000..b609a78c2c871da7064e70adb5680c8ce5612255 Binary files /dev/null and b/doc/images/service_order_states.png differ diff --git a/doc/images/service_specification_instantiation.png b/doc/images/service_specification_instantiation.png new file mode 100644 index 0000000000000000000000000000000000000000..4bdaea9b5ac8702a2dfd801d7c85669c8cba8a97 Binary files /dev/null and b/doc/images/service_specification_instantiation.png differ diff --git a/doc/images/service_states.png b/doc/images/service_states.png new file mode 100644 index 0000000000000000000000000000000000000000..582f6de14e7a3a2673e28b46e6263231aad407c7 Binary files /dev/null and b/doc/images/service_states.png differ diff --git a/doc/images/start_order_process_bpm.png b/doc/images/start_order_process_bpm.png new file mode 100644 index 0000000000000000000000000000000000000000..c16355cf30212e3aa511ef8fcd53baab315f0777 Binary files /dev/null and b/doc/images/start_order_process_bpm.png differ diff --git a/doc/images/start_order_process_diagram.png b/doc/images/start_order_process_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..4c225e5efb33e4771d0160dec86bcbea01507f21 Binary files /dev/null and b/doc/images/start_order_process_diagram.png differ diff --git a/doc/images/vinni_sb_model_diagram.png b/doc/images/vinni_sb_model_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..463b5082b12ab02481cd54f4056743eb1f9be1dd Binary files /dev/null and b/doc/images/vinni_sb_model_diagram.png differ diff --git a/doc/index.md b/doc/index.md new file mode 100644 index 0000000000000000000000000000000000000000..e8c0cbc224a790cb4d22acc2ef3d2a0fdf3b1de3 --- /dev/null +++ b/doc/index.md @@ -0,0 +1,134 @@ +drawing + +version: 2023Q4 - Release 0 + +The ETSI Software Development Group for OpenSlice (SDG OSL) is developing an open source service based Operations Support System (OSS) to deliver Network Slice as a Service (NSaaS) following specifications from major SDOs including ETSI, TM Forum and GSMA. See more details [here](https://osl.etsi.org/about/). + + +## Usage + +OpenSlice allows Vertical Customers to browse the available offered service specifications and also allows NFV developers to onboard and manage VNF and Network Service artifacts. It also supports TMFORUM OpenAPIs regarding Service Catalog Management, Ordering, Resource, etc. +The following figure displays the usage of OpenSlice. + +[![OpenSlice usage](./images/index_intro_architecture.png)](./images/index_intro_architecture.png) + + +There are two portals offering UI friendly access to users: + +* The Services portal allows users to access services and service providers to design services. +* The NFV portal allows users to self-manage NFV artifacts and onboard them to a target MANO/NFV Orchestrator. + +3rd party applications can use OpenSlice through TMForum Open APIs. + +Service Specifications reside into Service Catalogs, grouped in Categories. OpenSlice offers a Service Orchestrator called [OSOM](./architecture/osom.md). OSOM instantiates Service Specifications by requesting Network Services from target MANOs/NFVOs. NFV artifacts reside into a VNF/NSD catalog and are onboarded to a target MANO/NFV Orchestrator. Service Specifications reference NSD from the VNF/NSD catalog. + +Customers make Service Orders and OpenSlice instantiates the requested Service Specifications of the Service Order. Running Services instantiated by OpenSlice, reside in OpenSlice Service Inventory. The following picture displays how Service Specifications are related to Running Services and how Running Services relate with instantiated running Network Services. (See also [Service Inventory](./service_inventory.md)) + +[![OpenSlice Service Specification instantiation](./images/service_specification_instantiation.png)](./images/service_specification_instantiation.png) + +## Service Lifecycle Rules + +OpenSlice constains support for defining rules of services, affecting their behavior. See [LCM Rules](./lcm.md). + +## Multidomain scenarios and federation + +OpenSlice can be used to exchange service specifications/catalogs and make service orders between Organizations as the following figure displays. + +[![OpenSlice Service Specification instantiation](./images/multi-domain-organizations.png)](./images/multi-domain-organizations.png) + +An Identity federation is also possible since our authentication service is based on Keycloak (see [OAuth](./architecture/oauth.md)). + +See more on [Consuming Services From External Partner Organizations](./architecture/consumingServicesFromExternalPartners.md). + + +## Live Demo + +* OpenSlice demo: +* OpenSlice Service Catalogs and ordering: +* OpenSlice NFV Services onboarding: +> username=admin, password=openslice
or
username=admin, password=changeme + + +## Video demo + +* + +--- + +## Installing + +See [Deployment/Installation](./deployment.md). + +--- + +## Hardware requirements + +The complete environment consists of microservices deployed as docker containers. Portainer is also installed to monitor them at port 9000. + +If you would like to operate all APIs, OSOM, the Mysql Server, nginx, etc then you need at least: + +| **Minimum Hardware Requirements** | **Recomended Hardware Requirements** | +| --------------------------------- | ------------------------------------ | +| 4 CPU cores | 8 CPU cores | +| 8 GB RAM | 16 GB RAM | +| 20 GB storage | 40 GB storage | + + +(NOTE: Bugzilla or ELK are not included and we assume they run elsewhere) + +However, you may try the front facing services of OpenSlice with a minimum installation on a VM on a laptop with: + +- 2 cores +- 4GB of RAM + + + +## Supported APIs + +Quick overview of the supported APIs through our Swagger links: + +* [TMF APIs](http://portal.openslice.io/tmf-api/swagger-ui/index.html) +* [API for VNF/NSD management](http://portal.openslice.io/osapi/swagger-ui/index.html) + +## Source code + +OpenSlice source code is available at [OSL GitLab repository](https://labs.etsi.org/rep/osl/code). + +## Contributing + +You may contribute following the guidelines at [Contributing page](./contributing/developing.md). + +## Social Media + +* [Twitter](https://twitter.com/OpensliceOSS) +* [Slack](https://openslice.slack.com) + +## History + +* The NFV portal part of OpenSlice was initially developed in H2020 European Research project [5GinFIRE](https://5ginfire.eu) by University of Patras, Greece +* OpenSlice core services, APIs was further developed and maintained in H2020 European project [5G-VINNI](https://5g-vinni.eu/) by University of Patras, Greece +* OpenSlice has been a part off OSM's OSS/BSS ecosystem + + +[![Part of OSM Ecosystem](./images/osm_ecosystem_ossbss.png)](https://osm.etsi.org/wikipub/index.php/OSS_BSS) + +## Ecosystem + +Discover the current OpenSlice ecosystem [here](https://osl.etsi.org/ecosystem/). + +## Citation + +Please cite our [![paper]](https://arxiv.org/abs/2102.03290) if you use Openslice + +``` + +@misc{tranoris2021openslice, + title={Openslice: An opensource OSS for Delivering Network Slice as a Service}, + author={Christos Tranoris}, + year={2021}, + eprint={2102.03290}, + archivePrefix={arXiv}, + primaryClass={cs.NI} +} + +``` \ No newline at end of file diff --git a/doc/lcm.md b/doc/lcm.md new file mode 100644 index 0000000000000000000000000000000000000000..b668b908c58da2c6972e11a0b6ca50450fd02176 --- /dev/null +++ b/doc/lcm.md @@ -0,0 +1,158 @@ +# Lifecycle Management (LCM) Rules + +* NOTE: This is a prototype/experimental feature. So issues might raise during operation + +LCM Rules are used for defining complex conditions and actions during the lifecycle of a service. In Openslice there are four types of rules defined: + +* PRE_PROVISION +* CREATION +* AFTER_ACTIVATION +* SUPERVISION +* AFTER_DEACTIVATION + + +The following figure displays the different phases that the rules are performed, during the lifecycle of a Network Slice Instance. + +[![Rules in NSI](../images/lcm/lcmfig1.png)](../images/lcm/lcmfig1.png) + +* PRE_PROVISION rules: Run only once just before creating a service with a given priority. +* CREATION rules: Run while the referenced service dependencies of a service are created +* AFTER_ACTIVATION rules: Run only once just after a service get the ACTIVE state +* SUPERVISION rules: Run when a characteristic of a service is changed and the service is in the ACTIVE state +* AFTER_DEACTIVATION rules: Run only once just after a service get the INACTIVE/TERMINATED state + +In general the rules allow to perform many actions during service LCM. Thes are some examples: + +* Modify service specification parameters before the instantiation of a service (or during operation) based on other dependencies. These parameters might be part of other services already included in Service order +* Translate GST/NEST parameter values to other values passed later to NFVO for instantiation or control +* Define complex OSM Configs based on other dependencies and passing variables +* Define any dependencies when creating the referenced services +* Dynamically include new service dependencies +* Create new service orders so include dynamically other services +* Call external (RESTful) services (via http(s), define payload, examine response) + + + + +## Examine if the rules are executed successfully + +Rules are transformed automatically to executable code (currently is Java). If a rule is performed successfully or has any issues (e.g. unexpected syntax errors or exceptions) appear in OSOM logfiles and also tey are attached as Notes to the running Service. + +## LCM Rules and OSOM Service Orchestration + +OSOM is the responsible service for executing the rules on a specific phase. The following image explains the design in the BPMN phases: + + +[![Rules](../images/lcm/lcmfig1_osom.png)](../images/lcm/lcmfig1_osom.png) + + + +## Define rules + +Rules are defined when designing a Service Spec. Here is an example of a list of rules: + + +[![lcmrules](../images/lcm/lcmfig2.png)](../images/lcm/lcmfig2.png) + +Execution order of rules on a specific phase is random + +* NOTE: There is a priority field. The lower the number the highest the priority of rule execution. For example Rule with priority 0 will run before rule with priority 1. + + +### Definition language + +* The visual language that Openslice used is based on Google's Blockly (see https://developers.google.com/blockly) +* The blockly graph is automatically translated to Java internally and then dynamically executed during orchestration phases. + +The following figure is an example of such a rule design. The rule for example will run in PRE_PROVISION phase: + +[![lcmrules](../images/lcm/lcmfig3.png)](../images/lcm/lcmfig3.png) + +* The goal of the above rule is to properly define a variable AreaCodes given the chosen AreaOfService from a Service Order. +* On the right side the user can define some rule properties or observe the underlying generated java code. + + +## The blocks library + +The following images describe some blocks found in the library. + +Blockly has syntax rules. It helps with colours to define them. + +So for example a parameter that is a Number cannot be "glued" with a String. Will need some conversion first + +[![lcmrules](../images/lcm/lcmfig4.png)](../images/lcm/lcmfig4.png) +[![lcmrules](../images/lcm/lcmfig5.png)](../images/lcm/lcmfig5.png) +[![lcmrules](../images/lcm/lcmfig6.png)](../images/lcm/lcmfig6.png) +[![lcmrules](../images/lcm/lcmfig7.png)](../images/lcm/lcmfig7.png) +[![lcmrules](../images/lcm/lcmfig8.png)](../images/lcm/lcmfig8.png) + +## Examples of Rules + + +The following images provide some examples of rules. + +### define variables according to cases + +In the following example we : + +* define a String variable. +* Then according to the Area of Service selected from the Service Order of the Service Specification we need to define it properly. +* We output the value to the OSOM Log +* Define dynamically the value of another parameter (This is fictional) and then do some other condition check + +The strAreaCodes could be passed then e.g. to NFVO for instantiation of services to these cells. + + +[![lcmrules](../images/lcm/lcmfig9.png)](../images/lcm/lcmfig9.png) + + + +### Define complex OSM configs for DAY 0 + +The following displays some complex examples for defining the parameters to pass to the NFV. In this case is OSM. + +* NOTE: The OSM_CONFIG characteristic of a service is the one that it is used in orchestration to instantiate NS from OSM + +* check the variable strTargetsParam. It is passed to the variable strOsmConfig3 which is executed if the Number of Cameras is more than 100. +* if the Video quality requested is 3, then the Maximum Namber of camers will be 8. Check the OSM detailed configuration block and its syntax. +* if the Video quality requested is 2, we use a simpler OSM Config block to configure the parameter OSM_CONFIG. We just injected a json text ( watch the Escape of the string for the Quotes!) +* if the Video quality requested is 1, again we use a simpler OSM Config block to configure the parameter OSM_CONFIG. We use as injected json text a variable constructed later + + +[![lcmrules](../images/lcm/lcmfig10.png)](../images/lcm/lcmfig10.png) + + +### Define and instantiate different services according to Service Order request + +In the following example we would like to offer a service either as Platinum, Gold or Silver. Depending on the selection we need to instantiate different services. + +There are different ways to accomplish this: + +* create dynamically New Service Orders of RFSs with equivalent quality of Services +* change for example the VIMs that you deploy the NS +* change the NSD (that is use different VNFs) + +The following image displays for example the latter case. + +[![lcmrules](../images/lcm/lcmfig11.png)](../images/lcm/lcmfig11.png) + + +### Call an external RESTful service + +This is useful in cases for example of alarms , external logging, calling other services e.g. email or even a complex algorithm written in other language e.g. call an external service and get a result. (service e.g. a Python service) + + +[![lcmrules](../images/lcm/lcmfig12.png)](../images/lcm/lcmfig12.png) + +[![lcmrules](../images/lcm/lcmfig13.png)](../images/lcm/lcmfig13.png) + +### Create New Service Orders + +The following example calls to Order a New Service Specification with specific Parameter Values + +[![lcmrules](../images/lcm/lcmfig14.png)](../images/lcm/lcmfig14.png) + + + + + diff --git a/doc/lcmrules_main.pu b/doc/lcmrules_main.pu new file mode 100644 index 0000000000000000000000000000000000000000..7616cc5a93a268d9996f88c19fe94924994e49cd --- /dev/null +++ b/doc/lcmrules_main.pu @@ -0,0 +1,24 @@ +@startuml + +note + Notes + ---- + Each LCM rule might be executed during the following phases: + "Pre-provision phase" + "Activation phase" + "Supervision phase", + "De-activation phase" + + A rule may: + 1) Modify some parameters of the requested service according to user request. + These parameters might be part of other services (or related resources?) already included in Service order + 2) Modify the service order by including other services + 3) Initiate new Service Orders for Other Services (including their parameters) + 4) May call external services (e.g. via REST) +end note + +start +stop + + +@enduml \ No newline at end of file diff --git a/doc/nfvcatalogs.md b/doc/nfvcatalogs.md new file mode 100644 index 0000000000000000000000000000000000000000..ad055840d65abfe337af4a5b60a3e7e10097ec42 --- /dev/null +++ b/doc/nfvcatalogs.md @@ -0,0 +1,42 @@ +# NFV Services + +NFV Services are managed through a dedicate UI the NFV portal (eg http://portal.openslice.io/nfvportal) + +Users are able through this portal to manage their NFV artifacts towards the NFVO, ( for example onboard VNFs and NSDs to a target OSM) + + +Openslice NFV Services target to accommodate the following envisaged user roles. All users are assumed to be Authenticated: + +* NFV developer: This role is responsible to upload VNF and NSD Descriptors in the Openslice services towards NFVO like OSM +* Services administrator: This role represents the user that are responsible for maintenance of the Openslice services + +(obsolete: ) + +* Testbed provider: This role represents users that are responsible for testbed administration, configuration, integration, adaptation, support, etc +* Experimenter: This role represents the user that will utilize our services and tools to deploy an experiment. That is the experiment description in terms of e.g.: NSD (Network Service Descriptor) or TOSCA Specification (in future versions) + + +Finally an anonymous user role exists who has some really simple usage scenarios (e.g. signup through the portal) + + +During the onboarding process the following occurs: + +• A NFV developer submits a NFV archive (VNF or NSD) (he can later manage if needed some metadata) +• The administrator can manage the NFV artifact (e.g. edit it) +• The administrator On-Boards the NFV artifact to the target MANO +• The administrator can optionally mark the NFV: +o As public in order to be publicly visible by all portal users +o As Certified which means this is certified by a certain entity + + +## Request a new NSD deployment (this is different in comparison to Services) + + +A developer requests a new network service deployment (which NSD, tentative dates, target infrastructure, etc.). The request is marked as UNDER_REVIEW + +* The administrator is notified about the new request and he has the following options: +* Schedule the deployment for the requested dates or propose other dates. The request is marked as SCHEDULED +* Reject the request for some reason. The Request is marked as REJECTED +* Deploy the request to target VIM(s). The Request is marked as RUNNING +* Finalize the deployment and release resources. The Request is marked as COMPLETED +* every change of the request-lifecycle the experimenter is notified. \ No newline at end of file diff --git a/doc/nfvoconfig.md b/doc/nfvoconfig.md new file mode 100644 index 0000000000000000000000000000000000000000..91efd366f981905fa7cd16fdf3838b2c6954c4ed --- /dev/null +++ b/doc/nfvoconfig.md @@ -0,0 +1,19 @@ +# NFV Orchestrator configuration + +NOTE: Currently we support Open Source MANO version SEVEN/EIGHT/TEN/ELEVEN. Later versions of OSM may also be supported by the existing configuration, as from OSM 9+ the project converged to the SOL005 interface, regarding the NBI, and SOL006 (YANG model), regarding the NFV/NSD packaging. Also an implementation of a generic SOL005 interface is supported, but not extensively tested. + +Configuration of your target(s) NFVOs/MANO services with Openslice is performed through the NFV portal. + +Login to http://yourdomain/nfvportal/ + +Navigate to Admin->Manage MANO Platforms and pick one of the supported MANO platform(s), e.g. Name=OSMvTEN, Version=OSMvTEN and save + +Navigate to Admin->Manage MANO providers and enter a New MANO Provider: + +* Name whatever you wish +* API URL Endpoint, eg: https://10.10.10.10:9999 (This is the SOL005 NBI endpoint) +* Username, password and Project of your OSM tenant. + +Check EnabledForONBOARDING, so when users onboard VNFs/NSDs they will be automatically ONBOARDED to this MANO. If left unchecked, the onboarding must be performed manually after the VNF/NSD is uploaded to the portal. + +Check EnabledForSYNC, if you want to support MANO->Openslice auto synchronization. When enabled, the existing VNFs/NSDs and VIMs (and any updates on them) of the registered MANO are also reflected to the portal. \ No newline at end of file diff --git a/doc/service_inventory.md b/doc/service_inventory.md new file mode 100644 index 0000000000000000000000000000000000000000..480b92f111424c67ab3b4efbba089f4339ddb732 --- /dev/null +++ b/doc/service_inventory.md @@ -0,0 +1,39 @@ +# Service Inventory + +After a Service Order completion, active services with their additional characteristics are found: + +* From the Order Items of a selected Service order +* from the menu of Service inventory and then selecting details of each service +* through the Service Inventory API (TMF 638 - Service Inventory Management ) + + +Openslice creates a Service for the requested CFS. Customers make Service Orders and Openslice instantiates the requested Service Specifications for each Service Order Item of a Service Order. Running Services instantiated by Openslice, reside in Openslice Service Inventory. The following picture displays how Service Specifications are related to Running Services and how Running Services relate with instantiated running Network Services. + + +[![Openslice Service Specification instantiation](./images/service_specification_instantiation.png)](./images/service_specification_instantiation.png) + + +There is a hierarchy of services. Usually an Instantiated CFS has Supporting Services some Instantiated RFSs. Then an Instantiated RFS is related to some running NS managed by NFVO + + +## Interacting with an Active Service (Day 2 config) + +In some cases, if the underlying service is configured with actions (for example in OSM Day 2 primitive actions), there are characteristics that can be modified. Usually they are named like : ::Primitive:: + +The user can edit the characteristic with a new value. The value is propagated through the OSOM and NFVO down to the related VNF. + +## Terminating/Inactivating a service + +You can terminate the service with one of the following processes: + +* Select the related Service Order and terminate the Order Item. This will delete all the underlying related active services. The Order goes to ACKNOWLEDGED->INPROGRESS->COMPLETE +* To terminate or inactivate a service, select the specific service from the inventory, press Edit and set the State either to Inactive or Terminated + +Warning: if you terminate or inactivate a service the action cannot be undone. + + +## uml: sequence diagram +Here I will embed PlantUML markup to generate a sequence diagram. + +I can include as many plantuml segments as I want in my Markdown, and the diagrams can be of any type supported by PlantUML. + diff --git a/doc/so_ServiceCreationProcess.pu b/doc/so_ServiceCreationProcess.pu new file mode 100644 index 0000000000000000000000000000000000000000..d5404da18d1f2d2ad279583c6c3f0151c56dace0 --- /dev/null +++ b/doc/so_ServiceCreationProcess.pu @@ -0,0 +1,106 @@ +@startuml + + +start + +:create Underl Service for ServiceSpecification and for ServiceSpecRelationships; +:Create Service in RESERVED; +->human accepts; +:Service has state=RESERVED; + +:Process Create Rules; +repeat :for each service reference + :decide what to create; + if (anyNotCreatedSupportingServices[!allSupportingServicesCreatedAndActive]) then (yes) + if (allSupportingServicesCreated ) then (yes) + :wait a few seconds; + else + partition "**process** Create Service" { + } + endif + endif + +repeat while + +:Automation Check; + note right: allSupportingServicesCreatedAndActive +note + Automation Check process + ---- + //Automation Check process + decides which + services can be automatically + handled by NFVO + or can be managed + by external partner// +end note + + + + if ( partnerOrg != null ) then (yes) + :createServiceByServiceSpec + AUTOMATICALLY_MANAGED; + :execute any LCM rules "PRE_PROVISION" phase; + partition "**process** External Service Provider Deployment Request" { + :Submit Order To External Service Provider; + :Check external service order fulfilment; + } + else if ( "CustomerFacingServiceSpecification" && isIsBundle) then (yes) + :createServiceByServiceSpec + AUTOMATICALLY_MANAGED; + :copy characteristics from Service Order Item; + :copy the rest of characteristics from Service Spec; + :execute any LCM rules "PRE_PROVISION" phase; + :create the related Service Instance; + note + the underlying actual + running service + is not created here. + this spec is not an RFS + end note + partition "**process** Local Service Orchestration" { + :Local Service Orchestration; + :Check Service Deployment Task; + } + else if ( CustomerFacingServiceSpecification) && (specrel.findSpecCharacteristicByName("OSAUTOMATED") ) then + :createServiceByServiceSpec + AUTOMATICALLY_MANAGED; + :execute any LCM rules "PRE_PROVISION" phase; + else if ( ResourceFacingServiceSpecification ) then + :createServiceByServiceSpec + AUTOMATICALLY_MANAGED; + :copy characteristics from Service Order Item; + :copy the rest of characteristics from Service Spec; + :execute any LCM rules "PRE_PROVISION" phase; + :create the related Service Instance; + note + the underlying actual + running service + is not created yet + but is propaged + to NFVO next + if there is an NSD + end note + if ( specrel.findSpecCharacteristicByName( "NSDID" ) != null ) then + :servicesHandledByNFVOAutomated.add(createdServ.getId()); + else + :servicesLocallyAutomated.add(createdServ.getId()); + endif + partition "**process** NFVO Deployment Request" { + :NFVO RFS Task; + :Check service deployment; + } + else + :createServiceByServiceSpec + (sor, soi, specrel, EServiceStartMode.MANUALLY_BY_SERVICE_PROVIDER, null);; + partition "**process** User Task Manual Complete Service" { + :UserOrderCompleteService; + } + endif + + + :Evaluate Created Services Task ; + + +stop +@enduml \ No newline at end of file diff --git a/doc/so_activity_main.pu b/doc/so_activity_main.pu new file mode 100644 index 0000000000000000000000000000000000000000..bd108c37e734207d49ae605d498311a568d6353a --- /dev/null +++ b/doc/so_activity_main.pu @@ -0,0 +1,48 @@ +@startuml + + +start + +:Check for service orders; +->human accepts; +:Order is changed from INITIAL to ACKNOWLEDGED; +stop + +start +-> TIMER; +:Fetch Acknowledged Orders; +-> List of ordersToBeProcessed; +:Initialize Process Order; +note right: Each order is INPROGRESS +partition "**process** Start Order Process" { + note + Start Order Process + ---- + //Start Order Process// + end note + :Find Order Items; + repeat :for each ServiceOrderItem + + partition "**process** Process Order Item" { + :ProcessOrderItemActionCheck; + if (ServiceOrderActionType.ADD) then (yes) + :Action Add; + :CreateServiceProcess; + + + else if (ServiceOrderActionType.MODIFY) then (yes) + :Action MODIFY; + else if (ServiceOrderActionType.DELETE) then (yes) + :Action DELETE; + endif + :Process OrderItemComplete; + + } + repeat while + +} + + + +stop +@enduml \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000000000000000000000000000000000000..a3cb2d20b9beebf2d1667116965ff90878eb1325 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,95 @@ +# Project information +site_name: ETSI SDG OCF Documentation +site_description: ETSI SDG OCF Documentation page +site_author: OpenCAPIF by ETSI +site_url: https://ocf.etsi.org/ + +# Repository +repo_name: OCF GitLab +repo_url: https://labs.etsi.org/rep/ocf +edit_uri: "" +docs_dir: doc + +# edit_uri: edit/docs-revamp/docs/ +# edit_uri: blob/docs-revamp/docs/ + +# remote_name: origin +# remote_branch: gh-pages + +# Theme and overrides, i.e. language partial +# https://squidfunk.github.io/mkdocs-material/creating-your-site/ +theme: + name: material + + # Don't include MkDocs' JavaScript + #include_search_page: false + #search_index_only: true + + # Default values, taken from mkdocs_theme.yml + language: en +# feature: +# tabs: true + features: + - navigation.instant + - navigation.instant.progress + - navigation.top + - navigation.footer + - navigation.path + - search + - search.highlight + + palette: + primary: 'cyan' + accent: 'blue' + + logo: 'images/logo_osl.png' + favicon: images/favicon.png + + icon: + repo: fontawesome/brands/gitlab + +# Copyright +copyright: "Copyright © 2019-2024 OpenCAPIF Project" + +# Options +extra: +# search: +# languages: "en" + social: + - icon: fontawesome/solid/globe + link: https://ocf.etsi.org/ + - icon: fontawesome/brands/gitlab + link: https://labs.etsi.org/rep/ocf + - icon: fontawesome/brands/linkedin + link: https://www.linkedin.com/company/opencapif/ + - icon: fontawesome/brands/x-twitter + link: https://twitter.com/OpenCAPIF + version: + provider: mike + +# Page tree +nav: + - Overview: + - Introduction: index.md + - Getting Started: + - Deployment/Installation: deployment.md + - NFV Orchestrator Configuration: nfvoconfig.md + - Service Catalogs: catalogs.md + - NFV Catalogs: nfvcatalogs.md + - LCM Rules: lcm.md + - Consuming Services From External OSS: ./architecture/consumingServicesFromExternalPartners.md + - Service Inventory: service_inventory.md + - Alarms and Actions: alarms_actions.md + - Design & Architecture: + - Architecture: ./architecture/architecture.md + - Message bus: ./architecture/messagebus.md + - OSOM: ./architecture/osom.md + - Authentication: ./architecture/oauth.md + - TMF API: ./architecture/tmfapi.md + - NFV API: ./architecture/nfvapi.md + - TMF WEB: ./architecture/tmfweb.md + - NFV WEB: ./architecture/nfvweb.md + - Issue management: ./architecture/issuemgt.md + - Central logging: ./architecture/centrallog.md + - Contributing: + - Developing: ./contributing/developing.md