Step 1: Mobility Performance Monitoring Collector Configuration Procedure

This section provides detailed step-by-step instructions to configure the Mobility performance monitoring collector.

Prerequisites for 4G Mobility Devices

• 4G Mobility devices must be configured to stream Bulkstats. Refer to Cisco reference instructions to set up Bulkstats.

• FM and Mobility PM collector must be reachable from the mobility devices.

Prerequisites for 5G Mobility Devices

• 5G mobility device Bulkstats are polled by the Mobility performance monitoring Collector component (not streamed). The user must configure the specific stats they are interested in ingesting to Provider Connectivity Assurance via the Common Execution Environment (CEE) configuration file on the device.

• The CEE Bulkstats container on the 5G device must be reachable from the Fault and Mobility performance monitoring collector for SCP/SFTP communication.

1. Configure Mobility Performance Monitoring Collector

To configure mobility performance monitoring in Provider Connectivity Assurance

1. Enable the Mobility plugin within the Fault and Mobility performance monitoring Collector.

2. If 4G devices are required, set up the SFTP collector, which imports the data pushed from 4G Mobility devices.

3. Configure mobility performance monitoring data consumer:            

   1. Create mobility performance monitoring data ingestion cluster.

   2. Set up topic catalog for mobility performance monitoring.

   3. Create the schema for each data type.

   4. Create consumers and handlers for data processing.

4. Enable the performance monitoring data flow from the Fault and Mobility performance monitoring Collector to Provider Connectivity Assurance.          

   1. Create and deploy Censor Collector.

   2. Create, customize and deploy a Telemetry Collector.

   3. Install ingestion dictionaries.

   4. Enable data flow.

   5. Set up dashboard.

2. Enable Mobility Plug-In from the Configuration User Interface

To enable the Mobility plugin from the configuration user interface

1. Log in to the configuration UI with the default username and password provided, which have administrative privileges.

2. Follow the path Admin ▶ Tenant ▶ App Plugins.

3. Add mobility plugin by selecting Enabled and clicking Save. The plugin will be enabled.
   

3. Set Up 4G Devices to Push Data

4G Mobility devices will stream (push) Bulkstats to the SFTP collector. The configuration file on each 4G device must be updated to contain the IP address and credentials of the SFTP collector, so that it can connect to the Fault and Mobility performance monitoring Collector. The following commands must be executed on the 4G device:

Note: This step is not required for 5G devices because they are polled rather than pushing out a stream of data.  

bulkstats collection
  bulkstats mode
    sample-interval 5
    transfer-interval 5
    file 1
      remotefile format /home/callmodel/bulkstats/<HostName>/bulkstat%date%%time%.txt primary-receiver
      receiver <SFTP Collector IP> primary mechanism sftp login <SFTP username> encrypted password 

Note: This step is not required for 5G devices because they are polled rather than pushing out a stream of data.  

4. Set Up Mobility Performance Monitoring Data Ingestion Cluster

The data ingestion cluster imports the data after it has been collected from the devices (i.e via SFTP collector from 4G Devices and/or polled from the CEE Bulkstats container for 5G Devices).

To set this up

1. Log in to Fault and Mobility performance monitoring collector configuration UI using administrative access credentials.

2. Follow the path Admin ▶ Data Pipeline ▶ Ingestion Cluster

3. Click the Add icon on top of the list. Enter the required details in the available fields.

4. Enter name for the ingestion cluster.

5. Select File as the ingestion type.
   

6. Configure the required mandatory parameters for file-based ingestion types.            

   1. Host – Host of SFTP Collector

   2. Port – SFTP port 22

   3. Max sessions – ten

   4. File sync method - SFTP

   5. Username – User name of SFTP collector

   6. Password – password of SFTP collector (if private or public SSH key not available)

   7. Private key – private ssh key for SFTP collector

   8. Public key

7. After entering all the required details, click Save and continue.

5. Set Up Topic Catalog

Topic Catalog maintains the configuration of the Kafka topic in case of Kafka-based ingestion and File path on SFTP server in case of file-based ingestion.

To set this up

1. Log in to FM and Mobility PM collector configuration admin UI using administrative access credentials.

2. Follow the path Admin ▶ Data Pipeline ▶ Topic Catalog.

3. 4G Mobility devices - Bulkstats and SSD Topic configurations are created automatically when the mobility performance monitoring is enabled.            

   1. Configure the path for the SSD and Bulkstats files.
      
      

4. For 5G Mobility devices, click the Add icon on top of the list.            

   a. Create an individual Topic for SMF.
   

5. After entering all the required details, click Save and continue.

6. Set Up Data Pipeline Handlers

To configure the Data stream handlers

1. Log in to FM and Mobility PM collector configuration UI using administrative access credentials.

2. Follow the path Admin ▶ Data Pipeline ▶ Handlers.

In the list of available handlers, the Bulkstats and SSD Handlers are created automatically when mobility performance monitoring is enabled by adding the mobility plugin.

3. Edit the “Bulkstats” handler and the “SSD” handler using the Edit button in the UI, and select the following configuration:            

   1. BulkStats Handler                    

      To process the bulkstats file, set the following values:

      • Handler type: BulkstatsHandler

      • Post process: saveToDB
        
        

   2. SSD Handler                    

      This SSD handler is responsible of processing the SSD file and creating the entry in the database. To process the SSD files, configure these values:

      • Handler Type: SSDHandler

      • Post Process: saveToDB
        

4. For 5G Mobility devices, click the Add icon on top of the list to add the Handlers.

   
   
   

5. After entering all the required details, click Save and continue.

7. Set Up Data Pipeline Schema

To set up data stream Schema configurations

1. Log in to FM and Mobility PM collector configuration admin UI using administrative access credentials.

2. Follow the path Admin ▶ Data Pipeline ▶ Schema.

Bulkstats and SSD Schema are created automatically when mobility performance monitoring is enabled.

3. Edit the “Bulkstats” and the “SSD” using the Edit button in the UI, and choosing the following settings:  

   

   

4. 5G Mobility devices - Click on the Add icon on top of the list to add the Schema.    

   1. Add three individual Schema based on this configuration.

   

5. After entering all the required details, click Save and continue.

8. Set Up Consumers for Data Processing

Consumers process data imported from mobility devices through the configured file-based ingestion type.

To set this up

1. Log in to FM and Mobility PM collector configuration admin UI using administrative access credentials.

2. Follow the path Admin ▶ Data Pipeline ▶ Consumer.

3. Bulkstats and SSD Consumer configurations are created automatically when the mobility performance monitoring is enabled.

4. Edit the Bulkstats and SSD Consumers for 4G Mobility device KPI processing as described below.

   1. SSD Consumer                    

      To consume SSD files, configure the SSD consumer to consume from the topic <tenant>.ssd. The ingestion cluster must use the file-based method, functioning as a configurable scheduler. Select the appropriate SSD-related handler and schema in the Schema and Handler section.

      

   2. BulkStats Consumer                    

      To consume BulkStats files, configure the BulkStats consumer to consume from the topic <tenant>.bulkstats. The ingestion cluster should use the file-based method, functioning as a configurable scheduler. In the Schema and Handler section, select the appropriate BulkStats-related handler and schema.

      
      
      

5. For 5G Mobility devices, add the following consumer.            

   1. SMF Consumer:
      

6. After entering all the required details, click Save and continue.

Next Step

At this stage, the Fault and Mobility Performance Monitoring Collector has been configured. Next, you can proceed to: Step 2: Provider Connectivity Assurance for Mobility PM Configuration Procedure.