Creating and Installing Roadrunner for Legacy orchestrator

Overview

Roadrunner 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 orchestrator and forward it to Provider Connectivity Assurance
• Set up multiple Roadrunner instances to send data concurrently to Provider Connectivity Assurance

Prerequisite

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

• Configure a connector
• Download the connector file to the Docker host
• Install Roadrunner

System Requirements

Before setting up Roadrunner, 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 roadrunner 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. Go to the Settings menu.

3. Select Sessions.

4. Click Connectors.
   

5. Click the + button.

6. Assign a name to the connector.

7. Select your data source typeFileWatcher:

8. Select get data from Legacy orchestrator.
   

9. Specify path to data, as shown below:
   

10. Save the configuration.

Downloading the Connector

To download the connector

1. Select the collector you just created from the list and click the (...) button to download the DataHubConnector.tar.gz installation file to your workstation:
   

Installing Roadrunner

To install the Roadrunner

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

2. Open a terminal in to your Linux host

3. Go to the Roadrunner 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 Roadrunner:

sudo ./run.sh

Roadrunner will automatically start once the installation is complete.

Linking to Legacy orchestrator

To link Roadrunner to your Legacy orchestrator you must do the following from orchestrator in the Collection ▶ Server Configuration tab settings:

To link Roadrunner 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 Roadrunner in orchestrator you can validate that it is running.