- Print
- PDF
Creating and Installing Roadrunner for Skylight orchestrator
Overview
Roadrunner runs in a Docker container and is the interface between Skylight orchestrator and Skylight analytics.
This connection allows you to:
- Receive performance monitoring data from orchestrator and forward it to Skylight analytics
- Set up multiple Roadrunner instances to send data concurrently to Skylight analytics
Prerequisite
To install and configure roadrunner, you must first, from Skylight analytics:
- 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
Note: You should not have a firewall. If required, traffic to outside world on TCP port 443 (HTTPS) should be allowed.
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
Log in to Skylight analytics.
Go to the Settings menu.
Select Sessions.
Click Connectors.
Click the + button.
Assign a name to the connector.
Select your data source typeFileWatcher:
Select get data from Skylight orchestrator.
Specify path to data, as shown below:
CAUTION: This path should match the directory in your RR environment (i.e., /var/lib/data/roadrunner) and Zone name MUST BE UNIQUE per connector.
- Save the configuration.
Downloading the Connector
To download the connector
- 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
Copy the DataHubConnector.tar.gz file to the Roadrunner directory (/opt/roadrunner/) on your Docker/Linux host.
Open a terminal in to your Linux host
Go to the Roadrunner directory:
cd /var/tmp/roadrunner_files
- Extract the tar.gz archive:
sudo tar xfv DataHubConnector.tar.gz
- Run the run.sh shell script to install Roadrunner:
sudo ./run.sh
Roadrunner will automatically start once the installation is complete.
Linking to Skylight orchestrator
To link Roadrunner to your Skylight orchestrator you must do the following from orchestrator in the Collection ▶ Server Configuration tab settings:
To link Roadrunner to Skylight orchestrator
Log in to Skylight orchestrator and go to the Collection ▶ Server Configuration tab.
Check default server for metrics collection checkbox to export metrics from Skylight elements (PAA, BRW, SOAM, etc.) and Skylight sensor: control (NFV SOAM, flowmeter, etc.)
Check Enable export of performance sessions to export metrics from Skylight orchestrator sessions.
Set up the IP address of the device in /var/lib/data/roadrunner/.
Enter username and password.
Click Test to test the connection.
Click Apply.
Validate
Once you have linked the Roadrunner in orchestrator you can validate that it is running.
© 2024 Cisco and/or its affiliates. All rights reserved.
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms
For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks