Change OpenO by ONAP 71/18871/1
authorEric Debeau <eric.debeau@orange.com>
Sat, 14 Oct 2017 07:18:19 +0000 (07:18 +0000)
committerEric Debeau <eric.debeau@orange.com>
Sat, 14 Oct 2017 07:21:02 +0000 (07:21 +0000)
Change-Id: If0c75e10bee78e79e1c9c74e5b00dd293e24314a
Issue-ID: DOC-103
Signed-off-by: Eric Debeau <eric.debeau@orange.com>
docs/Chapter4.rst
docs/Chapter5.rst

index da9f622..2aa951d 100644 (file)
@@ -270,7 +270,7 @@ Integration and operation within a robust security environment is necessary and
 * R-85633 The VNF **MUST** implement Data Storage Encryption (database/disk encryption) for Sensitive Personal Information (SPI) and other subscriber identifiable data. Note: subscriber’s SPI/data must be encrypted at rest, and other subscriber identifiable data should be encrypted at rest. Other data protection requirements exist and should be well understood by the developer.
 * R-92207 The VNF **SHOULD** implement a mechanism for automated and frequent "system configuration (automated provisioning / closed loop)" auditing.
 * R-23882 The VNF **SHOULD** be scanned using both network scanning and application scanning security tools on all code, including underlying OS and related configuration. Scan reports shall be provided. Remediation roadmaps shall be made available for any findings.
-* R-46986 The VNF **SHOULD** have source code scanned using scanning tools (e.g., Fortify) and provide reports. 
+* R-46986 The VNF **SHOULD** have source code scanned using scanning tools (e.g., Fortify) and provide reports.
 * R-55830 The VNF **MUST** distribute all production code from NCSP internal sources only. No production code, libraries, OS images, etc. shall be distributed from publically accessible depots.
 * R-99771 The VNF **MUST** provide all code/configuration files in a “Locked down” or hardened state or with documented recommendations for such hardening. All unnecessary services will be disabled. Vendor default credentials, community strings and other such artifacts will be removed or disclosed so that they can be modified or removed during provisioning.
 * R-19768 The VNF **SHOULD** support L3 VPNs that enable segregation of traffic by application (dropping packets not belonging to the VPN) (i.e., AVPN, IPSec VPN for Internet routes).
@@ -308,7 +308,7 @@ Identity and Access Management Requirements
 * R-95105 The VNF **MUST** host connectors for access to the application layer.
 * R-45496 The VNF **MUST** host connectors for access to the OS (Operating System) layer.
 * R-05470 The VNF **MUST** host connectors for access to the database layer.
-* R-77737 The VNF **MUST** 
+* R-77737 The VNF **MUST**
 * R-99174 The VNF **MUST** comply with Individual Accountability (each person must be assigned a unique ID) when persons or non-person entities access VNFs.
 * R-42874 The VNF **MUST** comply with Least Privilege (no more privilege than required to perform job functions) when persons or non-person entities access VNFs.
 * R-71787 The VNF **MUST** comply with Segregation of Duties (access to a single layer and no developer may access production without special oversight) when persons or non-person entities access VNFs.
@@ -504,7 +504,7 @@ Data Protection Requirements
 d. VNF Modularity
 =================
 
-ONAP Heat Orchestration Templates: Overview 
+ONAP Heat Orchestration Templates: Overview
 -------------------------------------------
 
 ONAP supports a modular Heat Orchestration Template design pattern,
@@ -878,7 +878,7 @@ f. VNF Develop Steps
 =======================
 
 Aid to help the VNF vendor to fasten the integration with the GVNFM, the
-OpenO provides the VNF SDK tools, and the documents. In this charter,
+ONAP provides the VNF SDK tools, and the documents. In this charter,
 the develop steps for VNF vendors will be introduced.
 
 First, using the VNF SDK tools to design the VNF with TOSCA model and
index 4c2490e..2c37fb2 100644 (file)
@@ -9,8 +9,8 @@ Introduction
 -------------
 
 This reference document is the VNF TOSCA Template Requirements for
-OpenO, which provides recommendations and standards for building VNF
-TOSCA templates compatible with OpenO– initial implementations of
+ONAP, which provides recommendations and standards for building VNF
+TOSCA templates compatible with ONAP initial implementations of
 Network Cloud. It has the following features:
 
 1. VNF TOSCA template designer supports GUI and CLI.
@@ -25,26 +25,26 @@ Intended Audience
 -----------------
 
 This document is intended for persons developing VNF TOSCA templates
