Configuring OCNADD Using CNC Console

5 Configuring OCNADD Using CNC Console

This chapter describes how to configure different services in Oracle Communications Network Analytics Data Director (OCNADD) or access OCNADD dashboards using Oracle Communications Cloud Native Configuration Console (CNC Console).

This chapter describes how to configure different global and service parameters in Oracle Communications Network Analytics Data Director (OCNADD) using the CNC Console application. OCNADD provides a console interface using the highly secure GUI service, which allows you to use an interactive interface for interacting with the other OCNADD services.

OCNADD Console Interface

This section provides an overview of the CNC Console, which includes an interface to help in creating data feeds, data filters, and access dashboards in OCNADD.

You can use OCNADD integration with CNC Console, only after logging successfully into the CNC Console application. To log in successfully into CNC Console, ensure that the CNC Console installation steps are complete. For more information about GUI installation, see "Installing OCNADD GUI" section of Oracle Communications Network Analytics Data Director Installation, Upgrade, and Fault Recovery Guide

Note:

Before logging in to the OCNADD Console, create a user and password. Using these login details, you can log in to the OCNADD Console application. For more information about creating a user and password, see Oracle Communications Cloud Native Configuration Console Installation Guide.

To log in to OCNADD Console:

Open a web browser and enter the URL: http://cncc-core-ingress-gateway.cncc.svc.cluster.local:port number/ and press Enter.

Note:
port number is the cncc-iam-ingress-port number.

The login page opens.
Enter the Username and Password.
Click Sign In.
On the Welcome page, select the required instance from the Please Select Instance drop-down field.
This opens the Console home page for the selected instance.
To use OCNADD services integrated with the Console, click Data Director in the left navigation pane.

5.1 Homepage Display and Operations

After you log on, the GUI displays the OCNADD Homepage as the default landing page.

The following screen capture shows an illustration of the OCNADD Homepage:

Figure 5-1 OCNADD Homepage

By default, the homepage displays the Data Feeds page that lists all the available data feeds. The page consists of the following elements:

Create Feed Button

Use the Create Feed button at the top right hand side of the page to create new feeds. For more information about creating data feeds, see Creating Data Feed.
Dashboard Icon
The

icon at the bottom of the page navigates you to the OCNADD dashboard to monitor the system health through Alerts, KPIs, and Metrics. For more information about the page, see OCNADD Dashboard.
Data Feeds Icon
The

opens the existing Data Feed page.
Data Filters List Icon

This icon opens the Data Filters List page.
Alarm History Icon
The

icon at the bottom of the page navigates you to the OCNADD Alarms page to view any active alarms. For more details about the page, see Alarm History.
Ask Oracle
Use the

icon to navigate to Dashboard, 5G Data Feeds, 5G Data Filters, Create New Filter or Create New Feed pages from any page of the GUI.
The Ask Oracle option also allows you to view the following details:
- Information about the OCNADD release including version, release number, and product name
- OCNADD GUI Help

5.2 Data Feed

The Data Feeds page allows you to perform the message data feed related configurations. To open the page, click the icon at the bottom of the page or click 5G Data Feeds on the Ask Oracle page.

5.2.1 Creating Data Feed

This section describes how to create a data feed using the OCNADD console. The configurations include adding destinations, selecting Transport Layer Security (TLS), selecting data source, and handling failure.

The Data Feeds page displays the Create Feed button to begin a new data feed configuration.

To create a data feed:

Navigate to Data Feeds page. The page lists the available data feeds, if any.
Click the Create Feed button.
This opens the Add destinations wizard.

Enter the following information on the Add destinations wizard:

Table 5-1 Add destinations

