Skip to content
Steven Van Rossem edited this page Sep 6, 2017 · 32 revisions

Welcome to 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 tools is driven for a specific purpose, described as follows:

  1. son-workspace - creation and management of a development workspace/environment and creation of projects
  2. son-package - project packaging
  3. son-validate - validate the syntax, integrity and topology of SONATA SDK projects, packages, services and functions
  4. son-access - authentication in the Service Platform; uploading and retrieval of resources from the Service Platform and the Emulation Platform
  5. son-monitor - gather monitored metrics from network services deployed in the emulator or the service platform.
  6. son-profile - deployment of network services on SONATA’s Emulation platform and performance testing

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 setuptools.

Ubuntu Trusty (14.04) and Xenial (16.04)

To install the SONATA CLI toolset in Ubuntu 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, supported 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
  1. 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