-that will be orchestrated by OpenO.
+that will be orchestrated by ONAP.
 
-Scope 
-------
+Scope
+-----
 
-OpenO implementations of Network Cloud supports TOSCA Templates, also
+ONAP implementations of Network Cloud supports TOSCA Templates, also
 referred to as TOSCA in this document.
 
-OpenO requires the TOSCA Templates to follow a specific format. This
+ONAP requires the TOSCA Templates to follow a specific format. This
 document provides the mandatory, recommended, and optional requirements
 associated with this format.
 
-Overview 
+Overview
 ---------
 
 The document includes three charters to help the VNF vendors to use the
 VNF model design tools and understand the VNF package structure and VNF
 TOSCA templates.
 
-In the OPENO, VNF Package and VNFD template can be designed by manually
+In the ONAP, VNF Package and VNFD template can be designed by manually
 or via model designer tools. VNF model designer tools can provide the
 GUI and CLI tools for the VNF vendor to develop the VNF Package and VNFD
 template.
@@ -59,7 +59,7 @@ self-defined node or other extensions.
 NFV TOSCA Template
 ------------------
 
-TOSCA templates supported by OPENO must follow the requirements
+TOSCA templates supported by ONAP must follow the requirements
 enumerated in this section.
 
 TOSCA Introduction
@@ -84,7 +84,7 @@ Node Template references a Node Type and adds usage constraints, such as
 how many times the component can occur.
 
 |image1|
-Figure 1: Structural Elements of Service Template and their Relations 
+Figure 1: Structural Elements of Service Template and their Relations
 
 TOSCA Modeling Principles & Data Model
 --------------------------------------
@@ -653,7 +653,7 @@ Definition
 Artifact
 ^^^^^^^^
 +-----------+------------+-------------------------------+---------------+------------------------------------------------+
-| Name      | Required   | Type                          | Constraints   | Description                                    |                                                                         
+| Name      | Required   | Type                          | Constraints   | Description                                    |
 +===========+============+===============================+===============+================================================+
 | SwImage   | Yes        | tosca.artifacts.nfv.SwImage   |               | Describes the software image which is          |
 |           |            |                               |               | directly realizing this virtual storage        |
@@ -770,12 +770,12 @@ Properties
 
 
 +-------------------------------+------------+------------------------------------------+---------------+----------------------------------------------------------+
-| Name                          | Required   | Type                                     | Constraints   | Description                                              |                                
+| Name                          | Required   | Type                                     | Constraints   | Description                                              |
 +===============================+============+==========================================+==========================================================================+
-| bitrate_requirement           | no         | integer                                  |               | Bitrate requirement on this connection point.            |                                
+| bitrate_requirement           | no         | integer                                  |               | Bitrate requirement on this connection point.            |
 +-------------------------------+------------+------------------------------------------+---------------+----------------------------------------------------------+
 | virtual\_network\_interface_\ | no         | VirtualNetworkInterfaceRequirements      |               | Specifies requirements on a virtual network              |
-| requirements                  |            |                                          |               | realising the CPs instantiated from this CPD             | 
+| requirements                  |            |                                          |               | realising the CPs instantiated from this CPD             |
 +-------------------------------+------------+------------------------------------------+---------------+----------------------------------------------------------+
 
 Attributes
@@ -1578,25 +1578,25 @@ https://docs.openstack.org/developer/heat/template_guide/hot_spec.html.
 
 .. code-block:: python
 
- heat_template_version: <date>                       
-                                                       
- description:                                          
-   # a description of the template                       
-                                                       
- parameter_groups:                                    
-   # a declaration of input parameter groups and order   
-                                                       
- parameters:                                           
-   # declaration of input parameters                     
-                                                       
- resources:                                            
-   # declaration of template resources                   
-                                                       
- outputs:                                              
-   # declaration of output parameters                    
-                                                       
- conditions:                                           
-   # declaration of conditions                           
+ heat_template_version: <date>
+
+ description:
+   # a description of the template
+
+ parameter_groups:
+   # a declaration of input parameter groups and order
+
+ parameters:
+   # declaration of input parameters
+
+ resources:
+   # declaration of template resources
+
+ outputs:
+   # declaration of output parameters
+
+ conditions:
+   # declaration of conditions
 
 
 Heat Orchestration templates for ONAP must contain the following
@@ -2344,7 +2344,7 @@ When the internal network is created, it should be assigned a unique
 {network-role} in the context of the VNF. `ONAP Resource ID and Parameter Naming Convention`_ provides additional
 details.
 