Field Name	Description
Application Name	Enter the name of the destination application. The name should not start with a capital letter and should not contain special characters other than `-`.
Include Synthetic Packet	Enable this switch to generate synthetic packets to receive data in the hexadecimal format instead of the JSON format. Note: If you enable this switch, the option to configure synthetic packet appears on the page as Create Synthetic Packet wizard.
Connection Type	This data in this field is automatically populates based on the Include Synthetic Packet switch and the Transport Layer Security (TLS) configurations. The possible values for the Connection Type field are: HTTP2: This value populates if the Include Synthetic Packet switch remains disabled and Transport Layer Security (TLS) is configured as either Oracle Approved TLS or Static Key TLS. TCP_SECURED: This value populates if the Include Synthetic Packet switch remains enabled and Transport Layer Security (TLS) is configured as either Oracle Approved TLS or Static Key TLS. H2C: This value populates if the Include Synthetic Packet switch remains disabled and Transport Layer Security (TLS) is configured as No TLS. TCP: This value populates if the Include Synthetic Packet switch remains enabled and Transport Layer Security (TLS) is configured as No TLS.
Transport Layer Security (TLS)	Select any of the following TLS options: Oracle Approved TLS: Specifies the default TLS cipher provided by an Oracle approved cipher suite. This cipher is automatically generated. Static Key TLS: Specifies the static key TLS with which you can choose a different cipher. The data is transferred to HTTP/2 peer using a static key cipher. Here, forward secrecy is not supported. No TLS: Specifies the least secure option. Security is weakened as there is no secrecy of data. When selected, it changes the connection type in the Add destinations page to H2C.
Destination	Provide the destination URL. The URL can start with the `http`, `https`, `tcp`, or `tcps` protocols. Note: The URL protocol automatically populates on the configuration of the Create Synthetic Packet switch and the TLS option. Use the + or - icons to add or remove URLs. If multiple destinations are configured, the option to select the Load Balancing Type is enabled. If the Load Balancing Type selected is Weighted Load Balancing. The user can assign load factors to each destination individually. The load factor is a percentage value between 0 to 100. The sum total of the load factors assigned to each destination must be 100%.
Load Balancing Type	When multiple destinations are configured, the user can select the Load Balancing Type. The options available are: Round Robin: This option is selected by default. Weighted Load Balancing: When multiple destinations are configured, the user can assign load factors to each destination. The sum total of the load factors assigned to each destination must be 100%. Note: The maximum number of destination endpoints allowed is “2”.
Do you want to include meta data?	The switch indicates if the outbound packet from the data director should contain the optional metadata. By default, the switch remains enabled.

Click Continue.
<Optional> This opens the Create Synthetic Packet wizard.

Note:
This wizard is available only if you have enabled the Include Synthetic Packet switch on the Add destinations wizard.

Enter the following information in the Create Synthetic Packet wizard:

Table 5-2 Create Synthetic Packet

Option Name	Description
Device Details	Enter the following device related details: Mac Source Mac Destination Ethernet Type
Network Details	Source Details Source Ip Source Port Destination Details Destination Ip Destination Port

Click Continue.
This opens the Select Data Source(s) wizard.

Select the following options in the Select Data Source(s) wizard:

Table 5-3 Select Data Source(s)

Option Name	Description
Service Communication Proxy (SCP)	Select this option if the data must come from SCP, which allows securing and managing 5G networks by providing routing control, resiliency, and observability to the core network.
Network Repository Function (NRF)	Select this option if the data must come from NRF, which allows 5G NFs to register and discover one another through a standard API. NRF is also a critical component required to implement the new service based architecture (SBA) in the 5G core.
Security Edge Protection Proxy (SEPP)	Select this option if the data must come from SEPP, which acts as a security gateway by enabling secure interconnect between 5G networks. It ensure end-to-end confidentiality and integrity between the source and the destination networks.

Click Continue.
This opens the Handle Failure wizard.

Select any of the following options to determine the behavior of OCNADD if the data cannot reach your application:

Table 5-4 Handle Failure - OCNADD Behavior

Option Name	Description
Do not try again	Specifies that Data Director reaches out just one time if the data cannot reach the external application
Keep trying	Specifies that Data Director continually reaches out to the external application until it successfully connects to it.

Select any of the following options to determine how OCNADD resumes the sending of data after reconnection if a failure occurs.

Table 5-5 Handle Failure - Resuming services

Option Name	Description
Resume from point of failure	Specifies that Data Director resumes from point of failure if a failure occurs. This reduces the chance of losing data.
Proceed with latest data	Specifies that Data Director proceeds with latest data transfer once the connection is established. This might result in data loss.

Click Submit.
This creates the data feed with the selected configurations.

5.2.2 Editing Data Feed

This section describes how to edit a data feeds using the OCNADD console.

To edit or delete the data feeds:

Click the icon at the bottom of the page or click 5G Data Feeds on the Ask Oracle page. The Data Feeds page opens listing all the existing data feeds.
To edit a data feed, click the icon under the Actions column.
Select Edit to update the fields or options for the selected data feed. This opens the Edit Data Feed page.
The edit page can also be accessed by clicking on the data feed name.
Edit the selected data feed configurations by clicking the

icon.
After performing the modifications, click Save Changes.

Note:
Click Cancel to cancel the updates.

5.2.3 Cloning Data Feed

This section describes how to clone a data feed using the OCNADD console.

To clone the data feeds:

Click the icon at the bottom of the page or click 5G Data Feeds on the Ask Oracle page. The Data Feeds page opens listing all the existing data feeds.
To clone a data feed, click the icon under the Actions column.
Select Clone to create a clone of the selected data feed. This creates a clone of the selected data feed.
The clone has all the configurations similar to the data feed from which it is created.

5.2.4 Deleting Data Feed

This section describes how to delete a data feeds using the OCNADD console.

To edit or delete the data feeds:

Click the icon at the bottom of the page. The page lists all the existing data feeds.
Click the icon under the Actions column to delete a data feed.
Select Delete to delete the data feed. This opens a dialog box to confirm the deletion.
On the dialog box, click Delete. This deletes the data feed permanently.

5.3 Data Filters List

The Data Filters List page allows you view the configured data filters, modify, or create new data filters. To open this page, click the Data Filters List icon at the bottom of the homepage or click 5G Data Filters on the Ask Oracle page.

Use the Search option to search by Filter Name.

Use the icon in the Action column to Edit or Delete a filter.

The Status of a filter can be changed by enabling the Status (Active/Deactive) switch for the filter. If the status is changed, a notification appears on the screen indicating the change.

5.3.1 Create Filter

This section describes how to create a data filter using the OCNADD console.

To create a new data filter, click Create Filter on the Data Filters List page or click Create New Filter on the Ask Oracle page.

To create a data filter, enter the following information:

Add a Filter Name. The name should not contain capital letters or special characters except for hyphen.
Select the Filter Type from the drop down list. The available options are Egress and Ingress. The default filter type is Egress.
Select the Association. If the Filter Type is configured as Egress, the data feeds created by the user are the options available to select for Association. If the Filter Type is configured as Ingress, select NRF or SEPP or SCP as the Association.
The Action is automatically populated based configured Filter Type. If the Filter Type is Ingress, the Action is DENY. If the Filter Type is Egress, the Action is ALLOW.
Use the Filter Condition drop down list to select condition. If the Filter Type is Egress, the available options are service-name, user-agent, consumer-id, producer-id, consumer-Fqdn, and producer-fqdn. If the Filter Type is Ingress, the available options are consumer-id, producer-id, consumer-fqdn, and producer-fqdn.

Note:
A maximum of four Filter Conditions can be specified. Click Add Condition to add filter conditions. Click Remove Condition to remove Filter Conditions.
Use the Condition Value option to specify the values for the conditions. Use + or - icons to add or remove condition values.
Select the Status from the drop down list. The options available are ACTIVATE and DEACTIVATE. The default status is ACTIVATE.
The Filter Rule option appears only when more than one condition is specified for the filter. Use this option to specify the filter rule.

On successful creation of the filter, the filter is listed on the Data Filters List page.

5.3.2 Editing Data Filter

Note:

Ensure the filter is deactivated prior to updating (edit or change) the filter type.

This section describes how to edit a data filter using the OCNADD console.

To edit the data filter:

Click the

icon at the bottom of the page or click 5G Data Filters on the Ask Oracle page. The Data Filters List page opens, this page lists all the existing data filters.
To edit a data filter, click the icon under the Actions column.
Select Edit to update the fields or options for the selected data filter. This opens the Edit Data Filter page.
The edit page can also be accessed by clicking on the data filter name.
Edit the selected data filter configurations by clicking the

icon.
After performing the modifications, click Save Changes.

Note:
Click Cancel to cancel the updates.

5.3.3 Deleting Data Filter

This section describes how to delete a data filter using the OCNADD console.

To delete the data filters:

Click the

icon at the bottom of the page. The page lists all the existing data filters.
Click the icon under the Actions column to delete a data filter.
Select Delete to delete the data filter. This opens a dialog box to confirm the deletion.
On the dialog box, click Delete. This deletes the data filter permanently.

5.4 OCNADD Dashboard

This section describes how to use the OCNADD dashboard to view metrics, KPIs, and alarms for monitoring data feeds and the Ingress and Egress GW traffic.

To view the dashoard, click the

icon at the bottom of the page or click Dasboard on the Ask Oracle page.

Active Issues

In case of an active issue, the Dashboard page displays the respective metric or alert at the top of the page with the page title as Active issue needs your attention.

Click on View Button to see the detailed description of the issue and the affected data feeds. The page also provides the recommended action to fix the issue. For more details about OCNADD alerts and respective actions, see Oracle Communications Network Analytics Data Director User Guide.

Monitoring Alarms, Metrics, and KPIs

The dashboard allows monitoring of major and critical alarms that need to be resolved. It provides the details of the severity of a specific alarm and its impact on the data feed.

Also, the dashboard allows monitoring CPU utilization, memory utilization, and number of instances of a specific microservice. Using the dashboard, you can check the details of all the metrics and alarms related to a specific microservice.

To view the details of any active issues, click View Details. Viewing details allows you to understand the impact of any issues immediately, and therefore, prioritize the relevant troubleshooting tasks.

5.5 Alarm History

This section describes how to use the Alarm History page to view OCNADD alarms.

To view the dashoard, click the

icon at the bottom of the page.

The Alarm History page allows you to search and filter through all the alarms that may have occurred in the system since the beginning. It is possible to filter the alarms based on description or type, or both. The alarms are defined using different color notations.

For see the list of OCNADD alarms, see Oracle Communications Network Analytics Data Director User Guide.