Home

Welcome to the repository of the Command-Line-Interface (CLI) tools for the SONATA SDK, son-cli. This module provides a set of tools to help the developer on the creation, deployment and monitoring of services and functions for the SONATA platform.

Documentation

Each one of these tools is driven for a specific purpose, described as follows:

1. son-workspace - to create and manage a development workspace/environment and to create projects;
2. son-package - to package projects;
3. son-validate - to validate the syntax, integrity and topology of SONATA SDK projects, packages, services and functions;
4. son-access - to authenticate in the Service Platform and to upload and retrieve resources from the Service Platform and the Emulation Platform;
5. son-monitor - to gather monitoring metrics from network services deployed in the emulator or in the service platform;
6. son-profile - to deploy network services on SONATA’s Emulation platform and to test its performance.

Installation

We currently provide repositories for Ubuntu Trusty (14.04), Ubuntu Xenial (16.04) and CentOS 7. For the remaining OS's please use python's setup tools.

Ubuntu Trusty (14.04) and Xenial (16.04)

To install the SONATA CLI toolset in Ubuntu, please follow these steps:

1. Add the new GPG key

   sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 8EC0731023C1F15B

2. Add a source entry for your Ubuntu OS. For now, the following distributions are supported:

• Ubuntu Trusty 14.04 (LTS)

  echo "deb http://repo.sonata-nfv.eu ubuntu-trusty main" | sudo tee -a /etc/apt/sources.list

• Ubuntu Xenial 16.04 (LTS)

  echo "deb http://repo.sonata-nfv.eu ubuntu-xenial main" | sudo tee -a /etc/apt/sources.list

3. Update and install

   sudo apt-get update
   sudo apt-get install sonata-cli

CentOS 7

To install the SONATA CLI toolset in CentOS 7 follow these steps:

1. Install EPEL

   yum install epel-release

2. Create a repository entry file in /etc/yum.repo.d/sonata.repo with the following content:

   [sonata-repo]
   name=SONATA Repository
   baseurl=http://rpmrepo.sonata-nfv.eu/repo/
   enabled=1
   gpgcheck=0

   Note: currently the repository is not GPG signed (future work)
3. Install CLI

   yum install sonata-cli

All dists (using setuptools)

The SONATA CLI toolset can also be installed via the Python setup script:

git clone http://github.com/sonata-nfv/son-cli
cd son-cli
python3 setup.py install

Contact information

• son-workspace, son-package, son-validate, son-access: Luís Conceição (@lconceicao)
• son-monitor: Steven Van Rossem (@stevenvanrossem)
• son-profile: Manuel Peuster (@mpeuster), Steven Van Rossem (@stevenvanrossem)