summaryrefslogtreecommitdiffstats
path: root/nokiav2/docs/onboarding.rst
diff options
context:
space:
mode:
authorDenes Nemeth <denes.nemeth@nokia.com>2018-05-25 23:29:02 +0200
committerDenes Nemeth <denes.nemeth@nokia.com>2018-05-28 09:14:38 +0200
commit9d6a50cd9c6f369d3bb712cfbe870a102f285c13 (patch)
tree32e13d405c1b6be69affffc9ad733b3d5055af44 /nokiav2/docs/onboarding.rst
parent1dca0e2ef23d1d51e4d2b2f6675aeaa7320d44f6 (diff)
Documentation update
Change-Id: I1ce9d4a9eb71dd5796a703118e11668ee164abd1 Signed-off-by: Denes Nemeth <denes.nemeth@nokia.com> Issue-ID: VFC-728
Diffstat (limited to 'nokiav2/docs/onboarding.rst')
-rw-r--r--nokiav2/docs/onboarding.rst462
1 files changed, 390 insertions, 72 deletions
diff --git a/nokiav2/docs/onboarding.rst b/nokiav2/docs/onboarding.rst
index 4abf8faf..3380e438 100644
--- a/nokiav2/docs/onboarding.rst
+++ b/nokiav2/docs/onboarding.rst
@@ -1,150 +1,468 @@
-Onboard NS
-==========
+On-board NS
+===========
+
+The following section describes how to create an E2E service.
Create licensing model
----------------------
+The following section will create a license model. The license model is required for onboarding a VNF.
- Log into ONAP portal with designer role (cs0008)
- - Create License model
+- Select SDC from the application
+
+- Select ONBOARD
+
+- Click on CREATE NEW VLM
+
+- Specify the name of the license <licenseName>
+
+- Specify the description of the license
+
+- Select Entitlement pools from left
+
+- Click on ADD ENTITLEMENT POOL on right
+
+ - Specify the name (can be anything)
+
+ - Click on SAVE
+
+- Select License key groups from left
+
+- Click on ADD LICENSE KEY GROUP
+
+ - Specify the name (can be anything)
+
+ - Select universal type
+
+ - Click on SAVE
+
+- Select Feature groups from left
+
+- Click on ADD FEATURE GROUP
+
+ - Specify the name (can be anything) <featureGroup>
+
+ - Set 123456 as part number
+
+ - Set 123456 as manufacturer reference number
+
+ - Click on entitlement pools in middle
- - ONBOARD / Create new VLM
+ - Add previously created entitlement pool with arrow button
- - name = select a name easy to remember
+ - Click on license key groups in middle
- - Entitlement pool / add new Entitlement pool
+ - Add previously created license key group with arrow button
- - name = any
+ - Click on SAVE
- - License key group / add new license key group
+- Select License agreements from left
- - name = any
+- Click on ADD LICENSE AGREEMENT on right
- - type = universal
+ - Specify the name (can be anything)
- - Feature groups / add feature group
+ - Select unlimited license term
- - name = any
+ - Click on feature groups
- - part number = 123456
+ - Add previously created feature group with arrow button
- - manufacturer reference number = 123456
+- Click on the submit button on top right
- - entitlement pool (add any with arrow button)
+Prepare the ETSI configuration JSON
+-----------------------------------
- - license key group (add any with arrow button)
+The ETSI configuration of VF is the information gap that is required to instantiate a VNF, but this information is not
+provided by the VF-C component to the VNFM. The ETSI configuration is a JSON serialized into a string, which is specified
+as a VF property during VF design time.
- - save
+The JSON has the following root elements:
- - License agreements / Add license agreement
+- vimType: The type of the VIM
- - name = any
+- instantiationLevel: The initial instantiation level of the VNF.
- - license term unlimited
+- computeResourceFlavours: The collection of compute flavors.
- - feature groups (add any with arrow button)
+- zones: The collection of availability zones.
- - Check in (lock icon at top)
+- softwareImages: The collection of software images.
+
+- extManagedVirtualLinks: The collection of externally managed virtual links.
+
+- externalConnectionPointAddresses: Addresses of the external connection points.
+
+- extVirtualLinks: The collection of external virtual links.
+
+- extensions: The collection of VNF properties
+
+- additionalParams: Additional parameters passed during instantiation to the VNFM.
+
+- domain: The domain of the OpenStack cloud (only available in Amsterdam)
- - Submit (tick icon at top)
On-board VNF
------------
- - On-board / Create new VSP (vendor software package)
+The following section requires the CSAR and the ETSI configuration of the VNF to be available as a prerequisite.
- - Create VSP
+- Log into ONAP portal with designer role (cs0008)
- - name = select a name easy to remember
+- Select SDC from the application
- - vendor = name of the license model
+- Select ONBOARD
- - category = Database (IMPORTANT NOT TO CHANGE THIS (linked to the global customer))
+- Click on CREATE NEW VSP
- - onboarding procedure = network package
+ - Specify a the name of the VNF <vnfPackageName> (ex. vnf_simple_20180526_1)
- - description = any
+ - Select the previously created license model as vendor
- - Upload CSAR
+ - Select Database (General) for the category. It is important to select a category that has been linked to the customer.
- - overview / software product attachments / select file
+ - Select network package for onboarding procedure
- - Select licence
+ - Specify description
- - overview / software product details / license agreement
+ - Click on CREATE
- - licenses
+- Click on SELECT FILE from SOFTWARE PRODUCT ATTACHMENTS and upload the CSAR file
- - set license version, license agreement, feature groups
+- Click on General on the left
- - click on save icon at top
+ - Select 1.0 as for licensing version under LICENSES
- - commit & submit using icons at top
+ - Select the previously created license agreement <licenseName>
- - Create VF
+ - Select the previously created feature group <featureGroup>
- - home / import / import vsp (select VSP from list)
+ - Click on save icon at top right
- - set General / Vendor model number to CBAM package VNFD ID
+ - Click on Submit icon at top right
- - set sVNFM property assignment / inputs / nf_type set NokiaSVNFM
+- Select HOME using the small arrow left from ONBOARD at top
- - commit
+- Hoover over the import icon and select Import VSP
- - submit for testing
+- Select the created VSP from the list by name <vnfPackageName>
- - Test VF
+- Click on import VSP icon
- - Log in as tester role
+ - Set the CBAM VNF package identifier as the Vendor model number on left bottom
- - Select VF
+ - Click on create on top right
- - Start testing button
+- Click on Properties assignment on left
- - Accept testing
+ - Click on Inputs
-Design network service
-----------------------
+ - Specify NokiaSVNFM for the nf_type property
+
+ - Specify the ETSI configuration JSON for the etsi_config property
+
+ - Click on Save on the middle
+
+- Click on Check in
+
+- Search for the created VNF using the search box at top right <vnfPackageName>
+
+- Click on the VF
+
+- Click on submit for testing at top right
+
+- Log out using the small person icon at top right
+
+- Log in with tester role (jm0007)
+
+- Select SDC from the application
+
+- Search for the created VNF using the search box at top right <vnfPackageName>
+
+- Click on Start testing
+
+- Click on Accept
+
+- Log out using the small person icon at top right
+
+
+Design a network service
+------------------------
+
+The following section design a network service. The prerequisite is that the tested VF package is available.
+
+- Log into ONAP portal with designer role (cs0008)
+
+- Select SDC from the application
+
+- Select HOME
+
+- Hoover over the Add icon and select add service
+
+ - Specify the name of the network service <nsName> (ex. ns_simple_20180526_1)
+
+ - Specify 123456 ad project code
+
+ - Specify description
+
+ - Select Network Service for the category
+
+ - If the network service is missing from the list
+
+ - Log in as demo user and select SDC
+
+ - Click on Create
+
+ - Click on Composition at left
+
+ - Search for the created VF using the search box at top left <vnfPackageName>
+
+ - Drag the VF icon to middle
+
+ - Wait for the icon to appear at the middle (only drag once)
+
+ - Click on the icon on the middle
+
+ - Click on very small pencil icon at top right
+
+ - Specify the name of the VF
+
+ - Click on check in
+
+ - Search for the created NS using the search box at top right <nsName>
+
+ - Click on the NS icon
+
+ - Click on Submit for testing
+
+- Log out using the small person icon at top right
+
+- Log in with tester role (jm0007)
+
+ - Select SDC from the application
+
+ - Search for the created VNF using the search box at top right <vnfPackageName>
+
+ - Click on Start testing
+
+ - Click on Accept
+
+ - Log out using the small person icon at top right
+
+- Log in with tester role (gv0001)
+
+ - Select SDC from the application
+
+ - Search for the created VNF using the search box at top right <vnfPackageName>
+
+ - Click on Approve on top right
+
+ - Log out using the small person icon at top right
+
+- Log in with operation role (op0001)
+
+ - Select SDC from the application
+
+ - Search for the created VNF using the search box at top right <vnfPackageName>
+
+ - Click on Distribute on top right
+
+ - Click on monitor in an order to verify that the distribution was successful
+
+ - Click on the small arrow next to the Distribution ID
+
+ - The list should contain at least two lines staring with sdc and aai-ml
+
+ - If the list does not contain enough elements it can be refreshed with the small icon at middle right
+
+ - Each of the two lines should contain a green check sign next to Deployed
+
+ - Log out using the small person icon at top right
+
+
+
+Design a VF for the E2E service
+-------------------------------
+
+This step is only required if the UUI is planed to be used to manage the E2E service. The VF of the E2E service is
+a wrapper to be able to treat the created NS as a VF. The prerequisite of this step is that the network service was
+successfully distributed.
+
+- Determine the UUIDs of the created NS in previous step
+
+ - Using a REST client of your choice, send a request to the following URL: https://sdc.api.simpledemo.onap.org:8443/sdc/v1/catalog/services
+
+ - HTTP method: GET
+
+ - Set the following values in the Header of the request:
+
+ - basic auth SDC:SDC
+
+ - X-ECOMP-InstanceID: VFC
+
+ - Accept: application/json
+
+ - Search for the created service by name <nsName> and note the uuid and invariantUUID fields
+
+- Log in with designer role (cs0008)
+
+ - Select SDC from the application
+
+ - Select HOME
+
+ - Hoover over the Add icon and select add VF
+
+ - Specify the name of the VF <vfForNsName> (ex. vf_for_ns_simple_20180526_1_vIMS)
+
+ - the name must contain the vIMS character sequence (even if this is not an IMS)
+
+ - Specify something for the Vendor
+
+ - Specify any numeric value for the Vendor Release
+
+ - Specify something for description
+
+ - Select Network Service for the category
+
+ - Click on Create on top right
+
+ - Click on Composition at left
+
+ - Search for the NSD using the search box at top left
+
+ - Drag the NSD icon to middle
+
+ - Wait for the icon to appear at the middle (only drag once)
+
+ - Click on the icon on the middle
+
+ - Click on very small pencil icon at top right
+
+ - Specify the name of the NSD (ex. firstNsd ) <nsdName>
+
+ - Click on the name of the VF next to HOME at top
+
+ - Select Properties Assignment
+
+ - Select the check box before providing_service_uuid and providing_service_invariant_uuid properties
+
+ - Click on Declare at right
+
+ - Click on Inputs at middle
+
+ - Specify the UUID of the service (that was determined in previous step) for the <nsdName>_providing_service_uuid property
+
+ - Specify the invariant UUID of the service (that was determined in previous step) for the <nsdName>_providing_service_invariant_uuid property
+
+ - Click on Save
+
+ - Click on Check in
+
+ - Search for the created VF using the search box at top right <vfForNsName>
+
+ - Click on the VF icon
+
+ - Click on Submit for testing
+
+- Log out using the small person icon at top right
+
+- Log in with tester role (jm0007)
+
+ - Select SDC from the application
+
+ - Search for the created VNF using the search box at top right <vfForNsName>
+
+ - Click on Start testing
+
+ - Click on Accept
+
+ - Log out using the small person icon at top right
+
+
+Design a E2E service
+--------------------
+
+This step is only required if the UUI is planed to be used to manage the E2E service. The prerequisite of this step is that the VF
+wrapping the network service is tested.
+
+- Log in with designer role (cs0008)
+
+ - Select SDC from the application
+
+ - Select HOME
+
+ - Hoover over the Add icon and select add Service
+
+ - Specify the name of the NS <e2eNsName> (ex. e2e_simple_20180526_1)
+
+ - Specify any numeric value for the Project Code
+
+ - Specify something for description
+
+ - Select E2E Service for the category
+
+ - Click on Create on top right
+
+ - Click on Composition at left
+
+ - Search for the created VF using the search box at top left <vfForNsName>
+
+ - Drag the VF icon to middle
+
+ - Wait for the icon to appear at the middle (only drag once)
+
+ - Click on the name of the NS next to HOME at top
+
+ - Click on Check in
+
+ - Search for the created NS using the search box at top right <e2eNsName>
+
+ - Click on the NS icon
+
+ - Click on Submit for testing
+
+- Log out using the small person icon at top right
- - Create Service
+- Log in with tester role (jm0007)
- - Log in with designer role (cs0008)
+ - Select SDC from the application
- - home / add / add service
+ - Search for the created NS using the search box at top right <e2eNsName>
- - name = select a name easy to remember
+ - Click on Start testing
- - project code = 123456
+ - Click on Accept
- - Check in & check out (required to save a safe point to restore to if something goes wrong)
+ - Log out using the small person icon at top right
- - Add created VF (Composition)
+- Log in with tester role (gv0001)
- - drag icon to main picture (be patient only drag once, if multiple icons appear restart procedure )
+ - Select SDC from the application
- - Check in
+ - Search for the created VNF using the search box at top right <e2eNsName>
- - Open service again and verify that the VF is part of the service under composition
+ - Click on Approve on top right
- - Submit for testing
+ - Log out using the small person icon at top right
- - Test Service
+- Log in with operation role (op0001)
- - Log in with tester role (jm0007)
+ - Select SDC from the application
- - start testing & accept
+ - Search for the created VNF using the search box at top right <e2eNsName>
- - Approve service
+ - Click on Distribute on top right
- - Log in with governance role (gv0001)
+ - Click on monitor in an order to verify that the distribution was successful
- - Select service and press approve
+ - Click on the small arrow next to the Distribution ID
- - Distribute the service
+ - The list should contain at least two lines staring with sdc and aai-ml
- - Log in with operations role (op0001)
+ - If the list does not contain enough elements it can be refreshed with the small icon at middle right
- - Select service and push distribute
+ - Each of the two lines should contain a green check sign next to Deployed
- - Click on monitor (verify that the state of the service is distributed)
+ - Log out using the small person icon at top right