Skip to content

SONATA Final Review SDK Demo Playbook

Jump to bottom
Manuel Peuster edited this page Mar 26, 2018 · 25 revisions

SONATA Final Review SDK Demo Playbook

This pages contains the exact walkthrough of the SDK demo to be shown during the final project review in March 2018.

Preparations

Installation

# install son-cli tools
git clone https://github.com/sonata-nfv/son-cli.git

# clone vcdn pilot
git clone https://github.com/sonata-nfv/son-vcdn-pilot.git

Update/refresh

To reflect last minute changes on the descriptors, always update the vcdn pilot folder.

git pull --rebase upstream master

Activate virtualenv 

source son-cli/venv/bin/activate

Launch GUI Validator

docker run -d --rm -p 8080:8080 -p 5050:5050 -v /home/sonata/son-vcdn-pilot/projects:/projects --name son-validate-gui sonatanfv/son-validate-gui

Connect to SONATA VPN

sudo ./vpn.sh

Add some errors to the descriptors

NSD

File: son-vcdn-pilot/projects/son-vcdn-placementssm/sources/nsd/son-vcdn-placementssm.yml

# point to wrong VNF
network_functions:
  - vnf_id: "vnf_vtc"
    vnf_vendor: "de.sonata-nfv"  # BUG 'de' should be 'eu'
    vnf_name: "vtc-vnf"
    vnf_version: "0.2"

# use wrong connection points
virtual_links:
  - id: "vlmgmt"
    connectivity_type: "E-LAN"
    connection_points_reference:
      - "vnf_vtc:cpmgmtt"  # BUG 'cpmgmtt' should be 'cpmgmtt'
      - "vnf_vcc:cpmgmt"
      - "vnf_vtu:cpmgmt"  
      - "nscpmgmt"

# have a messed-up VNFFP
    network_forwarding_paths:
      - fp_id: "ns:fg01:fp01" # Incoming User Requests (for service) vtc-vcc plus the 
        policy: "none"
        connection_points:
          - connection_point_ref: "nscpinput"
            position: 1
          - connection_point_ref: "vnf_vtc:cpinput"
            position: 2
          - connection_point_ref: "vnf_vtc:cpoutput"
            position: 3
          - connection_point_ref: "vnf_vtc:cpinput"  # BUG 'vnf_vtc:cpinput' should be 'vnf_vcc:cpinput'
            position: 4 
          - connection_point_ref: "vnf_vcc:cpinput"
            position: 5
          - connection_point_ref: "nscpoutput"
            position: 6

Playbook

Step 1: Open the vCDN project in a editor

subl son-vcdn-pilot/projects/son-vcdn-genericplacement
subl son-vcdn-pilot/projects/son-vcdn-placementssm

Step 2: Validation

Step 2.1: Validate the service(s) using CLI

# service 1
son-validate --project son-vcdn-pilot/projects/son-vcdn-genericplacement
# service 2
son-validate --project son-vcdn-pilot/projects/son-vcdn-placementssm

Step 2.2: Validate the service(s) using GUI

  • Open Firefox and navigate to 127.0.0.1:8080 or click on SONATA Validator GUI shortcut.
  • Click: New Validation
  • Check: Syntax, Integrity, and Topology
  • Set path: /projects/son-vcdn-genericplacement or /projects/son-vcdn-placementssm
  • Click: Validate

Step 2.3: Fix the error(s) found during validation

(see son-validate output)

Step 2.4: Validate the service(s) using CLI (again)

# service 1
son-validate --project son-vcdn-pilot/projects/son-vcdn-genericplacement
# service 2
son-validate --project son-vcdn-pilot/projects/son-vcdn-placementssm

Step 3: Package the service(s)

# package 1
son-package --project son-vcdn-pilot/projects/son-vcdn-genericplacement

# package 2
son-package --project son-vcdn-pilot/projects/son-vcdn-placementssm

Step 4: On-board the service(s)

Step 4.1: Authentication

Log into the remote service platform.

son-access auth -u sonata -p 1234

Step 4.2: Package upload

Upload the packages:

son-access push --upload eu.sonata-nfv.son-vcdn-genericplacement.0.1.son
son-access push --upload eu.sonata-nfv.son-vcdn-placementssm.0.1.son

Step 5: Show package in BSS

Demo ends here so that the vCDN demo can continue ...

Videos

Pre-installed virtual machine

  • Cannot be made public due to credentials contained in the VM.
  • Ask: Manuel Peuster (manuel . peuster @ upb . de)

Other references

TBD

Optional

SONATA Editor

cd son-editor-backend
docker-compose up

Browse: http://localhost

Clone this wiki locally