Using Unified Data Repository (UDR) Console

Logging into CNC Console

A user can use UDR integrated with CNC Console only after logging successfully into the CNC Console application. To login successfully into the CNC Console, the user needs to make the following updates to the hosts file available at the C:\Windows\System32\drivers\etc location.

In the Windows system, user needs to open the hosts file in the notepad as an Administrator and append the following set of lines at the end:

Example:

10.75.212.88 cncc-iam-ingress-gateway.cncc.svc.cluster.local

10.75.212.88 cncc-core-ingress-gateway.cncc.svc.cluster.local

Note:

The IP Address in the above lines may change when deployment cluster changes.

Save and close the notepad.

Note:

Before logging to CNC Console, it is important to create a CNC user. Using this user details, you can login to the CNC Console application. For information on creating a CNC Console user, you can refer to its user guide.

To login to CNC Console:

Type http://cncc-core-ingress-gateway.cncc.svc.cluster.local:<PortNumber>/ in the web browser and press Enter. Following screen appears:

Figure 5-1 CNC Console Login Screen
Enter the Username and Password and click Log In. Following screen appears:

Figure 5-2 CNC Console Home Page

This is the CNC Console Home Page from where a user can navigate to different NF services. To use UDR services integrated with CNC Console, click UDR in the left navigation pane.

Global Configurations

To access the Global Configurations screen, click UDR → Global Configurations in the left navigation pane of the CNC Console application. The following screen appears:

Figure 5-3 Global Configurations

The Global Configurations screen displays value of some global parameters like:

DB Service Name: displays the name of the DB Service
UDR Services: displays 'All' when all the UDR services are engaged
Egress Gw Enabled: displays 'true' when egress gateway is enabled and 'false' when egress gateway is not enabled.
UDSF Enabled: displays 'true' when UDSF is enabled and 'false' when UDSF is not enabled.
Ingress Http Port: is a read-only field and its default value is 80. It defines the Ingress Gateway signalling port for http.
Ingress Https Port: is a read-only field and its default value is 443. It defines the Ingress Gateway signalling port for https.

These values are extracted from the database and on every Helm upgrade, users need to click the Refresh icon to view the latest values.

Service Configurations

To configure UDR services using CNC Console, you can use Service Configurations. In the left navigation pane of the CNC Console application, click UDR → Service Configurations.

Using Service Configurations, UDR users can configure following services:

Data Repository Service

Click UDR → Service Configurations → Data Repository Service. The Data Repository Service Configurations screen appears as shown below:

Figure 5-4 Data Repository Service Configurations

img/data-repository-service-configurations_new.png

The following table explains the Data Repository Service Configurations screen in detail:

Field Name	Default Value	Attribute	Description
Log Level	WARN	Editable	This field shows the log level of the data repository service. Its possible values are: WARN INFO DEBUG
Hikari Pool Size	25	Read-only	The hikari pool connection size to be created at start uP
Auto Create Subscriber	True	Editable	This field enables auto creation of a subscriber when creating data for a non existent subscriber.
VSA Level	smpolicy	Read-only	This field displays the VSA level. It is a read-only value.
Tracing Enabled	False	Read-only	By default, tracing is not enabled.

Editing Data Repository Service Configurations

To update or modify any configuration information related to data repository:

Click Edit. The Edit Datarepository Service Configurations screen appears.

Figure 5-5 Edit Datarepository Service Configurations
Update the configuration details as required and click Save. A confirmation message, "Save successfully." appears.
If you do not want to modify any configuration, click Cancel. You navigate back to the Data Repository Service Configurations screen.
Click Refresh to reload the Data Repository Service Configurations screen.

Notify Service

Click UDR → Service Configurations → Notify Service. The Notify Service Configurations screen appears as shown below:

Figure 5-6 Notify Service Configurations

The following table explains the Notify Service Configurations screen in detail:

Field Name	Default Value	Attribute	Description
Log Level	WARN	Editable	This field shows the log level of the data repository service. Its possible values are: WARN INFO DEBUG
Notif Retry Count	3	Editable	Number of notification attempts to be done in case of notification failures. Retries are based on notification.retryerrorcodes configuration.
HTTP Retry Count	2	Editable	Number of retries when there is failure of connection to other services.
Notif Retry Interval	5	Editable	The retry interval for notifications in case of failure. It is measured in seconds. Retries are based on notification.retryerrorcodes configuration.
Retry Error Codes	400,429,500,503	Editable	This field displays comma separated error codes. These error codes are eligible for retry notifications in case of failures.
Hikari Pool Size	25	Read-only	The hikari pool connection size to be created at start up.
Tracing Enabled	False	Read-only	By default, tracing is not enabled.

Editing Notify Service Configurations

To update or modify any configuration information related to notify service:

Click Edit. The Edit Notify Service Configurations screen appears.

Figure 5-7 Edit Notify Service Configurations
Update the configuration details as required and click Save. A confirmation message, "Save successfully." appears.
If you do not want to modify any configuration, click Cancel. You are navigated back to the Notify Service Configurations screen.
Click Refresh to reload the Notify Service Configurations screen.

NRF Client Service

Click UDR → Service Configurations → NRF Client Service. The NRF Client Configurations screen appears as shown below:

Figure 5-8 NRF Client Configurations

The following table explains the NRF Client Configurations screen in detail:

Field Name	Default Value	Attribute	Description
Log Level	WARN	Editable	This field shows the log level of the data repository service. Its possible values are: WARN INFO DEBUG
Heartbeat Timer	90	Editable
Allowed Nf Types	PCF,UDM	Read-only	The types of NF that are allowed to use this NRF client service.
UDR GroupId	udr-1	Editable	Group ID of UDR
Supported DataSets	POLICY,SUBSCRIPTION	Read-only	The types of datasets that are allowed.
SSL	False	Read-only	SSL flag to enable SSL with udr nrf client pod
Liveness Probe Max Retry	5	Editable	The maximum number of times to retry liveness probe of NRF client service.
NRF Base Url	"http://ocnrf-ingressgateway.mynrf.svc.cluster.local/nnrf-nfm/v1/nf-instances"	Read-only	NRF URL for registration
Tracing Enabled	False	Read-only	By default, tracing is not enabled.
Scheme	Http	Read-only	scheme in which udr supports
UDR IP Endpoint	udr-1	Editable	IP alotted to ocudr-endpoint pod
Priority	10	Editable	Priority to be sent in registration request
Pod Capacity Multiplier	500	Editable	Capacity multiplier of UDR based on number of UDR pods running
PLMN List	"[{mnc": "14", "mcc": "310"}]"	Editable	Plmn values range that it supports. Plmn values are sent to nrf during regisration from UDR.
SUPI Ranges	[{"start": "10000000000", "end": "20000000000"}]"	Editable	SUPI range supported with UDR
GPSI	"[{"start": "10000000000", "end": "20000000000"}]"	Editable	Gpsi Range supported with UDR

Editing NRF Client Configurations

To update or modify any configuration information related to NRF client:

Click Edit. The Edit NRF Client Configurations screen appears.

Figure 5-9 Edit NRF Client Configurations
Update the configuration details as required and click Save. A confirmation message, "Save successfully." appears.
If you do not want to modify any configuration, click Cancel. You navigate back to the NRF Client Configurations screen.
Click Refresh to reload the NRF Client Configurations screen.

Diameter Service

Click UDR → Service Configurations → Diameter Service. The Diameter Service Configurations screen appears as shown below:

Figure 5-10 Diameter Service

The following table explains the Diameter Service Configurations screen in detail:

Field Name	Default Value	Attribute	Description
Log Level	WARN	Editable	This field shows the log level of the data repository service. Its possible values are: WARN INFO DEBUG
Realm	oracle.com	Read-only	UDR Diameter server realm.
Identity	nudr.oracle.com	Read-only	UDR Diameter server identity/fqdn.
Reconnect Delay	4	Editable	Waiting time for reconnecting server peer in seconds.
Response Timeout	4	Editable	Time period to get the response from server peer in seconds.
Connection Timeout	7	Editable	Time period in which, both client and server should establish the connection.
Watchdog Interval	7	Editable	Interval of time to send Diameter watch dog message periodically.
Reconnect Limit	70	Read-only	Number of attempts allowed to reconnect with diameter server peer if server is unreachable/down.
Peer Nodes For Notifications	[ {"name": "seagull","responseOnly": true,"host": "10.75.185.158","realm": "seagull1.com","identity": "seagull1a.seagull1.com","port": 3868,"transport": "TCP"} ]	Editable	Server peer nodes used for sending notification.
peerNodesForNotifications.name	seagull	Editable	Name of the server peer
peerNodesForNotifications.responseOnly	true	Editable	Specify initiator or responder
peerNodesForNotifications.host	10.75.185.158	Editable	Host IP Address of the diameter server.
peerNodesForNotifications.realm	seagull1.com	Editable	Host server realm
peerNodesForNotifications.identity	seagull1a.seagull1.com	Editable	Host server identity or fqdn.
peerNodesForNotifications.port	3868	Editable	Host server port
peerNodesForNotifications.transport	TCP	Editable	TCP connection type
Allowed Client Nodes	[{"identity": "seagull1a.seagull1.com","realm": "seagull1.com"}]	Editable	Client peer who wants to connect 5G UDR through sh interface.
allowedClientNodes.identity	seagull1a.seagull1.com	Editable	Client peer identity/fqdn who wants to connect 5G UDR through sh interface.
allowedClientNodes.realm	seagull1.com	Editable	Client peer realm who wants to connect 5G UDR through sh interface.

Editing Diameter Service Configurations

To update or modify any configuration information related to diameter service:

Click Edit. The Edit Diameter Service Configurations screen appears:

Figure 5-11 Editing Diameter Service Configurations
Update the configuration details as required and click Save. A confirmation message, "Save successfully." appears.
If you do not want to modify any configuration, click Cancel. You navigate back to the Diameter Service Configurations screen.
Click Refresh to reload the Diameter Service Configurations screen.

Provisioning - Profile Data

In this section, you will learn to operate provisioning operations for Profile Data.

In the CNC Console application, click UDR → Provisioning → Profile Data in the left navigation pane. Following screen appears:

Figure 5-12 Provisioning - Profile Data

In the Provisioning Operations for Profile Data screen, user can:

Extract profile data from UDR database on the basis of UE ID entered
Add new profile data to the UDR database
Modify an existing profile data on the basis of UE ID
Delete an existing profile data that is no more needed in the UDR database

Extracting Profile Data

To extract a profile data:

Ensure Resource Name is set to 'Profile Data'.
Type an appropriate UE ID. For example: msisdn-1111111114
Click Get. A confirmation message, 'Fetched Successfully' appears for a second and the result appears in the Response text area as follows:

Figure 5-13 Sample Screen: Get - Profile Data - Response
An Error message summary appears in case of incorrect UE ID entered.

Adding a Profile Data

To add a profile data:

Ensure Resource Name is set to 'Profile Data'.
Type an appropriate UE ID. For example: msisdn-1111111114
Click Add. The Request text area appears.
Type-in the profile data that you want to add to the UDR database.
Click Submit. The 'Saved Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Editing a Profile Data

To edit a profile data:

Ensure Resource Name is set to 'Profile Data'.
Type an appropriate UE ID. For example: msisdn-1111111114
Click Edit. The Request text area displays an existing profile data.
Type-in the updated profile data.
Click Submit. The 'Saved Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Deleting a Profile Data

To delete a profile data:

Ensure Resource Name is set to 'Profile Data'.
Type an appropriate UE ID. For example: msisdn-1111111114
Click Delete.
The 'Deleted Successfully' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Clearing a Profile Data

Click the Clear option to clear all the text fields and text areas of the Provisioning Operations for Profile Data.

Provisioning - PCF Data

In this section, you will learn to operate provisioning operations for PCF (Policy Control Function) Data.

In the CNC Console application, click UDR → Provisioning → PCF Data in the left navigation pane. The following screen appears:

Figure 5-14 Provisioning Operations for PCF Data

In the Provisioning Operations for PCF Data screen, user can:

Select Resource Name as Policy Data.
Extract PCF data from UDR database on the basis of UE ID entered.
Add PCF Data on the basis of payload.
Modify the existing PCF data on the basis of UE ID.
Delete the existing PCF data that is no more needed in the UDR database.

Extracting PCF Data

To extract the PCF data:

Select Resource Name as Policy Data.
Type an appropriate UE ID. For example: msisdn-9111111112.
Click Get. A confirmation message, 'Fetched Successfully.' appears and the result appears in the Response text area as follows:

Figure 5-15 Provisioning PCF Get Response
An Error message summary appears in case of incorrect UE ID entered.

Adding a PCF Data

To add a PCF data:

Select the Resource Name as Policy Data.
Type an appropriate UE ID. For example: msisdn-9111111112.
Click Add. The Request text area displays an existing PCF data.
Type-in the updated profile data.
Click Submit. The 'Saved Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Editing a PCF Data

To edit a PCF data:

Select the Resource Name as Policy Data.
Type an appropriate UE ID. For example: msisdn-9111111112.
Click Edit. The Request text area displays an existing PCF data.
Type-in the updated profile data.
Click Submit. The 'Saved Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Deleting a PCF Data

To delete a PCF Data:

Select the Resource Name as either Access And Mobility Policy Data, Session Management Policy Data or UE Policy Set.
Type an appropriate UE ID. For example: msisdn-9111111112.
Click Delete.
The 'Deleted Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Clearing a Profile Data

Click the Clear option to clear the text fields and text areas of the Provisioning Operations for PCF screen.

Provisioning - SLF Data

In this section, you will learn to operate provisioning operations for SLF (Subscriber Location Function) Data.

In the CNC Console application, click UDR → Provisioning → SLF Data in the left navigation pane. The following screen appears:

Figure 5-16 Provisioning SLF Data

Note:

SLF Group Name must be provisioned before SLF Subscriber is provisioned.

In the Provisioning Operations for SLF Data screen, user can:

Extract SLF data from UDR database on the basis SLF Group Name (Query Parameter) or SLF Subscriber (UEID).
Add or edit an existing SLF data on basis of SLF Group Name (Query Parameter) or SLF Subscriber (UEID).
Delete an existing SLF data that is no more needed in the UDR database.

Extracting SLF Data on the basis of SLF Group Name

To extract the SLF data on the basis of SLF Group Name:

Select the Resource Name as SLF Group Name.
Enter the Query Parameters.
Click Get. A confirmation message, 'Fetched Successfully.' appears and the result appears in the Response text area as follows:

Figure 5-17 Provisioning SLF Get Response

Extracting SLF Data on the basis of SLF Subscriber

To extract the SLF data on the basis of SLF Subscriber:

Select the Resource Name as SLF Subscriber. The following screen appears:

Figure 5-18 SLF Data on the basis of SLF Subscriber
Type an appropriate UE ID. For example: msisdn-1111111112
Click Get. A confirmation message, 'Fetched Successfully.' appears and the result appears in the Response text area as follows:

Figure 5-19 Provisioning SLF Get Response
An Error message summary appears in case you enter an incorrect UE ID.

Adding SLF Data on the basis of SLF Group Name or SLF Subscriber

To add the SLF data:

Select the Resource Name as either SLF Group Name or SLF Subscriber.
If you have selected the Resource Name as SLF Group Name then,
1. Enter the Query Parameters.
2. Click Add. The Request text area appears.
3. Type the SLF data.
4. Click Submit. The 'Saved Successfully.' message appears.
[OR]
If you have selected the Resource Name as SLF Subscriber then,
1. Type an appropriate UE ID. For example: msisdn-1111111112.
2. Click Add. The Request text area appears.
3. Type-in the SLF data.
4. Click Submit. The 'Saved Successfully.' message appears.

Note:

If a user enters any incorrect input, an Error message summary appears.

Editing SLF Data

To edit a SLF data:

Select the Resource Name as either SLF Group Name or SLF Subscriber.
If you have selected the Resource Name as SLF Group Name then,
1. Type in the Query Parameters and click Get. The result appears in the Response text area.
2. Click Edit. The Request text area displays an existing SLF data. Modify the relevant details.
3. Click Submit. The 'Saved Successfully.' message appears.
[OR]
If you have selected the Resource Name as SLF Subscriber then,
1. Type in the UE ID and click Get. The result appears in the Response text area.
2. Click Edit and modify the required details. The Request text area displays an existing SLF data. Modify the relevant details.
3. Click Submit. The 'Saved Successfully.' message appears.

Note:

If a user enters any incorrect input, an Error message summary appears.

Deleting a SLF Data

To delete a SLF Data:

Select the Resource Name as either SLF Group Name or SLF Subscriber.
If you have selected the Resource Name as SLF Group Name then enter the 'Query Parameters' and if you have selected the Resource Name as SLF Subscriber then enter the 'UE ID'. For example: msisdn-1111111112
Click Delete.
The 'Deleted Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Clearing a Profile Data

Click the Clear option to clear the text fields and text areas of the Provisioning Operations for SLF Data screen.

Provisioning - UDM Data

In this section, you will learn to operate provisioning operations for UDM (Unified Data Management) Data.

In the CNC Console application, click UDR → Provisioning → UDM Data in the left navigation pane. The following screen appears:

Figure 5-20 Provisioning Operations for UDM Data

In the Provisioning Operations for UDM Data screen, user can extract, modify and delete UDM data on the basis of Resource Name, UE ID, PDU Session ID, Serving PLMN ID, Version and Query Parameters entered.

Extracting UDM Data

To extract the UDM data:

Select the Resource Name from the drop-down list.
Type an appropriate UE ID, PDU Session ID and Serving PLMN ID in their respective fields.
Select an appropriate Version and enter Query Parameters.
Click Get. A confirmation message, 'Fetched Successfully.' appears and the result appears in the Response text area.
An Error message summary appears in case of incorrect UE ID entered.

Adding a UDM Data

To add a UDM data:

Select the Resource Name.
Type an appropriate UE ID, PDU Session ID and Serving PLMN ID in their respective fields.
Select an appropriate Version and enter Query Parameters.
Click Edit. The Request text area appears.
Enter details and click Submit. The 'Saved Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Editing a UDM Data

To edit a UDM data:

Select the Resource Name.
Type an appropriate UE ID, PDU Session ID and Serving PLMN ID in their respective fields.
Select an appropriate Version and enter Query Parameters.
Click Edit. The Request text area displays an existing UDM data.
Edit as required and click Submit. The 'Saved Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Deleting a UDM Data

To delete a UDM Data:

Enter the Resource Name.
Type an appropriate UE ID, PDU Session ID and Serving PLMN ID in their respective fields.
Select an appropriate Version and enter Query Parameters.
Click Delete.
The 'Deleted Successfully.' message appears.

Note:
If a user enters any incorrect input, an Error message summary appears.

Clearing a Profile Data

Click the Clear option to clear the text fields and text areas of the Provisioning Operations for UDM screen.

Provisioning - Schema Management Data

In this section, you will learn to operate provisioning operations for schemas.

In the CNC Console application, click UDR → Provisioning → Schema Management Data in the left navigation pane. The following screen appears:

Figure 5-21 Provisioning for Schema Management

In the Schema Management screen, user can extract, modify and delete a schema on the basis of Resource Name and Query Parameters. This resource name can be either PCF AM Data, PCF SM Data or PCF UE Policy Set.

Extracting a Schema

To extract a schema:

Select the Resource Name. It can be either PCF AM Data, PCF SM Data or PCF UE Policy Set.
Enter the Query Parameters.
Click Get. A confirmation message, 'Fetched Successfully.' appears and the result appears in the Response text area as follows:

Figure 5-22 Schema - Get - PCF AM Data
An Error message summary appears in case of incorrect UE ID entered.

Adding or Editing a Schema

To add or edit a schema:

Select the Resource Name.
Enter the Query Parameters.
Click Edit. The Request text area displays the selected schema.
Edit as required and click Submit. The 'Saved Successfully.' message appears.

Note:
If a user edits the schema inappropriately, an Error message summary appears.

Deleting a Schema

To delete a schema:

Select the Resource Name.
Enter the Query Parameters.
Click Delete.
The 'Deleted Successfully.' message appears.

Note:
If a user selects a schema that does not exists, an Error message summary appears.

Clearing a Profile Data

Click the Clear option to clear the text fields and text areas of the Schema Management screen.

Logout of CNC Console

To logout of the CNC Console application, click the Sign Out link available at the top right corner. The following confirmation box appears:

Figure 5-23 CNC Console Logout

Click Log Out. The user exits the application and the CNC Console login screen appears.