-VNFs may use **Cloud assigned IP addresses** or 
+VNFs may use **Cloud assigned IP addresses** or
 **predetermined static IPs** when attaching VMs to an internal network.
 
 -  A Cloud assigned IP address is assigned by OpenStack’s DHCP Service.
@@ -3078,8 +3078,8 @@ In this example, the {vm-role} is enumerated in the environment file.
        metadata:
          vm_role: { get_param: vm_role }
 
-Example 
-~~~~~~~~
+Example
+~~~~~~~
 
 The example below depicts part of a Heat Orchestration Template that
 uses the five of the OS::Nova::Server metadata parameter discussed in
@@ -3502,7 +3502,7 @@ The parameter must not be enumerated in the Heat environment file.
 .. code-block:: python
 
  parameters:
+
     {vm-type}_{network-role}_ips:
        type: comma_delimited_list
        description: Fixed IPv4 assignments for {vm-type} VMs on the {Network-role} network
@@ -3844,7 +3844,7 @@ an oam network and the {vm-type} has been defined as db for database.
     db_oam_floating_ip:
        type: string
        description: VIP IP for db VMs on the oam network
+
  resources:
     db_0_port_0:
        type: OS::Neutron::Port
@@ -4086,15 +4086,15 @@ ONAP Output Parameter Names
 
 ONAP defines three types of Output Parameters as detailed in `Output Parameters`_.
 
-ONAP Base Module Output Parameters: 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ONAP Base Module Output Parameters:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ONAP Base Module Output Parameters do not have an explicit naming
 convention. The parameter name must contain {vm-type} and {network-role}
 when appropriate.
 
-ONAP Volume Template Output Parameters: 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ONAP Volume Template Output Parameters:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ONAP Base Module Output Parameters do not have an explicit naming
 convention. The parameter name must contain {vm-type} when appropriate.
@@ -4225,8 +4225,8 @@ ONAP requires the parameter names of certain Contrail Resources to
 follow specific naming conventions. This section provides these
 requirements.
 
-Contrail Network Parameters 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Contrail Network Parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Contrail based resources may require references to a Contrail network
 using the network FQDN.
@@ -4393,7 +4393,7 @@ represent an oam protected network and the {vm-type} has been defined as
      virtual_network_refs:
        - get_param: oam_protected_net_fqdn
      subnet_uuid: { get_param: oam_protected_subnet_id }
-                               
+
 Cinder Volume Templates
 -----------------------
 
@@ -4997,8 +4997,8 @@ balancer and db for database.
     scheduler_hints:
        group: {get_resource: lb_server_group} 
 
-Resource Data Synchronization 
-------------------------------
+Resource Data Synchronization
+-----------------------------
 
 For cases where synchronization is required in the orchestration of Heat
 resources, two approaches are recommended:
@@ -5067,7 +5067,7 @@ oam server.
      mountpoint: /dev/vdb
      instance_uuid: {get_resource: oam_server_01}
 
-High Availability 
+High Availability
 -----------------
 
 VNF/VM parameters may include availability zone IDs for VNFs that
@@ -5097,14 +5097,14 @@ c. VNFM Driver Develop Steps
 ==============================
 
 Aid to help the VNF vendor to fasten the integration with the NFVO via
-Special VNFM, the OpenO provides the documents. In this charter, the
+Special VNFM, the ONAP provides the documents. In this charter, the
 develop steps for VNF vendors will be introduced.
 
 First, using the VNF SDK tools to design the VNF with TOSCA model and
 output the VNF TOSCA package. The VNF package can be validated, and
 tested.
 
-Second, the VNF vendor should provide SVNFM Driver in the OpenO, which
+Second, the VNF vendor should provide SVNFM Driver in the ONAP, which
 is a micro service and in duty of translation interface from NFVO to
 SVNFM. The interface of NFVO is aligned to the ETSI IFA interfaces and
 can be gotten in the charter 5.5. The interface of SVNFM is provided by
@@ -5113,7 +5113,7 @@ the VNF vendor self.
 d. Create SVNFM Adaptor Mircoservice
 =======================================
 
-Some vnfs are managed by special vnfm, before add svnfm to openo, a
+Some vnfs are managed by special vnfm, before add svnfm to ONAP, a
 svnfm adaptor must be added to openo to adapter the interface of nfvo
 and svnfm.
 
@@ -5149,4 +5149,4 @@ POST /openoapi/microservices/v1/services
 
     ]
 
-    }                          
\ No newline at end of file
+    }