summaryrefslogtreecommitdiffstats
path: root/docs/guides/onap-user/design/resource-onboarding
diff options
context:
space:
mode:
authorandreasgeissler <andreas-geissler@telekom.de>2019-06-05 21:14:56 +0200
committerEric Debeau <eric.debeau@orange.com>2019-06-08 17:23:53 +0000
commit3502b06eab742bfc484b50f60e3cebb55294d942 (patch)
treee66bc823af43925bac6f0e186874f85f913f4ad5 /docs/guides/onap-user/design/resource-onboarding
parent6d44ad39b9edc4e40163ab465df07856248e1a58 (diff)
Added PNF support in Onboarding and VF Creation
Issue-ID: DOC-473 Signed-off-by: andreasgeissler <andreas-geissler@telekom.de> Change-Id: I0a5be07fda257a0bd9b5d069da544920e81b3f5a
Diffstat (limited to 'docs/guides/onap-user/design/resource-onboarding')
-rw-r--r--docs/guides/onap-user/design/resource-onboarding/index.rst144
1 files changed, 100 insertions, 44 deletions
diff --git a/docs/guides/onap-user/design/resource-onboarding/index.rst b/docs/guides/onap-user/design/resource-onboarding/index.rst
index 592651ee2..56f6b6e18 100644
--- a/docs/guides/onap-user/design/resource-onboarding/index.rst
+++ b/docs/guides/onap-user/design/resource-onboarding/index.rst
@@ -6,7 +6,8 @@
Resource Onboarding
===================
-**Goal:** Add models and other artifacts required to create, configure, instantiate, and manage a VF and, optionally, a VFC.
+**Goal:** Add models and other artifacts required to create, configure,
+ instantiate, and manage a VF and, optionally, a VFC.
**Tool:** SDC
@@ -30,14 +31,19 @@ After updating the artifacts in a VSP, also update:
|image1|
+.. _doc_guide_user_des_res-onb_cre-lic:
+
Create a License Model
----------------------
-VSPs optionally require a license and entitlements to enable the service provider to track the usage.
+VSPs optionally require a license and entitlements to enable the service
+provider to track the usage.
-Note: For interim saving while creating the license model and its components, click |image2|
+Note: For interim saving while creating the license model and its components,
+click |image2|
-**Prerequisites:** To obtain license information, contact the service provider's Supply Chain Management (SCM) group.
+**Prerequisites:** To obtain license information, contact the service
+ provider's Supply Chain Management (SCM) group.
|image3|
@@ -45,25 +51,31 @@ Note: For interim saving while creating the license model and its components, cl
#. Hover over Add and select New License Model.
#. Complete all fields.
#. Click *Save*.
-#. In the ONBOARD header, hover over the arrow after License Agreements to reveal a menu.
+#. In the ONBOARD header, hover over the arrow after License Agreements to
+ reveal a menu.
Select the following options in order:
- #. Create 0 or more license key groups (see `Create a License Key Group [Optional]`_).
+ #. Create 0 or more license key groups (see
+ `Create a License Key Group [Optional]`_).
#. Create 1 or more entitlement pools (see `Create an Entitlement Pool`_).
#. Create 1 or more feature groups (see `Create a Feature Group`_).
#. Create 1 or more license agreements (see `Create a License Agreement`_).
- Note: Perform all steps above before submitting the license model to the SDC catalog.
+ Note: Perform all steps above before submitting the license model to
+ the SDC catalog.
#. In the header, click the license model created in steps 1 to 4.
#. Click *Check In* to save changes.
-#. Click *Submit* to add the license model to the catalog. A success message displays.
-#. After creating a license, complete `Create a Vendor Software Product`_ to add the VSP required for the associated VF.
+#. Click *Submit* to add the license model to the catalog. A success message
+ displays.
+#. After creating a license, complete `Create a Vendor Software Product`_ to
+ add the VSP required for the associated VF.
Create a License Key Group [Optional]
-------------------------------------
-If required by the resource model, create one or more license key groups; otherwise the license key group is optional.
+If required by the resource model, create one or more license key groups;
+otherwise the license key group is optional.
**Prerequisites:** `Create a License Model`_
@@ -79,7 +91,9 @@ If required by the resource model, create one or more license key groups; otherw
Create an Entitlement Pool
--------------------------
-**Prerequisites:** If required by the resource model, create one or more license key groups (see `Create a License Key Group [Optional]`_).
+**Prerequisites:** If required by the resource model, create one or more
+ license key groups (see
+ `Create a License Key Group [Optional]`_).
|image5|
@@ -94,7 +108,8 @@ Create a Feature Group
**Prerequisites:** Create one or more:
-* license key groups if required by the resource model (see `Create a License Key Group [optional]`_)
+* license key groups if required by the resource model
+ (see `Create a License Key Group [optional]`_)
* entitlement pools (see `Create an Entitlement Pool`_)
|image6|
@@ -114,24 +129,29 @@ Create a Feature Group
Create a License Agreement
--------------------------
-**Prerequisites:** Create one or more feature groups (see `Create a Feature Group`_).
+**Prerequisites:** Create one or more feature groups
+ (see `Create a Feature Group`_).
|image7|
1. From the drop-down menu, select License Agreements.
2. Click *Add License Agreement*.
The Create New License Agreement box displays.
-3. On the General tab, complete required fields (mandatory fields are marked by a red asterisk).
+3. On the General tab, complete required fields (mandatory fields are marked
+ by a red asterisk).
4. Click *Feature Groups*.
5. If not selected, click *Available Feature Groups*.
6. Select one or more groups and click the right arrow.
7. Click *Save*.
8. Return to step 5 of `Create a License Model`_ to complete the license model.
+.. _doc_guide_user_des_res-onb_cre-vsp:
+
Create a Vendor Software Product
--------------------------------
-Create one or more Vendor Software Products (VSPs) as the building blocks for VFs.
+Create one or more Vendor Software Products (VSPs) as the building blocks
+for VFs.
.. note::
For interim saving while creating a VSP, click |image2|
@@ -139,7 +159,7 @@ Create one or more Vendor Software Products (VSPs) as the building blocks for VF
**Prerequisites:**
* `Create a License Model`_
-* Generate manifest and package artifacts.
+* Existing VNF HEAT package or VNF/PNF CSAR/Zip package
#. From the SDC HOME page, click *ONBOARD*.
#. Hover over Add and select New Vendor Software Product.
@@ -149,19 +169,25 @@ Create one or more Vendor Software Products (VSPs) as the building blocks for VF
The Overview section is displayed.
.. note::
- A warning is displayed under License Agreement if the VSP does not have an associated license.
+ A warning is displayed under License Agreement if the VSP does not have
+ an associated license.
#. Click *Software Product Details* (left pane).
|image8|
-#. In order, select a licensing version, a license agreement, and one or more feature groups.
-#. [Optional] Complete other fields, such as Availability (high-availability zones) and Storage
- Data Replication (requirement for storage replication), as required.
+#. In order, select a licensing version, a license agreement, and one or more
+ feature groups.
+#. [Optional] Complete other fields, such as Availability (high-availability
+ zones) and Storage Data Replication (requirement for storage replication),
+ as required.
#. In Software Product Attachments (right pane), click *Select file*.
-#. Locate a Heat .zip package and click *Open*.
- SDC validates the files in the package. After successful validation, SDC displays the files
- and a success message. If validation fails, SDC displays the errors in the files.
+#. In case of a VNF HEAT file: Locate the Heat .zip package and click *Open*.
+ In case of a VNF or PNF CSAR file: Locate the VNF or PNF csar/.zip package
+ and click *Open*.
+#. SDC validates the files in the package. After successful validation, SDC
+ displays the files and a success message. If validation fails, SDC displays
+ the errors in the files.
Example Heat errors:
@@ -169,64 +195,94 @@ Create one or more Vendor Software Products (VSPs) as the building blocks for VF
#. Click *Check In* to save the changes.
#. Click *Submit* to add the VSP to the catalog.
-#. A success message is displayed. If the VSP attachments contain errors, an error message is displayed instead. Fix the issue(s) and re-submit.
-#. To configure VFCs associated with the VSP, see `Update VFCs in a VSP [optional]`_, below.
+#. A success message is displayed. If the VSP attachments contain errors, an
+ error message is displayed instead. Fix the issue(s) and re-submit.
+#. To configure VFCs associated with the VSP, see
+ `Update VFCs in a VSP [optional]`_, below.
+
+.. _doc_guide_user_des_res-onb_upd-vfc:
Update VFCs in a VSP [optional]
-------------------------------
-If required, configure Virtual Function Components (VFCs) associated with a VSP, such as the Hypervisor, VM recovery details, and cloning. VFCs are listed on the Components tab.
+If required, configure Virtual Function Components (VFCs) associated with a
+VSP, such as the Hypervisor, VM recovery details, and cloning. VFCs are listed
+on the Components tab.
.. note::
- All fields are optional. Answers to questionnaires are stored as metadata only on the SDC platform.
+ All fields are optional. Answers to questionnaires are stored as metadata
+ only on the SDC platform.
-**Prerequisites:** Add one or more VSPs (see `Create a Vendor Software Product`_).
+**Prerequisites:** Add one or more VSPs
+ (see `Create a Vendor Software Product`_).
#. From the SDC HOME page, click *ONBOARD* and search for a VSP.
#. In the Overview section, click *Check Out*.
#. In Components (bottom pane), click a VFC (VSP component).
The component links display in the left pane.
-#. Click *General* to view and edit general parameters such as hypervisor, image format, VM recovery details, and DNS configuration.
-#. Click *Compute* to view and edit VM parameters such as the number of VMs required for a VFC instance and persistent storage/volume size.
-#. Click *High Availability & Load Balancing* to answer questions related to VM availability and load balancing.
-#. Click *Networks* to view or edit parameters related to network capacity and interfaces.
+#. Click *General* to view and edit general parameters such as hypervisor,
+ image format, VM recovery details, and DNS configuration.
+#. Click *Compute* to view and edit VM parameters such as the number of VMs
+ required for a VFC instance and persistent storage/volume size.
+#. Click *High Availability & Load Balancing* to answer questions related
+ to VM availability and load balancing.
+#. Click *Networks* to view or edit parameters related to network capacity
+ and interfaces.
.. note::
- Click an interface to view or edit it. A dialog box displays similar to the figure below.
+ Click an interface to view or edit it. A dialog box displays similar
+ to the figure below.
|image10|
-#. Click *Storage* to configure storage information, such as backup type, storage size, and logging.
-#. Click *Process Details*, click *Add Component Process Details*, and complete the Create New Process Details dialog box. Use Process Details to identify the processes and configuration associated with VFCs.
+#. Click *Storage* to configure storage information, such as backup type,
+ storage size, and logging.
+#. Click *Process Details*, click *Add Component Process Details*, and complete
+ the Create New Process Details dialog box. Use Process Details to identify
+ the processes and configuration associated with VFCs.
#. Click *Monitoring* to upload MIB or JSON files for SNMP traps and polling.
#. Click *Overview* and click *Check In* to save changes.
-#. If updating a VSP, click *Submit*. If this procedure is performed during the workflow to create a VSP, there is no need to click *Submit* now.
+#. If updating a VSP, click *Submit*. If this procedure is performed during the
+ workflow to create a VSP, there is no need to click *Submit* now.
+
+.. _doc_guide_user_des_res-onb_upd-vsp:
Update a VSP [optional]
-----------------------
Upload a new Heat package to a VSP. Afterward, update the VF and service.
-**Prerequisites:** Add one or more VSPs (see `Create a Vendor Software Product`_).
+**Prerequisites:** Add one or more VSPs
+ (see `Create a Vendor Software Product`_).
#. From the SDC HOME page, click *ONBOARD* and search for a VSP.
#. In the Overview section, click *Check Out*.
#. In Software Product Attachments (right pane), click *Select file*.
-#. Locate a Heat .zip package and click *Open*.
+#. In case of a VNF HEAT file: Locate the Heat .zip package and click *Open*.
+
+ In case of a VNF or PNF CSAR file: Locate the VNF or PNF csar/.zip package
+ and click *Open*.
+
SDC warns that uploading a new package erases existing data.
-#. Click *Continue* to upload the new Heat package.
- SDC validates the files in the package. After successful validation, SDC displays the files and a success message. If validation fails, SDC displays the errors in the files.
+#. Click *Continue* to upload the new package.
+ SDC validates the files in the package. After successful validation, SDC
+ displays the files and a success message. If validation fails, SDC displays
+ the errors in the files.
.. note::
- If the Heat template contains errors, contact the Certification Group for guidance on how to proceed.
+ If the Heat template contains errors, contact the Certification Group for
+ guidance on how to proceed.
#. Click *Check In* to save changes.
#. Click *Submit* to add the VSP to the catalog.
- A success message is displayed. If the VSP attachments contain errors, an error message is displayed instead. Fix the issue(s) and re-submit.
+ A success message is displayed. If the VSP attachments contain errors, an
+ error message is displayed instead. Fix the issue(s) and re-submit.
#. After updating the VSP:
- #. Upload the VSP to the VF (see steps 3 to 5 in (TBD)Update a VF [optional]).
- #. Update the VF version in services that include the VF (see step 4 in (TBD) Update a service [optional]).
+ #. Upload the VSP to the VF
+ (see steps 3 to 5 in :ref:`doc_guide_user_des_vf-cre`).
+ #. Update the VF version in services that include the VF (see step 4
+ in :ref:`doc_guide_user_des_ser-des`).
.. |image0| image:: media/sdro-resource-onboarding-workflow.png