Oracle® Communications Network Repository Function (NRF) Cloud Native Installation and Upgrade Guide Release 1.1 F19518-01 July 2019 Oracle Communications Network Repository Function (NRF) Cloud Native Installation and Upgrade Guide, Release 1.1 F19518-01 Copyright © 2019, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle. Contents 1 NRF Overview NRF Overview 1-1 NRF Supported Services 1-1 References 1-2 Acronyms 1-2 Documentation Admonishments 1-3 Locate Product Documentation on the Oracle Help Center Site 1-4 Customer Training 1-4 My Oracle Support 1-5 Emergency Response 1-5 2 NRF Customization NRF Configuration 2-1 NRF Configurable Parameters 2-4 3 NRF Installation NRF Pre-requisites 3-1 Installation Sequence 3-2 NRF Installation Preparation 3-3 NRF Deployment 3-4 4 NRF Upgrade 5 NRF Uninstallation 6 NRF Alert Configuration iii List of Tables 1-1 Acronyms 1-3 1-2 Admonishments 1-4 2-1 Global Parameters 2-5 2-2 NF Registration 2-7 2-3 NF Subscription 2-9 2-4 NRF Auditor 2-10 2-5 Ambassador 2-10 2-6 NF Discovery 2-11 3-1 Installation Sequence 3-2 3-2 NRF Images 3-3 3-3 NRF Installation Preparation 3-3 3-4 NRF Deployment 3-6 3-5 Parameters and Definitions for NRF Installation 3-7 4-1 Parameters and Definitions during NRF Upgrade 4-1 iv 1 NRF Overview NRF Overview This section includes information about the role of Network Repository Function (NRF) in 5G Service Based Architecture. The NRF is one of the main key component of the 5G Service Based Architecture. The NRF maintains an updated repository of all the 5G elements available in the operator's network along with the services provided by each of the elements in the 5G core that are expected to be instantiated, scaled and terminated without or minimal manual intervention. The NRF supports discovery mechanisms that allows 5G elements to discover each other and get updated status of the desired elements. The NRF supports the following functions: • Maintains the profiles of the available NF instances and their supported services in the 5G core network • Allows consumer NF instances to discover other providers NF instances in the 5G core network • Allows NF instances to track the status of other NF instances The NRF interacts with every other element in the 5G core network and it supports the above functions through the following services: • Management Services • Discovery Services NRF Supported Services This section includes information about the services supported by NRF. NRF supports the following services: NRF Management Services The NRF Management service is identified by the service operation name Nnrf_NFManagement. NRF supports the following management services: Note: The respective service operation name is mentioned next to each service. 1-1 Chapter 1 References • Register NF instance (NFRegister): Allows an NF instance to register its NF profile in the NRF along with the list of services provided by the NF instance. • Update NF instance (NFUpdate): Enables an NF instance to partially update or replace the parameters of its NF profile in the NRF. It also allows to add or delete services provided by the NF instance. This operation supports the following: – Complete Replacement of NF profile – Partial Replacement of NF profile – Add, Remove, or Update attributes of NF Profile – Heart beat & Load info of NF • De-register NF instance (NFDeregister): Enables an NF instance to de-register its NF profile and the services provided by the NF instance from the 5G network. • Subscribe to Status (NFStatusSubscribe): Enables an NF instance to subscribe the status changes of other NF instances registered in the NRF. • Unsubscribe to Status (NFStatusUnsubscribe): Enables an NF instance to unsubscribe the status changes of other NF instances. • Receive Notifications of Status (NFStatusNotify): Enables the NRF to notify changes in status of NF instances to any subscriber of NF status. Changes also include information regarding newly registered and de-registered NFs. Discovery Service The NRF Discovery service is identified by the service operation name Nnrf_NFDiscovery Service. NRF supports the following Discovery service: Note: The respective service operation name is mentioned next to the supported Discovery service. Discover NF instance (NFDiscover): NRF supports discovery of the IP address/FQDN of the NF instances, or NF Services that match certain input criteria. References • CNE Installation Document • NRF User's Guide Acronyms The following table provides information about the acronyms and the terminology used in the document. 1-2 Chapter 1 Documentation Admonishments Table 1-1 Acronyms Field Description 5G-AN 5G Access Network 5GC 5G Core Network AMF Access and Mobility Management Function CNE Cloud Native Environment MMI Machine Machine Interface MPS Messages Per Second NF Network Function Network Function A functional building block within a network infrastructure, which has well defined external interfaces and well defined functional behavior. In practical terms, a network function is often a network node or physical appliance. Network Slice A logical network that provides specific network capabilities and network characteristics. Network Slice instance A set of Network Function instances and the required resources (e.g. compute, storage and networking resources) which form a deployed Network Slice. NF Consumer A generic way to refer to an NF which consumes services provided by another NF. Ex: An AMF is referred to as a Consumer when it consumes AMPolicy services provided by the PCF. NF Instance A specific instance of a network function type. NF Producer or NF Provider A generic way to refer to an NF which provides services that can be consumed by another NF. Ex: A PCF is a provider NF and provides AMPolicy Services NRF Network Repository Function or Network Function Repository Function Resiliency The ability of the NFV framework to limit disruption and return to normal or at a minimum acceptable service delivery level in the fame of a fault, failure, or an event that disrupts normal operation. Scaling Ability to dynamically extend/reduce resources granted to the Virtual Network Function (VNF) as needed. This includes scaling out/in or scaling up/down. Scaling Out/In/ Horizontally The ability to scale by add/remove resource instances (e.g. VMs). Also called scaling Horizontally. Scaling Up/Down/ Vertically The ability to scale by changing allocated resources, e.g. increase/ decrease memory, CPU capacity or storage size. PCF Policy Control Function SEPP Security Edge Protection Proxy SCP Service Controller Proxy 5G System 3GPP system consisting of 5G Access Network (AN), 5G Core Network and UE Documentation Admonishments Admonishments are icons and text throughout this manual that alert the reader to assure personal safety, to minimize possible service interruptions, and to warn of the potential for equipment damage.