Creating and Installing Sensor Collector for Legacy Orchestrator

Overview

Sensor Collector runs in a Docker container and is the interface between Legacy Orchestrator and Provider Connectivity Assurance.

This connection allows you to:

• Receive performance monitoring data from Legacy Orchestrator and forward it to Provider Connectivity Assurance
• Set up multiple Sensor Collector instances to send data concurrently to Provider Connectivity Assurance

Prerequisite

To install and configure Sensor Collector, you must first, from Provider Connectivity Assurance:

• Configure a connector
• Download the connector file to the Docker host
• Install Sensor Collector

System Requirements

Before setting up Sensor Collector, make sure you have the following environment set up:

• 100 GB disk space
• 4 CPU
• 2 GB RAM
• Docker 18.03 or later
• Tested operating systems:
• Debian 9 or higher
• CentOS 7.3 or higher

Deployments

To standardize deployments, the following structure on your Docker/Linux host is recommended :

Create a directory for your Sensor Collector software in /opt/

sudo mkdir -p /opt/roadrunner

Create a directory for your data in /var/lib/data/

sudo mkdir -p /var/lib/data/roadrunner

Configuring a Connector

To configure a connector

1. Log in to Provider Connectivity Assurance.

2. Access the page Settings ▶ Sessions.

3. Select Connectors.

4. Click the Add ( + ) button.

5. Assign a name to the connector.

6. Select your data source typeFileWatcher.

7. Select get data from Legacy Orchestrator.

8. Specify the Path to the data.

10. Save the configuration.

Downloading the Connector

To download the connector

1. Select the collector you have just created from the list.
2. Click the ellipses (...) button.
3. Click Download Connector Config to download the DataHubConnector.tar.gz installation file to your workstation.

Installing Sensor Collector

To install the Sensor Collector

1. Copy the DataHubConnector.tar.gz file to the Sensor Collector directory (/opt/roadrunner/) on your Docker/Linux host.

2. Open a terminal in to your Linux host.

3. Go to the Sensor Collector directory:

cd /var/tmp/roadrunner_files

4. Extract the tar.gz archive:

sudo tar xfv DataHubConnector.tar.gz

5. Run the run.sh shell script to install Sensor Collector:

sudo ./run.sh

Sensor Collector will automatically start once the installation is complete.

Linking to Legacy Orchestrator

To link Sensor Collector to your Legacy Orchestrator you must do the following from Legacy Orchestrator in the Collection ▶ Server Configuration tab settings:

To link Sensor Collector to Legacy Orchestrator

1. Log in to Legacy Orchestrator and go to the Collection ▶ Server Configuration tab.

2. Check default server for metrics collection checkbox to export metrics from Provider Connectivity Assurance Sensors (PAA, BRW, SOAM, etc.) and Provider Connectivity Assurance Sensor Control (NFV SOAM, flowmeter, etc.)

3. Check Enable export of performance sessions to export metrics from Legacy Orchestrator sessions.

4. Set up the IP address of the device in /var/lib/data/roadrunner/.

5. Enter username and password.

6. Click Test to test the connection.

7. Click Apply.

Validate

Once you have linked the Sensor Collector in Legacy Orchestrator you can validate that it is running.